Resumen
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.
Configuración guiada
Conecta Loja Integrada a Meta Muse en 2 minutos
Empieza la prueba gratuita en AnythingMCP Cloud, conecta Loja Integrada con la configuración guiada y añade tu URL MCP a Meta Muse. Sin código y sin servidores que mantener.
Sin tarjeta de crédito · 7 días de prueba · Alternativa self-host disponible
Prueba a pedir
Prompts de ejemplo para Loja Integrada
Haz clic en un prompt para copiarlo. Pégalo en Claude, ChatGPT, Cursor, Gemini, Copilot u OpenClaw para ejecutarlo contra este conector.
Claude es IA y puede equivocarse. Verifica siempre las respuestas.
💡 ¿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 + Meta Muse
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.
- 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, sinchave_api. Las claves de API solo están disponibles en los planes de pago (ayuda de Loja Integrada). - 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. - Pon la clave de aplicación, un UUID como
dc6049f0-1234-..., enLOJA_INTEGRADA_APP_KEY. Pega solo la clave, sinaplicacao. - 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 Muse
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 muestraYOUR_SERVER_ID.
Muse añade los servidores MCP remotos como conectores personalizados e inicia sesión en ellos con OAuth.
- En Muse, abre Settings → Connectors y elige Add custom connector.
- Pega la URL del servidor MCP
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. - Muse abre la página de inicio de sesión de AnythingMCP: inicia sesión y aprueba el acceso.
- En un chat, pídele a Muse algo que necesite las herramientas de
Loja Integrada.
También puedes configurarlo desde un chat, en la web, en las apps de iOS y Android o en WhatsApp. Envía a Muse este mensaje:
Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth
¿Lo alojas tú mismo? Usa la dirección HTTPS pública de tu instancia en lugar de https://cloud.anythingmcp.com. Muse se conecta desde la nube de Meta, así que localhost no funciona.
Herramientas disponibles
| Tool | What it does |
|---|---|
loja_integrada_list_products | List the store's products, 20 per page: id, sku, nome, tipo (normal, atributo = parent with variations, atributo_opcao = variation), ativo… |
loja_integrada_get_product | Read one product by its Loja Integrada id (or by your id_externo): name, SKU, type, active and featured flags, categories, brand… |
loja_integrada_create_product | Create a product. tipo normal is a simple product; atributo creates a parent for variations, and each variation is then created with tipo… |
loja_integrada_update_product | Update a product |
loja_integrada_list_stock | List the stock records of all products, 20 per page: produto URI, quantidade (quantity), quantidade_reservada (reserved by orders)… |
loja_integrada_get_stock | Read the stock of one product or variation: quantity, reserved and available quantity, whether stock is managed, and the availability… |
loja_integrada_update_stock | Set the stock of one product or variation: quantidade (absolute quantity, not a delta), gerenciado (track stock) and the availability ids… |
loja_integrada_list_prices | List the prices of all products, 20 per page: produto URI, cheio (list price), promocional (sale price), custo (cost) and sob_consulta… |
loja_integrada_get_price | Read the prices of one product or variation: cheio (list price), promocional (sale price, null when none), custo (cost) and sob_consulta |
loja_integrada_update_price | Change the prices of one product or variation: cheio (list price), promocional (sale price; send 0 or null to remove it), custo (cost) and… |
loja_integrada_list_categories | List the store's categories: id, nome, descricao, categoria_pai (parent URI), id_externo, url and resource_uri |
loja_integrada_create_category | Create a category, optionally below a parent category |
loja_integrada_list_brands | List the store's brands: id, nome, apelido, descricao, id_externo and resource_uri |
loja_integrada_create_brand | Create a brand |
loja_integrada_list_grids | List the variation grids (grades, e.g |
loja_integrada_get_grid | Read one variation grid with its variations (values such as P, M, G or Azul), each with id and nome |
loja_integrada_search_orders | Search orders, 20 per page (at most 50): numero (order number), situacao (status with codigo and nome), cliente URI, valor_total… |
loja_integrada_get_order | Read one order by its number: customer, billing and delivery address, items (itens with SKU, quantity and prices), payments, shipments… |
loja_integrada_list_order_statuses | List the order statuses of the store: id, codigo (e.g. aguardando_pagamento, pedido_pago, pedido_enviado, pedido_entregue… |
loja_integrada_update_order_status | Move an order to another status by its codigo, for example pedido_pago, pedido_em_separacao, faturado, pedido_enviado… |
loja_integrada_get_order_status_history | Read the status history of one order: each change with its date, the new and previous status and who changed it (alterado_por_nome), by… |
loja_integrada_update_tracking_code | Set the tracking code of one shipment of an order |
loja_integrada_list_payment_methods | List the payment methods of the store: id, nome, codigo and configuracoes (ativo, disponivel) |
loja_integrada_list_customers | List customers, 20 per page: id, nome, email, cpf or cnpj, phone numbers, sexo, data_nascimento, group and dates |
loja_integrada_search_customers | Search customers by e-mail and/or a created or updated date window; date-filtered results come newest modification first |
loja_integrada_get_customer | Read one customer by id: name, e-mail, CPF or CNPJ, company name, phones, birth date, group and addresses (enderecos) |
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
¿Dónde está disponible Muse? Por ahora Meta ofrece Muse en Estados Unidos y Canadá, en la web, en las apps de iOS y Android y en WhatsApp.
¿Meta revisa este conector? No. Meta no revisa los conectores personalizados. Muse solo ve las herramientas que activaste para este servidor MCP en AnythingMCP, y puedes desconectarlo cuando quieras en Settings → Connectors.
Siguientes pasos
¿Te ha sido útil esta guía?