Configurá el MCP server de Tiendis

¿Qué es el MCP server de Tiendis?

Es un endpoint HTTP que expone, como herramientas MCP, las acciones de tu cuenta Tiendis: leer tu catálogo, actualizar productos, listar y modificar pedidos, gestionar promociones, configurar envíos, etc. Un asistente IA conectado puede entender tu pedido en lenguaje natural (“agregá una promo 2x1 para este viernes”) y ejecutarlo directamente contra tu negocio.

¿Cómo obtengo mi Personal Access Token?

1. Entrá a tu panel admin de Tiendis (tenés que estar logueado).
2. En el menú lateral, abrí Desarrolladores > MCP server.
3. Hacé clic en Crear nuevo token, elegí un nombre descriptivo, marcá los permisos que necesitás y una expiración.
4. Copiá el JWT que aparece en pantalla. Sólo se muestra una vez: si lo perdés, vas a tener que generar uno nuevo.

Configurar tu cliente MCP

El endpoint del MCP server es https://mcp.tiendis.app/mcp y usa transporte HTTP streamable. Pasá el token en el header Authorization como Bearer.

Claude Code (CLI)

Desde tu terminal, ejecutá:

claude mcp add tiendis --transport http \
  --header "Authorization: Bearer <TU_TOKEN>" \
  https://mcp.tiendis.app/mcp

Claude Desktop

Editá tu archivo claude_desktop_config.json (en macOS: ~/Library/Application Support/Claude/claude_desktop_config.json) y agregá esta entrada en mcpServers:

{
  "mcpServers": {
    "tiendis": {
      "transport": {
        "type": "http",
        "url": "https://mcp.tiendis.app/mcp",
        "headers": {
          "Authorization": "Bearer <TU_TOKEN>"
        }
      }
    }
  }
}

Cursor

En Cursor abrí Settings > MCP y agregá este servidor (o editá ~/.cursor/mcp.json):

{
  "mcpServers": {
    "tiendis": {
      "url": "https://mcp.tiendis.app/mcp",
      "headers": {
        "Authorization": "Bearer <TU_TOKEN>"
      }
    }
  }
}

ChatGPT Desktop / Codex

En el archivo de configuración de Codex agregá este bloque TOML:

[mcp_servers.tiendis]
url = "https://mcp.tiendis.app/mcp"
headers = { Authorization = "Bearer <TU_TOKEN>" }

¿Qué puede hacer el MCP server?

El servidor expone herramientas agrupadas por módulo. Los scopes del token determinan qué herramientas quedan disponibles para el agente.

Configuración del negocio (settings)

Leer y modificar datos generales del negocio: alias, nombre, horarios, contacto, branding y preferencias operativas.

Catálogo (catalog)

Listar y editar secciones, productos, modificadores y precios de la tienda.

Pedidos (orders)

Consultar pedidos entrantes, ver detalle, cambiar estados (aceptar, en camino, entregado, cancelado) y descargar estadísticas.

Promociones (promotions)

Crear, listar y editar promociones y cupones aplicables al catálogo.

Envíos (delivery)

Administrar zonas de cobertura, costos, métodos de envío y configuración de delivery.

Permisos (scopes)

Cada token lleva un set de scopes. Hay dos niveles: scopes umbrella que aplican a todos los módulos y scopes por módulo para limitar el acceso.

• tiendis.business.read — Lectura completa de todos los módulos.
• tiendis.business.write — Escritura completa de todos los módulos. Incluye lectura.
• tiendis.business.<modulo>.read — Lectura sólo del módulo indicado.
• tiendis.business.<modulo>.write — Escritura (y lectura) sólo del módulo indicado.

Los módulos válidos son: settings, catalog, orders, promotions y delivery.

Seguridad

• El JWT actúa con tu identidad y los permisos que le hayas asignado. Tratalo como una contraseña.
• Si sospechás que el token se filtró, revocalo desde el panel admin y generá uno nuevo.
• Configurá una expiración acorde al uso (idealmente 30 o 90 días para tokens de desarrollo).
• Usá scopes mínimos: si el agente sólo necesita leer pedidos, no le des escritura al catálogo.