ChatGPT Ads no Claude Code com um comando
Claude Code
Para conectar o ChatGPT 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 acessa suas contas do ChatGPT Ads por 28 ferramentas: relatórios de campanhas, grupos e anúncios, mais criar campanhas, grupos e anúncios em cartão de chat, e pausar, ativar, atualizar e arquivar. O Claude Code pergunta antes de cada ferramenta.
Nível build. O Claude Code pode criar campanhas, grupos de anúncios e anúncios do ChatGPT Ads, e novos grupos de anúncios começam pausados até você ativar.
O comando
O Claude Code conversa com servidores MCP remotos por Streamable HTTP. O PaidSync é um deles. Adicione uma vez e o mesmo terminal que edita seu código pode gerar relatórios e gerenciar suas campanhas do ChatGPT Ads.
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 ChatGPT Ads no painel do PaidSync
Clique em Conectar no ChatGPT Ads. Entre com a conta da OpenAI que consegue abrir sua conta de anúncios no ChatGPT Ads Manager e cole sua API key do OpenAI Ads. Crie a chave em Settings da sua conta de anúncios no ChatGPT Ads Manager em ads.openai.com. Cada chave conecta exatamente uma conta de anúncios, e chaves de platform.openai.com são recusadas. O PaidSync criptografa a chave em repouso.
Já está dentro do Claude Code? Peça para ele executar connect_openai_ads. A ferramenta devolve um link para o seu painel do PaidSync, onde você cola a chave.
3Escolha a conta de anúncios em que o Claude Code deve trabalhar
Dentro de uma sessão, list_openai_accounts mostra suas contas conectadas do ChatGPT Ads, e set_active_openai_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, pergunte: “Show me my ChatGPT Ads campaigns for the last 7 days with spend, clicks and impressions”
O Claude Code devolve gasto, cliques e impressões de cada campanha. 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 do ChatGPT Ads no Claude Code
Cada prompt abaixo corresponde a ferramentas do grupo ChatGPT Ads do PaidSync. O Claude Code escolhe a ferramenta. A última coluna diz se a chamada pode alterar algo na conta de anúncios.
| Pedido | Ferramentas que chama | Altera sua conta? |
|---|---|---|
| “List my ChatGPT Ads accounts and make Acme the active one” | list_openai_accounts, set_active_openai_account | Não |
| “Show campaigns for the last 7 days with spend, clicks and impressions” | list_openai_campaigns, get_openai_performance | Não |
| “List every ad group in the Spring Sale campaign with its status” | list_openai_adgroups | Não |
| “Which ads are live right now” | list_openai_ads | Não |
| “Pause the Retargeting ad group” | pause_openai_adgroup | Sim, depois que você confirma |
| “Create a campaign called Spring Launch with a daily budget” | create_openai_campaign | Sim, depois que você confirma |
| “Archive the old Winter campaign” | archive_openai_campaign | 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 ChatGPT Ads performance by campaign and list the campaigns with spend and no clicks." \
--allowedTools "mcp__paidsync" \
--output-format json > reports/chatgpt-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
O PaidSync tem 28 ferramentas do ChatGPT Ads que leem, criam e gerenciam. As leituras cobrem contas, campanhas, grupos de anúncios, anúncios, desempenho e segmentações geográficas.
Ler mais
As escritas cobrem criar campanhas, grupos de anúncios e anúncios em cartão de chat, enviar imagens de criativo e pausar, ativar, atualizar e arquivar campanhas, grupos de anúncios e anúncios.
Criações e atualizações aparecem antes como prévia por padrão com dry_run, e pausar, ativar e arquivar exigem confirmação explícita.
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 ChatGPT Ads
- Criativo em vídeo não é exposto como ferramenta. Criativos em imagem são enviados com
upload_openai_creative_image. - Não há ferramentas de gerenciamento de públicos. A configuração de públicos fica no ChatGPT Ads Manager.
- Não há alterações de cobrança ou pagamento. Orçamentos sim, formas de pagamento nunca.
- Arquivar é permanente, então o Claude Code avisa antes de executar.
- Criar uma campanha com três grupos de anúncios são quatro tarefas separadas, um objeto por tarefa.
Perguntas frequentes
Como conecto o ChatGPT Ads ao Claude Code?
Cadastre-se em paidsync.ai, conecte o ChatGPT Ads no painel e execute claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp no terminal. Digite /mcp dentro de uma sessão, escolha paidsync e entre com o login do PaidSync.
O Claude Code pode criar campanhas do ChatGPT Ads?
Sim. O ChatGPT Ads é uma plataforma de nível build no PaidSync. O Claude Code pode criar uma campanha, seus grupos de anúncios e anúncios em cartão de chat, e enviar imagens de criativo. As criações aparecem antes como prévia em dry run.
Onde consigo a API key do OpenAI Ads?
Crie-a em Settings da sua conta de anúncios no ChatGPT Ads Manager em ads.openai.com. Cada chave conecta exatamente uma conta de anúncios, então conecte uma chave por conta. Chaves de platform.openai.com são recusadas para anúncios.
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 campanhas do ChatGPT Ads. Um comando.