Cómo conectar Payhip a Gemini vía MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Payhip, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

Payhip + Gemini

Gestiona los códigos de cupón de tu tienda de Payhip y comprueba claves de licencia de software desde un agente de IA: lista y lee cupones, crea nuevos con tu aprobación, verifica la clave de licencia de un comprador y, si lo permites, desactívala, reactívala o cuenta sus activaciones.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

PAYHIP_API_KEY

Paso 1 — Obtener credenciales

La configuración lleva unos 2 minutos. Necesitas una tienda de Payhip y su clave de API. Para las claves de licencia también necesitas un producto con las claves de licencia activadas.

1. En Payhip abre Settings → Developer y copia la API key.
2. Pega solo la clave en PAYHIP_API_KEY. La usan las herramientas de cupones.
3. Opcional, para claves de licencia: abre el producto en Payhip, marca Generate unique license keys si aún no está activado y copia la product secret key que aparece debajo de esa casilla en PAYHIP_PRODUCT_SECRET_KEY.
4. Instala el conector y ejecuta payhip_list_coupons: lista tus códigos de cupón y confirma que la clave de API funciona. Si configuraste una product secret key, ejecuta payhip_verify_license con la clave que recibió uno de tus compradores para comprobar también las licencias.

Un producto con licencia por instalación: una product secret key pertenece a un solo producto. Para comprobar claves de varios productos, instala el conector una vez por producto y pon a cada instalación el nombre del producto. Los cupones funcionan en todas las instalaciones, porque usan la clave de API de la tienda.

Qué lee: los códigos de cupón de tu tienda con código, tipo (un producto, todos los productos o una colección), descuento en porcentaje o importe, fechas de inicio y fin, compra mínima, límite de usos y notas; y, para el producto configurado, el estado de una clave de licencia: si está activa, el email del comprador, producto y variante, cuántas veces se ha usado y cuándo se emitió.

Solo cupones y claves de licencia: hoy la API de Payhip solo cubre estas dos áreas. Productos, ventas, clientes y pagos no están disponibles a través de ella.

Cómo leer los datos: los importes (descuento fijo, compra mínima) van en céntimos y el descuento porcentual es un porcentaje. Una respuesta vacía de payhip_verify_license significa que la clave no existe para este producto. Payhip desactiva una clave automáticamente cuando se reembolsa su compra. Los usos de una clave son un contador que tu software sube y baja; Payhip no impone límite, lo impone tu software.

Desactivadas al instalar: payhip_create_coupon, payhip_disable_license, payhip_enable_license, payhip_increase_license_usage y payhip_decrease_license_usage. Un cupón nuevo funciona en el checkout en cuanto existe, y una clave desactivada deja al comprador sin acceso a tu software hasta que se reactive. Los productos de suscripción no pueden recibir cupones por la API. Un administrador activa las que necesites.

Pregunta antes de cada cambio: con una herramienta de escritura activada, la IA te muestra el código, el descuento y a qué se aplica, o la clave de licencia y qué le va a pasar, y espera tu sí.

Límites: las listas de cupones llegan en páginas de hasta 100, así que en una tienda grande la IA las recorre por páginas en lugar de pedirlo todo de golpe.

Errores comunes: 401 authentication_fail significa que la clave de API o la product secret key es incorrecta o falta: vuelve a copiar PAYHIP_API_KEY desde Settings → Developer y, para las herramientas de licencias, revisa PAYHIP_PRODUCT_SECRET_KEY en la página del producto. El firewall de Payhip pone a prueba las llamadas de cupones que llegan desde direcciones de centros de datos, por eso salen por el proxy de salida de AnythingMCP donde hay uno configurado (como en AnythingMCP Cloud). En un servidor propio sin CONNECTOR_PROXY_URL, las llamadas de cupones pueden responder 403 con una página HTML.

El conector no lee productos, ventas, clientes ni pagos, y no emite reembolsos ni claves de licencia nuevas.

Paso 2 — Instalar el adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Paso 3 — Añadir el conector en Gemini

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Gemini CLI lee los servidores MCP de ~/.gemini/settings.json (en Windows, %USERPROFILE%\.gemini\settings.json). Añade:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia gemini.
3. Ejecuta /mcp dentro de Gemini CLI (o gemini mcp list en tu terminal): anythingmcp debería aparecer como conectado.
4. Empieza a escribir prompts: Gemini CLI ya puede llamar a las herramientas de Payhip.

Herramientas disponibles

Ejemplos de prompts

• "¿Es válida la clave de licencia 7XK2-9QPL-44MZ-H1TR? ¿Quién la compró y cuántas veces se ha usado?"
• "Lista nuestros códigos de cupón con el descuento de cada uno y dime cuáles caducan este mes."
• "¿Qué condiciones tiene el cupón VERANO25: compra mínima, límite de usos y a qué producto se aplica?"
• "Un comprador dice que su clave dejó de funcionar después de un reembolso. Comprueba si sigue activa y a qué email pertenece."
• "¿Cuáles de nuestros cupones valen para todos los productos y cuáles solo para un producto o una colección?"

FAQ

¿Dónde busca Gemini CLI los servidores MCP? En ~/.gemini/settings.json para tu usuario, o en .gemini/settings.json dentro de un proyecto. gemini mcp list muestra cada servidor y si se conecta.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT
• Conectar a Cursor
• Conectar a Meta Muse
• Conectar a Microsoft Copilot