Para conectar Google Ads al Claude Agent SDK, añade un servidor MCP http para https://mcp.paidsync.ai/mcp con tu clave de API de PaidSync.ai en la cabecera Authorization y enumera sus herramientas en allowedTools. Tu agente podrá entonces llamar a las herramientas de PaidSync.ai para Google Ads, Meta Ads y 12 plataformas más.
Qué necesita el Agent SDK
El Agent SDK recibe los servidores MCP en sus opciones. Para un servidor remoto necesitas:
- Una entrada en mcpServers con tipo
http, la URL y un objeto headers. - allowedTools con el nombre de las herramientas, con el formato
mcp__paidsync__tool_name. - Una clave de API de PaidSync.ai en una variable de entorno.
El SDK no abre un navegador ni ejecuta un flujo OAuth interactivo, así que el camino es un token en la cabecera. La documentación de Anthropic dice que las herramientas MCP necesitan permiso explícito mediante allowedTools.
Cómo funciona la conexión
| Ajuste | Valor |
|---|---|
| Tipo de servidor | http |
| URL | https://mcp.paidsync.ai/mcp |
| Cabecera | Authorization: Bearer, desde una variable de entorno |
| Nombres de herramientas | mcp__paidsync__ seguido del nombre de la herramienta |
| 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. Si completas ese flujo en tu propia app, puedes enviar el token de acceso en la misma cabecera.
Cómo conectar Google Ads al Claude Agent SDK en 5 pasos
Haz esto en orden. El cuadro de código contiene la configuración exacta de la documentación MCP del Claude Agent 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.
Añade el servidor
Pasa el fragmento de abajo como tus opciones.
Permite solo lo que necesitas
Enumera en allowedTools las herramientas de lectura como mcp__paidsync__get_wasted_spend_report.
Revisa el mensaje de init
Mira la lista mcp_servers del mensaje de init y confirma que paidsync aparece como connected.
Claude Agent SDK con 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())Cómo comprobar la conexión
Lee primero el mensaje de init. Un estado connected para paidsync significa que la clave funciona.
Cómo te protege PaidSync.ai
- Permiso explícito. Solo las herramientas de allowedTools se ejecutan sin preguntar.
- 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 Agent SDK de Anthropic, comprobada el 24 de octubre de 2026. Fuente: documentación MCP del Claude Agent 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 Claude Agent SDK admite servidores MCP remotos?
Sí. La documentación de Anthropic describe servidores http y sse con cabeceras, en Python y TypeScript.
¿Por qué una clave y no OAuth?
La documentación de Anthropic dice que el SDK no ejecuta un flujo OAuth interactivo. Pasa un token en las cabeceras.
¿Cómo nombro las herramientas de PaidSync.ai en allowedTools?
Usa mcp__paidsync__ seguido del nombre de la herramienta, o mcp__paidsync__* para todas.
¿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