Creatividades, email e IA

Shopify MCP: consulta los datos de tu tienda en Claude y otras apps de IA

Un servidor MCP de Shopify permite que Claude y otras apps de IA consulten los datos de tu tienda. Mira cómo funcionan las herramientas de solo lectura de ROASaurus y cómo conectarlas.

·Actualizado el ·9 min de lectura·Por el equipo de ROASaurus

Ideas clave
  • 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.

Haces una preguntaEn Ask AI o en tu propio cliente MCP
El modelo elige una herramientaPor ejemplo campaign_profit para los últimos 30 días
ROASaurus ejecuta la herramientaSolo lectura, sobre los datos de una tienda
El modelo redacta la respuestaSolo a partir de las cifras devueltas
El modelo nunca lee tu base de datos directamente. Solo ve lo que devuelve una herramienta.

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.

24herramientas de solo lectura, las mismas en Ask AI y en MCP
6periodos fijos: hoy, ayer, 7, 14, 30 y 90 días
40preguntas de Ask AI por usuario y día, por defecto
1tienda por clave de API y por conexión

¿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.

PreguntaHerramientaQué muestra la respuesta
¿Cómo se comparan los últimos 7 días con los 7 días anteriores?profit_summaryIngresos, 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_profitPor 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_tableGasto, 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_insightsCohortes mensuales, mes de recuperación del CAC y LTV previsto
¿Qué productos traen de vuelta a más clientes recurrentes?productsProductos principales y la proporción de compradores primerizos que volvieron a pedir
¿Vamos bien para cumplir el objetivo de ingresos de este mes?goals_forecastObjetivos, resultados hasta ahora y previsión de fin de mes
¿Qué debería reponer esta semana?inventoryExistencias disponibles, ritmo de ventas, días de existencias restantes y estado de reposición
El modelo elige la herramienta. Tú solo tienes que hacer la pregunta.

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í:

ConceptoMeta, últimos 30 díasCómo se calcula
Ingresos atribuidos$24,000Ingresos de los pedidos atribuidos a los clics de Meta
Beneficio bruto (contribution en el resultado)$13,440Ingresos menos el coste de producto, el envío, las comisiones de pago y la preparación (56%)
Gasto publicitario$8,000Sincronizado desde la cuenta publicitaria de Meta
Beneficio tras los anuncios$5,440$13,440 − $8,000
ROAS3.00$24,000 ÷ $8,000
POAS1.68$13,440 ÷ $8,000
Tienda de ejemplo. Un POAS superior a 1.0 significa que los anuncios recuperaron más beneficio bruto del que costaron.

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.

  1. 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.

  2. 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.

  3. 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-Key de la misma tarjeta, cuya sección MCP muestra la cabecera completa.

  4. 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.

  5. Haz una pregunta de prueba

    Pregunta «¿Cuáles fueron mis ingresos de ayer?» y comprueba la cifra con tu dashboard.

Endpoint y un ejemplo para Claude Code
# 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 protocolo
tools/list · 24 tools · readOnlyHint: trueEl cliente descubre qué herramientas existen
tools/call · campaign_profit · period 30El modelo pide el beneficio de campañas de 30 días
result · isError: falseJSON con una fila por canal y campaña
401 · Invalid store key or API key.Lo que devuelve una clave incorrecta o regenerada
Cómo es una pregunta entre el cliente y el servidor MCP de ROASaurus.

¿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

  1. Model Context Protocol: What is the Model Context Protocol (MCP)?
  2. Model Context Protocol specification (2025-06-18): Tools
  3. Claude Code Docs: Connect Claude Code to tools via MCP
  4. Claude Docs: Authentication for connectors
  5. OpenAI: Building MCP servers for plugins and API integrations

En ROASaurus

Sigue leyendo

Creatividades, email e IAFatiga creativa en los anuncios de Facebook: cuándo sustituir un anuncioLa fatiga creativa en los anuncios de Facebook se nota en una frecuencia que sube y un CTR que baja. Aprende a medirla por anuncio, a leer el hook rate y el hold rate y a planificar una rutina de renovación.Creatividades, email e IAFlujos de carrito abandonado en Klaviyo: reconoce a más compradoresLos flujos de carrito abandonado y de navegación de Klaviyo solo llegan a los compradores que Klaviyo puede identificar. Descubre cómo los identifica y cómo reconocer a más en el checkout.TrackingBloqueadores de anuncios y tracking: lo que pierde tu tiendaLos bloqueadores de anuncios frenan los píxeles de tracking, así que las plataformas publicitarias se pierden compras. Descubre qué eventos se pierden, por qué los eventos server-side no y cómo medir tu brecha.
Preguntas frecuentes

Tus preguntas, resueltas

¿Qué es un servidor MCP de Shopify?

Es un servidor que usa el Model Context Protocol para ofrecer a las apps de IA herramientas para una tienda de Shopify. El servidor MCP de ROASaurus ofrece a un cliente de IA herramientas de solo lectura sobre el beneficio, la atribución, los anuncios, el valor del cliente, el inventario, los objetivos, los referentes y las alertas de una tienda.

¿Puede la IA cambiar mis campañas o mi tienda?

No por sí sola. Las herramientas de analítica de Ask AI y del servidor MCP solo leen. Ask AI, y un cliente MCP cuya clave tenga el permiso actions:write, pueden proponer un cambio en una campaña en la bandeja de entrada de Actions, y nada cambia hasta que un propietario o administrador lo aprueba. Ninguno de los dos puede editar tu tienda, tus costes ni tus ajustes.

¿Qué apps de IA pueden conectarse al servidor MCP de ROASaurus?

Claude, ChatGPT y otros clientes MCP compatibles con OAuth inician sesión con tu acceso a ROASaurus. Los clientes que te dejan definir una cabecera Authorization, como Claude Code, pueden usar una clave de API en su lugar.

¿Se envían datos de clientes a la IA?

Las herramientas devuelven métricas agregadas, no datos de contacto de clientes. Ask AI envía tu pregunta y estas métricas a Anthropic; con MCP, los resultados van al cliente de IA que conectes.

¿Por qué no puedo preguntar por un intervalo de fechas personalizado?

Las herramientas solo aceptan periodos fijos: hoy, ayer o los últimos 7, 14, 30 o 90 días en la zona horaria de la tienda. Las preguntas sobre valor del cliente y cohortes no usan periodo y utilizan tu historial de pedidos.

¿Cuentan las preguntas por MCP para el límite de 40 preguntas?

No. El límite diario se aplica a Ask AI en el dashboard. Con MCP, se aplican los límites de uso de tu propio cliente de IA.

Cada venta, rastreada hasta el anuncio que la generó

Server-side tracking, beneficio y valor de vida del cliente en una sola app. Prueba gratuita de 14 días, sin tarjeta de crédito.

Empieza tu prueba gratuita →