Para conectar o Google Ads ao Claude Agent SDK, adicione um servidor MCP http para https://mcp.paidsync.ai/mcp com sua chave de API do PaidSync.ai no cabeçalho Authorization e liste suas ferramentas em allowedTools. Seu agente poderá então chamar as ferramentas do PaidSync.ai para Google Ads, Meta Ads e outras 12 plataformas.
O que o Agent SDK precisa
O Agent SDK recebe servidores MCP em suas opções. Para um servidor remoto, você precisa de:
- Uma entrada em mcpServers com o tipo
http, a URL e um objeto headers. - allowedTools com o nome das ferramentas, no formato
mcp__paidsync__tool_name. - Uma chave de API do PaidSync.ai em uma variável de ambiente.
O SDK não abre um navegador nem executa um fluxo OAuth interativo, então o caminho é um token no cabeçalho. A documentação da Anthropic diz que as ferramentas MCP precisam de permissão explícita por meio de allowedTools.
Como a conexão funciona
| Configuração | Valor |
|---|---|
| Tipo de servidor | http |
| URL | https://mcp.paidsync.ai/mcp |
| Cabeçalho | Authorization: Bearer, a partir de uma variável de ambiente |
| Nomes das ferramentas | mcp__paidsync__ seguido do nome da ferramenta |
| Limite da chave | Leituras e prévias no Google Ads |
Aplicar uma alteração no Google Ads exige o login OAuth do PaidSync.ai. Se você concluir esse fluxo no seu próprio app, pode enviar o token de acesso no mesmo cabeçalho.
Como conectar o Google Ads ao Claude Agent SDK em 5 passos
Siga na ordem. A caixa de código traz a configuração exata da documentação de MCP do Claude Agent SDK.
Conecte o Google Ads ao PaidSync.ai
Cadastre-se em paidsync.ai e conecte o Google Ads na tela de login do próprio Google.
Crie uma chave de API
Crie uma chave no seu painel e exporte-a como PAIDSYNC_API_KEY.
Adicione o servidor
Passe o trecho abaixo como suas opções.
Permita só o que você precisa
Liste ferramentas de leitura como mcp__paidsync__get_wasted_spend_report em allowedTools.
Confira a mensagem de init
Veja a lista mcp_servers na mensagem de init e confirme que paidsync aparece como conectado.
Claude Agent SDK com PaidSync.ai
import asyncio, os
from claude_agent_sdk import query, ClaudeAgentOptions, ResultMessage
options = ClaudeAgentOptions(
mcp_servers={
"paidsync": {
"type": "http",
"url": "https://mcp.paidsync.ai/mcp",
"headers": {"Authorization": "Bearer " + os.environ["PAIDSYNC_API_KEY"]},
}
},
allowed_tools=["mcp__paidsync__get_wasted_spend_report"],
)
async def main():
async for message in query(prompt="Run get_wasted_spend_report for the last 30 days.", options=options):
if isinstance(message, ResultMessage) and message.subtype == "success":
print(message.result)
asyncio.run(main())Como verificar a conexão
Leia primeiro a mensagem de init. Um status connected para paidsync significa que a chave funciona.
Como o PaidSync.ai protege você
- Permissão explícita. Só as ferramentas em allowedTools rodam sem pedir confirmação.
- Relatórios não alteram nada. Os relatórios de gasto desperdiçado e de desempenho apenas leem sua conta.
- Login para alterações. Uma chave não consegue aplicar uma alteração no Google Ads.
- Um registro de mudanças. As mudanças aplicadas são registradas, na medida do possível, com o resultado de antes e depois.
A configuração segue a documentação do Agent SDK da Anthropic, conferida em 24 de outubro de 2026. Fonte: documentação de MCP do Claude Agent SDK. Todas as ferramentas do Google Ads estão na página do servidor MCP do Google Ads, e a lista completa de clientes está em Conecte seus anúncios.
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.
Perguntas frequentes
O Claude Agent SDK é compatível com servidores MCP remotos?
Sim. A documentação da Anthropic descreve servidores http e sse com cabeçalhos, em Python e TypeScript.
Por que uma chave e não OAuth?
A documentação da Anthropic diz que o SDK não executa um fluxo OAuth interativo. Passe um token nos cabeçalhos.
Como nomeio as ferramentas do PaidSync.ai em allowedTools?
Use mcp__paidsync__ seguido do nome da ferramenta, ou mcp__paidsync__* para todas.
Funciona para o Meta Ads?
Sim. O mesmo servidor expõe ferramentas do Meta Ads. Veja a página do servidor MCP do Meta Ads.
Quanto custa?
O PaidSync.ai é gratuito para 100 tarefas por mês, no valor de $50, sem cartão. O Pro começa em $99 por mês. Veja os preços.
Guias relacionados
O PaidSync.ai roda 630+ ferramentas em 14 plataformas de anúncios e análise. Conecte suas contas uma vez e use-as no assistente de IA em que você já trabalha.
Comece grátis Ver demo