PaidSync.ai no Claude Code em 2 minutos

Conecte suas contas de anúncios ao Claude Code: rode claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp, inicie uma sessão, digite /mcp, escolha paidsync e entre com o login do PaidSync.ai. Nenhuma chave é colada.

O Claude Code passa então a trabalhar dentro das suas contas de Google Ads, GA4, Tag Manager e Search Console por um só conector, com Meta Ads e mais nove plataformas no mesmo conector. Ele lê primeiro, e uma mudança difícil de desfazer é confirmada antes.

Duas formas de entrar

Sem terminal. Abra o PaidSync.ai no diretório de conectores do Claude em https://claude.ai/directory/connectors/paidsync-mcpp e clique em Connect.

Ler mais

Entre no PaidSync.ai (grátis, sem cartão) e clique em Approve. Quando o Claude Code está conectado com a mesma conta do claude.ai, o conector aparece em /mcp por conta própria.

A página do Claude Code da Anthropic diz assim: “MCP servers you've added in claude.ai, known as connectors, are automatically available in Claude Code” (code.claude.com/docs/en/mcp, lida em 26 de outubro de 2026).

claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp

Com um comando. O comando acima registra o servidor para o projeto atual.

Ler mais

Adicione --scope user para tê-lo em todos os projetos da sua máquina. claude mcp list confirma que ele está lá. Os cinco passos abaixo mostram como.

Escolha uma forma, não as duas: uma entrada adicionada por comando tem precedência sobre um conector do claude.ai no mesmo endereço, e o /mcp então lista o conector como oculto (mesma página).

O plugin do PaidSync

O plugin instala a mesma entrada de servidor do PaidSync mais seis skills de anúncios. Use-o no lugar do comando acima. Em uma sessão do Claude Code, rode:

/plugin marketplace add https://paidsync.ai/.claude-plugin/marketplace.json
/plugin install paidsync@paidsync

Depois digite /mcp, escolha o servidor do PaidSync e entre com o seu login do PaidSync.

Em um shell, os mesmos dois passos são claude plugin marketplace add https://paidsync.ai/.claude-plugin/marketplace.json e claude plugin install paidsync@paidsync.

O plugin exige o Claude Code 2.1.224 ou posterior, então rode claude update primeiro em uma versão mais antiga.

As seis skills, cada uma também um slash command, com o detalhe completo de cada uma na página de skills:

Wasted Spend Hunter, /paidsync:wasted-spend-hunter. Bloqueia termos de pesquisa do Google Ads que gastam e nunca convertem.
Negative Keyword Triage, /paidsync:negative-keyword-triage. Triagem semanal de termos de pesquisa em bloquear, observar e aproveitar.
Meta Ads Audit, /paidsync:meta-ads-audit. Auditoria da Meta com oito verificações que combina ferramentas de leitura, uma verificação por vez.
Creative Fatigue Scan, /paidsync:creative-fatigue-scan. Encontra anúncios cansados da Meta e depois os pausa ou reequilibra.
LinkedIn Campaign QA, /paidsync:linkedin-campaign-qa. Checklist de lançamento para cada campanha ativa do LinkedIn.
Tracking Health, /paidsync:tracking-health. Encontra rastreamento de conversões quebrado e lê as configurações de consentimento das tags.

Já adicionou o PaidSync com claude mcp add? Mantenha. O Claude Code reconhece o servidor do plugin pela URL e conecta uma vez.

Atualize o plugin com /plugin marketplace update paidsync e remova-o com /plugin uninstall paidsync@paidsync.

Os cinco passos

1

Cadastre-se em paidsync.ai

Dez segundos, login com Google ou e-mail, sem cartão.

2

Conecte Google Ads, GA4, Tag Manager e Search Console no painel do PaidSync.ai

Clique em Conectar no Google Ads. Entre com a conta do Google que acessa suas contas de anúncios. GA4, Tag Manager e Search Console usam o mesmo login do Google. O PaidSync.ai guarda os tokens criptografados em repouso e nunca vê a sua senha do Google. Já está no Claude Code? Peça que ele rode connect_google_ads e abra o link que ele devolver.

3

Escolha as contas que o Claude Code deve ver

Marque as contas que o Claude Code deve ver. Uma conta que você não marcar fica invisível.

4

Adicione o PaidSync ao Claude Code

No seu terminal, rode:

claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp

Inicie 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.

5

Faça a primeira pergunta

“Mostre o desempenho do Google Ads dos últimos 7 dias por campanha.”

O Claude Code devolve impressões, cliques, custo e conversões de cada campanha na conta ativa. A conexão está ativa.

PaidSync, exemplo

Crie sua conta gratuitaContinuar com GoogleContinuar com e-mailSem cartão de crédito

Painel do PaidSync, exemplo

Conectar contas de anúnciosAbre o login da própria plataformaConectado

Contas de anúnciosSua senha fica com a plataformaConectado

No Claude Code, exemplo

Que contas você consegue ver?

Conta principal

Outlet

Lançamento de primavera

Claude Code, exemplo

PaidSync.aiAdicionado no Claude CodeConectado

Conectado com o PaidSyncPronto no seu próximo chatConectado

No Claude Code, exemplo

O que mudou nas minhas contas de anúncios na semana passada?

Veja o que encontrei.

Prospecção$1.240 de gastoROAS 3.4

Remarketing$610 de gastoROAS 5.1

Pesquisa de marca$980 de gastoROAS 2.7

Grátis para começar, sem cartão.

Start free See a Demo

Setup do Claude Code por plataforma

Cada guia abaixo cobre a mesma configuração de um comando e depois os prompts, os nomes das ferramentas, a divisão entre leitura e escrita e os limites de uma plataforma.

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.

Três perguntas para começar

Cada uma só lê. Nada na conta muda.

Audit my Google Ads account and list the five fixes with the most spend behind them.
Which search terms spent money in the last 30 days with zero conversions?
Is the purchase event firing in GA4 right now, and is Google Ads linked to the property?

A primeira roda run_account_audit. A segunda roda get_search_terms_report e get_wasted_spend_report. A terceira roda run_ga4_realtime_report e list_ga4_google_ads_links.

Ler mais

Depois faça a alteração. “Adicione esses cinco termos como negativas de correspondência de frase na campanha Brand” roda add_negative_keywords depois que você confirma.

“Reduza em 20 por cento o orçamento diário da campanha Generic” roda update_campaign_budget primeiro como prévia e depois aplica quando você confirma.

Uma auditoria sem interface com claude -p

A opção -p roda o Claude Code sem a sessão interativa. Entre uma vez por /mcp e o token OAuth guardado é reaproveitado. Uma auditoria matinal que cai em um arquivo fica assim:

claude -p "Run the account-audit workflow on the Acme Google Ads account, \
then list the three highest-impact fixes with the numbers behind each." \
  --allowedTools "mcp__paidsync" \
  --output-format json > reports/audit-$(date +%F).json

As leituras rodam direto, e as escritas também. --allowedTools "mcp__paidsync" libera todas as ferramentas do PaidSync, escritas incluídas, sem pedido, e o PaidSync não gera cartão de aprovação por MCP.

Ler mais

Para uma tarefa agendada, libere só as ferramentas de leitura de que ela precisa, cada uma pelo nome como mcp__paidsync__tool_name.

Coloque a mesma linha em uma tarefa agendada e você tem uma auditoria diária em Google Ads, Meta Ads, TikTok Ads e LinkedIn Ads sem nenhum painel aberto.

Para chamar as mesmas ferramentas de um agente que você mesmo escreve, veja como chamar o PaidSync do seu próprio agente.

O que evita um erro

Mudanças difíceis de desfazer são confirmadas antes.

O Claude Code pergunta antes de rodar cada ferramenta, a menos que você a tenha liberado com --allowedTools ou nas suas configurações.
O PaidSync.ai acrescenta verificações próprias. A maioria das escritas no Google Ads mostra uma prévia com dry_run, então a primeira chamada mostra a alteração e uma segunda chamada a aplica.
Exclusões, pausas e mudanças de orçamento exigem confirm_destructive, e uma mudança de orçamento de mais de 50 por cento exige ainda confirm_large_change. remove_campaign é permanente no Google Ads, então use pause_campaign quando você só quiser parar a veiculação.
As alterações aplicadas são registradas, na medida do possível, com um resultado de antes e depois em 7 dias. Cartões de aprovação, e Desfazer em um cartão aplicado cuja alteração tem uma inversa segura, valem apenas no workspace do PaidSync.

No Tag Manager, publish_gtm_version exige confirm, porque publicar entra no ar no seu site na hora.

As escritas no GA4 não têm simulação e se aplicam na primeira chamada, então leia os argumentos no pedido do Claude Code antes de liberá-las. O Search Console é somente leitura.

Todas as plataformas, um conector

A mesma entrada de servidor cobre as 14 plataformas. As contagens abaixo vêm do registro atual de ferramentas do PaidSync. Criar significa que o Claude Code pode criar campanhas.

Gerenciar significa pausar, ativar, orçamento e configurações em campanhas existentes. Configurar significa que ele escreve configuração de rastreamento ou de feed. Observar significa somente leitura.

Google Ads

158 ferramentas, nível de criação. Campanhas, grupos de anúncios, palavras-chave, negativas, lances, públicos, RSAs, relatórios. Veja o pilar Google Ads MCP e a configuração Google Ads ao Claude.

Meta Ads

92 ferramentas, nível de criação. Campanhas, conjuntos de anúncios, anúncios, públicos, fadiga de criativos, relatórios. Veja o pilar Meta Ads MCP e a configuração Meta Ads ao Claude.

TikTok Ads

24 ferramentas, nível de gerenciamento. Pausar, ativar, orçamento e configurações em campanhas existentes, além de relatórios. Veja o pilar TikTok Ads MCP e a configuração TikTok Ads ao Claude.

LinkedIn Ads

34 ferramentas, nível de criação. Grupos de campanhas, campanhas, criativos, relatórios. Veja o pilar LinkedIn Ads MCP e a configuração LinkedIn Ads ao Claude.

Merchant Center

16 ferramentas, nível de configuração. Operações de produtos e feeds, verificações de reprovação, nunca campanhas. Veja o pilar Merchant Center MCP e a configuração Merchant Center ao Claude.

Google Analytics 4

26 ferramentas, nível de configuração. Relatórios e escritas na configuração de rastreamento, como eventos e conversões. Veja o pilar GA4 MCP e a configuração GA4 ao Claude.

Search Console

6 ferramentas, nível de observação. Somente leitura. Análise de pesquisa, desempenho de consultas e páginas, cobertura do índice, útil para relatórios de pago e orgânico em um só prompt. Veja a configuração Search Console ao Claude.

Microsoft Ads, Snapchat Ads, Reddit Ads, Pinterest Ads, X Ads, ChatGPT Ads e Google Tag Manager usam o mesmo conector. A lista completa está na página do servidor MCP.

PaidSync e o servidor MCP oficial do Google Ads

O Google lança seu próprio servidor MCP para o Google Ads. Ele serve bem se você só precisa consultar uma plataforma e não se importa de rodar o servidor. Os dois foram feitos para trabalhos diferentes.

	Servidor MCP oficial do Google Ads	PaidSync
Acesso	Read, plus assets and labels since v0.0.6 (2 Nov 2026)	Leitura e escrita, simulação na maioria das criações, confirmação nas mudanças destrutivas
Ferramentas	7	630+
Plataformas	Só Google Ads	14, incluindo Meta Ads, TikTok Ads e LinkedIn Ads
Hospedagem	Auto-hospedado, você mesmo o roda	Hospedado em https://mcp.paidsync.ai/mcp
Login a partir do Claude Code	Suas próprias credenciais da Google Ads API	OAuth 2.0 por /mcp com o seu login do PaidSync
Fluxos salvos	Nenhuma	Cinco fluxos oficiais mais os seus
Preço	Grátis, mais a sua hospedagem	Grátis para começar, sem cartão

Fontes, verificadas em 2026-09-01: developers.google.com/google-ads/api/docs/developer-toolkit/mcp-server e github.com/googleads/google-ads-mcp.

Ler mais

A Meta mantém em beta aberto seu próprio servidor de leitura e escrita em mcp.facebook.com/ads desde 29 de abril de 2026, liberado por conta de anúncios.

O TikTok tem um MCP oficial de Ads desde 13 de maio de 2026. O LinkedIn não tem servidor oficial em setembro de 2026.

Escolha sua plataforma

O mesmo endpoint e o mesmo login em todas elas.

Perguntas frequentes

Preciso de um developer token do Google Ads ou de uma chave de API?

Não. O PaidSync.ai é um servidor hospedado em https://mcp.paidsync.ai/mcp. Você entra no Google por OAuth do Google no painel do PaidSync.ai e no PaidSync.ai por /mcp no Claude Code.

O Claude Code pode alterar minhas campanhas?

Sim. Ele pode adicionar negativas, alterar orçamentos, pausar e ativar campanhas e criar campanhas de Search pausadas, e pode alterar tags do Tag Manager e eventos-chave do GA4. O Claude Code pergunta antes de rodar cada ferramenta, a menos que você a tenha liberado. A maioria das escritas no Google Ads mostra uma prévia em simulação antes, e exclusões, pausas e mudanças de orçamento exigem uma confirmação explícita.

Já conectei o PaidSync.ai no claude.ai. Ainda preciso do comando?

Não. Entre no Claude Code com a mesma conta do claude.ai e digite /mcp; o conector aparece com uma marca do claude.ai. Se você também rodou o comando para o mesmo endereço, o Claude Code usa a entrada do comando e mostra o conector como oculto, então mantenha só um dos dois. Os conectores do claude.ai não carregam quando o Claude Code roda com uma chave de API ou com um token claude setup-token (página da Anthropic, lida em 26 de outubro de 2026).

Funciona sem interface com claude -p?

Sim. Entre uma vez por /mcp e o claude -p reutiliza o token guardado. As leituras rodam direto. As escritas pedem cuidado: ninguém está lá para responder ao pedido do Claude Code, então qualquer ferramenta de escrita liberada com --allowedTools roda direto. Para uma tarefa sem supervisão, libere só as ferramentas de leitura de que ela precisa, cada uma pelo nome como mcp__paidsync__tool_name.

O que recebo para GA4, Tag Manager e Search Console?

26 ferramentas do GA4 (11 de leitura, 13 de escrita), 39 ferramentas do Tag Manager (18 de leitura, 19 de escrita) e 6 ferramentas do Search Console, todas de leitura, pelo mesmo login do Google do Google Ads. O GA4 cobre propriedades, fluxos de dados, eventos-chave, dimensões personalizadas, públicos, vínculos com o Google Ads e relatórios; o Tag Manager cobre contêineres, workspaces, tags, acionadores, variáveis, versões e publicação; o Search Console cobre consultas, páginas, países e cobertura do índice.

Como isto é diferente do servidor MCP oficial do Google Ads?

Google's official server ships 7 tools, covers Google Ads only, and you host it yourself; since its 2 Nov 2026 release it also creates assets and manages labels, with a propose-and-confirm step. PaidSync is hosted at https://mcp.paidsync.ai/mcp, covers 14 platforms with 630+ tools, and can apply changes, with a dry run before most creates and an explicit confirm on destructive ones. Details at developers.google.com/google-ads/api/docs/developer-toolkit/mcp-server.

Minha equipe toda pode compartilhar a mesma configuração?

Sim. Faça commit de um .mcp.json na raiz do repositório com uma entrada paidsync do tipo http e url https://mcp.paidsync.ai/mcp. Cada engenheiro que abrir o projeto recebe o conector e entra com o próprio login do PaidSync. Adicione --scope user ao comando claude mcp add se você o quiser em todos os projetos da sua máquina.

Que plataformas o Claude Code recebe pelo PaidSync?

Google Ads, Meta Ads, LinkedIn Ads, TikTok Ads, Microsoft Ads, Snapchat Ads, Reddit Ads, Pinterest Ads, X Ads, ChatGPT Ads, Google Tag Manager, Google Analytics 4, Google Search Console e Google Merchant Center. Catorze plataformas, um endpoint, um login.