Microsoft Ads no Claude Code com um comando
Claude Code
Para conectar o Microsoft 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 o Microsoft Ads com 156 ferramentas: relatórios de campanhas, palavras-chave e termos, pausas, orçamentos, negativas e novos anúncios. Pergunta antes de cada uma.
Nível Build. O Claude Code trabalha dentro das suas campanhas existentes, e todo novo grupo de anúncios, palavra-chave e anúncio começa pausado, a menos que você diga o contrário.
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 passa a mostrar relatórios e gerenciar suas campanhas da Microsoft.
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 Microsoft Ads no painel do PaidSync
Clique em Conectar no Microsoft Ads e entre com a conta Microsoft que abre suas contas da Microsoft Advertising. O Microsoft Ads autoriza via Microsoft OAuth, e o PaidSync cuida do developer token do lado dele.
Já está dentro do Claude Code? Peça que ele execute connect_microsoft_ads. A ferramenta devolve 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_ms_accounts mostra as contas do Microsoft Ads que o seu login alcança, e set_active_microsoft_account escolhe a conta 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: “Show me my Microsoft Ads campaigns for the last 30 days with spend, clicks, conversions and ROAS”
O Claude Code devolve gasto, cliques, impressões, conversões, receita, CTR, CPC médio e ROAS 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 de Microsoft Ads no Claude Code
Cada prompt abaixo corresponde a ferramentas do grupo Microsoft 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 Microsoft Ads accounts and make Acme the active one” | list_ms_accounts, set_active_microsoft_account | Não |
| “Show campaigns for the last 30 days with spend, clicks, conversions and ROAS” | get_ms_performance | Não |
| “Which search terms spent money in the last 30 days with no conversions” | get_ms_search_query_performance | Não |
| “Add the worst five as exact match negatives to the Brand Search campaign” | add_ms_negative_keywords | Sim, depois que você confirma |
| “Pause the Spring Sale campaign” | pause_ms_campaign | Sim, depois que você confirma |
| “Raise the daily budget on the Brand Search campaign to $80” | update_ms_campaign_budget | Sim, depois que você confirma |
| “Add an ad group called Trail Shoes to the Running campaign with five phrase match keywords and one responsive search ad” | create_ms_adgroup, add_ms_keywords, add_ms_responsive_search_ad | 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 30 days Microsoft Ads search terms and list the terms that spent money with no conversions." \
--allowedTools "mcp__paidsync" \
--output-format json > reports/microsoft-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 156 ferramentas do Microsoft Ads, 82 só leem e 72 podem escrever. As leituras cobrem desempenho de campanhas, grupos de anúncios, palavras-chave, termos de pesquisa, conversões, locais e públicos.
Ler mais
As escritas cobrem pausas, orçamentos, alterações de grupos de anúncios e palavras-chave, palavras-chave negativas, novos grupos de anúncios, palavras-chave e anúncios responsivos de pesquisa, públicos, tags UET e metas de conversão.
Alterações de orçamento, palavras-chave negativas, grupos de anúncios, palavras-chave e anúncios mostram uma prévia por padrão com dry_run, e novos grupos de anúncios, palavras-chave e anúncios começam pausados.
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 na Microsoft
- O PaidSync não cria campanhas de Shopping nem de Público no Microsoft Ads. Crie essas na Microsoft Advertising, ou importe do Google Ads, e o PaidSync passa a construir dentro delas.
- Não há ferramentas do Microsoft Ads para estratégias de lance nem rótulos.
- Anúncios responsivos de pesquisa são o único tipo de anúncio que o PaidSync cria ou edita no Microsoft Ads.
- O PaidSync não exclui anúncios, grupos de anúncios nem palavras-chave. Ele os pausa.
- Ative de novo uma campanha pausada com
enable_ms_campaign.
Perguntas frequentes
Como conectar Microsoft Ads ao Claude Code?
Crie sua conta em paidsync.ai, conecte o Microsoft 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 seu login do PaidSync.
O Claude Code cria campanhas no Microsoft Ads?
O PaidSync cria campanhas de Search e Performance Max, pausadas, e constrói dentro de campanhas existentes com novos grupos de anúncios, palavras-chave e anúncios responsivos de pesquisa. Campanhas de Shopping e de Público são criadas na Microsoft Advertising.
O Claude Code altera orçamentos no Microsoft Ads?
Sim. update_ms_campaign_budget altera o orçamento de uma campanha. Ele mostra antes uma prévia (dry run), lê de volta da Microsoft o novo orçamento depois de aplicado, e o Claude Code pergunta antes de executar a 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 alterações de campanha do Microsoft Ads. Um comando no Claude Code.