Cómo conectar Shopee Seller a Gemini vía MCP

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

Shopee Seller + Gemini

Deja que tu IA trabaje con tu tienda de Shopee: publicaciones y variantes, pedidos, envíos y seguimiento, devoluciones, ingresos por pedido, promociones y cifras de Ads, con cambios de stock y precio cuando los pidas.

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:

SHOPEE_HOST, SHOPEE_PARTNER_ID, SHOPEE_PARTNER_KEY

Paso 1 — Obtener credenciales

La configuración lleva unos 15 minutos la primera vez, más lo que tarde Shopee en revisar una app nueva. Necesitas una app propia en la Shopee Open Platform y la cuenta de vendedor de la tienda.

1. Inicia sesión en open.shopee.com, completa el registro de desarrollador, abre Console → App List y crea una app para tu propia tienda (por ejemplo del tipo Seller In House System). Shopee revisa las apps nuevas antes de que puedan pasar a producción.
2. En la página de edición de la app, pon tu dirección de AnythingMCP en Test Redirect URL Domain y Live Redirect URL Domain: https://cloud.anythingmcp.com en AnythingMCP Cloud, o la dirección de tu propio servidor si lo alojas tú. Shopee rechaza una autorización que vuelve a otro dominio.
3. Copia el Partner ID de la app en SHOPEE_PARTNER_ID y la Partner Key en SHOPEE_PARTNER_KEY. Las apps de producción y de prueba tienen claves distintas: usa el par que corresponda al host.
4. Configura SHOPEE_HOST: https://partner.shopeemobile.com para tiendas reales (Sudeste Asiático, Taiwán, Latinoamérica y los demás mercados), https://openplatform.shopee.com.br si tu app se sirve desde Brasil, https://openplatform.shopee.cn para desarrolladores de China continental, y https://openplatform.sandbox.test-stable.shopee.sg (o https://partner.test-stable.shopeemobile.com) con claves de prueba y una tienda de prueba en el sandbox.
5. Instala el conector, ábrelo y haz clic en Authorize with Provider. En Shopee, inicia sesión con la cuenta de la tienda (una cuenta principal o de merchant se rechaza), elige la tienda y cuánto dura la autorización, y confirma. Después ejecuta shopee_get_shop_info: muestra la tienda, su región y estado, y cuándo caduca la autorización.

Los tokens se renuevan solos: el token de acceso dura unas 4 horas y se renueva automáticamente. El refresh token que lo respalda dura unos 30 días, así que un conector que nadie usa durante más tiempo, o cuya autorización se revocó en Shopee Seller Centre, necesita una autorización nueva. El conector lo indica, su propietario recibe un email y basta un clic en Authorize with Provider.

Tu Partner Key se queda en AnythingMCP: cada llamada se firma con ella y la clave nunca se envía. Una firma vale 5 minutos, así que en un servidor propio con la hora mal puesta Shopee responde error_sign.

Qué lee: la tienda y su perfil público; tus publicaciones con nombre, SKU, categoría, estado, precio, stock, imágenes, peso y logística, además de ventas, visitas, me gusta y valoraciones; las variantes de una publicación (color, talla, etc.) con su propio precio y stock; los pedidos con comprador, artículos, importes, método de pago, transportista, paquetes y dirección; los pedidos que aún hay que enviar; cómo se puede entregar un pedido (franjas de recogida y puntos de entrega), números y historial de seguimiento; tus canales logísticos; las solicitudes de devolución y reembolso con motivo, fotos del comprador e importe; lo que te deja cada pedido tras comisiones, tarifas, envío y cupones; tus promociones; y tu saldo de Shopee Ads con las cifras diarias de tus anuncios CPC (impresiones, clics, gasto, pedidos, GMV y ROAS).

Ventanas de tiempo: Shopee lista pedidos y devoluciones en ventanas de 15 días como máximo, así que para un mes entero la IA consulta dos veces y suma. Las cifras de Ads cubren como mucho un mes por consulta, dentro de los últimos 6 meses.

Desactivadas al instalar: shopee_update_stock y shopee_update_price. Cambian tu tienda real: el stock se sobrescribe (no puede bajar de lo que ya reservaron los pedidos) y un precio nuevo vale al momento, mientras que las promociones en curso conservan su propio precio. Un administrador las activa a propósito, y aun así la IA te muestra cada publicación o variante con el valor anterior y el nuevo y espera tu sí.

Nada mueve dinero: ninguna herramienta envía, cancela, reembolsa, responde a compradores ni crea promociones. Organizar envíos, gestionar devoluciones y responder a compradores sigue en Shopee Seller Centre.

Límites: Shopee limita las llamadas por app. Tras error_rate_limit o un 429 la IA espera un minuto antes de volver a intentarlo. Las herramientas de Ads necesitan el permiso de Ads en tu app.

Errores comunes: error_sign o invalid_partner_id significa que el Partner ID, la Partner Key y el host no encajan, por ejemplo claves de producción en el host del sandbox. error_permission significa que a la app le falta el permiso para esa API. error_param significa que un parámetro es incorrecto o una ventana de tiempo es demasiado larga. source_ip_undeclared significa que tu app tiene en la Console una lista de IP permitidas sin la dirección de AnythingMCP.

El conector no organiza envíos, no cancela pedidos, no gestiona devoluciones ni reembolsos, no responde a compradores ni chats, no crea descuentos ni anuncios y no sube publicaciones 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 Shopee Seller.

Herramientas disponibles

Ejemplos de prompts

• "¿Qué pedidos están pendientes de envío ahora mismo y con qué transportista sale cada uno?"
• "¿Cuánto gané de verdad con los pedidos de la semana pasada después de la comisión de Shopee, las tarifas y los cupones?"
• "¿Qué publicaciones se vendieron mejor este mes y cuáles están a punto de agotarse?"
• "Enséñame las solicitudes de devolución abiertas con el motivo y el importe de reembolso."
• "¿Cómo fueron mis Shopee Ads en los últimos 14 días: gasto, pedidos y ROAS por día?"

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