Ask AI e MCP

Pergunte sobre as análises da sua loja em linguagem natural

O Ask AI responde a perguntas sobre sua loja a partir dos seus próprios relatórios do ROASaurus. As mesmas ferramentas estão disponíveis em um servidor MCP, para que o Claude, o ChatGPT ou outro cliente MCP consulte seu lucro, sua atribuição e seu LTV.

Respostas a partir dos seus dados

Cada número vem de uma chamada de ferramenta sobre os seus relatórios, nunca da memória do modelo.

Roda no Claude

O modelo da Anthropic lê os resultados e responde no idioma em que você escreve.

24 ferramentas somente leitura

Lucro, atribuição, view-throughs, anúncios, campanhas, clientes, LTV, produtos, web, metas, estoque, benchmarks, custos, públicos, leads, alertas, anomalias, o plano de ação, dashboards, mix de marketing, orçamentos e assinaturas.

Servidor MCP

Use as mesmas ferramentas no Claude, no ChatGPT ou em outro cliente MCP: entre com seu login do ROASaurus ou envie uma chave de API em um cabeçalho.

Mantenha a chave em segurança

Use uma chave de API nomeada só com o escopo mcp, ou a chave de API da loja, que também pode enviar pedidos e eventos. Mantenha qualquer uma delas tão segura quanto uma senha.

Por loja

Uma conexão lê uma loja: a loja que você escolhe ao entrar, ou a loja da chave de API.

Como funciona o Ask AI

O Ask AI é uma página de chat no dashboard. Você faz uma pergunta, o Claude escolhe as ferramentas que podem respondê-la, o ROASaurus as executa sobre os dados da sua loja e o Claude escreve a resposta a partir dos resultados. Se uma ferramenta não retorna dados, ele avisa e sugere o que conectar, como o script de rastreamento, contas de anúncios ou custos de produto. O histórico é mantido por usuário e loja, e cada usuário tem um limite diário de perguntas (40 por padrão, 5 no plano Grátis). O Ask AI também pode propor uma mudança em uma campanha, conjunto de anúncios ou anúncio para a caixa de entrada Actions; nada muda até que um proprietário ou administrador a aprove.

Exemplos de perguntas que ele responde: “Qual campanha teve o melhor POAS nos últimos 30 dias?”, “Quantos meses uma coorte leva para recuperar o CAC?” e “Estamos no caminho certo para a meta de receita deste mês?”

As ferramentas

FerramentaO que ela retorna
profit_summaryReceita, pedidos, AOV, investimento em anúncios, MER, CAC, POAS, custos, lucro bruto e líquido, em comparação com o período anterior
attributionPedidos, receita, investimento, ROAS e CPA por canal e campanha, em qualquer um dos doze modelos e janelas de lookback, por data do pedido ou do clique
view_throughCompras que as plataformas de anúncios relatam após uma visualização de anúncio sem clique, e quantas o ROASaurus alocou em pedidos, por plataforma e campanha
ads_tableInvestimento, impressões, cliques, CTR e CPM combinados com as compras rastreadas, por campanha, conjunto de anúncios ou anúncio
campaign_profitLucro antes e depois dos anúncios, POAS, CAC e LTV de 90 dias por campanha
customer_valueLTV de 30 a 365 dias, taxa de recompra, dias até o segundo pedido e coortes mensais
ltv_insightsPayback do CAC, LTV previsto, tempo de recompra, próximo produto, segmentos RFM e fatores do LTV
productsPrincipais produtos e a parcela de compradores de primeira viagem que pediram de novo
web_analyticsSessões, taxa de rejeição e taxa de conversão por origem, dispositivo e página de entrada
goals_forecastAs metas deste mês, o realizado até agora e a previsão de fim de mês
inventoryValor do estoque, velocidade de vendas, dias restantes e itens para repor
benchmarksSeus últimos 90 dias em relação aos quartis de lojas semelhantes
cost_modelLinhas do P&L até o EBITDA, CM1 a CM3, despesas gerais, IVA recuperado e as fontes de custo conectadas
audiencesCada público com as suas regras, o tamanho com consentimento e o status de sincronização por destino
leads_pipelineLeads, MQLs, SQLs, negócios ganhos, receita ganha e custo por lead, por canal e campanha
alertsQuedas recentes de pedidos, quedas de ROAS, picos de investimento e falhas de rastreamento
anomaliesMétricas que saíram da faixa normal nos últimos dias, com o valor esperado
action_planO plano de ação semanal e o registro de decisões, com resultados antes e depois
list_dashboardsDashboards personalizados compartilhados com o workspace e métricas personalizadas
evaluate_metricQualquer métrica nativa ou personalizada, ou uma fórmula, com filtros e o período de comparação
marketing_mixReceita incremental, iROAS, ROAS marginal e saturação por canal a partir do modelo de mix de marketing
optimal_budgetA melhor divisão de um orçamento entre canais, com limites por canal
subscriptionsAssinantes, MRR, churn, motivos de churn e a conversão de compradores avulsos em assinantes
subscriber_cohortsRetenção de assinantes e de MRR por mês da primeira assinatura

O Ask AI e os clientes MCP cuja chave tem o escopo actions:write também recebem ad_entities (as campanhas, os conjuntos de anúncios e os anúncios das contas de anúncios com escrita habilitada) e propose_action, que adiciona uma mudança proposta à caixa de entrada Actions para um proprietário ou administrador aprovar.

O servidor MCP

O MCP, o Model Context Protocol, permite que apps de IA chamem ferramentas de outros serviços. O ROASaurus mantém um servidor MCP com as mesmas 24 ferramentas somente leitura, para você perguntar sobre sua loja no Claude Code ou em outro cliente MCP que já usa.

Endpoint: POST https://app.roasaurus.com/mcp
Header: Authorization: Bearer <store key>:<API key>

Ele fala MCP Streamable HTTP com respostas JSON (sem server-sent events) e suporta initialize, ping, tools/list e tools/call. Toda ferramenta de análise é marcada como somente leitura. Você também pode enviar a chave da loja em um cabeçalho X-Roasaurus-Key e apenas a chave de API como bearer token. As duas chaves estão no card Settings › Orders API da loja. Essa chave de API é a mesma que a API de pedidos usa, então ela também pode enviar pedidos e eventos: mantenha-a tão segura quanto uma senha. Gerá-la de novo desconecta todos os clientes que usavam a antiga. Uma chave nomeada só com o escopo mcp, criada em Store settings › API & data, funciona sozinha como bearer token e não pode gravar.

Apps de IA compatíveis com OAuth, como Claude e ChatGPT, entram com login em vez de usar uma chave: adicione o endpoint como conector personalizado, entre no ROASaurus, escolha uma loja e permita a conexão. Proprietários e administradores podem conectar, e Store settings › API & data lista cada conexão, onde você pode desconectá-la.

Privacidade

O Ask AI envia sua pergunta e métricas agregadas da loja para a 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.

Para quem é

Donos de loja que querem um número sem montar um relatório e profissionais de marketing ou analistas que já trabalham no Claude e querem os dados da loja ao lado do restante do trabalho. As respostas são tão completas quanto os dados por trás delas, então conecte primeiro o rastreamento, o investimento do Meta e do TikTok e os seus custos de produto.

Limites

  • Os períodos são fixos: hoje, ontem ou os últimos 7, 14, 30 ou 90 dias no fuso horário da loja.
  • A tabela de anúncios usa uma janela de lookback de 7 dias; a atribuição e o lucro por campanha usam a janela de lookback da loja ou a que você pedir.
  • As ferramentas não conseguem alterar nada sozinhas. O Ask AI e os clientes MCP cuja chave tem o escopo actions:write só podem propor mudanças nos anúncios para um proprietário ou administrador aprovar.
  • Uma chave de API cobre uma loja. Para várias lojas, conecte cada uma.
Mais funcionalidades

Construído sobre os mesmos dados first-party

Rastreamento server-sideCaptura de cliques first-party, associação de pedidos e Conversions APIs para 15 plataformas de anúncios, deduplicadas com o pixel do navegador.Análise de lucroLucro líquido após todos os custos, POAS e ROAS de equilíbrio, um P&L completo e lucro por produto, pedido e canal.AtribuiçãoDoze modelos, do último clique aos modelos de Markov e Shapley baseados em dados e ao Total Impact, sobre os seus próprios dados de cliques, com jornadas de pedidos e lucro por campanha.Valor vitalícioCoortes, payback do CAC, LTV previsto em até 24 meses, tempo de recompra e segmentos RFM sincronizados com o Klaviyo.Análise de criativosHook rate, hold rate, fadiga e ROAS por criativo, hook, criador e formato para Meta e TikTok.Marketing mix & orçamentosUm modelo de marketing mix com otimizador de orçamento, geo-lift e testes liga/desliga, curvas de investimento e conselhos diários de escalar, manter ou cortar por campanha.PúblicosPúblicos a partir de pedidos, LTV previsto, RFM, visitantes e leads, mantidos em sincronia com dez plataformas de anúncios e o Klaviyo.Actions & AutopilotUm gerenciador de anúncios para nove plataformas, com caixa de aprovação, regras com limites de segurança, um Autopilot de IA e reversão em um clique.Briefings de IAAlertas de anomalias, resumos de IA baseados nos seus próprios números, um plano de ação semanal com registro de decisões e perguntas agendadas no Slack.Concorrentes & visibilidade em IAAnúncios e e-mails dos concorrentes no Meta, quantas vezes assistentes de IA citam sua loja, rascunhos de conteúdo com IA e grupos focais de IA.InfluenciadoresUm CRM de influenciadores com acordos, atribuição por código e link, e ROI e lucro por acordo e por influenciador.AgênciasWorkspaces de clientes, uma visão geral multicliente, white label no seu próprio domínio, relatórios em PDF e participação na receita.
Perguntas frequentes

Perguntas respondidas

O que é um servidor MCP?

O MCP (Model Context Protocol) é um padrão aberto que permite que apps de IA chamem ferramentas de outros serviços. O servidor MCP do ROASaurus dá a um cliente de IA ferramentas somente leitura para o lucro, a atribuição, os anúncios, o LTV, o estoque, os benchmarks e os alertas de uma loja.

Quais apps de IA podem se conectar?

Claude Code e outros clientes MCP que consigam chamar um servidor Streamable HTTP com um cabeçalho Authorization. O ChatGPT espera login com OAuth para servidores MCP personalizados, algo que o ROASaurus ainda não oferece. Use uma chave nomeada com o escopo mcp de Store settings › API & data, ou a chave da loja e a chave de API de Settings › Orders API.

A IA pode alterar minhas campanhas ou configurações?

Não diretamente. O Ask AI e os clientes MCP cuja chave tem o escopo actions:write podem propor uma mudança em uma campanha, conjunto de anúncios ou anúncio na caixa de entrada Actions, e nada muda até que um proprietário ou administrador a aprove. Nenhuma ferramenta pode editar sua loja, seus custos nem suas configurações. A chave de API da loja também pode enviar pedidos e eventos, então mantenha-a privada.

Os dados dos clientes são enviados à IA?

O Ask AI envia sua pergunta e métricas agregadas da loja para a Anthropic, que opera o Claude, e nenhum dado de contato dos seus clientes. Pelo MCP, os resultados das ferramentas vão para o cliente de IA que você conectar.

Cada venda, rastreada até o anúncio que a gerou

Rastreamento server-side, lucro e valor vitalício em um só app. 14 dias de teste grátis, sem cartão de crédito.

Comece seu teste grátis →