Snapchat Ads no Claude Code com um comando
Claude Code
Para conectar o Snapchat Ads ao Claude Code, adicione o PaidSync.ai: rode claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp, digite /mcp e entre com seu login do PaidSync.
O Claude Code passa então a acessar suas contas de anúncios do Snapchat por 15 ferramentas: relatórios por campanha, além de pausar, ativar e alterar orçamento e ad squads em campanhas existentes. O Claude Code pergunta antes de executar cada ferramenta.
Nível Manage. O Claude Code trabalha em campanhas que você já veicula. Ele não cria novas campanhas no Snapchat.
O comando
O Claude Code se comunica com servidores MCP remotos por Streamable HTTP. O PaidSync é um deles. Adicione uma vez e o mesmo terminal que edita seu código também pode gerar relatórios e gerenciar suas campanhas do Snapchat.
claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcpPor padrão, isso registra o servidor só para o projeto atual. Adicione --scope user para disponibilizá-lo em todos os projetos da sua máquina.
Execute claude mcp list para confirmar que ele está lá, depois inicie uma sessão e digite /mcp para entrar.
Configuração em 5 passos
1Cadastre-se em paidsync.ai/signup
Leva 10 segundos. Login com Google ou e-mail. O plano gratuito tem 100 tarefas por mês, no valor de $50, por $0, sem cartão.
2Conecte o Snapchat Ads no painel do PaidSync
Clique em Conectar no Snapchat Ads e entre com a conta do Snapchat que consegue abrir suas contas de anúncios em business.snapchat.com. O Snapchat Ads autoriza via Snapchat OAuth, e o PaidSync nunca vê sua senha do Snapchat.
Já está dentro do Claude Code? Peça para ele executar connect_snapchat_ads. A ferramenta retorna um link para abrir no navegador.
3Escolha a conta de anúncios em que o Claude Code deve trabalhar
Dentro de uma sessão, list_snapchat_accounts mostra todas as contas de anúncios que seu login do Snapchat consegue abrir, em todas as organizações, e set_active_snapchat_account escolhe aquela em que o Claude Code trabalha.
4Adicione o PaidSync ao Claude Code
No seu terminal, rode:
claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcpInicie uma sessão, digite /mcp, escolha paidsync e entre com o seu login do PaidSync na janela do navegador que abrir. O Claude Code guarda o token OAuth para você. Nenhuma chave é colada em lugar nenhum.
Configurando para uma equipe? Faça commit de um .mcp.json na raiz do repositório para que todo engenheiro receba o mesmo conector:
{
"mcpServers": {
"paidsync": { "type": "http", "url": "https://mcp.paidsync.ai/mcp" }
}
}Prefere uma chave de API, por exemplo para execuções sem interface? Envie-a em um cabeçalho, nunca na URL, onde ela iria parar nos logs:
claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp --header "Authorization: Bearer $PAIDSYNC_API_KEY"Em um .mcp.json commitado, adicione "headers": { "Authorization": "Bearer ${PAIDSYNC_API_KEY}" } para que a chave fique no ambiente de cada engenheiro e nunca entre no git. Aplicar uma alteração no Google Ads ainda exige o login OAuth. Em outras plataformas, uma chave também pode aplicar alterações, então trate-a como uma senha e prefira OAuth.
5Teste a conexão
Em uma sessão do Claude Code, peça: “Mostre minhas campanhas do Snapchat e o status delas”
O Claude Code retorna cada campanha com ID, nome, status e objetivo. A conexão está ativa.
O plano gratuito inclui 100 tarefas por mês. Pro a partir de $99 por mês, Team a partir de $249.
Prompts de Snapchat Ads no Claude Code
Cada prompt abaixo corresponde a ferramentas do grupo Snapchat Ads do PaidSync. O Claude Code escolhe a ferramenta. A última coluna indica se a chamada pode alterar algo na conta de anúncios.
| Pedido | Ferramentas que chama | Altera sua conta? |
|---|---|---|
| “Liste minhas contas de anúncios do Snapchat e defina a Acme como ativa” | list_snapchat_accounts, set_active_snapchat_account | Não |
| “Liste minhas campanhas do Snapchat com status e objetivo” | list_snapchat_campaigns | Não |
| “Mostre gasto, impressões, swipes e compras da campanha Spring Sale, dia a dia” | list_snapchat_campaigns, get_snapchat_performance | Não |
| “Liste os ad squads da campanha Retargeting” | list_snapchat_adsquads | Não |
| “Pause a campanha Summer Promo” | pause_snapchat_campaign | Sim, depois que você confirma |
| “Mostre uma prévia de aumentar o orçamento diário da campanha Retargeting para 80” | update_snapchat_campaign_budget | Sim, depois que você confirma |
| “Reduza o lance do ad squad Lookalike 1% para 1.20” | update_snapchat_adsquad | Sim, depois que você confirma |
Execute em modo headless com claude -p
A flag -p executa o Claude Code sem a sessão interativa. Entre uma vez por /mcp e o token OAuth guardado continua valendo. Um relatório que cai em um arquivo fica assim:
claude -p "Pull last 7 days Snapchat performance by campaign and list the campaigns with spend and no purchases." \
--allowedTools "mcp__paidsync" \
--output-format json > reports/snapchat-ads-$(date +%F).jsonAs leituras rodam direto, e as escritas também. --allowedTools "mcp__paidsync" permite todas as ferramentas do PaidSync, escritas incluídas, sem prompt.
Em uma tarefa sem supervisão, permita só as ferramentas de leitura de que ela precisa, cada uma pelo nome como mcp__paidsync__tool_name.
O que lê e o que grava
Das 15 ferramentas do Snapchat Ads, 8 apenas leem e 5 podem gravar. As de leitura cobrem organizações, contas de anúncios, campanhas, ad squads, anúncios e desempenho das campanhas.
Ler mais
As de gravação cobrem pausar e ativar campanhas, orçamentos e configurações de campanhas, e status, lance, orçamento e nome de ad squads.
Alterações de orçamento, lance e configurações mostram prévia por padrão com dry_run, e o PaidSync lê cada alteração de volta no Snapchat depois.
Via MCP, a etapa de aprovação é o próprio prompt do Claude Code. Ele pergunta antes de executar uma ferramenta, a menos que você a tenha permitido com --allowedTools ou nas suas configurações. O PaidSync acrescenta verificações do seu lado. Exclusões, pausas e alterações de orçamento exigem confirm_destructive, e uma verificação de regras antes da gravação bloqueia argumentos inseguros. O cartão de aprovação, e o Undo em um cartão aplicado cuja alteração tem inverso seguro, valem apenas no workspace do PaidSync.
Adicionar ao ChatGPT: abra o PaidSync.ai no diretório de plugins do ChatGPT, instale e faça login.
Adicionar ao Claude: abra o PaidSync.ai no diretório de conectores do Claude, clique em Conectar e faça login.
O que o Claude Code não faz no Snapchat
- O PaidSync não cria campanhas, ad squads nem anúncios no Snapchat. Crie-os no Snapchat Ads Manager e depois gerencie-os pelo Claude Code.
- Não há envio de imagens ou vídeos nem edição de criativos.
- Públicos e segmentação continuam no Snapchat Ads Manager.
- O desempenho vem por campanha, não por ad squad nem por anúncio.
- Cada pausa de campanha tem uma ativação correspondente, então uma pausa sempre pode ser desfeita.
Perguntas frequentes
Como conectar o Snapchat Ads ao Claude Code?
Cadastre-se em paidsync.ai, conecte o Snapchat Ads via OAuth no painel e depois execute claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp no seu terminal. Digite /mcp dentro de uma sessão, escolha paidsync e entre com seu login do PaidSync.
O Claude Code pode criar campanhas no Snapchat?
Não. O Snapchat é uma plataforma de nível manage no PaidSync. O Claude Code pode gerar relatórios de campanhas existentes, pausá-las e ativá-las e alterar orçamentos e configurações de ad squads. Novas campanhas são criadas no Snapchat Ads Manager.
O Claude Code pode alterar orçamentos do Snapchat?
Sim. update_snapchat_campaign_budget altera o orçamento de uma campanha e update_snapchat_adsquad altera o lance ou o orçamento de um ad squad. Os dois mostram antes uma prévia em simulação, e o Claude Code pergunta antes de executar cada ferramenta.
Funciona em modo headless com claude -p?
Sim. Depois de entrar por /mcp, o claude -p reutiliza o token OAuth guardado. As leituras rodam direto. As escritas exigem cuidado. Ninguém está lá para responder ao prompt do Claude Code, então qualquer ferramenta de escrita que você permitiu com --allowedTools roda direto. Em uma tarefa sem supervisão, permita só as ferramentas de leitura de que ela precisa.
É grátis?
Sim. O plano gratuito custa $0 para 100 tarefas por mês, sem cartão. O Pro começa em $99 por mês e o Team em $249 por mês.
Relatórios e gestão de campanhas do Snapchat. Um comando no Claude Code.