Cómo conectar Sellercloud a Gemini vía MCP

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

Sellercloud + Gemini

Las operaciones de e-commerce multicanal de Sellercloud: pedidos de venta con notas y paquetes, vistas de pedidos guardadas, catálogo de productos y precios, inventario por almacén, clientes, empresas, órdenes de compra, proveedores y sus productos, devoluciones (RMA), almacenes, traspasos, picklists y tareas en cola. Solo lectura, inicia sesión con el login de un empleado de Sellercloud.

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:

SELLERCLOUD_API_URL, SELLERCLOUD_USERNAME, SELLERCLOUD_PASSWORD

Paso 1 — Obtener credenciales

La configuración lleva unos minutos. Necesitas el nombre de tu equipo de Sellercloud y el login de un empleado de Sellercloud.

1. Abre https://api.sellercloud.com/api/server-by-team/?team=YOURTEAM en el navegador, cambiando YOURTEAM por el nombre de equipo con el que entras en Sellercloud.
2. Copia el valor RestApiEndpoint en SELLERCLOUD_API_URL. Tiene este aspecto: https://xx.api.sellercloud.com/rest (algunos servidores terminan en .sellercloud.us/rest). Deja el /rest al final y quita la barra final si la hay.
3. Elige el empleado con el que entra el conector. Sellercloud recomienda un empleado distinto para cada integración, así que usa uno dedicado y dale los permisos de Delta para los datos que la IA debe leer: pedidos, productos, inventario, compras, clientes.
4. Pon el nombre de usuario de ese empleado (normalmente el email) en SELLERCLOUD_USERNAME y la contraseña en SELLERCLOUD_PASSWORD.
5. Instala el conector y ejecuta sellercloud_list_warehouses: si la dirección y el login son correctos, lista tus almacenes. Después sellercloud_list_companies muestra tus empresas (unidades de negocio o tiendas), cuyos ids filtran la mayoría de las demás herramientas.

Inicia sesión solo: el conector entra con el usuario y la contraseña, recibe un token que dura de 30 a 60 minutos y vuelve a entrar antes de que caduque o tras un 401. Si cambia la contraseña del empleado, pega la nueva. La IA ve exactamente lo que ese empleado puede ver, por eso un empleado dedicado con solo los permisos necesarios es la opción más segura.

Qué lee: pedidos de venta con líneas, totales, pagos, pérdidas y ganancias, notas, paquetes y seguimiento; tus vistas de pedidos guardadas; el catálogo de productos con el precio del sitio y el precio por canal de venta; el inventario con cantidad física, reservada y por almacén, y unidades vendidas; clientes y empresas; órdenes de compra con sus líneas, los proveedores y los productos que suministra cada uno; devoluciones (RMA) con motivos, resoluciones y reembolsos; almacenes, traspasos entre almacenes, picklists y tareas en cola como importaciones y exportaciones, con su progreso.

Las vistas guardadas funcionan como en Sellercloud: sellercloud_list_order_views lista las vistas guardadas en la página Manage Orders y sellercloud_list_orders_by_view devuelve exactamente los pedidos que muestra una vista, así la IA no tiene que reconstruir tus filtros.

Códigos, páginas y moneda: Sellercloud usa códigos numéricos para estados y canales, por ejemplo estado de pedido 2 InProcess, 3 Completed, 100 ProblemOrder, 200 OnHold y -1 Cancelled; la IA te los traduce. Las listas devuelven 10 filas por defecto y hasta 50 por página, recortadas a los campos útiles; sellercloud_get_order y las demás herramientas de un solo registro devuelven todos los campos. Los importes de los pedidos internacionales se convierten a USD al crearse el pedido.

Solo lectura, nada que confirmar: ninguna herramienta crea, cambia ni borra nada, así que ninguna está desactivada al instalar y la IA nunca tiene que preguntar antes de un cambio.

Límites: Sellercloud permite 10.800 peticiones por hora por usuario y dirección IP. Por encima del límite responde "Too many requests." con un RateLimitResetTime, y la IA espera hasta entonces.

Errores comunes: 400 o 401 al iniciar sesión significa que el usuario o la contraseña son incorrectos, o que la dirección no es el RestApiEndpoint de tu propio servidor. 403 significa que al empleado le falta el permiso de Delta para esos datos. 404 significa que en esa dirección no hay una API REST de Sellercloud: vuelve a copiar el RestApiEndpoint, termina en /rest.

El conector no crea ni actualiza pedidos, productos, inventario, órdenes de compra ni devoluciones.

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

Herramientas disponibles

Ejemplos de prompts

• "¿Qué pedidos han entrado hoy y siguen sin enviar? Agrúpalos por canal de venta."
• "¿Cuántas unidades del SKU WIDGET-AZUL tenemos en cada almacén, y cuántas están reservadas?"
• "¿Qué productos están agotados ahora mismo, y cuántos vendimos de cada uno en los últimos 30 días?"
• "¿Qué órdenes de compra abiertas con Acme Supply no se han recibido del todo todavía, y qué falta?"
• "¿Dónde está el pedido 1234567? Dame el número de seguimiento, el estado de la entrega y las notas del pedido."

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