Para conectar Google Ads al OpenAI Agents SDK, crea un MCPServerStreamableHttp para https://mcp.paidsync.ai/mcp con tu clave de API de PaidSync.ai en la cabecera Authorization y pásalo a tu Agent. El agente podrá entonces llamar a las herramientas de PaidSync.ai para Google Ads, Meta Ads y 12 plataformas más.
Qué necesita el Agents SDK
El SDK ofrece dos formas de usar un servidor MCP remoto. PaidSync.ai funciona con la que hace que tu código gestione la conexión:
- MCPServerStreamableHttp, con la URL y las cabeceras en sus parámetros.
- Una clave de API de PaidSync.ai en una variable de entorno. La documentación recomienda una cabecera Authorization antes que una URL.
- Una cuenta de PaidSync.ai con Google Ads conectado.
El SDK también tiene una herramienta MCP alojada, en la que la Responses API de OpenAI hace las llamadas por ti. La documentación no describe que el SDK ejecute un flujo OAuth, así que aquí el camino es una cabecera.
Cómo funciona la conexión
| Ajuste | Valor |
|---|---|
| Clase | MCPServerStreamableHttp |
| URL | https://mcp.paidsync.ai/mcp |
| Cabecera | Authorization: Bearer, desde una variable de entorno |
| Se pasa a | Agent(mcp_servers=[server]) |
| Límite de la clave | Lecturas y vistas previas en Google Ads |
Aplicar un cambio en Google Ads necesita el inicio de sesión OAuth de PaidSync.ai, y una clave no puede hacerlo. El ajuste de aprobación de herramientas del SDK puede reservar las herramientas de escritura para una persona.
Cómo conectar Google Ads al OpenAI Agents SDK en 5 pasos
Haz esto en orden. El cuadro de código contiene la configuración exacta de la documentación MCP del OpenAI Agents SDK.
Conecta Google Ads a PaidSync.ai
Regístrate en paidsync.ai y conecta Google Ads en la pantalla de inicio de sesión de Google.
Crea una clave de API
Crea una clave en tu panel y expórtala como PAIDSYNC_API_KEY.
Crea el servidor
Usa el fragmento de abajo. El gestor de contexto asíncrono abre y cierra la conexión.
Pásalo a un Agent
Da al Agent mcp_servers=[server] y llama a Runner.run.
Comprueba la llamada a la herramienta
Lee la salida de la ejecución y confirma que se usó una herramienta de PaidSync.ai.
OpenAI Agents SDK con 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())Cómo comprobar la conexión
Empieza con la lista de cuentas, que solo lee, y luego pasa al informe de gasto desperdiciado.
Cómo te protege PaidSync.ai
- Las claves no van en las URL. La clave va en una cabecera, tomada de una variable de entorno.
- Los informes no cambian nada. Los informes de gasto desperdiciado y de rendimiento solo leen tu cuenta.
- Inicio de sesión para los cambios. Una clave no puede aplicar un cambio en Google Ads.
- Un registro de cambios. Los cambios aplicados se registran, en la medida de lo posible, con un resultado de antes y después.
La configuración sigue la documentación del OpenAI Agents SDK, comprobada el 24 de octubre de 2026. Fuente: documentación MCP del OpenAI Agents SDK. Todas las herramientas de Google Ads están en la página del servidor MCP de Google Ads, y la lista completa de clientes está en Conecta tus anuncios.
Añadir a ChatGPT: abre PaidSync.ai en el directorio de plugins de ChatGPT, instálalo e inicia sesión.
Añadir a Claude: abre PaidSync.ai en el directorio de conectores de Claude, haz clic en Conectar e inicia sesión.
Preguntas frecuentes
¿El OpenAI Agents SDK admite MCP?
Sí. Admite herramientas MCP alojadas y servidores Streamable HTTP que gestiona tu código.
¿Cuál debo usar para PaidSync.ai?
MCPServerStreamableHttp con una cabecera Bearer es la vía documentada y sencilla.
¿Puede el agente cambiar mi cuenta de Google Ads?
Con una clave lee y previsualiza. Aplicar un cambio en Google Ads necesita el inicio de sesión OAuth.
¿Funciona con Meta Ads?
Sí. El mismo servidor expone herramientas de Meta Ads. Consulta la página del servidor MCP de Meta Ads.
¿Cuánto cuesta?
PaidSync.ai es gratis con 100 tareas al mes, por un valor de $50, sin tarjeta. Pro empieza en $99 al mes. Consulta los precios.
Guías relacionadas
PaidSync.ai ofrece 630+ herramientas en 14 plataformas de anuncios y analítica. Conecta tus cuentas una vez y úsalas en el asistente de IA con el que ya trabajas.
Empieza gratis Reserva una demo