O que é um servidor MCP do Shopify?

É um servidor que usa o Model Context Protocol para dar às apps de IA ferramentas para uma loja Shopify. O servidor MCP da ROASaurus dá a um cliente de IA ferramentas só de leitura para o lucro, a atribuição, os anúncios, o valor do cliente, o inventário, os objetivos, os benchmarks e os alertas de uma loja.

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

Não por si só. As ferramentas de análise do Ask AI e do servidor MCP só leem. O Ask AI, e um cliente MCP cuja chave tenha o âmbito actions:write, podem propor uma alteração a uma campanha na caixa de entrada Actions, e nada muda até um proprietário ou administrador a aprovar. Nenhum dos dois pode editar a sua loja, os seus custos ou as suas definições.

Que apps de IA se podem ligar ao servidor MCP da ROASaurus?

O Claude, o ChatGPT e outros clientes MCP compatíveis com OAuth iniciam sessão com o seu acesso ROASaurus. Os clientes que permitem definir um cabeçalho Authorization, como o Claude Code, podem usar uma chave de API em vez disso.

Os dados de clientes são enviados para a IA?

As ferramentas devolvem métricas agregadas, não dados de contacto de clientes. O Ask AI envia a sua pergunta e estas métricas para a Anthropic; através do MCP, os resultados vão para o cliente de IA que ligar.

Porque não posso perguntar por um intervalo de datas personalizado?

As ferramentas só aceitam 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 antes o seu histórico de encomendas.

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

Não. O limite diário aplica-se ao Ask AI no dashboard. Através do MCP, aplicam-se os limites de utilização do seu próprio cliente de IA.

Shopify MCP: pergunte pelos dados da sua loja no Claude e noutras apps de IA

Pontos-chave

O MCP (Model Context Protocol) é um padrão aberto que permite às apps de IA chamar ferramentas de outros serviços, para que um assistente possa responder a partir dos dados reais da sua loja.
O Ask AI da ROASaurus e o servidor MCP da ROASaurus partilham 24 ferramentas só de leitura, do lucro, da atribuição e do valor do cliente aos custos, leads, subscrições, marketing mix model e anomalias.
Uma app de IA liga-se iniciando sessão no ROASaurus com OAuth, ou com uma chave de API num cabeçalho Authorization.
Uma chave com nome que tenha apenas o âmbito mcp só pode ler; a chave da Orders API também pode enviar encomendas, por isso mantenha qualquer chave secreta e revogue-a se houver uma fuga.
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 utilizador por dia por predefinição.

Um servidor MCP do Shopify liga os dados da sua loja a um assistente de IA através do Model Context Protocol (MCP). Faz uma pergunta em linguagem corrente, como “Que 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. A ROASaurus tem um servidor MCP com 24 ferramentas de análise só de leitura, e as mesmas ferramentas alimentam o Ask AI dentro do dashboard.

Este guia explica o que é o MCP, porque ajuda fazer perguntas de análise desta forma, como funcionam o Ask AI e o servidor MCP, como ligar um cliente, que perguntas funcionam bem e a privacidade, a segurança e os limites que deve conhecer.

O que é o MCP?

O MCP é um padrão de código aberto para ligar aplicações de IA a sistemas externos. Uma 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 faz uma pergunta, o cliente pergunta ao servidor que ferramentas existem (tools/list). O modelo escolhe a ferramenta adequada e o cliente chama-a (tools/call). O resultado volta ao modelo, que escreve a resposta. Não precisa de conhecer os nomes das ferramentas. Só tem de fazer a pergunta.

O Shopify também tem servidores MCP. Centram-se em agentes de compras e programadores: pesquisa de produtos, carrinhos, checkout, contas de clientes e documentação para programadores. Um servidor MCP de análise responde a outro tipo de pergunta: lucro depois dos anúncios, atribuição e valor do cliente, calculados a partir das suas encomendas, dos seus custos e do investimento nas suas contas de anúncios.

Porque perguntar pelos 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. "A Meta deu dinheiro no mês passado?" precisa de receita, custos de produto, envio, taxas e investimento em anúncios no mesmo sítio. Num dashboard, abre o relatório certo, define as datas e faz as contas. Num assistente de IA ligado aos seus dados, faz a pergunta e recebe a resposta com os números por trás.

Linguagem corrente. Sem filtros, construtores de relatórios nem fórmulas de folha de cálculo.
Perguntas de seguimento. Pergunte "e para o TikTok?" ou "que campanha causou isso?" sem recomeçar.
Vários relatórios numa só resposta. O lucro, a atribuição e o valor do cliente podem ser combinados numa única resposta.
Na sua língua. O Ask AI responde na língua em que escrever.
Ao lado do seu outro trabalho. Através do MCP, os números da loja ficam disponíveis na app de IA onde já escreve atualizações ou planos.

A resposta só é tão completa quanto os dados que a sustentam. Ligue primeiro o tracking server-side, as suas contas de anúncios e os seus custos de produto, para que as ferramentas tenham encomendas, investimento e margens com que trabalhar.

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

O Ask AI é uma página de chat no dashboard da ROASaurus. Corre no Claude, o modelo da Anthropic. O servidor MCP oferece as mesmas 24 ferramentas a um cliente de IA à sua escolha. Em ambos os casos, as ferramentas leem os seus relatórios da ROASaurus e devolvem os números em JSON. O modelo escreve a resposta a partir desses resultados.

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

A ROASaurus executa a ferramentaSó de leitura, nos dados de uma loja

O modelo escreve a respostaApenas a partir dos números devolvidos

O modelo nunca lê diretamente a sua base de dados. Só vê o que uma ferramenta devolve.

Todas as ferramentas de análise só leem. Nenhuma ferramenta pode alterar a sua loja, as suas campanhas, os seus custos ou as suas definições. O servidor MCP marca cada uma delas como só de leitura e diz ao cliente para responder apenas a partir dos resultados das ferramentas. Uma chave com o âmbito actions:write recebe também propose_action, que acrescenta uma alteração proposta a um anúncio à caixa de entrada Actions; nada muda até um proprietário ou administrador a aprovar. O Ask AI no dashboard também a tem.

No Ask AI, uma pergunta pode usar até 8 rondas de chamadas a ferramentas. Se uma pergunta precisar de mais, o assistente pede-lhe que seja mais específico. O Ask AI guarda a sua conversa por utilizador e loja e usa as últimas 12 mensagens como contexto para uma pergunta de seguimento. Pode limpar a conversa a qualquer momento.

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

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

40perguntas ao Ask AI por utilizador por dia, por predefinição

1loja por chave de API e por ligação

Que perguntas pode fazer?

As boas perguntas nomeiam uma métrica e um dos períodos suportados. A tabela mostra exemplos de perguntas, a ferramenta que responde a cada uma e em que se baseia a resposta.

Pergunta	Ferramenta	O que a resposta mostra
Como se comparam os últimos 7 dias com os 7 dias anteriores?	`profit_summary`	Receita, encomendas, investimento em anúncios, MER, POAS e lucro, face ao período anterior de igual duração
Que campanha teve o melhor POAS nos últimos 30 dias?	`campaign_profit`	Por campanha: receita atribuída, lucro bruto, investimento em anúncios, lucro depois dos anúncios, ROAS, POAS e CAC
Que anúncios têm um CPM alto e poucas compras?	`ads_table`	Investimento, impressões, cliques, CTR e CPM ao lado das compras registadas, do ROAS e do CPA
Quantos meses leva uma coorte a recuperar o seu CAC?	`ltv_insights`	Coortes mensais, mês de recuperação do CAC e LTV previsto
Que produtos trazem mais clientes recorrentes?	`products`	Produtos mais vendidos e percentagem de compradores de primeira vez que voltaram a encomendar
Estamos no bom caminho para o objetivo de receita deste mês?	`goals_forecast`	Objetivos, valores reais até agora e a previsão para o fim do mês
O que devo reabastecer esta semana?	`inventory`	Stock disponível, velocidade de vendas, dias de stock restantes e estado de reposição

O modelo escolhe a ferramenta. Só tem de fazer a pergunta.

Eis um exemplo prático. Pergunta: "A Meta deu dinheiro nos últimos 30 dias?" O modelo chama campaign_profit com o período definido para 30 dias e o modelo de último clique predefinido. Para uma loja de exemplo, a linha da Meta no resultado é assim:

Linha	Meta, últimos 30 dias	Como é calculado
Receita atribuída	$24,000	Receita das encomendas atribuídas a cliques da Meta
Lucro bruto (contribution no resultado)	$13,440	Receita menos custo do produto, envio, taxas de pagamento e manuseamento (56%)
Investimento em anúncios	$8,000	Sincronizado a partir da conta de anúncios da Meta
Lucro depois dos 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 recuperaram mais lucro bruto do que custaram.

No Ask AI, a resposta começa por "Sim", depois indica o lucro depois dos anúncios e o POAS e sugere no máximo três passos seguintes. Se quiser outra perspetiva, faça uma pergunta de seguimento como "e com o modelo Total Impact?". Os nossos guias sobre POAS e modelos de atribuição explicam estes números com mais pormenor.

Como ligar o servidor MCP da ROASaurus?

O servidor usa o transporte Streamable HTTP do MCP e devolve respostas JSON, sem server-sent events. As apps de IA como o Claude e o ChatGPT iniciam sessão com OAuth: entra no ROASaurus, escolhe uma loja e autoriza a ligação. Os clientes que permitem definir um cabeçalho de pedido, 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 na ROASaurus e crie uma chave com nome com o âmbito mcp. Copie-a: é mostrada uma única vez. Só os proprietários e os administradores podem criar chaves.
Ou reutilize a chave da Orders API
Também pode usar a chave do cartão Orders API, por exemplo a que o plugin do WooCommerce usa. Essa chave também pode enviar encomendas. Regenerate API key substitui-a e desliga tudo o que usa a antiga.
Anote a chave da loja
Uma chave com nome vai sozinha no cabeçalho. Com a chave da Orders API, acrescente a chave da loja: o valor X-Roasaurus-Key no mesmo cartão, cuja secção MCP mostra o cabeçalho completo.
Adicione o servidor ao seu cliente MCP
Introduza o endpoint e o cabeçalho Authorization mostrados abaixo. O cliente tem de suportar Streamable HTTP e cabeçalhos de pedido personalizados.
Faça uma pergunta de teste
Pergunte "Qual foi a minha receita de ontem?" e confirme 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>"

Também pode enviar a chave da loja num cabeçalho X-Roasaurus-Key e usar apenas a chave de API como bearer token. No Claude Code, mantenha o âmbito local predefinido. Um servidor com âmbito de projeto é guardado num ficheiro .mcp.json que é partilhado através do controlo de versões, e isso partilharia a sua chave.

Para iniciar sessão em vez disso, adicione https://app.roasaurus.com/mcp como conector personalizado no Claude ou no ChatGPT e inicie sessão quando a app pedir. Só proprietários e administradores podem autorizar uma ligação. Store settings › API & data lista cada app ligada, onde a pode desligar, e uma ligação também termina quando essa pessoa sai do espaço de trabalho.

initialize · 2025-06-18O cliente e o servidor acordam a versão do protocolo

tools/list · 24 tools · readOnlyHint: trueO cliente fica a saber que 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 devolve uma chave errada ou regenerada

Como é uma pergunta entre o cliente e o servidor MCP da ROASaurus.

É seguro? Privacidade e segurança

Como as ferramentas de análise só leem, uma app de IA não pode pausar uma campanha, editar um custo nem alterar uma definição através da ROASaurus; com actions:write, só pode propor uma alteração a um anúncio para um proprietário ou administrador aprovar. As ferramentas também só aceitam entradas fixas, como um período ou um modelo de atribuição de uma lista. Ainda assim, há alguns pontos que exigem cuidado.

Para onde vão os dados. O Ask AI envia a sua pergunta e métricas agregadas da loja para a Anthropic, que gere o Claude. Não envia dados de contacto dos seus clientes. Através do MCP, os resultados das ferramentas vão para o cliente de IA que ligar, ao abrigo dos termos desse cliente. Verifique as suas definições de retenção de dados e de treino.
O que as ferramentas devolvem. Totais por período, canal, campanha, anúncio, produto, coorte e segmento. Não devolvem nomes de clientes, endereços de email nem números de telefone.
Quem pode perguntar. Qualquer pessoa com acesso à app de IA onde adiciona a ligação pode consultar a loja. Adicione-a à sua própria conta, não a uma partilhada.
Outros conectores. A especificação do MCP diz que deve haver sempre uma pessoa no circuito que possa recusar chamadas a ferramentas, e que os clientes têm de tratar as anotações das ferramentas como não fiáveis, a menos que o servidor seja de confiança. Se a sua app de IA também tiver ferramentas que enviam email 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 é suportado. As ferramentas de valor do cliente e de coortes não recebem período: trabalham a partir do seu histórico de encomendas, 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 definir em Store settings. As ferramentas de atribuição e de lucro por campanha, tal como os relatórios de atribuição no dashboard, usam a sua própria definição ou uma janela de lookback que pedir.
Listas abreviadas. As listas de campanhas devolvem 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 ligação. Para várias lojas, crie uma chave e uma ligação para cada uma.
O limite de perguntas do Ask AI. Cada utilizador pode fazer 40 perguntas por dia por predefinição, contadas nas últimas 24 horas. Através do MCP, aplicam-se antes os limites de utilização do seu próprio cliente de IA.
As respostas podem estar erradas. O modelo pode interpretar mal um resultado. Confirme os números importantes nos relatórios antes de agir com base neles, por exemplo na análise de lucro.

Fontes

Na ROASaurus

Continue a ler

Criativos, email e IAFadiga de criativos nos anúncios do Facebook: quando substituir um anúncioA fadiga de criativos nos anúncios do Facebook revela-se numa frequência a subir e num CTR a descer. Saiba como a medir por anúncio, ler o hook rate e o hold rate e planear uma rotina de renovação.Criativos, email e IAFluxos de carrinho abandonado do Klaviyo: reconheça mais compradoresOs fluxos de carrinho abandonado e de navegação do Klaviyo só chegam aos compradores que o Klaviyo consegue identificar. Saiba como os identifica e como reconhecer mais compradores no checkout.TrackingBloqueadores de anúncios e tracking: o que a sua loja perdeOs bloqueadores de anúncios travam os pixels de tracking, por isso as plataformas de anúncios perdem compras. Veja que eventos se perdem, porque é que os eventos server-side não se perdem e como medir a diferença na sua loja.