--- title: "MCP no Claude Code, Cursor e VS Code | Sparkle Tracker" description: "Adicione o MCP do Sparkle Tracker no Claude Code com um comando, autorize no navegador e gere relatórios de vendas e ROAS em arquivo." url: https://sparkletracker.com/integracoes/claude-code updated: 2026-11-03 language: pt-BR --- **INTEGRAÇÃO MCP** Claude 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](https://sparkletracker.com/planos#planos) [Ver o comando](https://sparkletracker.com/integracoes/claude-code#como-conectar) **1** comando no terminal para adicionar o servidor do Sparkle **3** permissõ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](https://sparkletracker.com/integracoes/mcp) do Sparkle está disponível a partir do plano Pro. Atualizado em 3 de novembro de 2026 **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](https://sparkletracker.com/integracoes/claude-code#permissoes) 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](https://sparkletracker.com/integracoes/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](https://sparkletracker.com/blog/prompts-para-gestor-de-trafego). Para o formato do relatório, veja [relatório de tráfego pago](https://sparkletracker.com/blog/relatorio-de-trafego-com-chatgpt). 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](https://sparkletracker.com/planos#planos). Do mesmo assunto ## Outros caminhos _para usar o Sparkle com IA_ [**Integração MCP** Permissões, segurança e limitações](https://sparkletracker.com/integracoes/mcp)[**O que é MCP** O protocolo explicado sem jargão](https://sparkletracker.com/blog/o-que-e-mcp)[**Conectar no ChatGPT** Pelo Modo desenvolvedor](https://sparkletracker.com/integracoes/chatgpt)[**ROAS real com IA** O ROAS da Meta ao lado do confirmado](https://sparkletracker.com/blog/roas-real-com-ia)[**Sparkle para gestores de tráfego** Como o Sparkle entra na rotina de quem gere contas](https://sparkletracker.com/para/gestores-de-trafego)[**Gerenciador de Anúncios do Sparkle** As colunas que o Claude Code lê](https://sparkletracker.com/gerenciador-de-anuncios) 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](https://sparkletracker.com/planos#planos) --- Versão em Markdown de https://sparkletracker.com/integracoes/claude-code para agentes de IA. Índice do site: https://sparkletracker.com/llms.txt