- MCP (Model Context Protocol) es un estándar abierto que permite a las apps de IA llamar a herramientas de otros servicios, de modo que un asistente pueda responder con los datos reales de tu tienda.
- Ask AI de ROASaurus y el servidor MCP de ROASaurus comparten 24 herramientas de solo lectura, desde el beneficio, la atribución y el valor del cliente hasta los costes, los leads, las suscripciones, el modelo de marketing mix y las anomalías.
- Una app de IA se conecta iniciando sesión en ROASaurus con OAuth, o con una clave de API en una cabecera Authorization.
- Una clave con nombre que solo tenga el permiso mcp solo puede leer; la clave de Orders API también puede enviar pedidos, así que mantén en secreto cualquier clave y revócala si se filtra.
- Los periodos son fijos (hoy, ayer o los últimos 7, 14, 30 o 90 días), y Ask AI permite 40 preguntas por usuario y día por defecto.
Un servidor MCP de Shopify conecta los datos de tu tienda con un asistente de IA a través del Model Context Protocol (MCP). Haces una pregunta en lenguaje natural, como «¿Qué campaña generó más beneficio el mes pasado?», y el asistente responde con las cifras reales de tu tienda en lugar de hacerlo de memoria. ROASaurus ejecuta un servidor MCP con 24 herramientas de analítica de solo lectura, y las mismas herramientas impulsan Ask AI dentro del dashboard.
Esta guía explica qué es MCP, por qué conviene hacer así las preguntas de analítica, cómo funcionan Ask AI y el servidor MCP, cómo conectar un cliente, qué preguntas funcionan bien, y la privacidad, la seguridad y los límites que debes conocer.
¿Qué es MCP?
MCP es un estándar de código abierto para conectar aplicaciones de IA con sistemas externos. Una app de IA como Claude es el cliente. Un servicio que ofrece datos o acciones es el servidor. El servidor describe sus herramientas: cada herramienta tiene un nombre, una descripción y un esquema para sus entradas.
Cuando haces una pregunta, el cliente pregunta al servidor qué herramientas existen (tools/list). El modelo elige la herramienta adecuada y el cliente la llama (tools/call). El resultado vuelve al modelo, que redacta la respuesta. No tienes que conocer los nombres de las herramientas. Solo haces la pregunta.
Shopify también ofrece servidores MCP. Se centran en los agentes de compra y en los desarrolladores: búsqueda de productos, carritos, checkout, cuentas de cliente y documentación para desarrolladores. Un servidor MCP de analítica responde a otro tipo de preguntas: beneficio tras los anuncios, atribución y valor del cliente, calculados a partir de tus pedidos, tus costes y el gasto de tus cuentas publicitarias.
¿Por qué consultar los datos de tu tienda en un asistente de IA?
La mayoría de las preguntas sobre una tienda necesitan cifras de varios informes. «¿Ganó dinero Meta el mes pasado?» necesita ingresos, costes de producto, envío, comisiones y gasto publicitario en un mismo sitio. En un dashboard abres el informe adecuado, fijas las fechas y haces las cuentas. En un asistente de IA conectado a tus datos, haces la pregunta y recibes la respuesta con las cifras que la respaldan.
- Lenguaje natural. Sin filtros, generadores de informes ni fórmulas de hoja de cálculo.
- Preguntas de seguimiento. Pregunta «¿y para TikTok?» o «¿qué campaña lo causó?» sin empezar de nuevo.
- Varios informes en una sola respuesta. El beneficio, la atribución y el valor del cliente pueden combinarse en una misma respuesta.
- Tu propio idioma. Ask AI responde en el idioma en el que escribes.
- Junto al resto de tu trabajo. Con MCP, las cifras de la tienda están disponibles en la app de IA donde ya escribes informes o planes.
La respuesta solo es tan completa como los datos que hay detrás. Conecta primero el server-side tracking, tus cuentas publicitarias y tus costes de producto, para que las herramientas tengan pedidos, gasto y márgenes con los que trabajar.
¿Cómo funcionan Ask AI y el servidor MCP de ROASaurus?
Ask AI es una página de chat del dashboard de ROASaurus. Funciona con Claude, el modelo de Anthropic. El servidor MCP ofrece las mismas 24 herramientas al cliente de IA que elijas. En ambos casos, las herramientas leen tus informes de ROASaurus y devuelven las cifras en JSON. El modelo redacta la respuesta a partir de esos resultados.
Cada herramienta de analítica solo lee. Ninguna herramienta puede cambiar tu tienda, tus campañas, tus costes ni tus ajustes. El servidor MCP marca cada una de ellas como de solo lectura y le indica al cliente que responda solo a partir de los resultados de las herramientas. Una clave con el permiso actions:write también obtiene propose_action, que añade un cambio propuesto en los anuncios a la bandeja de entrada de Actions; nada cambia hasta que un propietario o administrador lo aprueba. Ask AI en el dashboard también la tiene.
En Ask AI, una pregunta puede usar hasta 8 rondas de llamadas a herramientas. Si una pregunta necesita más, el asistente te pide que seas más específico. Ask AI guarda tu conversación por usuario y tienda, y usa los últimos 12 mensajes como contexto para una pregunta de seguimiento. Puedes borrar la conversación en cualquier momento.
¿Qué preguntas puedes hacer?
Las buenas preguntas nombran una métrica y uno de los periodos admitidos. La tabla muestra preguntas de ejemplo, la herramienta que responde a cada una y en qué se basa la respuesta.
| Pregunta | Herramienta | Qué muestra la respuesta |
|---|---|---|
| ¿Cómo se comparan los últimos 7 días con los 7 días anteriores? | profit_summary | Ingresos, pedidos, gasto publicitario, MER, POAS y beneficio, frente al periodo anterior de igual duración |
| ¿Qué campaña tuvo el mejor POAS en los últimos 30 días? | campaign_profit | Por campaña: ingresos atribuidos, beneficio bruto, gasto publicitario, beneficio tras los anuncios, ROAS, POAS y CAC |
| ¿Qué anuncios tienen un CPM alto y pocas compras? | ads_table | Gasto, impresiones, clics, CTR y CPM junto a las compras registradas, el ROAS y el CPA |
| ¿Cuántos meses tarda una cohorte en recuperar su CAC? | ltv_insights | Cohortes mensuales, mes de recuperación del CAC y LTV previsto |
| ¿Qué productos traen de vuelta a más clientes recurrentes? | products | Productos principales y la proporción de compradores primerizos que volvieron a pedir |
| ¿Vamos bien para cumplir el objetivo de ingresos de este mes? | goals_forecast | Objetivos, resultados hasta ahora y previsión de fin de mes |
| ¿Qué debería reponer esta semana? | inventory | Existencias disponibles, ritmo de ventas, días de existencias restantes y estado de reposición |
Veamos un ejemplo práctico. Preguntas: «¿Ganó dinero Meta en los últimos 30 días?». El modelo llama a campaign_profit con el periodo fijado en 30 días y el modelo de último clic por defecto. En una tienda de ejemplo, la fila de Meta del resultado queda así:
| Concepto | Meta, últimos 30 días | Cómo se calcula |
|---|---|---|
| Ingresos atribuidos | $24,000 | Ingresos de los pedidos atribuidos a los clics de Meta |
| Beneficio bruto (contribution en el resultado) | $13,440 | Ingresos menos el coste de producto, el envío, las comisiones de pago y la preparación (56%) |
| Gasto publicitario | $8,000 | Sincronizado desde la cuenta publicitaria de Meta |
| Beneficio tras los anuncios | $5,440 | $13,440 − $8,000 |
| ROAS | 3.00 | $24,000 ÷ $8,000 |
| POAS | 1.68 | $13,440 ÷ $8,000 |
En Ask AI, la respuesta empieza con «Sí», después da el beneficio tras los anuncios y el POAS, y sugiere como máximo tres pasos siguientes. Si quieres otra perspectiva, haz una pregunta de seguimiento como «¿y con el modelo Total Impact?». Nuestras guías sobre el POAS y los modelos de atribución explican estas cifras con más detalle.
¿Cómo se conecta el servidor MCP de ROASaurus?
El servidor usa el transporte Streamable HTTP de MCP y devuelve respuestas JSON, sin server-sent events. Las apps de IA como Claude y ChatGPT inician sesión con OAuth: entras en ROASaurus, eliges una tienda y permites la conexión. Los clientes que te dejan definir una cabecera de solicitud, como Claude Code, pueden usar una clave de API en su lugar, como en los pasos de abajo.
- Crea una clave de API
Abre Store settings › API & data en ROASaurus y crea una clave con nombre con el permiso
mcp. Cópiala: solo se muestra una vez. Solo los propietarios y administradores pueden crear claves. - O reutiliza la clave de Orders API
También puedes usar la clave de la tarjeta Orders API, por ejemplo la que usa el plugin de WooCommerce. Esa clave también puede enviar pedidos. Regenerate API key la sustituye y desconecta todo lo que use la anterior.
- Anota la clave de la tienda
Una clave con nombre va sola en la cabecera. Con la clave de Orders API, añade la clave de la tienda: el valor
X-Roasaurus-Keyde la misma tarjeta, cuya sección MCP muestra la cabecera completa. - Añade el servidor a tu cliente MCP
Introduce el endpoint y la cabecera Authorization que se muestran abajo. El cliente debe admitir Streamable HTTP y cabeceras de solicitud personalizadas.
- Haz una pregunta de prueba
Pregunta «¿Cuáles fueron mis ingresos de ayer?» y comprueba la cifra con tu dashboard.
# Endpoint POST https://app.roasaurus.com/mcp Authorization: Bearer <named key with the mcp scope> # or, with the Orders API key Authorization: Bearer <store key>:<API key> # Claude Code claude mcp add --transport http roasaurus https://app.roasaurus.com/mcp \ --header "Authorization: Bearer <named key with the mcp scope>"
También puedes enviar la clave de la tienda en una cabecera X-Roasaurus-Key y solo la clave de API como bearer token. En Claude Code, mantén el ámbito local por defecto. Un servidor con ámbito de proyecto se guarda en un archivo .mcp.json que se comparte mediante el control de versiones, y eso compartiría tu clave.
Para iniciar sesión en su lugar, añade https://app.roasaurus.com/mcp como conector personalizado en Claude o ChatGPT e inicia sesión cuando la app lo pida. Solo los propietarios y administradores pueden permitir una conexión. Store settings › API & data muestra cada app conectada, donde puedes desconectarla, y una conexión también termina cuando esa persona deja el espacio de trabajo.
initialize · 2025-06-18El cliente y el servidor acuerdan la versión del protocolotools/list · 24 tools · readOnlyHint: trueEl cliente descubre qué herramientas existentools/call · campaign_profit · period 30El modelo pide el beneficio de campañas de 30 díasresult · isError: falseJSON con una fila por canal y campaña401 · Invalid store key or API key.Lo que devuelve una clave incorrecta o regenerada¿Es seguro? Privacidad y seguridad
Como las herramientas de analítica solo leen, una app de IA no puede pausar una campaña, editar un coste ni cambiar un ajuste a través de ROASaurus; con actions:write solo puede proponer un cambio en los anuncios para que lo apruebe un propietario o administrador. Además, las herramientas solo aceptan entradas fijas, como un periodo o un modelo de atribución de una lista. Aun así, hay algunos puntos a tener en cuenta.
- Adónde van los datos. Ask AI envía tu pregunta y las métricas agregadas de la tienda a Anthropic, que ejecuta Claude. No envía datos de contacto de tus clientes. Con MCP, los resultados de las herramientas van al cliente de IA que conectes, según las condiciones de ese cliente. Revisa sus ajustes de conservación de datos y de entrenamiento.
- Lo que devuelven las herramientas. Totales por periodo, canal, campaña, anuncio, producto, cohorte y segmento. No devuelven nombres de clientes, direcciones de email ni números de teléfono.
- Quién puede preguntar. Cualquiera con acceso a la app de IA en la que añadas la conexión puede consultar la tienda. Añádela a tu propia cuenta, no a una compartida.
- Otros conectores. La especificación de MCP dice que siempre debería haber una persona en el circuito que pueda rechazar las llamadas a herramientas, y que los clientes deben tratar las anotaciones de las herramientas como no fiables salvo que el servidor sea de confianza. Si tu app de IA también tiene herramientas que envían emails o publican mensajes, mantén activadas las confirmaciones para esas herramientas.
¿Cuáles son los límites?
- Periodos fijos. Hoy, ayer o los últimos 7, 14, 30 o 90 días, en la zona horaria de la tienda. No se admite un intervalo personalizado, como una semana de marzo. Las herramientas de valor del cliente y de cohortes no usan periodo: trabajan con tu historial de pedidos, con hasta 12 cohortes mensuales.
- Una ventana de 7 días para la tabla de anuncios. La herramienta de anuncios usa una ventana de atribución de 7 días, sea cual sea la ventana que hayas definido en Store settings. Las herramientas de atribución y de beneficio por campaña, como los informes de atribución del dashboard, usan tu propio ajuste o la ventana que pidas.
- Listas abreviadas. Las listas de campañas devuelven como máximo 25 campañas, la tabla de anuncios las 30 filas con más gasto, y la lista de productos los 25 productos principales.
- Una tienda por conexión. Para varias tiendas, crea una clave y una conexión para cada una.
- El límite de preguntas de Ask AI. Cada usuario puede hacer 40 preguntas al día por defecto, contadas en las últimas 24 horas. Con MCP, se aplican en su lugar los límites de uso del propio cliente de IA.
- Las respuestas pueden ser erróneas. El modelo puede interpretar mal un resultado. Comprueba las cifras importantes en los informes antes de actuar, por ejemplo en la analítica de beneficios.
Fuentes
- Model Context Protocol: What is the Model Context Protocol (MCP)?
- Model Context Protocol specification (2025-06-18): Tools
- Claude Code Docs: Connect Claude Code to tools via MCP
- Claude Docs: Authentication for connectors
- OpenAI: Building MCP servers for plugins and API integrations