Conectar Loja Integrada MCP con Cursor

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

Loja Integrada + Cursor

Gestiona una tienda de Loja Integrada desde tu IA: busca productos, actualiza stock y precios, crea productos, categorías y marcas, sigue los pedidos, cambia su estado, añade códigos de seguimiento y consulta clientes. API v1 oficial.

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:

LOJA_INTEGRADA_API_KEY, LOJA_INTEGRADA_APP_KEY

Paso 1 — Obtener credenciales

La configuración lleva unos 5 minutos una vez que tienes las dos claves, pero la clave de aplicación tarda de 5 a 10 días hábiles en llegar. Necesitas una tienda de Loja Integrada con un plan de pago, acceso a su panel y una clave de aplicación (chave de aplicação) que Loja Integrada emite para la integración.

1. En el panel de la tienda abre Configurações → Chave para API, pulsa Cadastrar nova chave y copia la clave de 20 caracteres en LOJA_INTEGRADA_API_KEY. Pega solo la clave, sin chave_api. Las claves de API solo están disponibles en los planes de pago (ayuda de Loja Integrada).
2. Solicita la clave de aplicación (chave de aplicação) a Loja Integrada con el formulario para integradores que describe este artículo de ayuda. En el formulario, indica las direcciones IP desde las que se llamará a la API: en una instalación self-hosted, la dirección de tu servidor; en AnythingMCP Cloud, la dirección IPv4 fija 104.248.242.235, desde la que Cloud hace todas las llamadas. La página de configuración del conector también muestra las direcciones de salida. Loja Integrada responde en un plazo de 5 a 10 días hábiles.
3. Pon la clave de aplicación, un UUID como dc6049f0-1234-..., en LOJA_INTEGRADA_APP_KEY. Pega solo la clave, sin aplicacao.
4. Instala el conector y comprueba la conexión con loja_integrada_list_order_statuses.

La clave de aplicación solo funciona desde sus direcciones IP: Loja Integrada rechaza las llamadas desde cualquier dirección que no esté registrada con la clave. Si la dirección cambia (un servidor nuevo, el paso a Cloud o desde Cloud), envía la nueva lista con el mismo formulario antes del cambio, para que las llamadas no empiecen a fallar.

Cloud y self-hosted funcionan igual: solo cambia la dirección IP que registras con la clave de aplicación.

Las dos claves van en una sola cabecera: cada llamada envía Authorization: chave_api <API key> aplicacao <application key>; AnythingMCP la compone con las dos variables. Este conector no usa el inicio de sesión con Personal Token (Authorization: Basic ...).

Límite de peticiones: Loja Integrada permite 100 peticiones por minuto y tienda, y por encima responde 429. Pide las listas página a página en lugar de repetir llamadas; tras un 429, espera un minuto.

Ids y referencias: productos, categorías, marcas y clientes tienen ids numéricos (202591789); los pedidos se identifican por su número (numero, por ejemplo 164). Los registros se enlazan con URIs como /api/v1/categoria/15246059 (el campo resource_uri), que se pasan tal cual en categorias, marca y pai de un producto. Con id_externo en 1, un producto o un precio se busca por tu propio id externo.

Paginación, precios y fechas: las listas devuelven 20 elementos por página por defecto, como máximo 50, y se paginan con limit y offset hasta que meta.next es null; meta.total_count es el total. Los precios están en BRL y llegan como cadenas del tipo "32.83". Los filtros de fecha aceptan YYYY-MM-DD, con hora opcional.

Productos, variaciones, stock y precios: un producto con variaciones es un producto padre (tipo atributo) con un hijo por variación (tipo atributo_opcao, con pai apuntando al padre); loja_integrada_list_grids y loja_integrada_get_grid muestran los valores de las grillas de variaciones, como tallas y colores. El precio y el stock son registros aparte, que se fijan después de crear el producto. El stock es una cantidad absoluta, no una diferencia, y se fija en cada variación. Una actualización sustituye el producto entero, así que la IA lo lee primero y vuelve a enviar todos los campos: los campos que falten pueden quedar vacíos.

Errores frecuentes: 401 significa que Loja Integrada rechazó las claves: revisa LOJA_INTEGRADA_API_KEY, LOJA_INTEGRADA_APP_KEY y que la clave de aplicación esté registrada para la dirección IP del conector. 403 significa que las claves se leyeron pero se denegó el acceso: la llamada salió de una dirección no registrada con la clave de aplicación. 429 es el límite de peticiones.

Qué lee: productos con SKU, tipo (simple, padre con variaciones o variación), categorías, marca, medidas y peso, NCM y GTIN, imágenes y grillas de variaciones; stock con cantidad reservada y disponible; precios de lista, promocional y de coste; categorías, marcas y grillas de variaciones con sus valores; pedidos con cliente, dirección de facturación y de entrega, líneas, pagos, envíos con código de seguimiento, estado y totales, además del historial de estados de cada pedido y los estados de pedido y medios de pago de la tienda; clientes con correo, CPF o CNPJ, teléfonos y direcciones.

Las herramientas de escritura están activadas al instalar: ninguna herramienta está desactivada. El conector crea productos, categorías y marcas, edita productos, fija stock y precios, cambia el estado de los pedidos y añade códigos de seguimiento, todo en tu tienda real; un cambio de estado puede enviar un correo al comprador y un estado final como cancelado es definitivo. Desactiva en la página del conector las que no necesites; la IA te pide confirmación antes de cada cambio.

No se borra nada: ninguna herramienta borra datos ni crea pedidos, y el conector no gestiona imágenes de productos, cupones, SEO, webhooks, facturas (NF), marketing ni etiquetas de envío de Enviali.

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 Cursor

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.

Cursor lee los servidores MCP de ~/.cursor/mcp.json. Añade esta entrada:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "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 Cursor.
3. Abre Cursor → Settings → MCP y comprueba que anythingmcp aparece en la lista y está conectado.
4. Empieza a chatear: el agente ya puede usar las herramientas de Loja Integrada.

Herramientas disponibles

Ejemplos de prompts

• "¿Cuántas unidades del SKU CAM-001 hay disponibles y cuáles son su precio de lista y su precio promocional?"
• "Muéstrame los pedidos de esta semana que siguen esperando el pago."
• "Pon el precio promocional del SKU CAM-001 en R$ 89,90 y su stock en 40 unidades."
• "Marca el pedido 164 como enviado y añade el código de seguimiento AA123456789BR."
• "Busca a la clienta con el correo [email protected] y lista sus pedidos."

FAQ

¿Cursor admite servidores MCP personalizados en el plan gratuito? Sí, MCP está disponible en los planes Hobby, Pro y Business.

Siguientes pasos

• Página del conector
• Conectar a Claude