MerchantFlow

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

Aprenda o que é MCP, por que você iria querer usá-lo e como conectar o MerchantFlow a qualquer assistente de IA para que você possa fazer perguntas sobre sua loja em linguagem natural.

O que é MCP?

MCP (Model Context Protocol) é um padrão aberto que permite que assistentes de IA como Claude, ChatGPT, Cursor e Windsurf leiam dados de serviços de terceiros com segurança. Quando você conecta o MerchantFlow via MCP, seu assistente de IA pode responder perguntas sobre sua loja usando dados reais da sua conta — seu P&L, margens de produtos, gastos com anúncios, coortes e valuation do negócio — sem que você precise copiar e colar números de dashboards.

Por que você iria querer isso

A maioria dos lojistas gasta 30+ minutos por semana navegando por dashboards para responder perguntas como "Qual é o meu MER combinado?" ou "Quais produtos estão me dando prejuízo após os gastos com anúncios?" O MCP permite que você faça essas perguntas em linguagem natural e obtenha uma resposta direta e baseada em dados na sua ferramenta de IA favorita.

Exemplos reais dos nossos usuários beta:

• "Resuma o P&L desta semana com comparação com a semana passada." — briefing semanal completo em 15 segundos.
• "Estou pensando em lançar um produto a $49 com COGS de $12 e $8 de gasto com anúncios por unidade. É viável?" — verificação de viabilidade com ROAS de ponto de equilíbrio e um veredito verde/âmbar/vermelho.
• "Execute minha avaliação de negócio e me diga o que está reduzindo o múltiplo." — avaliação SDE completa mais scorecard.

O que ele pode fazer

O MerchantFlow atualmente expõe:

• 64 ferramentas somente leitura nas categorias financeira, produto, anúncios, cliente, monitoramento, valuation, Markets, inventário, pedidos, auditoria de loja, marketing, relatórios, COGS, impostos e busca. Quatro dependem de atribuição por canal, que está desativada por padrão, então uma conexão típica lista 60.
• 6 prompts guiados para fluxos de trabalho comuns, como briefings semanais, auditorias de vazamento de lucro, verificações de lançamento de produto, fechamento de fim de mês, varreduras de crescimento e revisões de prontidão para saída.
• 4 recursos somente leitura que ajudam clientes compatíveis a se orientarem sobre sua loja, integrações, definições de North Star e o catálogo de ferramentas.
• Um funil de lucro e perda interativo que é renderizado dentro do chat, em clientes que suportam MCP Apps (Claude web e desktop, ChatGPT, VS Code, Cursor). Outros clientes recebem os mesmos números como texto.

Um cliente de IA conectado pode:

• Ler seu P&L completo com comparações
• Classificar produtos por receita, lucro, margem ou unidades
• Simular a viabilidade de novos produtos
• Reportar desempenho de anúncios e MER combinado em Meta, Google, Snapchat e TikTok
• Detalhar o lucro por país com as ferramentas de Markets
• Analisar coortes, LTV e payback de CAC
• Auditar inventário, velocidade de estoque, estoque morto e lacunas em múltiplas localizações
• Consultar pedidos, atrasos de fulfillment e pedidos de alto risco
• Auditar seu catálogo em busca de problemas de imagem, SEO, coleções, redirecionamentos e páginas
• Extrair listas de marketing de carrinho abandonado, recuperação de clientes e níveis de clientes
• Listar e gerar qualquer relatório salvo ou de modelo
• Ler entradas de COGS, histórico de custos e cobertura
• Executar a mesma avaliação de negócio que o dashboard
• Sinalizar anomalias e problemas de saúde da sincronização
• Listar clientes por valor de vida útil e abrir o histórico completo de um cliente
• Reportar margem por código de desconto, para que você veja quais promoções se pagaram
• Mostrar exposição tributária por país em relação às suas regras de imposto configuradas

Todas as ferramentas são somente leitura — elas nunca alteram os dados da sua loja. Ferramentas de escrita (atualizar COGS, criar despesas, acionar sincronizações) estão planejadas para uma versão futura com fluxos explícitos de confirmação.

Algumas ferramentas só estão disponíveis quando o recurso correspondente está ativado para sua loja. As ferramentas de atribuição (get_attribution_breakdown, get_unattributed_revenue, run_sales_by_channel_report) ficam ocultas a menos que a atribuição por canal esteja ativada, então sempre confie na lista de ferramentas ao vivo que seu cliente mostra em vez de qualquer lista estática.

Privacidade e confiança

• Cada chamada de ferramenta é limitada à sua loja. Dados de outras lojas são inacessíveis mesmo que alguém adivinhe um ID.
• PII de clientes (e-mails, telefones, endereços) é ocultada por padrão nas respostas.
• Cada chamada é registrada em uma trilha de auditoria que você pode inspecionar.
• Você pode revogar qualquer cliente de IA conectado em Configurações > Desenvolvedor > MCP (/dashboard/settings/developer/mcp) a qualquer momento.
• Não há escopo de escrita, então nenhum cliente conectado pode alterar seus dados do MerchantFlow ou sua loja. Detalhes completos: Segurança e tratamento de dados do MCP.
• O acesso ao MCP está incluído em todos os planos pagos. Até onde você pode consultar depende do plano — veja abaixo.

Limites do plano

O MCP está incluído em todos os planos pagos. O que difere é até onde uma consulta pode alcançar e quantas chamadas você recebe.

Plano	Janela de histórico	Chamadas por hora	Chamadas por dia
Trial	Histórico completo	300	2.000
Starter	90 dias	300	2.000
Pro	365 dias	600	5.000
Plus	Histórico completo	1.200	10.000
Agency	Histórico completo	1.200	10.000 por loja, 25.000 em toda a carteira de clientes

Todo trial de 14 dias inclui acesso Plus completo, então os trials recebem histórico completo.

Solicitar um período que ultrapasse sua janela não é um erro. Você recebe todos os dias dentro da janela mais uma nota dizendo onde os dados param e qual plano cobriria o restante, para que a IA possa informar que respondeu com base em 90 dias em vez de reportar silenciosamente um número parcial como se fosse completo.

Peça ao seu cliente de IA para "listar os recursos do MerchantFlow" e ele reportará seu plano, sua janela exata de histórico e seu orçamento restante de chamadas.

Detalhes da conexão

• URL do servidor: https://merchantflow.ai/api/mcp
• Transporte: Streamable HTTP (JSON-RPC 2.0 sobre POST). Não há endpoint SSE — não acrescente /sse nem qualquer outro sufixo.
• Versão do protocolo: 2025-11-25, com compatibilidade retroativa para clientes mais antigos.
• Autenticação: um cabeçalho Authorization: Bearer, vindo de OAuth ou de um token de acesso pessoal.

Se o endpoint retornar um 404 simples

Além de exigir um plano pago, o endpoint MCP fica atrás de um interruptor de plataforma (mcp_server_enabled) controlado pelo MerchantFlow. Ele está ativado por padrão para todos os workspaces, mas enquanto estiver desativado — globalmente durante um incidente, ou para um workspace específico — https://merchantflow.ai/api/mcp responde 404 com corpo vazio em vez de um erro de autorização. Isso é intencional: mantém o servidor não detectável em vez de anunciar que ele existe mas está fechado para você.

Portanto, um 404 com uma credencial válida e dentro do prazo não é uma configuração incorreta do cliente. Confirme que sua assinatura está ativa e entre em contato com o suporte — tentar novamente, reconectar ou reemitir um token não mudará isso.

Duas formas de autenticar

• OAuth (padrão) — o fluxo padrão para Claude, ChatGPT, Claude Code, Cursor, Windsurf e VS Code em uma estação de trabalho. Clique em Permitir acesso no seu navegador quando o cliente conectar. Se você estiver desconectado do MerchantFlow nesse momento, faça login primeiro e volte automaticamente para a página de autorização.
• Tokens de acesso pessoal — tokens bearer de longa duração para ambientes headless (VMs, sessões SSH, runners de CI, contêineres de desenvolvimento) que não podem abrir um navegador. Escopados para leituras específicas, com expiração configurável e revogáveis em Configurações > Desenvolvedor > MCP (/dashboard/settings/developer/mcp).

Se você instalou o MerchantFlow pela Shopify App Store

Sua conta foi criada pela instalação e não tem senha web, então a página de login que abre durante o OAuth pode parecer um beco sem saída. Não é: escolha Continuar com Shopify, insira o domínio da sua loja (your-store.myshopify.com, ou apenas o handle da loja de admin.shopify.com/store/your-store) e aprove o login no Shopify. Você volta direto para a página de autorização.

Isso funciona enquanto o MerchantFlow estiver instalado nessa loja. Se você o desinstalou, abra o MerchantFlow pelo seu admin da Shopify para reconectar primeiro. Você também pode definir uma senha web se preferir fazer login dessa forma.

Próximos passos

• Conectar o Claude — configuração de 2 minutos no claude.ai e no Claude Desktop, a mais popular
• Conectar o ChatGPT — adicione o MerchantFlow pelo diretório de plugins do ChatGPT, sem precisar copiar URL de servidor
• Conectar o Claude Code — um comando no terminal (claude mcp add)
• Conectar o Cursor — para desenvolvedores-operadores
• Conectar o Windsurf — IDE alternativa
• Conectar o VS Code Copilot — se você vive no VS Code
• Tokens de acesso pessoal — configuração headless para VMs, SSH, CI e contêineres
• Referência de ferramentas — todas as 54 ferramentas com parâmetros e escopos, além dos prompts e recursos integrados
• 15 exemplos de prompts — prompts prontos para copiar e colar e testar agora
• Potencialize com o arquivo Skill — baixe o arquivo de skill de IA opcional para melhorar drasticamente a qualidade das respostas

---

Última atualização: 19 de setembro de 2026

[

Conectar Fulfilment Plus - MerchantFlow

Conecte o Fulfilment Plus, o 3PL de Auckland que roda no CartonCloud, ao MerchantFlow para puxar cobranças de pick and pack e frete por envio em cada pedido.

](https://docs.merchantflow.ai/docs/integrations/fulfilment-plus)[

Conectar MerchantFlow ao Claude

Guia passo a passo para conectar o MerchantFlow ao Claude via MCP, no claude.ai e no Claude Desktop. Leva cerca de 2 minutos.

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