Para conectar o Google Ads ao Agent Development Kit, adicione um McpToolset com StreamableHTTPConnectionParams apontando para https://mcp.paidsync.ai/mcp e envie sua chave de API do PaidSync.ai no cabeçalho Authorization. O agente ADK poderá então chamar as ferramentas do PaidSync.ai para Google Ads, Meta Ads e outras 12 plataformas.
O que o ADK precisa
Os agentes do ADK usam um McpToolset para acessar servidores MCP. Para o PaidSync.ai, você precisa de:
- Um McpToolset com StreamableHTTPConnectionParams e a URL do PaidSync.ai.
- Uma chave de API do PaidSync.ai, criada no seu painel e guardada em uma variável de ambiente.
- Um login do PaidSync.ai com o Google Ads conectado.
A documentação do ADK mostra cabeçalhos nos parâmetros de conexão e diz que o McpToolset também pode gerenciar a renovação de tokens OAuth 2.0 por meio de auth_scheme e auth_credential.
Como a conexão funciona
| Configuração | Valor |
|---|---|
| Classe | McpToolset |
| Conexão | StreamableHTTPConnectionParams |
| URL | https://mcp.paidsync.ai/mcp |
| Cabeçalho | Authorization: Bearer, a partir de uma variável de ambiente |
| Limite da chave | Leituras e prévias no Google Ads |
Aplicar uma alteração no Google Ads exige o login OAuth do PaidSync.ai, e uma chave não consegue fazer isso. Use a chave para agentes de relatórios e mantenha uma pessoa no processo para as alterações.
Google Ads no Google ADK em 5 passos
Siga na ordem. A caixa de código traz a configuração exata da documentação de ferramentas MCP do Google ADK.
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. Nunca a coloque na URL.
Adicione o toolset
Adicione o McpToolset da caixa abaixo às ferramentas do seu LlmAgent.
Execute o agente
Inicie o agente com adk run ou pela interface web e pergunte sobre sua conta.
Confira a chamada da ferramenta
Confirme no log de eventos que uma ferramenta do PaidSync.ai rodou.
Agente ADK com PaidSync.ai
import os
from google.adk.agents import LlmAgent
from google.adk.tools.mcp_tool import McpToolset
from google.adk.tools.mcp_tool.mcp_session_manager import StreamableHTTPConnectionParams
root_agent = LlmAgent(
model="gemini-flash-latest",
name="ads_analyst",
instruction="Answer questions about the user's ad accounts with PaidSync tools.",
tools=[McpToolset(connection_params=StreamableHTTPConnectionParams(
url="https://mcp.paidsync.ai/mcp",
headers={"Authorization": "Bearer " + os.environ["PAIDSYNC_API_KEY"]},
))],
)Como verificar a conexão
Comece com uma pergunta que só lê, como a lista de contas, e confira no log de eventos a chamada da ferramenta.
Como o PaidSync.ai protege você
- Chaves fora das URLs. A chave vai em um cabeçalho, a partir de uma variável de ambiente.
- 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 ADK do Google, conferida em 24 de outubro de 2026. Fonte: documentação de ferramentas MCP do Google ADK. 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
Os agentes do Google ADK podem usar servidores MCP?
Sim. O McpToolset do ADK conecta um agente a servidores MCP remotos por Streamable HTTP.
O ADK precisa de OAuth para o PaidSync.ai?
Não para relatórios. Um cabeçalho Bearer com uma chave de API funciona. O ADK também documenta suporte a OAuth por meio de auth_scheme.
Um agente ADK pode alterar minha conta do Google Ads?
Com uma chave, ele lê e visualiza. Aplicar uma alteração no Google Ads exige o login OAuth.
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