Cómo conectar Tiendanube / Nuvemshop a Gemini — via MCP

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

Tiendanube / Nuvemshop + Gemini

Tiendas online de Tiendanube (Nuvemshop en Brasil): datos de la tienda, productos, variantes y stock, categorías, pedidos y órdenes de envío, clientes, carritos abandonados, cupones y webhooks. REST API 2025-03 con un access token de app.

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:

TIENDANUBE_STORE_ID, TIENDANUBE_ACCESS_TOKEN

Paso 1 — Obtener credenciales

Tiendanube (Nuvemshop en Brasil) no tiene claves de API en el panel de la tienda: el acceso pasa por una app. Para conectar tu propia tienda, crea una app una vez e instálala en la tienda.

1. Regístrate en el portal de Partners de Tiendanube o Nuvemshop y crea una app en Apps. Elige los scopes que necesita la IA, por ejemplo read_products, write_products, read_orders, write_orders, read_customers, read_coupons. Un scope de escritura incluye el de lectura.
2. Instala la app en tu tienda abriendo https://www.tiendanube.com/apps/APP_ID/authorize. Se te redirige a la URL de redirección de la app con un code válido durante 5 minutos.
3. Canjea el código con POST https://www.tiendanube.com/apps/authorize/token, enviando client_id, client_secret, grant_type=authorization_code y code. Pon access_token en TIENDANUBE_ACCESS_TOKEN (solo el token, sin "bearer") y user_id en TIENDANUBE_STORE_ID.
4. Llama primero a tiendanube_get_store para comprobar la conexión: devuelve el nombre de la tienda, los idiomas, la moneda y el plan.

El token no caduca. Deja de funcionar cuando se desinstala la app o se emite un token nuevo para la misma app. Un 403 significa que a la app le falta un scope: añádelo en el portal de Partners y reinstala la app. Un 402 significa que el acceso a la API de la tienda está suspendido por una suscripción impaga.

Límites: un cubo de 40 solicitudes que se vacía a 2 por segundo, por tienda y app (10 veces más en los planes Next y Evolution). Las consultas de pedidos se detienen en 10.000 resultados, así que acótalas por fecha o estado. Los nombres y descripciones de productos son objetos por idioma, y el stock y el precio están en la variante. tiendanube_cancel_order repone el stock y envía un e-mail al cliente, salvo que lo desactives.

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 Tiendanube / Nuvemshop.

Herramientas disponibles

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