Cómo conectar Gumroad a Gemini vía MCP

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

Gumroad + Gemini

Deja que tu IA lea tu tienda de Gumroad: productos, ventas con filtros, suscriptores de membresías, códigos de descuento, campos del checkout, claves de licencia y webhooks. Tras tu confirmación puede publicar o retirar un producto y crear un código de descuento. Los reembolsos están desactivados. Token de acceso de tu aplicación de Gumroad.

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:

GUMROAD_ACCESS_TOKEN

Paso 1 — Obtener credenciales

La configuración lleva unos 3 minutos y solo necesitas tu cuenta de Gumroad.

1. Inicia sesión en Gumroad y abre Settings → Advanced → Applications.
2. Crea una aplicación: cualquier nombre y cualquier dirección https como redirect URI (el conector no la usa). Haz clic en Create application.
3. En la nueva aplicación, haz clic en Generate access token y copia el token en GUMROAD_ACCESS_TOKEN, sin la palabra Bearer.
4. Instala el conector y ejecuta gumroad_get_user: muestra la cuenta a la que pertenece el token.

Guarda el token en privado: un token de Gumroad tiene todos los permisos que ofrece Gumroad, reembolsos incluidos, y quien lo tenga puede gestionar tu tienda. El conector solo usa lo que necesitan sus herramientas. Para revocar el acceso, elimina la aplicación o genera un token nuevo.

Qué lee: tus productos con precio, moneda, estado de publicación, detalles de membresía, etiquetas, número de ventas e ingresos; un producto con su descripción, variantes y opciones; las ventas, de la más reciente a la más antigua, filtradas por fecha, producto, correo o nombre del comprador, número de pedido o clave de licencia, cada una con precio, comisión de Gumroad, cantidad, variantes, código de descuento y estado de reembolso y disputa; los suscriptores de una membresía con su estado (activo, cancelación pendiente, pago fallido, cancelado) y sus fechas; los códigos de descuento y cuántas veces se usó cada uno; los campos adicionales que un producto pide en el checkout; las claves de licencia; y los webhooks configurados en tu cuenta.

Ingresos de un periodo: Gumroad devuelve 10 ventas por página, así que para un mes o un año la IA recorre todas las ventas, las suma y te dice cuántas ha contado. Los importes llegan en céntimos de la moneda del producto y las fechas en UTC.

Verificar licencias no gasta activaciones: gumroad_verify_license te dice si una clave es válida para un producto, cuántas veces se ha usado y a qué compra pertenece, sin contar un uso (salvo que lo pidas). Un 404 significa que la clave no existe para ese producto, está desactivada o su compra perdió el acceso.

Pregunta antes de cada cambio: gumroad_enable_product pone un producto a la venta al instante, gumroad_disable_product lo retira de la venta (quien ya lo compró conserva el acceso) y gumroad_create_offer_code crea un código de descuento que los clientes pueden usar enseguida. Antes de cada uno, la IA te muestra el producto, o el código con su descuento y sus límites, y espera tu sí.

Desactivado al instalar: gumroad_refund_sale. Los reembolsos devuelven dinero al comprador y no se pueden deshacer. Un administrador lo activa a conciencia; la IA te muestra entonces la venta, el comprador y el importe, y solo reembolsa tras tu confirmación. Ninguna herramienta elimina productos, códigos de descuento ni campos adicionales.

Datos de clientes: las ventas y los suscriptores incluyen correos, nombres y claves de licencia de los compradores. La IA solo lee lo que necesita tu pregunta y no lo copia a ningún otro sitio.

Errores habituales: 401 significa que el token es incorrecto o que se eliminó la aplicación; genera un token nuevo. "Not found" significa que Gumroad no conoce ese id de producto, venta o suscriptor.

El conector no crea, edita ni elimina productos, variantes o archivos, no marca ventas como enviadas, no revoca accesos, no reenvía recibos, no gestiona pagos ni formularios fiscales, no envía correos ni gestiona flujos de trabajo y no crea ni elimina webhooks.

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 Gumroad.

Herramientas disponibles

Ejemplos de prompts

• "¿Cuántas ventas hice el mes pasado y cuántos ingresos generó cada producto?"
• "¿Qué miembros de mi membresía cancelaron o tienen un pago fallido este mes?"
• "¿Es válida esta clave de licencia para Plugin Pro y cuántas veces se ha usado? No cuentes la comprobación como uso."
• "Crea un código de descuento BLACKFRIDAY del 20 % para el Notion Template Pack, limitado a 100 usos. Enséñame antes los detalles."
• "Retira de la venta mi antiguo curso de 2024 para que nadie pueda comprarlo más."

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