Pular para o conteúdo
Entrar Teste Grátis
INTEGRAÇÃO MCPClaude Code, Cursor e VS Code

MCP do Sparkle no Claude Code: os números de venda direto no terminal

Um comando liga o Sparkle ao Claude Code, e o relatório sai em arquivo, com a venda confirmada de cada anúncio. Sem painel, CSV nem planilha.

Um comando para adicionar Login no navegador A partir do plano Pro
Teste grátis por 7 dias Ver o comando

Exemplo de conversa

1comando no terminal para adicionar o servidor do Sparkle
3permissões escolhidas na tela do Sparkle, antes do primeiro uso
Resposta rápida

Como adicionar o MCP do Sparkle Tracker no Claude Code?

No terminal, rode claude mcp add --transport http sparkle https://ap.sparkletracker.com/mcp. Na primeira vez que o Claude Code usar o Sparkle, o navegador abre a tela de autorização: confira a conta, escolha as permissões e clique em Permitir acesso. O comando /mcp mostra o servidor e o login.

Cursor e VS Code usam o mesmo endereço. A integração MCP do Sparkle está disponível a partir do plano Pro.

Atualizado em

Servidor HTTP remoto, nada para instalar
OAuth pelo navegador, sem chave no terminal
Relatório em arquivo com os dados da conta
Para quem é

Quem ganha tempo com o Sparkle no Claude Code?

Para quem trabalha no terminal ou no editor e repete toda semana a mesma análise: você pede e recebe texto, tabela ou arquivo.

Gestor de tráfego técnico

Cruza custo por venda e ROAS do Sparkle com os resultados da Meta sem sair do terminal, e guarda o histórico em arquivos.

Quem presta contas ao cliente

Gera o relatório da semana no mesmo formato todas as vezes, com as variações em porcentagem, pronto para revisar e mandar.

Quem padroniza relatório

Guarda os pedidos que funcionam num arquivo do projeto e repete a mesma análise a cada fechamento.

Claude Code

Como ligar o Sparkle no Claude Code

Você precisa do Claude Code e de uma conta no Sparkle no plano Pro, Expert ou Growth. O servidor é remoto: nada para instalar.

1Adicione o servidor

Rode no terminal:

claude mcp add --transport http sparkle https://ap.sparkletracker.com/mcp

"sparkle" é o nome que o servidor recebe no Claude Code. O endereço é o mesmo que aparece no painel, em Integrações › Integração MCP · Claude · ChatGPT.

2Autorize no navegador

  1. Abra o Claude Code e peça algo que use o Sparkle, como "me dá um resumo da minha conta do Sparkle".
  2. Na primeira chamada, o navegador abre a tela de autorização do Sparkle. Entre na conta, se pedir, e confira se é a conta certa.
  3. Escolha as permissões e clique em Permitir acesso.

A tela do Sparkle marca como verificados só o Claude (no navegador e no aplicativo) e o ChatGPT. Ferramentas de terminal e editores podem aparecer como "Aplicativo não verificado". É esperado: confira o nome do aplicativo e, se quiser que ele configure a conta, ligue "Configurar a conta", que nesse caso vem desligada.

3Confira com /mcp

Dentro do Claude Code, o comando /mcp mostra o servidor sparkle e a situação do login. Se o navegador não abriu sozinho, é por ali que você entra.

Os três atalhos prontos do Sparkle (Diagnóstico das campanhas, Relatório da semana e Configurar minha operação) viram comandos de barra no Claude Code, como /mcp__sparkle__relatorio_semanal. Digite / e procure por sparkle.

Prefere o Claude no navegador ou no aplicativo? Use o conector personalizado do Claude.

Editores

E no Cursor ou no VS Code?

Funciona em qualquer cliente compatível com MCP remoto e login OAuth: você adiciona o endereço do Sparkle e autoriza na mesma tela.

CCursor

  1. Abra Settings › MCP e escolha adicionar servidor.
  2. Use o endereço https://ap.sparkletracker.com/mcp.
  3. Quando o Cursor pedir o login, autorize na tela do Sparkle.

VVS Code

  1. Abra a paleta de comandos e rode MCP: Add Server.
  2. Escolha o tipo HTTP e cole https://ap.sparkletracker.com/mcp.
  3. Quando o VS Code pedir o login, autorize na tela do Sparkle.
https://ap.sparkletracker.com/mcp
Pedidos prontos

O que pedir no terminal?

O Claude Code lê os dados do Sparkle e grava arquivos na sua pasta. Os pedidos abaixo aproveitam as duas coisas.

  • Gere o relatório da semana comparando com a anterior e salve em relatorios/semana.md.Usa o atalho Relatório da semana, com as variações em porcentagem

  • Monte uma tabela com vendas, investimento e ROAS de cada uma das últimas 4 semanas e salve em semanas.csv.Período personalizado, de até 1 ano

  • Faça o diagnóstico das campanhas e escreva as ações sugeridas em diagnostico.md.Pausar, escalar e testar, com o motivo de cada uma

  • Compare os resultados que a Meta informa com as vendas confirmadas pelo Sparkle nos últimos 30 dias, por campanha.

  • Quanto do faturamento deste mês veio do tráfego pago e quanto veio do orgânico?

Mais pedidos por objetivo em prompts para gestor de tráfego. Para o formato do relatório, veja relatório de tráfego pago.

Você no controle

O que o Claude Code pode fazer na conta?

O mesmo que qualquer assistente conectado. Ler métricas vem sempre ligado; configurar e mexer nos anúncios da Meta são escolhas suas.

Permissões e proteções do Sparkle Tracker no Claude Code
Ponto Como funciona
Aplicativo não verificado Se a tela mostrar "Aplicativo não verificado", "Configurar a conta" vem desligada. Só ver métricas já basta para relatório e diagnóstico. Ligue a configuração se quiser que ele crie operação, pixel ou dashboard.
Segredos Chave do gateway, token do pixel, chave da Datacrazy e QR code do WhatsApp vão por um bloco seguro do Sparkle, aberto num link (o das chaves vale 10 minutos e um envio). Nada disso passa pelo terminal nem fica salvo em arquivo.
Mexer nos anúncios Sempre desligada no começo. Ligada, toda pausa, ativação ou mudança de verba na Meta passa por uma prévia com código de confirmação que vale 5 minutos.
Dados dos leads Telefone e e-mail chegam mascarados, então o arquivo gerado também não traz o contato completo.
Login OAuth 2.1 com PKCE. O acesso vale 1 hora e se renova por até 90 dias. Trocar a senha do Sparkle desconecta todos os assistentes.
Várias máquinas Cada conexão conta: são no máximo 5 ativas por conta, e a sexta derruba a mais antiga. Em Integrações você vê todas e desconecta com um clique.

Quer testar na sua conta? A integração MCP está disponível a partir do plano Pro, com 7 dias grátis. Começar o teste.

Do mesmo assunto

Outros caminhos para usar o Sparkle com IA

Integração MCPPermissões, segurança e limitações
O que é MCPO protocolo explicado sem jargão
Conectar no ChatGPTPelo Modo desenvolvedor
ROAS real com IAO ROAS da Meta ao lado do confirmado
Sparkle para gestores de tráfegoComo o Sparkle entra na rotina de quem gere contas
Gerenciador de Anúncios do SparkleAs colunas que o Claude Code lê
FAQs

Dúvidas sobre o MCP do Sparkle no Claude Code

Rode claude mcp add --transport http sparkle https://ap.sparkletracker.com/mcp no terminal. Na primeira vez que o Claude Code usar o Sparkle, o navegador abre a tela de autorização para você entrar e escolher as permissões.

Não. O acesso é por login OAuth na tela do Sparkle, aberta no navegador. Não tem chave para copiar nem para guardar no projeto.

Dentro do Claude Code, digite /mcp. O comando mostra o servidor sparkle e a situação do login. No painel do Sparkle, a conexão também aparece em Integrações, com a permissão que você deu.

A tela marca como verificados só o Claude no navegador e no aplicativo e o ChatGPT. Ferramentas de terminal e editores podem aparecer como aplicativo não verificado, e então a permissão "Configurar a conta" vem desligada. Confira o nome do aplicativo e ligue a configuração só se quiser que ele altere a conta.

Sim. Qualquer cliente compatível com MCP remoto e login OAuth funciona. No Cursor, adicione o servidor em Settings, MCP. No VS Code, use o comando MCP: Add Server com o tipo HTTP. Nos dois, o endereço é https://ap.sparkletracker.com/mcp.

A partir do plano Pro. A integração MCP está nos planos Pro, Expert e Growth, e não está no Starter. Dá para testar por 7 dias grátis.

Seu relatório da semana em um comando.

Teste o plano Pro por 7 dias, adicione o servidor do Sparkle no Claude Code e peça o primeiro relatório com a venda confirmada de cada anúncio.

Iniciar o teste grátis