Conectar Insights no Claude e no ChatGPT (MCP)

Use o Checkout Sentry dentro do Claude.ai, do ChatGPT ou de IDEs (Cursor, VS Code e similares) para perguntar sobre a saúde do checkout da sua loja — sem sair do chat.

A conexão MCP é liberada gradualmente. Se a opção ainda não aparecer em Desenvolvedores na sua loja, fale com o suporte Checkout Sentry.

URL do servidor

https://mcp.checkoutsentry.com/mcp

No Claude.ai e no ChatGPT você autentica com login Checkout Sentry (OAuth). Em IDEs, use uma chave de API (csk_…) criada em Desenvolvedores.

Claude.ai (navegador)

No Claude pela web, o conector usa login Checkout Sentry.

  1. Abra o Claude.ai e vá em Configurações → Conectores (Connectors).
  2. Adicione um conector personalizado (Custom / Web) e informe a URL do servidor acima.
  3. Escolha autenticação com login (Sign in) — não use “sem login” nem cole chave nos headers.
  4. Conclua o login no Checkout Sentry, escolha a loja e clique em Autorizar.
  5. Volte ao chat e peça, por exemplo: “qual a receita em risco nas últimas 24 horas?”.

ChatGPT (navegador)

No ChatGPT pela web, o conector também usa login Checkout Sentry.

  1. Abra o ChatGPT e vá até Apps / Conectores (ou Configurações → Apps conectados, conforme sua conta).
  2. Adicione um conector MCP remoto e informe a URL do servidor acima.
  3. Siga o login Checkout Sentry quando o navegador abrir.
  4. Escolha a loja, revise as permissões e clique em Autorizar.
  5. Confirme que o conector aparece como instalado e teste com uma pergunta sobre o checkout.

VS Code, Cursor e outras IDEs (JSON)

Em editores que aceitam MCP por arquivo JSON, use a URL do servidor e uma chave criada em Desenvolvedores (escopos recomendados: leitura da loja e métricas; opcionalmente integrações e checkouts).

  1. Em Desenvolvedores, crie uma chave com os escopos necessários e copie o secret (csk_…).
  2. Abra a configuração MCP da IDE (ex.: mcp.json no Cursor ou config equivalente no VS Code).
  3. Cole o bloco JSON abaixo, troque o Bearer pela sua chave e reinicie a IDE se pedido.

Exemplo de configuração

{
  "mcpServers": {
    "checkout-sentry": {
      "url": "https://mcp.checkoutsentry.com/mcp",
      "headers": {
        "Authorization": "Bearer csk_test_…"
      }
    }
  }
}

O formato exato pode variar um pouco entre IDEs; o importante é a URL do MCP e o header Authorization com a chave.

O que você pode perguntar (tools)

Depois de conectar, o assistente pode usar estas ferramentas sobre a loja autorizada:

  • get_store_pulse — Panorama rápido

    Resumo do período: receita em risco, erros, abandonos e checkouts concluídos.

  • get_revenue_at_risk — Receita em risco

    Quanto está em risco no período e quais tipos de erro mais pesam nesse cenário.

  • get_error_breakdown — Erros por tipo

    Contagem dos erros mais frequentes no checkout (por tipo).

  • get_errors_over_time — Erros ao longo do tempo

    Como os erros críticos evoluem no período (série temporal).

  • get_daily_series — Série diária

    Indicadores do checkout dia a dia no período escolhido.

  • get_integrations_health — Saúde das integrações

    Status dos serviços monitorados da loja (ex.: pagamento e envio). Requer permissão de integrações na autorização ou na chave.

  • compare_periods — Comparar períodos

    Compara dois intervalos (ex.: últimas 24h vs. 7 dias) para ver tendência.

  • get_checkouts — Checkouts por status

    Lista ou resume checkouts abandonados, com erro, concluídos ou em andamento. O detalhe inclui UTM (source, medium, campaign, term, content). Requer permissão de checkouts na autorização ou na chave.

  • get_utm_breakdown — UTM por fonte

    Contagem, valor do carrinho e erros críticos abertos por utm_source no período. Pode separar por campanha e indica onde a receita em risco se concentra. Requer permissão de checkouts.

  • get_daily_report: relatório de um dia

    Os dados do relatório da aba Insights para ontem ou para um dia fechado (até 31 dias atrás), para o assistente analisar. Exemplo: “Me mande o relatório de ontem”. Campanhas UTM e cupons só vêm com a permissão de checkouts, e as quedas de serviço, com a de integrações.

  • get_period_report: relatório de um período

    Os dados de um intervalo fechado de até 31 dias, para o assistente analisar. O link abre a lista da aba Insights. Campanhas UTM e cupons só vêm com a permissão de checkouts, e as quedas de serviço, com a de integrações.

Períodos aceitos nas tools: últimas 24 horas, 7 dias ou 30 dias.

Pedir o relatório

Depois de conectar, peça por exemplo: “Me mande o relatório de ontem”. O assistente usa get_daily_report ou get_period_report e deve mostrar o texto como veio, com o link do painel.

O relatório só traz números desta loja. Não compara com outras lojas. O texto segue para o assistente que você conectou, como as outras ferramentas.