AdOps MCP

Gestión publicitaria multiplataforma impulsada por IA para el Protocolo de Contexto de Modelos (MCP)

License: MIT TypeScript MCP

Gestiona campañas de Google Ads y Meta Ads, analiza el rendimiento multiplataforma, optimiza presupuestos y detecta anomalías, todo a través de asistentes de IA como Claude, Cursor y VS Code.

Características

Gestión unificada de campañas para Google Ads y Meta Ads
14 herramientas MCP que cubren todo el ciclo de vida publicitario
4 recursos MCP para acceso rápido al panel de control
Informes de rendimiento multiplataforma con métricas normalizadas
Optimización de presupuesto impulsada por IA con recomendaciones accionables
Detección estadística de anomalías (picos de CPC, caídas de CTR, aumentos de gasto)
Análisis de pruebas A/B con puntuación de confianza
Comparativa con benchmarks del sector (9 verticales)
Previsión de gasto y conversiones (7/14/30 días)
Referencia de especificaciones creativas específicas por plataforma
42 pruebas automatizadas (unitarias + flujos de usuario E2E), modo estricto de TypeScript, validación Zod

Inicio rápido

Instalar desde npm

npm i adops-mcp-server

Añadir a tu cliente MCP

{
  "mcpServers": {
    "adops": {
      "command": "node",
      "args": ["path/to/node_modules/adops-mcp-server/dist/index.js"]
    }
  }
}

Construir desde el código fuente

git clone https://github.com/enzoemir1/adops-mcp.git
cd adops-mcp
npm ci && npm run build

Herramientas

Herramienta	Descripción
`platform_connect`	Registrar una conexión de cuenta de Google Ads o Meta Ads
`campaign_list`	Listar y filtrar campañas en todas las plataformas conectadas
`campaign_create`	Crear una nueva campaña con parámetros unificados
`campaign_update`	Actualizar la configuración de la campaña (presupuesto, estado, pujas, programación)
`campaign_pause_resume`	Pausar o reanudar en lote hasta 50 campañas a la vez
`ads_report`	Generar un informe de rendimiento multiplataforma unificado
`budget_analyze`	Analizar la asignación de presupuesto con recomendaciones de optimización
`budget_reallocate`	Transferir presupuesto entre campañas a través de plataformas
`audience_insights`	Obtener desgloses demográficos, geográficos y por dispositivo
`creative_specs`	Obtener requisitos de imagen, vídeo y texto específicos de la plataforma
`anomaly_detect`	Detectar anomalías de rendimiento con sensibilidad configurable
`ab_test_analyze`	Comparar dos campañas con pruebas de significancia estadística
`competitor_benchmark`	Comparar tus métricas con los promedios del sector
`forecast_spend`	Prever el gasto, las conversiones y el ROAS para el próximo periodo

Recursos

Recurso	Descripción
`ads://overview`	Resumen del panel de control multiplataforma
`ads://campaigns`	Todas las campañas activas con métricas clave
`ads://budget`	Asignación de presupuesto entre plataformas
`ads://alerts`	Anomalías de rendimiento recientes y advertencias

Configuración

Todas las integraciones son opcionales. El servidor funciona sin claves API utilizando almacenamiento local para la gestión de campañas y análisis.

Variable	Plataforma	Requerido	Descripción
`GOOGLE_ADS_DEVELOPER_TOKEN`	Google	Para sincronización en vivo	Token de desarrollador de API
`GOOGLE_ADS_CLIENT_ID`	Google	Para sincronización en vivo	ID de cliente OAuth2
`GOOGLE_ADS_CLIENT_SECRET`	Google	Para sincronización en vivo	Secreto de cliente OAuth2
`GOOGLE_ADS_REFRESH_TOKEN`	Google	Para sincronización en vivo	Token de actualización OAuth2
`GOOGLE_ADS_CUSTOMER_ID`	Google	Para sincronización en vivo	ID de cuenta publicitaria (10 dígitos)
`META_APP_ID`	Meta	Para sincronización en vivo	ID de aplicación de Facebook
`META_APP_SECRET`	Meta	Para sincronización en vivo	Secreto de aplicación de Facebook
`META_ACCESS_TOKEN`	Meta	Para sincronización en vivo	Token de acceso de usuario del sistema
`META_AD_ACCOUNT_ID`	Meta	Para sincronización en vivo	ID de cuenta publicitaria (act_XXX)

Consulta .env.example para obtener una plantilla completa.

Métricas unificadas

AdOps normaliza las métricas entre plataformas en un esquema único:

Métrica	Fórmula	Descripción
CTR	clics / impresiones x 100	Tasa de clics (%)
CPC	gasto / clics	Coste por clic
CPM	gasto / impresiones x 1000	Coste por 1000 impresiones
ROAS	ingresos / gasto	Retorno de la inversión publicitaria
CPA	gasto / conversiones	Coste por adquisición
Tasa de conversión	conversiones / clics x 100	Tasa de conversión (%)

Mapeo de campos por plataforma:

Campo AdOps	Google Ads	Meta Ads
`spend`	`cost_micros / 1,000,000`	`amount_spent`
`impressions`	`impressions`	`impressions`
`clicks`	`clicks`	`clicks`
`conversions`	`conversions`	`actions[type=purchase]`
Campaña > Grupo de anuncios	Grupo de anuncios	Conjunto de anuncios

Precios

Nivel	Precio	Características
Gratuito	0 $	1 plataforma, informes de solo lectura, especificaciones creativas, 50 llamadas/día
Pro	29 $/mes	2 plataformas, CRUD completo, detección de anomalías, optimización de presupuesto
Agencia	59 $/mes	Ilimitado, previsión, benchmarking, soporte prioritario

Disponible en MCPize.

Desarrollo

npm run dev        # Hot reload development
npm run build      # Production build
npm test           # Run 42 tests (unit + E2E)
npm run inspect    # Open MCP Inspector

Pruebas

42 pruebas en 5 suites de pruebas:

Almacenamiento: CRUD de conexiones, búsqueda de campañas, agregación de métricas, inserciones por lotes
Análisis: Cálculos de métricas, informes de rendimiento, previsiones, benchmarks
Optimizador: Análisis de presupuesto, reasignación, recomendaciones de escalado/pausa
Anomalías: Detección de picos de CPC, caídas de conversiones, niveles de sensibilidad, clasificación de gravedad
Flujo de trabajo E2E: 14 escenarios de usuario real: conectar plataformas, crear campañas, generar informes, optimizar presupuestos, ejecutar pruebas A/B, detectar anomalías, prever gastos, comparar con el sector

npm test

Licencia

Licencia MIT. Consulta LICENSE para más detalles.

Creado por Automatia BCN.

adops-mcp