Agent Planners
Crea y monitorea tareas de automatización de marketing con IA en Google Ads, GA4, BigQuery y más, desde cualquier cliente MCP.
Documentación
TL;DR
Agent Planners ahora tiene una superficie de integración saliente: una API REST pública y un servidor MCP, ambos autenticados con claves API por organización. Apunta Claude Desktop o Claude Code al servidor MCP, o llama a la API REST desde Codex, un trabajo cron o tu propio script, y puede crear una tarea, consultar su estado y listar tus cuentas conectadas — ejecutándose en el mismo orquestador, los mismos créditos y las mismas escrituras sujetas a aprobación que una tarea iniciada manualmente en el Workspace.
Lo que se incluye
Dos formas de entrada, un mismo motor subyacente: una API REST en /api/v1\ (crear una tarea, consultar su estado e informe, listar cuentas conectadas) y un servidor MCP en /api/mcp\ que expone las mismas tres acciones como herramientas — create\_task\, get\_task\, list\_accounts\. Ambos se autentican de la misma manera: una clave API por organización que generas desde el panel de control, enviada como token Bearer.
Funciona con Claude, Codex o cualquier cosa que hable HTTP
Los clientes MCP se conectan directamente — añade la URL del servidor y tu clave como encabezado Bearer en la configuración MCP de Claude Desktop o Claude Code, y sus tres herramientas aparecerán junto a tus otros servidores MCP.
Todo lo demás — Codex, un trabajo de CI, un script cron, la capa de herramientas de otro framework de agentes — puede impulsar exactamente la misma funcionalidad a través de la API REST simple. Es solo un endpoint HTTP con un token Bearer; no hay ningún requisito específico de MCP para usarlo.
REST vs MCP — mismas acciones, dos formatos
| API REST (/api/v1) | Servidor MCP (/api/mcp) | |
|---|---|---|
| Mejor para | Codex, scripts, CI, cualquier cosa con capacidad HTTP | Claude Desktop, Claude Code, otros clientes MCP |
| Crear una tarea | POST /tasks | herramienta create_task |
| Consultar estado / informe | GET /tasks/:id | herramienta get_task |
| Listar cuentas conectadas | GET /accounts | herramienta list_accounts |
| Autenticación | Authorization: Bearer <key> | Encabezado Authorization en la configuración del cliente MCP |
Las mismas salvaguardas, ahora invocables desde fuera de la aplicación
Esta es una puerta de salida hacia el mismo sistema que usa el Workspace — no un atajo para evitarlo. Una tarea creada a través de la API o MCP ejecuta el pipeline normal de orquestador → especialistas → puerta de aprobación, por lo que nada sobre lo cuidadosamente que se comporta cambia solo porque vino de Codex en lugar de una pestaña del navegador.
- Las claves están limitadas a la organización y se almacenan como un hash — una clave solo puede actuar como su propia organización, y una fuga de base de datos no puede reproducirse contra la API.
- Las tareas externas consumen los créditos de tu organización exactamente igual que una tarea iniciada en el Workspace.
- Las escrituras siguen pasando por la pila de aprobación y salvaguardas de la organización a menos que la tarea establezca explícitamente
autoApprove\— e incluso entonces, los límites de salvaguarda siguen aplicándose. - Las claves están limitadas (
tasks:write\,tasks:read\,accounts:read\), con límite de tasa por clave, y revocables al instante desde el panel de control.
Configúralo
- 1Abre API y MCP en tu panel de control y haz clic en "Nueva clave".
- 2Ponle una etiqueta (por ejemplo, "Claude Desktop — mi portátil" o "Trabajo CI de Codex") y elige los alcances — empieza con los tres a menos que sepas que quieres menos.
- 3Copia la clave sin procesar inmediatamente — se muestra una sola vez y se almacena solo como hash después.
- 4Para un cliente MCP: añade la URL del servidor con la clave como encabezado Bearer en su configuración MCP. Para cualquier otra cosa: llama a la base REST con
Authorization: Bearer <key\>\. - 5Revoca la clave desde la misma página en cualquier momento para cortar el acceso de inmediato.
Preguntas frecuentes
¿Esto evita la puerta de aprobación?
No. Las tareas creadas a través de la API o el servidor MCP ejecutan el mismo orquestador y pipeline de puerta de aprobación que una tarea iniciada en el Workspace — las escrituras siguen pausándose para aprobación a menos que la tarea establezca autoApprove, y los límites de salvaguarda siguen aplicándose en cualquier caso.
¿Puede Codex usar esto, o solo Claude?
Ambos. Claude Desktop y Claude Code (y otros clientes MCP) se conectan directamente al servidor MCP. Codex, un script, un trabajo de CI o cualquier otro agente que pueda enviar una solicitud HTTP puede impulsar la funcionalidad idéntica a través de la API REST simple con la misma clave Bearer.
¿Esto tiene un costo adicional?
No hay precios separados — las tareas creadas externamente consumen los créditos normales de tu organización, igual que una tarea ejecutada desde el Workspace.
¿En qué se diferencia de la documentación MCP existente?
En la dirección opuesta. Añadir tu propio servidor MCP permite que el agente llame a tus herramientas. Esta función permite que un agente externo — Claude, Codex, un script — llame a Agent Planners y ejecute tareas en tus cuentas.
¿Puedo limitar lo que puede hacer una clave?
Sí — cada clave está limitada a tasks:write, tasks:read y/o accounts:read en su creación, y puede revocarse al instante, independientemente de tus otras claves.