Administrá tu tienda Tiendanube hablando con tu IA
Un servidor MCP (Model Context Protocol) gratuito y de código abierto para Tiendanube / Nuvemshop. Pedile a Claude, Codex, OpenCode o cualquier cliente MCP que revise el stock, actualice precios, consulte órdenes o cree cupones. Corre en tu computadora y usa la API oficial.
Instalalo en una línea
Pegá esto en tu agente de IA. Instala el servidor, te pide los pocos datos necesarios y verifica la conexión:
Instalá el servidor MCP de Tiendanube siguiendo https://raw.githubusercontent.com/fedeclavero/tiendanube-mcp/main/guides/AGENT_INSTALL.md — hablame en español.- 191herramientas
- 39recursos de la API
- 78herramientas de solo lectura
- MITlicencia libre
Funcionando en unos 5 minutos
Conseguí tus credenciales
Creá una aplicación a medida en tu panel de Tiendanube y copiá el ID de la tienda y el access token.
Dejá que tu agente lo instale
Pegá el prompt de una línea. Empezá en modo solo lectura: la IA mira pero no toca.
Pedí en lenguaje natural
“¿Qué órdenes pagas no se enviaron?” “Poné en 40 el stock del SKU REM-001-M.”
Decí la tarea, no los clics
“Listá los productos con stock menor a 5.”
Catálogo y stock“Aplicá 10 % de descuento a la categoría Verano.”
Precios en lote“¿Qué órdenes pagas siguen sin enviar?”
Órdenes y despachos“Creá el cupón BIENVENIDA15 hasta el 31/12.”
Cupones“¿Quién abandonó el carrito en los últimos 3 días?”
Checkouts abandonados“Suscribí mi backend a order/paid.”
WebhooksSeguro por diseño
Modo solo lectura
Un único ajuste elimina todas las herramientas de escritura. Empezá ahí.
Anotaciones honestas
Cada herramienta declara si es de lectura, destructiva o idempotente para que el cliente pida confirmación antes de borrar.
Mínimo privilegio
Un 403 indica el scope OAuth exacto que falta. Otorgá solo lo necesario.
Tus datos son tuyos
Las credenciales quedan en la configuración de tu cliente. Sin telemetría ni servidores de terceros.
Respeta el rate limit
Sigue las cabeceras de Tiendanube y reintenta los 429 una cantidad acotada de veces.
Código abierto
Licencia MIT. Leé cada línea antes de confiar.
Compatible con
Claude Code · Claude Desktop · OpenAI Codex · OpenCode · Gemini CLI · Cursor · VS Code (Copilot) · Windsurf · cualquier cliente MCP
Limitaciones, con honestidad
Algunos cuerpos de request (promociones, transacciones, disputas, billing, custom objects, reglas de negocio) son JSON libre; la IA debe consultar la referencia oficial. Los endpoints de proveedores de pago y transportistas son para apps de partners. Aún no está en npm: se instala desde GitHub.
Preguntas frecuentes
¿Qué es un servidor MCP de Tiendanube?
Es un programa pequeño que permite a un asistente de IA usar la API de Tiendanube como herramientas. Describís lo que querés y la IA elige las operaciones: listar productos, actualizar stock, crear cupones.
¿Funciona con Nuvemshop en Brasil?
Sí. Configurá TIENDANUBE_API_DOMAIN con https://api.nuvemshop.com.br.
¿Necesito saber programar?
No. Pegá el prompt de instalación en tu agente de IA y respondé sus preguntas. La guía de credenciales explica cómo obtener el ID de tienda y el access token.
¿Puede la IA borrar mis productos por error?
No en modo solo lectura. En modo lectura-escritura, las herramientas de borrado y cancelación están marcadas como destructivas para que los clientes bien diseñados pidan confirmación. Hacé un backup del catálogo antes de operaciones masivas.
¿Cuánto cuesta?
El servidor es gratis y con licencia MIT. Solo pagás el servicio de IA que ya uses. El acceso a la API de Tiendanube depende de tu plan.
¿Con qué herramientas de IA funciona?
Claude Code, Claude Desktop, OpenAI Codex, OpenCode, Gemini CLI, Cursor, VS Code con Copilot, Windsurf y cualquier cliente que soporte MCP por stdio o HTTP.