Para conectar o Google Ads ao OpenAI Agents SDK, crie um MCPServerStreamableHttp para https://mcp.paidsync.ai/mcp com sua chave de API do PaidSync.ai no cabeçalho Authorization e passe-o ao seu Agent. O agente poderá então chamar as ferramentas do PaidSync.ai para Google Ads, Meta Ads e outras 12 plataformas.
O que o Agents SDK precisa
O SDK oferece duas formas de usar um servidor MCP remoto. O PaidSync.ai funciona com aquela em que o seu código gerencia a conexão:
- MCPServerStreamableHttp, com a URL e os cabeçalhos em seus parâmetros.
- Uma chave de API do PaidSync.ai em uma variável de ambiente. A documentação recomenda um cabeçalho Authorization em vez de uma URL.
- Um login do PaidSync.ai com o Google Ads conectado.
O SDK também tem uma ferramenta MCP hospedada, em que a Responses API da OpenAI faz as chamadas por você. A documentação não descreve o SDK executando um fluxo OAuth, então aqui o caminho é um cabeçalho.
Como a conexão funciona
| Configuração | Valor |
|---|---|
| Classe | MCPServerStreamableHttp |
| URL | https://mcp.paidsync.ai/mcp |
| Cabeçalho | Authorization: Bearer, a partir de uma variável de ambiente |
| Passado para | Agent(mcp_servers=[server]) |
| 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. A configuração de aprovação de ferramentas do SDK pode reter as ferramentas de escrita para uma pessoa.
Como conectar o Google Ads ao OpenAI Agents SDK em 5 passos
Siga na ordem. A caixa de código traz a configuração exata da documentação de MCP do OpenAI Agents 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.
Crie o servidor
Use o trecho abaixo. O gerenciador de contexto assíncrono abre e fecha a conexão.
Passe-o a um Agent
Dê ao Agent mcp_servers=[server] e chame Runner.run.
Confira a chamada da ferramenta
Leia a saída da execução e confirme que uma ferramenta do PaidSync.ai foi usada.
OpenAI Agents SDK com PaidSync.ai
import asyncio, os
from agents import Agent, Runner
from agents.mcp import MCPServerStreamableHttp
async def main():
async with MCPServerStreamableHttp(
name="PaidSync",
params={
"url": "https://mcp.paidsync.ai/mcp",
"headers": {"Authorization": "Bearer " + os.environ["PAIDSYNC_API_KEY"]},
"timeout": 10,
},
cache_tools_list=True,
) as server:
agent = Agent(name="Ads analyst", mcp_servers=[server])
result = await Runner.run(agent, "List my Google Ads accounts.")
print(result.final_output)
asyncio.run(main())Como verificar a conexão
Comece pela lista de contas, que só lê, e depois passe para o relatório de gasto desperdiçado.
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 OpenAI Agents SDK, conferida em 24 de outubro de 2026. Fonte: documentação de MCP do OpenAI Agents 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 OpenAI Agents SDK é compatível com MCP?
Sim. Ele é compatível com ferramentas MCP hospedadas e com servidores Streamable HTTP que o seu código gerencia.
Qual devo usar para o PaidSync.ai?
O MCPServerStreamableHttp com um cabeçalho Bearer é o caminho documentado e simples.
O agente 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