O que é um servidor MCP do Shopify?

É um servidor que usa o Model Context Protocol para dar a apps de IA ferramentas para uma loja no Shopify. O servidor MCP do ROASaurus dá a um cliente de IA ferramentas somente de leitura sobre lucro, atribuição, anúncios, valor do cliente, estoque, metas, benchmarks e alertas de uma loja.

A IA pode alterar as minhas campanhas ou a minha loja?

Não por conta própria. As ferramentas de análise do Ask AI e do servidor MCP apenas leem. O Ask AI e um cliente MCP cuja chave tenha o escopo actions:write podem propor uma mudança em uma campanha na caixa de entrada Actions, e nada muda até que um proprietário ou administrador a aprove. Nenhum dos dois pode editar a sua loja, os seus custos ou as suas configurações.

Quais apps de IA podem se conectar ao servidor MCP do ROASaurus?

Claude, ChatGPT e outros clientes MCP compatíveis com OAuth entram com seu login do ROASaurus. Clientes que permitem definir um cabeçalho Authorization, como o Claude Code, podem usar uma chave de API em vez disso.

Os dados dos clientes são enviados à IA?

As ferramentas retornam métricas agregadas, não dados de contato de clientes. O Ask AI envia a sua pergunta e essas métricas à Anthropic; pelo MCP, os resultados vão para o cliente de IA que você conectar.

Por que não posso perguntar sobre um intervalo de datas personalizado?

As ferramentas aceitam apenas períodos fixos: hoje, ontem ou os últimos 7, 14, 30 ou 90 dias no fuso horário da loja. As perguntas sobre valor do cliente e coortes não recebem período e usam o seu histórico de pedidos.

As perguntas pelo MCP contam para o limite de 40 perguntas?

Não. O limite diário vale para o Ask AI no dashboard. Pelo MCP, valem os limites de uso do seu próprio app cliente de IA.

Shopify MCP: pergunte sobre os dados da sua loja no Claude e em outros apps de IA

Principais conclusões

MCP (Model Context Protocol) é um padrão aberto que permite que apps de IA chamem ferramentas de outros serviços, para que um assistente possa responder com base nos dados reais da sua loja.
O Ask AI do ROASaurus e o servidor MCP do ROASaurus compartilham 24 ferramentas somente leitura, de lucro, atribuição e valor do cliente a custos, leads, assinaturas, o modelo de mix de marketing e anomalias.
Um app de IA se conecta entrando no ROASaurus com OAuth, ou com uma chave de API em um cabeçalho Authorization.
Uma chave nomeada só com o escopo mcp pode apenas ler; a chave da Orders API também pode enviar pedidos, então mantenha qualquer chave em segredo e revogue-a se ela vazar.
Os períodos são fixos (hoje, ontem ou os últimos 7, 14, 30 ou 90 dias), e o Ask AI permite 40 perguntas por usuário por dia por padrão.

Um servidor MCP do Shopify conecta os dados da sua loja a um assistente de IA por meio do Model Context Protocol (MCP). Você faz uma pergunta em linguagem natural, como “Qual campanha deu mais lucro no mês passado?”, e o assistente responde com os números reais da sua loja em vez de responder de memória. O ROASaurus mantém um servidor MCP com 24 ferramentas de análise somente leitura, e as mesmas ferramentas alimentam o Ask AI dentro do dashboard.

Este guia explica o que é o MCP, por que perguntar sobre análises dessa forma ajuda, como o Ask AI e o servidor MCP funcionam, como conectar um cliente, quais perguntas funcionam bem e a privacidade, a segurança e os limites que você deve conhecer.

O que é MCP?

O MCP é um padrão de código aberto para conectar aplicações de IA a sistemas externos. Um app de IA como o Claude é o cliente. Um serviço que oferece dados ou ações é o servidor. O servidor descreve as suas ferramentas: cada ferramenta tem um nome, uma descrição e um esquema para as suas entradas.

Quando você faz uma pergunta, o cliente pergunta ao servidor quais ferramentas existem (tools/list). O modelo escolhe a ferramenta que serve e o cliente a chama (tools/call). O resultado volta ao modelo, que escreve a resposta. Você não precisa saber os nomes das ferramentas. Basta fazer a pergunta.

O Shopify também mantém servidores MCP. Eles se concentram em agentes de compras e desenvolvedores: busca de produtos, carrinhos, checkout, contas de clientes e documentação para desenvolvedores. Um servidor MCP de análise responde a outro tipo de pergunta: lucro após anúncios, atribuição e valor do cliente, calculados a partir dos seus pedidos, dos seus custos e do investimento nas suas contas de anúncios.

Por que perguntar sobre os dados da sua loja a um assistente de IA?

A maioria das perguntas sobre a loja precisa de números de vários relatórios. "O Meta deu lucro no mês passado?" precisa de receita, custos de produto, frete, taxas e investimento em anúncios em um só lugar. Em um dashboard, você abre o relatório certo, define as datas e faz as contas. Em um assistente de IA conectado aos seus dados, você faz a pergunta e recebe a resposta com os números por trás dela.

Linguagem natural. Sem filtros, criadores de relatórios nem fórmulas de planilha.
Perguntas de acompanhamento. Pergunte "e para o TikTok?" ou "qual campanha causou isso?" sem começar de novo.
Vários relatórios em uma resposta. Lucro, atribuição e valor do cliente podem ser combinados em uma única resposta.
No seu idioma. O Ask AI responde no idioma em que você escreve.
Junto com o seu outro trabalho. Pelo MCP, os números da loja ficam disponíveis no app de IA onde você já escreve atualizações ou planos.

A resposta só é tão completa quanto os dados por trás dela. Conecte primeiro o rastreamento server-side, as suas contas de anúncios e os seus custos de produto, para que as ferramentas tenham pedidos, investimento e margens com que trabalhar.

Como funcionam o Ask AI e o servidor MCP do ROASaurus?

O Ask AI é uma página de chat no dashboard do ROASaurus. Ele roda no Claude, o modelo da Anthropic. O servidor MCP oferece as mesmas 24 ferramentas a um cliente de IA que você escolher. Nos dois casos, as ferramentas leem os seus relatórios do ROASaurus e devolvem os números em JSON. O modelo escreve a resposta a partir desses resultados.

Você faz uma perguntaNo Ask AI ou no seu próprio cliente MCP

O modelo escolhe uma ferramentaPor exemplo, campaign_profit para os últimos 30 dias

O ROASaurus executa a ferramentaSomente leitura, nos dados de uma loja

O modelo escreve a respostaSó a partir dos números retornados

O modelo nunca lê o seu banco de dados diretamente. Ele só vê o que uma ferramenta retorna.

Toda ferramenta de análise apenas lê. Nenhuma ferramenta pode alterar a sua loja, as suas campanhas, os seus custos ou as suas configurações. O servidor MCP marca cada uma delas como somente leitura e diz ao cliente para responder apenas com base nos resultados das ferramentas. Uma chave com o escopo actions:write também recebe propose_action, que adiciona uma mudança proposta nos anúncios à caixa de entrada Actions; nada muda até que um proprietário ou administrador a aprove. O Ask AI no dashboard também tem essa ferramenta.

No Ask AI, uma pergunta pode usar até 8 rodadas de chamadas de ferramentas. Se uma pergunta precisar de mais, o assistente pede que você seja mais específico. O Ask AI guarda a sua conversa por usuário e por loja e usa as últimas 12 mensagens como contexto para uma pergunta de acompanhamento. Você pode limpar a conversa a qualquer momento.

24ferramentas somente de leitura, as mesmas no Ask AI e no MCP

6períodos fixos: hoje, ontem, 7, 14, 30 e 90 dias

40perguntas do Ask AI por usuário por dia, por padrão

1loja por chave de API e por conexão

Que perguntas você pode fazer?

Boas perguntas citam uma métrica e um dos períodos aceitos. A tabela mostra exemplos de perguntas, a ferramenta que responde a cada uma e em que a resposta se baseia.

Pergunta	Ferramenta	O que a resposta mostra
Como os últimos 7 dias se compararam com os 7 dias anteriores?	`profit_summary`	Receita, pedidos, investimento em anúncios, MER, POAS e lucro, em relação ao período anterior de mesma duração
Qual campanha teve o melhor POAS nos últimos 30 dias?	`campaign_profit`	Por campanha: receita creditada, lucro bruto, investimento em anúncios, lucro após anúncios, ROAS, POAS e CAC
Quais anúncios têm um CPM alto e poucas compras?	`ads_table`	Investimento, impressões, cliques, CTR e CPM ao lado de compras rastreadas, ROAS e CPA
Quantos meses uma coorte leva para recuperar o seu CAC?	`ltv_insights`	Coortes mensais, mês de payback do CAC e LTV previsto
Quais produtos trazem mais clientes recorrentes?	`products`	Principais produtos e a parcela de compradores de primeira viagem que pediram de novo
Estamos no caminho certo para a meta de receita deste mês?	`goals_forecast`	Metas, resultados até agora e a previsão para o fim do mês
O que devo repor no estoque esta semana?	`inventory`	Estoque disponível, velocidade de vendas, dias de estoque restantes e status de reposição

O modelo escolhe a ferramenta. Você só precisa fazer a pergunta.

Veja um exemplo resolvido. Você pergunta: "O Meta deu lucro nos últimos 30 dias?" O modelo chama campaign_profit com o período definido em 30 dias e o modelo padrão de último clique. Para uma loja de exemplo, a linha do Meta no resultado fica assim:

Linha	Meta, últimos 30 dias	Como é calculado
Receita creditada	$24,000	Receita dos pedidos creditados a cliques do Meta
Lucro bruto (contribution no resultado)	$13,440	Receita menos custo do produto, frete, taxas de pagamento e manuseio (56%)
Investimento em anúncios	$8,000	Sincronizado a partir da conta de anúncios do Meta
Lucro após anúncios	$5,440	$13,440 − $8,000
ROAS	3.00	$24,000 ÷ $8,000
POAS	1.68	$13,440 ÷ $8,000

Loja de exemplo. Um POAS acima de 1.0 significa que os anúncios devolveram mais lucro bruto do que custaram.

No Ask AI, a resposta começa com "Sim", depois traz o lucro após anúncios e o POAS e sugere no máximo três próximos passos. Se você quiser outra visão, faça uma pergunta de acompanhamento como "e com o modelo Total Impact?". Nossos guias sobre POAS e modelos de atribuição explicam esses números com mais profundidade.

Como conectar o servidor MCP do ROASaurus?

O servidor usa o transporte Streamable HTTP do MCP e retorna respostas JSON, sem server-sent events. Apps de IA como Claude e ChatGPT entram com OAuth: você faz login no ROASaurus, escolhe uma loja e permite a conexão. Clientes que permitem definir um cabeçalho de requisição, como o Claude Code, podem usar uma chave de API em vez disso, como nos passos abaixo.

Crie uma chave de API
Abra Store settings › API & data no ROASaurus e crie uma chave nomeada com o escopo mcp. Copie-a: ela é mostrada só uma vez. Só proprietários e administradores podem criar chaves.
Ou reutilize a chave da Orders API
Você também pode usar a chave do card Orders API, por exemplo a que o plugin do WooCommerce usa. Essa chave também pode enviar pedidos. Regenerate API key a substitui e desconecta tudo o que usa a antiga.
Anote a chave da loja
Uma chave nomeada vai sozinha no cabeçalho. Com a chave da Orders API, adicione a chave da loja: o valor de X-Roasaurus-Key no mesmo card, cuja seção MCP mostra o cabeçalho completo.
Adicione o servidor ao seu cliente MCP
Informe o endpoint e o cabeçalho Authorization mostrados abaixo. O cliente precisa oferecer suporte a Streamable HTTP e a cabeçalhos de requisição personalizados.
Faça uma pergunta de teste
Pergunte "Qual foi a minha receita de ontem?" e confira o número no seu dashboard.

Endpoint e um exemplo para o 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>"

Você também pode enviar a chave da loja em um cabeçalho X-Roasaurus-Key e usar só a chave de API como bearer token. No Claude Code, mantenha o escopo local padrão. Um servidor com escopo de projeto é salvo em um arquivo .mcp.json que é compartilhado pelo controle de versão, e isso compartilharia a sua chave.

Para entrar com login, adicione https://app.roasaurus.com/mcp como conector personalizado no Claude ou no ChatGPT e faça login quando o app pedir. Só proprietários e administradores podem permitir uma conexão. Store settings › API & data lista cada app conectado, onde você pode desconectá-lo, e uma conexão também termina quando essa pessoa sai do workspace.

initialize · 2025-06-18Cliente e servidor combinam a versão do protocolo

tools/list · 24 tools · readOnlyHint: trueO cliente descobre quais ferramentas existem

tools/call · campaign_profit · period 30O modelo pede 30 dias de lucro por campanha

result · isError: falseJSON com uma linha por canal e campanha

401 · Invalid store key or API key.O que uma chave errada ou regenerada retorna

Como uma pergunta aparece entre o cliente e o servidor MCP do ROASaurus.

É seguro? Privacidade e segurança

Como as ferramentas de análise apenas leem, um app de IA não consegue pausar uma campanha, editar um custo nem mudar uma configuração pelo ROASaurus; com actions:write, ele só pode propor uma mudança nos anúncios para um proprietário ou administrador aprovar. As ferramentas também aceitam apenas entradas fixas, como um período ou um modelo de atribuição de uma lista. Mesmo assim, alguns pontos pedem cuidado.

Para onde vão os dados. O Ask AI envia a sua pergunta e métricas agregadas da loja à Anthropic, que opera o Claude. Ele não envia dados de contato dos seus clientes. Pelo MCP, os resultados das ferramentas vão para o cliente de IA que você conectar, sob os termos desse cliente. Confira as configurações de retenção de dados e de treinamento dele.
O que as ferramentas retornam. Totais por período, canal, campanha, anúncio, produto, coorte e segmento. Elas não retornam nomes, e-mails nem telefones de clientes.
Quem pode perguntar. Qualquer pessoa com acesso ao app de IA onde você adiciona a conexão pode consultar a loja. Adicione-a à sua própria conta, não a uma compartilhada.
Outros conectores. A especificação do MCP diz que deve haver sempre uma pessoa no circuito que possa negar chamadas de ferramentas e que os clientes devem tratar as anotações das ferramentas como não confiáveis, a menos que o servidor seja confiável. Se o seu app de IA também tem ferramentas que enviam e-mails ou publicam mensagens, mantenha os pedidos de confirmação ativados para essas ferramentas.

Quais são os limites?

Períodos fixos. Hoje, ontem ou os últimos 7, 14, 30 ou 90 dias, no fuso horário da loja. Um intervalo personalizado, como uma semana de março, não é aceito. As ferramentas de valor do cliente e de coortes não recebem período: elas trabalham a partir do seu histórico de pedidos, com até 12 coortes mensais.
Uma janela de 7 dias para a tabela de anúncios. A ferramenta de anúncios usa uma janela de lookback de 7 dias, seja qual for a janela que você definir em Store settings. As ferramentas de atribuição e de lucro por campanha, assim como os relatórios de atribuição no dashboard, usam a sua própria configuração ou a janela de lookback que você pedir.
Listas reduzidas. As listas de campanhas retornam no máximo 25 campanhas, a tabela de anúncios as 30 linhas com mais investimento e a lista de produtos os 25 principais produtos.
Uma loja por conexão. Para várias lojas, crie uma chave e uma conexão para cada uma.
O limite de perguntas do Ask AI. Cada usuário pode fazer 40 perguntas por dia por padrão, contadas nas últimas 24 horas. Pelo MCP, valem os limites de uso do próprio cliente de IA.
As respostas podem estar erradas. O modelo pode interpretar mal um resultado. Confira os números importantes nos relatórios antes de agir com base neles, por exemplo na análise de lucro.

Fontes

No ROASaurus

Continue lendo

Criativos, e-mail e IAFadiga de criativo em anúncios do Facebook: quando trocar um anúncioA fadiga de criativo em anúncios do Facebook aparece como frequência em alta e CTR em queda. Aprenda a medi-la por anúncio, ler o hook rate e o hold rate e planejar uma rotina de renovação.Criativos, e-mail e IAFluxos de carrinho abandonado do Klaviyo: reconheça mais compradoresOs fluxos de carrinho abandonado e de navegação do Klaviyo só alcançam os compradores que o Klaviyo consegue identificar. Saiba como ele os identifica e como reconhecer mais deles no checkout.RastreamentoBloqueadores de anúncios e rastreamento: o que a sua loja perdeBloqueadores de anúncios barram os pixels de rastreamento, e as plataformas de anúncios deixam de ver compras. Veja quais eventos se perdem, por que os eventos server-side não se perdem e como medir a sua diferença.