Agency AI
Agency AI MCP convierte a Claude y ChatGPT en un administrador de anuncios completo para tus cuentas publicitarias de Meta (Facebook, Instagram) y Google.
Documentación
Servidor MCP de Agency AI
Convierte a Claude y ChatGPT en un CMO para tus anuncios de Meta y Google
🎯 Gestión completa de anuncios en el chat | 📊 Información de rendimiento en tiempo real | ⚡ Creación y edición de anuncios | 💰 Optimización de presupuesto
Conéctate una vez. Tu asistente analiza, lanza, optimiza y reporta sobre tus campañas, según el horario que establezcas.
Funciona con cualquier plataforma de comercio electrónico o sitio web. La automatización más profunda en Shopify.
📋 Tabla de Contenidos
- Resumen
- Lo Que Puedes Hacer
- Referencia de Herramientas
- Gestión de Anuncios y Piloto Automático
- Plataformas
- Requisitos
- Inicio Rápido
- Ejemplos de Prompts
- Preguntas Frecuentes
- Enlaces
🎯 Resumen
Agency AI MCP convierte a Claude y ChatGPT en un CMO para tus cuentas de anuncios de Meta (Facebook, Instagram) y Google. Dales un objetivo en lugar de una lista de tareas — "mantén mi ROAS combinado por encima de 3 y escala lo que funciona" — y analiza, lanza, optimiza y reporta sin salir del chat:
✨ Análisis de Rendimiento – datos de campañas, desgloses, NCROAS y KPIs avanzados 🎯 Estrategia – orientación de presupuesto, recomendaciones creativas, planes de escalado ⚡ Creación y Edición de Anuncios – crea anuncios optimizados para conversiones, actualiza presupuestos, pausa o lanza campañas 🤖 Piloto Automático – programa la gestión recurrente de anuncios con las tareas programadas de Claude y ChatGPT ⏱️ Rápido y Eficiente – respuestas más rápidas con menor gasto de tokens que los MCP directos a plataformas publicitarias
🎨 Lo Que Puedes Hacer
📊 Analista
Obtén datos de campañas, desgloses de rendimiento, NCROAS y KPIs avanzados en Meta y Google. Comprende qué funciona y qué no.
💡 Example: "Compare my top 5 campaigns by ROAS last month"
🎯 Estratega
Recibe orientación de presupuesto, recomendaciones creativas, planes de escalado y estrategias de planificación de campañas multicanal.
💡 Example: "Which campaigns should I scale and why?"
⚡ Gestor de Anuncios
Crea nuevos anuncios, pausa los de bajo rendimiento, ajusta presupuestos y lanza campañas en Meta y Google en segundos, sin salir del chat. Ponlo en un horario y tu cuenta se gestiona sola.
💡 Example: "Pause all campaigns with ROAS below 2:1"
🧰 Referencia de Herramientas
15 herramientas: 10 herramientas de lectura para análisis y 5 herramientas de escritura para la gestión de anuncios.
📖 Herramientas de lectura
| Herramienta | Qué devuelve |
|---|---|
get_brand_info | Perfil de la marca y economía: qué vende la tienda, su audiencia y el ROAS de punto de equilibrio |
get_campaigns | Campañas de Meta + Google con gasto, ingresos, ROAS, impresiones, clics, conversiones y objetivo |
get_adsets | Conjuntos de anuncios de Meta (con presupuesto diario y rendimiento) o grupos de activos de Google |
get_ads | Anuncios de Meta con rendimiento para el rango de fechas, ordenados por gasto; también el selector de anuncios fuente para create_ad |
get_ad_creative | El creativo de un anuncio de Meta: tipo, texto principal, titular, descripción, CTA, página de destino, URLs de medios |
get_performance_timeseries | Gasto diario, ingresos y ROAS por plataforma conectada: una fila por plataforma por día, cada una con un data_status (complete, partial, not_synced, error) y last_synced_at por plataforma; la ventana es de máximo 366 días |
get_pacing | Gasto de lo que va del mes frente al presupuesto mensual que estableciste, por plataforma: una plataforma cuyo gasto no se pudo obtener se marca como available: false sin cifra de gasto, y spendComplete: false indica que el total la excluye |
get_anomalies | Días estadísticamente inusuales de gasto/ROAS en los últimos 30 días |
get_recommendations | Recomendaciones de optimización con IA, con razonamiento y confianza |
get_operation_status | Progreso, resultado o error de una creación de anuncio en cola |
✍️ Herramientas de gestión de anuncios (escritura)
| Herramienta | Qué cambia |
|---|---|
create_ad | Crea una nueva campaña, conjunto de anuncios o anuncio de Meta, con creativo nuevo optimizado para conversiones o el creativo de un anuncio existente |
update_campaign | Nombre de campaña, presupuesto diario y/o estado: Meta y Google |
update_adset | Nombre de conjunto de anuncios de Meta, presupuesto diario y/o estado; nombre y/o estado de grupo de activos de Google |
update_ad | Nombre y/o estado de anuncio de Meta |
set_campaign_status | Inicia o pausa hasta 25 campañas en una sola llamada, en ambas plataformas |
⚡ Gestión de Anuncios y Piloto Automático (herramientas de escritura)
Cinco herramientas de escritura permiten a Claude o ChatGPT crear anuncios, editar campañas y actuar directamente sobre tu cuenta de anuncios. Nada se ejecuta sin ti: tu asistente confirma cada escritura contigo antes de ejecutarla; consulta las Salvaguardas a continuación.
🛠️ Qué hace cada herramienta de escritura
create_ad – Crea una nueva campaña, conjunto de anuncios o anuncio de Meta. El creativo proviene de uno de dos lugares: creativo y texto nuevos optimizados para conversiones generados por Agency AI, o un anuncio existente que indiques (se reutiliza su creativo). placement decide cuánta estructura se crea:
placement | Qué se crea |
|---|---|
new-campaign | Campaña + conjunto de anuncios + anuncio (requiere un presupuesto diario) |
new-adset | Conjunto de anuncios + anuncio dentro de una campaña existente |
existing-adset | Solo el anuncio, dentro de un conjunto de anuncios existente |
La creación se ejecuta en segundo plano y devuelve un operation_id; pide a tu asistente que lo revise y llamará a get_operation_status. El horario de un conjunto de anuncios fuente no se hereda: el nuevo conjunto de anuncios se ejecuta sin fecha de finalización a menos que proporciones una futura.
update_campaign – Renombra una campaña, cambia su presupuesto diario y/o la inicia/pausa, en Meta o Google. Cada campo informa su propio resultado, por lo que un resultado parcial ("renombrada, pero el presupuesto fue rechazado") se comunica con honestidad en lugar de un fallo general.
update_adset – Los mismos tres campos para un conjunto de anuncios de Meta. Los grupos de activos de Google solo admiten nombre y estado; su presupuesto vive en la campaña.
update_ad – Renombra o inicia/pausa un anuncio de Meta. Solo Meta: Google Performance Max no tiene un nivel de anuncio separado.
set_campaign_status – Inicio/pausa masivo de hasta 25 campañas en una sola llamada, mezclando Meta y Google. Cada campaña tiene éxito o falla de forma independiente y el resultado enumera cada resultado, por lo que una identificación incorrecta nunca bloquea al resto.
🤖 Piloto Automático
Combina las herramientas de escritura con las tareas programadas integradas de Claude y ChatGPT y la gestión rutinaria de anuncios se ejecuta sola. Establece la regla una vez en inglés sencillo; tu asistente la ejecuta según el horario:
- Una revisión diaria a las 9 a. m. que pausa cualquier cosa por debajo del ROAS de punto de equilibrio
- Un reequilibrio de presupuesto los lunes hacia los ganadores de la semana pasada
- Un escaneo diario de anomalías que señala gastos inusuales antes de que se acumulen
🛡️ Salvaguardas
- 🔐 Solo tu cuenta – la cuenta se resuelve desde tu conexión verificada, nunca desde lo que el asistente pasa. Las identificaciones que no pertenecen a tu cuenta conectada de Meta o Google se rechazan antes de escribir cualquier cosa.
- ✅ Confirmación primero – las herramientas de escritura se declaran a Claude y ChatGPT como destructivas (
readOnlyHint: false,destructiveHint: true), por lo que tu asistente pregunta antes de ejecutar una y el cliente puede mostrar su propio aviso de aprobación. El servidor también instruye al modelo a confirmar contigo antes de cualquier escritura. - 💰 Tope de presupuesto – los presupuestos diarios de Meta están limitados a $1–$5,000/día, en el chat exactamente igual que en el panel.
- 📋 Mismo proceso que el panel – las escrituras pasan por los mismos servicios y verificaciones de propiedad que usa el panel de Agency AI, y cada cambio llega a tu registro de actividad.
- 📊 Medido – cada llamada de herramienta se registra para tu cuenta (herramienta, duración, tamaño de respuesta, errores), por lo que lo que hizo tu asistente es auditable.
- ↩️ Reversible – cualquier cosa pausada se puede reactivar de la misma manera. Una creación de anuncio en cola se puede verificar con
get_operation_status; pausa el resultado si cambias de opinión.
🛒 Plataformas
Agency AI MCP funciona con cualquier plataforma de comercio electrónico o sitio web: conecta tus cuentas de anuncios de Meta y Google y todo lo anterior funciona.
¿Usas Shopify? La aplicación de Agency AI para Shopify añade una capa de datos más profunda: ingresos de la tienda comparados con el gasto publicitario, NCROAS y KPIs avanzados, para el análisis y la automatización más precisos. La recomendamos para tiendas de Shopify.
¿No usas Shopify? Crea una cuenta independiente de Agency AI en agencyai.app/mcp y conecta tus cuentas de anuncios de Meta y Google directamente.
✅ Requisitos
- ✔️ Una cuenta de Agency AI – instala la aplicación de Shopify o crea una cuenta en cualquier plataforma
- ✔️ Cualquier plan de Claude (incluido el gratuito) O un plan de ChatGPT que admita conectores personalizados
- ✔️ Al menos una cuenta de anuncios conectada (Meta y/o Google) en Agency AI
🚀 Inicio Rápido
URL del Endpoint
https://s.agencyai.app/mcp
Necesitarás esta URL para ChatGPT; Claude encuentra a Agency AI en su directorio de conectores.
📱 Configuración de Claude
- Abre Claude (claude.ai)
- Haz clic en tu perfil → Configuración → Conectores
- Haz clic en Explorar conectores y busca Agency AI
- Haz clic en Conectar
- Inicia sesión con tu cuenta de Agency AI cuando se te solicite
- ✅ ¡Listo! Empieza a preguntarle a Claude sobre tus anuncios
¿No lo ves? Haz clic en Añadir conector personalizado y pega https://s.agencyai.app/mcp.
💬 Configuración de ChatGPT
- Abre ChatGPT (chatgpt.com)
- Haz clic en tu perfil → Configuración → Conectores
- Haz clic en Añadir conector
- Pega:
https://s.agencyai.app/mcp - Inicia sesión con tu cuenta de Agency AI cuando se te solicite
- ✅ ¡Listo! Empieza a preguntarle a ChatGPT sobre tus anuncios
📖 ¿Necesitas pasos detallados? Consulta llms-install.md para ver un recorrido completo.
💬 Ejemplos de Prompts
Prueba estas preguntas con tu Claude o ChatGPT conectado:
📊 Analysis
"How did my Meta campaigns perform last 30 days vs prior 30?"
"Show me my top 10 best-performing ads by ROAS"
"Which campaigns are underperforming and why?"
🎯 Strategy
"Which ads should I iterate on and which should I cut?"
"Where should I shift budget this week?"
"Give me creative recommendations for my top 5 performers"
⚡ Ad Management
"Pause all campaigns with ROAS below 2:1"
"Create a new ad for our bestseller and launch it in a new campaign at $50/day"
"Raise Spring Drop's daily budget to $150"
"Every weekday at 9am, check my account and pause anything below breakeven"
❓ Preguntas Frecuentes
¿Qué es Agency AI MCP? Un servidor MCP que conecta tus cuentas de anuncios de Meta y Google con Claude y ChatGPT. Maneja análisis de rendimiento, optimización de presupuesto, recomendaciones creativas y estrategia de escalado, y crea anuncios, edita campañas y ejecuta tu cuenta en piloto automático, todo por chat.
¿Necesito Shopify? No. Agency AI MCP funciona con cualquier plataforma de comercio electrónico o sitio web. Las tiendas de Shopify obtienen la capa de datos más profunda y la automatización más precisa a través de la aplicación de Agency AI para Shopify, por lo que la recomendamos si usas Shopify.
¿Claude o ChatGPT pueden realmente crear y editar mis anuncios? Sí. Tu asistente puede crear nuevos anuncios optimizados para conversiones, cambiar presupuestos y nombres, y pausar o lanzar campañas, conjuntos de anuncios y anuncios en Meta y Google.
¿Cambiará algo sin mi aprobación? No. Las herramientas de escritura se declaran destructivas para que tu asistente confirme contigo antes de actuar. Los cambios tienen tope de presupuesto, verificación de propiedad y cada uno llega a tu registro de actividad.
¿En qué se diferencia de conectar los MCP de Meta o Google directamente? Un solo conector cubre ambas plataformas con KPIs precalculados, una capa de estrategia y creación de anuncios integrada. Las respuestas llegan más rápido con menor gasto de tokens que los MCP directos a plataformas publicitarias.
¿Cuánto cuesta? El acceso a MCP está incluido en los planes de Agency AI. Crea una cuenta en agencyai.app/mcp para comenzar.
🔗 Enlaces
| Enlace | Propósito |
|---|---|
| 🌐 Sitio web | Aprende más sobre Agency AI |
| 🚀 Comenzar | Crea una cuenta y conéctate |
| 🛍️ Aplicación de Shopify | Instala desde la tienda de aplicaciones de Shopify |
| 📧 Soporte | Obtén ayuda o envía comentarios |
📄 Licencia
Este proyecto está licenciado bajo la Licencia Apache 2.0; consulta el archivo LICENSE para más detalles.