Para conectar Google Ads al Agent Development Kit, añade un McpToolset con StreamableHTTPConnectionParams que apunte a https://mcp.paidsync.ai/mcp y envía tu clave de API de PaidSync.ai en la cabecera Authorization. El agente ADK podrá entonces llamar a las herramientas de PaidSync.ai para Google Ads, Meta Ads y 12 plataformas más.
Qué necesita ADK
Los agentes ADK usan un McpToolset para llegar a los servidores MCP. Para PaidSync.ai necesitas:
- Un McpToolset con StreamableHTTPConnectionParams y la URL de PaidSync.ai.
- Una clave de API de PaidSync.ai, creada en tu panel y guardada en una variable de entorno.
- Una cuenta de PaidSync.ai con Google Ads conectado.
La documentación de ADK muestra cabeceras en los parámetros de conexión, y dice que McpToolset también puede gestionar la renovación de tokens OAuth 2.0 mediante auth_scheme y auth_credential.
Cómo funciona la conexión
| Ajuste | Valor |
|---|---|
| Clase | McpToolset |
| Conexión | StreamableHTTPConnectionParams |
| URL | https://mcp.paidsync.ai/mcp |
| Cabecera | Authorization: Bearer, desde una variable de entorno |
| 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. Usa la clave para agentes de informes y mantén a una persona en el circuito para los cambios.
Cómo conectar Google Ads a Google ADK en 5 pasos
Haz esto en orden. El cuadro de código contiene la configuración exacta de la documentación de herramientas MCP de Google ADK.
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. Nunca la pongas en la URL.
Añade el toolset
Añade el McpToolset del cuadro de abajo a las herramientas de tu LlmAgent.
Ejecuta el agente
Inicia el agente con adk run o con la interfaz web y pregunta por tu cuenta.
Comprueba la llamada a la herramienta
Confirma en el registro de eventos que se ejecutó una herramienta de PaidSync.ai.
Agente ADK con 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"]},
))],
)Cómo comprobar la conexión
Empieza con una pregunta que solo lea, como la lista de cuentas, y revisa en el registro de eventos la llamada a la herramienta.
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 de ADK de Google, comprobada el 24 de octubre de 2026. Fuente: documentación de herramientas MCP de Google ADK. 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
¿Los agentes de Google ADK pueden usar servidores MCP?
Sí. McpToolset de ADK conecta un agente con servidores MCP remotos mediante Streamable HTTP.
¿ADK necesita OAuth para PaidSync.ai?
No para informes. Una cabecera Bearer con una clave de API funciona. ADK también documenta compatibilidad con OAuth mediante auth_scheme.
¿Puede un agente ADK 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