Cómo conectar SellAuth a Gemini vía MCP

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

SellAuth + Gemini

Tienda SellAuth de productos digitales, solo lectura: análisis de ingresos y beneficios, productos y clientes principales, facturas (pedidos), productos y variantes, clientes, valoraciones, tickets de soporte y cupones. Las claves de producto entregadas nunca se devuelven.

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:

SELLAUTH_API_KEY, SELLAUTH_SHOP_ID

Paso 1 — Obtener credenciales

La configuración lleva unos 2 minutos. Necesitas una tienda en SellAuth y acceso a su panel para crear una clave de API.

1. En el panel de SellAuth abre Account y luego Developers (dash.sellauth.com/api), y crea una clave de API.
2. Pega solo la clave en SELLAUTH_API_KEY, sin Bearer, espacios ni comillas.
3. Escribe el id numérico de tu tienda en SELLAUTH_SHOP_ID, por ejemplo 123456. Si no lo tienes claro, sellauth_list_shops lista todas las tiendas a las que llega la clave, con su id.
4. Instala el conector y ejecuta sellauth_list_shops: muestra las tiendas de la clave con nombre, subdominio, moneda y totales, lo que confirma que la clave funciona.

Un conector, una tienda: todas las herramientas salvo sellauth_list_shops leen la tienda de SELLAUTH_SHOP_ID. Si tu clave llega a varias tiendas, instala el conector una vez por tienda.

Qué lee: las cifras principales de la tienda (ingresos, pedidos, clientes, coste de la mercancía, beneficio y cobertura de costes) con la variación frente al periodo anterior; las series de ingresos, pedidos y beneficio del gráfico del panel; los 10 productos y variantes más vendidos y los 10 clientes que más han gastado; las facturas (pedidos) con estado, precio, importe pagado, pasarela, método de pago, e-mail del cliente, país y artículos, y una factura completa con comisiones, descuentos, impuestos, pagos, cupón y estado de disputa; productos y variantes con precio, coste, stock, unidades vendidas y visibilidad; clientes con e-mail, nombre de Discord, saldo en la tienda, pedidos completados y gasto total; valoraciones con nota, mensaje, respuesta y disputa; tickets de soporte con asunto, estado, factura relacionada y último mensaje; y cupones con usos, vigencia, ingresos atribuidos e importe ahorrado.

Encontrar pedidos: las facturas se filtran por estado (completed para pedidos pagados, o pending, expired, cancelled, refunded y partial), por e-mail del cliente y por rango de fechas de creación, y se ordenan por id, precio, importe pagado o fecha. Las listas llegan por páginas; la IA pide la siguiente hasta tenerlas todas. Los importes están en USD salvo que el campo indique otra cosa.

Fuera de las respuestas: las claves de serie, archivos y enlaces entregados a los compradores, los comprobantes de pago, las direcciones IP y los secretos de Discord y webhook de la propia tienda nunca llegan a la IA. Las facturas sí incluyen el e-mail y el país del cliente.

Solo lectura: todas las herramientas solo leen. No cambia nada en tu tienda, así que no hay nada que confirmar y ninguna herramienta está desactivada al instalar.

Límites: las listas devuelven como máximo 100 filas por página. Cuando SellAuth responde 429 (demasiadas llamadas), la IA espera un minuto antes de volver a intentarlo.

Errores frecuentes: 401 significa que la clave de API es incorrecta o se eliminó: crea una nueva en Developers y vuelve a pegarla. 403 significa que la clave funciona, pero no para esa tienda: revisa SELLAUTH_SHOP_ID con sellauth_list_shops. 404 significa que en esta tienda no hay ninguna factura o producto con ese id, o que no existe una tienda con ese id.

El conector no crea ni edita productos, cupones ni facturas, no emite reembolsos, no responde a tickets ni valoraciones y no entrega ni muestra claves de producto.

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

Herramientas disponibles

Ejemplos de prompts

• "¿Cómo va mi tienda: ingresos, pedidos y beneficio frente al periodo anterior?"
• "¿Cuáles son los 10 productos que más me hacen ganar y cuánto beneficio deja cada uno?"
• "Lista los pedidos reembolsados y cancelados del mes pasado con el e-mail del cliente y el importe."
• "Muéstrame los tickets de soporte abiertos y a qué pedido corresponde cada uno."
• "¿Qué valoraciones tienen nota baja o una disputa, y ya les hemos respondido?"

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