MerchantFlow

npx add-mcp 'https://merchantflow.ai/api/mcp'

Aprende qué es MCP, por qué lo querrías y cómo conectar MerchantFlow a cualquier asistente de IA para que puedas hacer preguntas sobre tu tienda en lenguaje natural.

¿Qué es MCP?

MCP (Protocolo de Contexto de Modelo) es un estándar abierto que permite a asistentes de IA como Claude, ChatGPT, Cursor y Windsurf leer datos de forma segura desde servicios de terceros. Cuando conectas MerchantFlow vía MCP, tu asistente de IA puede responder preguntas sobre tu tienda usando datos reales de tu cuenta — tu P&L, márgenes de producto, gasto en anuncios, cohortes y valoración de negocio — sin que tengas que copiar y pegar números desde los paneles.

Por qué lo querrías

La mayoría de los comerciantes dedican más de 30 minutos a la semana navegando por paneles para responder preguntas como "¿Cuál es mi MER combinado?" o "¿Qué productos me están haciendo perder dinero después del gasto en anuncios?". MCP te permite hacer esas preguntas en lenguaje natural y obtener una respuesta directa y respaldada por datos en tu herramienta de IA favorita.

Ejemplos reales de nuestros usuarios beta:

• "Resume el P&L de esta semana comparándolo con la semana pasada." — informe semanal completo en 15 segundos.
• "Estoy pensando en lanzar un producto a $49 con $12 de COGS y $8 de gasto en anuncios por unidad. ¿Es viable?" — verificación de viabilidad con ROAS de punto de equilibrio y un veredicto verde/ámbar/rojo.
• "Ejecuta mi valoración de negocio y dime qué está reduciendo el múltiplo." — valoración SDE completa más un cuadro de mando.

Lo que puede hacer

MerchantFlow actualmente expone:

• 64 herramientas de solo lectura en las categorías financiera, de producto, anuncios, cliente, monitoreo, valoración, Mercados, inventario, pedidos, auditoría de tienda, marketing, informes, COGS, impuestos y búsqueda. Cuatro dependen de la atribución por canal, que está desactivada por defecto, por lo que una conexión típica lista 60.
• 6 indicaciones guiadas para flujos de trabajo comunes como informes semanales, auditorías de fugas de ganancias, verificaciones de lanzamiento de productos, cierres de mes, análisis de crecimiento y revisiones de preparación para la salida.
• 4 recursos de solo lectura que ayudan a los clientes compatibles a orientarse sobre tu tienda, integraciones, definiciones de North Star y el catálogo de herramientas.
• Un gráfico interactivo de cascada de pérdidas y ganancias que se renderiza dentro del chat, en clientes que admiten MCP Apps (Claude web y de escritorio, ChatGPT, VS Code, Cursor). Otros clientes reciben las mismas cifras como texto.

Un cliente de IA conectado puede:

• Leer tu P&L completo con comparaciones
• Clasificar productos por ingresos, ganancias, margen o unidades
• Simular la viabilidad de nuevos productos
• Reportar el rendimiento de anuncios y el MER combinado en Meta, Google, Snapchat y TikTok
• Desglosar ganancias por país con las herramientas de Mercados
• Analizar cohortes, LTV y recuperación de CAC
• Auditar inventario, velocidad de stock, stock muerto y brechas en múltiples ubicaciones
• Consultar pedidos, retrasos en el cumplimiento y pedidos de alto riesgo
• Auditar tu catálogo en busca de problemas de imágenes, SEO, colecciones, redirecciones y páginas
• Extraer listas de marketing de carritos abandonados, recuperación de clientes y niveles de clientes
• Listar y generar cualquier informe guardado o plantilla
• Leer entradas de COGS, historial de costos y cobertura
• Ejecutar la misma valoración de negocio que el panel
• Señalar anomalías y problemas de salud de sincronización
• Listar clientes por valor de vida y abrir el historial completo de un cliente
• Reportar margen por código de descuento, para que puedas ver qué promociones se pagaron por sí mismas
• Mostrar exposición fiscal por país frente a tus reglas fiscales configuradas

Todas las herramientas son de solo lectura — nunca cambian los datos de tu tienda. Las herramientas de escritura (actualizar COGS, crear gastos, activar sincronizaciones) están planificadas para una futura versión con flujos de confirmación explícitos.

Algunas herramientas solo están disponibles cuando la función correspondiente está habilitada para tu tienda. Las herramientas de atribución (get_attribution_breakdown, get_unattributed_revenue, run_sales_by_channel_report) están ocultas a menos que la atribución por canal esté activada, así que confía siempre en la lista de herramientas en vivo que muestra tu cliente por encima de cualquier lista estática.

Privacidad y confianza

• Cada llamada a herramienta está limitada a tu tienda. Los datos de otras tiendas son inaccesibles incluso si alguien adivina un ID.
• La PII del cliente (correos electrónicos, teléfonos, direcciones) está redactada por defecto en las respuestas.
• Cada llamada se registra en un rastro de auditoría que puedes inspeccionar.
• Puedes revocar cualquier cliente de IA conectado desde Configuración > Desarrollador > MCP (/dashboard/settings/developer/mcp) en cualquier momento.
• No hay alcance de escritura, por lo que ningún cliente conectado puede cambiar tus datos de MerchantFlow o tu tienda. Detalle completo: Seguridad y manejo de datos de MCP.
• El acceso a MCP está incluido en todos los planes de pago. Hasta dónde puedes consultar depende del plan — ver más abajo.

Límites del plan

MCP está incluido en todos los planes de pago. Lo que difiere es hasta dónde puede llegar una consulta y cuántas llamadas obtienes.

Plan	Ventana de historial	Llamadas por hora	Llamadas por día
Prueba	Historial completo	300	2,000
Starter	90 días	300	2,000
Pro	365 días	600	5,000
Plus	Historial completo	1,200	10,000
Agencia	Historial completo	1,200	10,000 por tienda, 25,000 en toda la cartera de clientes

Cada prueba de 14 días incluye acceso completo a Plus, por lo que las pruebas obtienen historial completo.

Solicitar un período que supere tu ventana no es un error. Obtienes cada día dentro de la ventana más una nota que indica dónde se detienen los datos y qué plan cubriría el resto, para que la IA pueda decirte que respondió con 90 días en lugar de reportar silenciosamente una cifra parcial como si fuera completa.

Pídele a tu cliente de IA que "liste las capacidades de MerchantFlow" y reportará tu plan, tu ventana de historial exacta y tu presupuesto de llamadas restante.

Detalles de conexión

• URL del servidor: https://merchantflow.ai/api/mcp
• Transporte: HTTP Streamable (JSON-RPC 2.0 sobre POST). No hay endpoint SSE — no agregues /sse ni ningún otro sufijo.
• Versión del protocolo: 2025-11-25, con compatibilidad hacia atrás para clientes más antiguos.
• Autenticación: un encabezado Authorization: Bearer, ya sea de OAuth o de un token de acceso personal.

Si el endpoint devuelve un 404 simple

Además de necesitar un plan de pago, el endpoint MCP está detrás de un interruptor de plataforma (mcp_server_enabled) que MerchantFlow controla. Está activado por defecto para cada espacio de trabajo, pero mientras esté desactivado — globalmente durante un incidente, o para un espacio de trabajo específico — https://merchantflow.ai/api/mcp responde 404 con cuerpo vacío en lugar de un error de autorización. Esto es deliberado: mantiene el servidor no descubrible en lugar de anunciar que existe pero está cerrado para ti.

Así que un 404 con una credencial válida y vigente no es una mala configuración del cliente. Confirma que tu suscripción está activa y luego contacta al soporte — reintentar, reconectar o reemitir un token no cambiará nada.

Dos formas de autenticarse

• OAuth (por defecto) — el flujo estándar para Claude, ChatGPT, Claude Code, Cursor, Windsurf y VS Code en una estación de trabajo. Haz clic en Permitir acceso en tu navegador cuando el cliente se conecte. Si no has iniciado sesión en MerchantFlow en ese momento, primero inicias sesión y vuelves a la página de autorización automáticamente.
• Tokens de acceso personal — tokens portadores de larga duración para entornos sin interfaz gráfica (VMs, sesiones SSH, runners de CI, contenedores de desarrollo) que no pueden abrir un navegador. Limitados a lecturas específicas, con expiración configurable y revocables desde Configuración > Desarrollador > MCP (/dashboard/settings/developer/mcp).

Si instalaste MerchantFlow desde la App Store de Shopify

Tu cuenta fue creada por la instalación y no tiene contraseña web, por lo que la página de inicio de sesión que se abre durante OAuth puede parecer un callejón sin salida. No lo es: elige Continuar con Shopify, ingresa el dominio de tu tienda (your-store.myshopify.com, o solo el identificador de la tienda desde admin.shopify.com/store/your-store) y aprueba el inicio de sesión en Shopify. Aterrizas de vuelta en la página de autorización.

Esto funciona mientras MerchantFlow esté instalado en esa tienda. Si lo has desinstalado, abre MerchantFlow desde tu administrador de Shopify para reconectarte primero. También puedes establecer una contraseña web si prefieres iniciar sesión de esa manera.

Próximos pasos

• Conectar Claude — configuración de 2 minutos en claude.ai y Claude Desktop, la más popular
• Conectar ChatGPT — agrega MerchantFlow desde el directorio de plugins de ChatGPT, sin URL de servidor que copiar
• Conectar Claude Code — un comando en la terminal (claude mcp add)
• Conectar Cursor — para operadores desarrolladores
• Conectar Windsurf — IDE alternativo
• Conectar VS Code Copilot — si vives en VS Code
• Tokens de acceso personal — configuración sin interfaz gráfica para VMs, SSH, CI y contenedores
• Referencia de herramientas — las 54 herramientas con parámetros y alcances, más las indicaciones y recursos integrados
• 15 ejemplos de indicaciones — indicaciones de copiar y pegar para probar ahora mismo
• Potencia con el archivo Skill — descarga el archivo Skill de IA opcional para mejorar drásticamente la calidad de las respuestas

---

Última actualización: 19 de septiembre de 2026

[

Conectar Supply Chain Fusion - MerchantFlow

Conecta Supply Chain Fusion a MerchantFlow para extraer los cargos de flete SCF en cada pedido enviado, con una conexión por mercado como Australia y Estados Unidos.

](https://docs.merchantflow.ai/docs/integrations/supply-chain-fusion)[

Conectar MerchantFlow a Claude

Guía paso a paso para conectar MerchantFlow a Claude vía MCP, en claude.ai y Claude Desktop. Tarda unos 2 minutos.

](https://docs.merchantflow.ai/docs/integrations/mcp/claude-desktop)