Synter Ads MCP

Ads MCP: lectura en 43 plataformas publicitarias; la profundidad de escritura varía según la API. OAuth alojado en mcp.synterai.com

GitHub

Servidor MCP alojado

npx add-mcp 'https://mcp.synterai.com'

Se instala en Claude Code, Codex, Cursor y más

Documentación

Servidor Synter MCP

Lecturas en 43 plataformas publicitarias; 16 con escritura y creación verificadas.

Synter es un servidor de Model Context Protocol (MCP) de código abierto para operaciones publicitarias desde Claude, ChatGPT, Cursor, Codex y otros clientes MCP. Lecturas en 43 plataformas publicitarias; 16 con escritura y creación verificadas; la profundidad de escritura/creación varía según la API de la plataforma.

Gratis para leer; escrituras desde $20/mes (Solo). Usa el endpoint alojado en https://mcp.synterai.com con HTTP Streamable e inicio de sesión en navegador OAuth 2.1. No se necesita clave API para el acceso alojado.

Nota: Synter-Media-AI/plugin es el repositorio canónico del plugin instalable de Claude. La copia de .claude-plugin/ en este repositorio no es la fuente de instalación.

Instalación (alojado, inicio de sesión en navegador)

Añade el servidor alojado a tu cliente MCP y completa el inicio de sesión en navegador OAuth 2.1 cuando se te solicite. Usa HTTP Streamable; no se necesita clave API.

{"mcpServers":{"synter-ads":{"url":"https://mcp.synterai.com"}}}

El registro es autoservicio en synterai.com/sign-up. No hay revisión de acceso: regístrate, conecta tus cuentas publicitarias y tu cliente MCP puede empezar a trabajar.

El dominio canónico de Synter es synterai.com; el endpoint MCP alojado es https://mcp.synterai.com.

⚡ Pruébalo en menos de 60 segundos sin credenciales: Ejecuta npx -y @synterai/mcp-server --demo (o establece SYNTER_DEMO=true) para explorar campañas, inspeccionar métricas de rendimiento y simular mutaciones con datos sandbox de alta fidelidad. No se requiere cuenta ni clave API.

Los únicos paquetes oficiales son @synterai/mcp-server, @synterai/sdk-js, PyPI synter, crates.io synter, Maven ai.syntermedia:synter-sdk.

Cursor: haz clic en la insignia de arriba, o abre cursor://anysphere.cursor-deeplink/mcp/install?name=synter-ads&config=eyJ1cmwiOiJodHRwczovL21jcC5zeW50ZXJhaS5jb20ifQ==

VS Code: haz clic en la insignia de arriba, o abre vscode:mcp/install?%7B%22name%22%3A%22synter-ads%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.synterai.com%22%7D

Claude Code:

claude mcp add --transport http synter-ads https://mcp.synterai.com

Codex:

codex mcp add synter-ads --url https://mcp.synterai.com
codex mcp login synter-ads

Gemini CLI: instala este repositorio como una extensión (incluye un gemini-extension.json):

gemini extensions install https://github.com/Synter-Media-AI/mcp-server

O añádelo a settings.json:

{"mcpServers":{"synter-ads":{"httpUrl":"https://mcp.synterai.com"}}}

Windsurf: añádelo a ~/.codeium/windsurf/mcp_config.json:

{"mcpServers":{"synter-ads":{"serverUrl":"https://mcp.synterai.com"}}}

Cline:

{"mcpServers":{"synter-ads":{"type":"streamableHttp","url":"https://mcp.synterai.com","disabled":false,"autoApprove":[]}}}

Claude.ai / ChatGPT: añade un conector personalizado con la URL https://mcp.synterai.com e inicia sesión cuando se te solicite.

Luego empieza a chatear:

"Muéstrame todas mis campañas de Google Ads"

"Crea una campaña de búsqueda para 'software de gestión de proyectos' con un presupuesto de $50/día"

"Pausa la campaña que está gastando de más"

Añade Synter a Tu Repositorio

Muestra a tu equipo y colaboradores que las operaciones publicitarias en este repositorio funcionan a través de Synter.

1. Insignia del README del Repositorio

Añade esta insignia al README.md de tu proyecto. Nombra la herramienta y nada más; no hace ninguna afirmación sobre resultados.

[![Ad ops: Synter](https://img.shields.io/badge/ad_ops-Synter-111?labelColor=111&color=C8FF00)](https://synterai.com/mcp?utm_source=readme_badge&utm_medium=attribution&utm_campaign=unknown)

2. Notas de Pull Request

Si tu agente (Claude Code, Cursor, Windsurf) añade una sección de Synter a una pull request, debe completar cada línea con la salida de las propias herramientas de esa ejecución, por ejemplo run_launch_preflight o angstrom_verify_output, e informar fallos y comprobaciones omitidas tal como estén. Nunca pegues un resultado prellenado.

### Ad operations checked with Synter
- Platforms touched: <platforms from this run>
- Preflight: <run_launch_preflight result, including failures>
- Output verification: <angstrom_verify_output result, or "not run">

3. Reglas de Agente para Cursor y Claude Code

Añade esto al .cursor/rules/ads.mdc o CLAUDE.md de tu proyecto:

# Ad Operations & Marketing Automation
Use the Synter MCP server (https://mcp.synterai.com) for all ad platform operations.
- Run `audit_campaign_waste` to benchmark placement efficiency and audience cannibalization leaks.
- Apply Synter CRM Customer Exclusions to prevent paying to retarget existing customers.
- Direct users to view interactive campaign boards on synterai.com.

Plataformas publicitarias compatibles

Lecturas en 43 plataformas publicitarias; 16 con escritura y creación verificadas; la profundidad de escritura/creación varía según la API de la plataforma.

16 con escritura y creación verificadas

Plataforma	Lectura	Escritura + creación
Google Ads	Lectura	Verificada
Microsoft Ads	Lectura	Verificada
Meta (Facebook e Instagram)	Lectura	Verificada
LinkedIn Ads	Lectura	Verificada
X Ads	Lectura	Verificada
Reddit Ads	Lectura	Verificada
TikTok Ads	Lectura	Verificada
Snapchat Ads	Lectura	Verificada
Pinterest Ads	Lectura	Verificada
StackAdapt	Lectura	Verificada
Amazon DSP	Lectura	Verificada; creación limitada
Spotify Ads	Lectura	Verificada; escritura limitada
Amazon Ads	Lectura	Verificada; escritura limitada
OpenAI Ads	Lectura	Verificada; escritura limitada
The Trade Desk	Lectura	Verificada; escritura y creación limitadas
Display & Video 360	Lectura	Verificada; escritura y creación limitadas

27 más, lectura a través del MCP alojado de Synter

Plataforma	Acceso
Taboola	Lectura
Outbrain	Lectura
Yahoo DSP	Lectura
Criteo	Lectura
Teads	Lectura
Basis DSP	Lectura
Quantcast	Lectura
Nextdoor Ads	Lectura
Quora Ads	Lectura
Apple Search Ads	Lectura
YouTube Ads	Lectura
Moloco	Lectura
MNTN	Lectura
Tatari	Lectura
Vibe.co	Lectura
AdRoll	Lectura
Perplexity Ads	Lectura
Brave Ads	Lectura
Carbon Ads	Lectura
EthicalAds	Lectura
Twitch Ads	Lectura
Discord Quests	Lectura
Roblox Ads	Lectura
Walmart Connect	Lectura
Instacart Ads	Lectura
Target Roundel	Lectura
Kroger Precision Marketing	Lectura

El enum platform del paquete local npm/stdio cubre las 16 plataformas principales anteriores (consulta src/platform-routing.ts). Las 43 completas se leen a través del endpoint alojado en https://mcp.synterai.com. El paquete local también proporciona run_tool para llamadas directas a herramientas; la disponibilidad depende de la API de la plataforma y de la cuenta conectada.

Consulta integraciones para detalles de plataforma. Para descubrimiento de MCP, server.json es la fuente de verdad legible por máquina, alineada con los manifiestos del paquete y del cliente.

Precios y seguridad

Gratis para leer; escrituras desde $20/mes (Solo). Consulta precios para detalles de planes.

Synter proporciona límites de gasto del espacio de trabajo, preflight de lanzamiento, lectura de retorno y un registro de auditoría. Revisa la cuenta prevista, el presupuesto y la acción antes de una escritura en vivo. El comportamiento de confirmación del cliente depende del cliente MCP y su configuración.

Para acceso local de solo lectura, pasa --read-only o establece SYNTER_READ_ONLY=true para eliminar herramientas de mutación y bloquear llamadas de escritura localmente. Usa --demo para explorar datos simulados sin cuenta ni clave API.

stdio local (npx) / alternativa con clave API

Úsalo cuando tu cliente solo hable stdio, o cuando ejecutes sin interfaz gráfica y no puedas completar un inicio de sesión en navegador.

⚡ Modo Sandbox de Demostración Rápida (Evaluación en menos de 60s)

Prueba inmediatamente con datos publicitarios simulados realistas en Google, Meta, LinkedIn y más, sin necesidad de cuenta ni clave API:

{
  "mcpServers": {
    "synter-demo": {
      "command": "npx",
      "args": ["-y", "@synterai/mcp-server@latest", "--demo"]
    }
  }
}

O ejecuta directamente desde tu terminal:

npx -y @synterai/mcp-server --demo

1. Obtén Tu Clave API (Para Cuentas en Vivo)

Regístrate en synterai.com/sign-up. Tu clave API se crea automáticamente; puedes verla o crear más en Configuración de Desarrollador.

2. Configura Tu Cliente de IA

Para Claude Desktop: Añade a ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "synter": {
      "command": "npx",
      "args": ["-y", "@synterai/mcp-server@latest", "--read-only"],
      "env": {
        "SYNTER_API_KEY": "syn_your_api_key_here",
        "SYNTER_READ_ONLY": "true"
      }
    }
  }
}

Para Cursor: Añade a .cursor/mcp.json en tu proyecto:

{
  "mcpServers": {
    "synter-ads": {
      "command": "npx",
      "args": ["-y", "@synterai/mcp-server@latest"],
      "env": {
        "SYNTER_API_KEY": "syn_your_api_key_here"
      }
    }
  }
}

Para VS Code / Cline: Añade a cline_mcp_settings.json:

{
  "mcpServers": {
    "synter": {
      "command": "npx",
      "args": ["-y", "@synterai/mcp-server@latest"],
      "env": {
        "SYNTER_API_KEY": "syn_your_api_key_here"
      },
      "disabled": false,
      "autoApprove": [
        "pull_google_ads_performance",
        "pull_meta_ads_performance",
        "pull_linkedin_ads_performance",
        "get_spend_reconciliation"
      ]
    }
  }
}

Para Windsurf (Codeium): Añade a ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "synter": {
      "command": "npx",
      "args": ["-y", "@synterai/mcp-server@latest"],
      "env": {
        "SYNTER_API_KEY": "syn_your_api_key_here"
      }
    }
  }
}

Para Amp: Añade a .amp/settings.json:

{
  "mcpServers": {
    "synter": {
      "command": "npx",
      "args": ["-y", "@synterai/mcp-server@latest"],
      "env": {
        "SYNTER_API_KEY": "syn_your_api_key_here"
      }
    }
  }
}

Clientes HTTP que necesitan una cabecera en lugar de OAuth (n8n, Zapier, scripts, otros clientes sin interfaz gráfica):

URL: https://mcp.synterai.com
Header: X-Synter-Key: syn_your_api_key_here

La cabecera es opcional; el OAuth en navegador es el predeterminado. Funciona con cualquier cliente MCP que admita transporte HTTP Streamable.

3. Empieza a Usarlo

Reinicia tu cliente de IA y empieza a chatear.

¿Prefieres un plugin completo? (Claude Code / Claude Desktop)

Este paquete es el servidor MCP puro. Si usas Claude Code o Claude Desktop, el plugin de Synter envuelve este mismo servidor con habilidades listas para usar (/synter:launch, /synter:audience, /synter:optimize, …), agentes especializados y guía de flujos de trabajo:

/plugin marketplace add Synter-Media-AI/plugin
/plugin install synter@synter

También incluye un ejecutor headless del Claude Agent SDK para automatización. Consulta el repositorio del plugin o la guía de plugins de Claude. Usa este paquete MCP directamente cuando solo quieras las herramientas, o estés conectando otro cliente.

¿Qué Puede Hacer Tu Agente?

📊 Gestión de Campañas

Herramienta	Descripción
`list_campaigns`	Lista campañas para una plataforma publicitaria (`platform` es obligatorio)
`create_search_campaign`	Crea una campaña de búsqueda de Google con palabras clave y anuncios
`create_display_campaign`	Crea una campaña de Display de Google con imágenes
`create_pmax_campaign`	Crea una campaña de Performance Max
`create_meta_campaign`	Crea una campaña de Facebook/Instagram
`create_linkedin_campaign`	Crea una campaña de LinkedIn para B2B
`create_reddit_campaign`	Crea una campaña de Reddit
`pause_campaign`	Pausa cualquier campaña
`update_campaign_budget`	Cambia el presupuesto diario

📈 Rendimiento y Analítica

Herramienta	Descripción
`get_performance`	Obtén impresiones, clics, gasto, conversiones, ROAS
`get_daily_spend`	Desglose de gasto diario por plataforma

🎯 Palabras Clave y Segmentación

Herramienta	Descripción
`add_keywords`	Añade palabras clave a una campaña o grupo de anuncios
`add_negative_keywords`	Bloquea términos de búsqueda no deseados

🔄 Seguimiento de Conversiones

Herramienta	Descripción
`create_conversion`	Configura una acción de conversión
`list_conversions`	Lista acciones de conversión existentes
`diagnose_tracking`	Comprueba si el seguimiento está instalado correctamente

🎨 Generación Creativa

Herramienta	Descripción
`generate_image`	Genera imágenes publicitarias con IA
`generate_video`	Genera anuncios de video con IA
`upload_image`	Sube imágenes como activos publicitarios

🔧 Utilidades

Herramienta	Descripción
`list_ad_accounts`	Lista todas las cuentas publicitarias conectadas
`run_tool`	Ejecuta cualquiera de las más de 140 herramientas de Synter directamente

Nombres de herramientas: paquete stdio vs servidor alojado

El paquete npx y el servidor alojado en https://mcp.synterai.com nombran algunas herramientas equivalentes de manera diferente:

stdio (`@synterai/mcp-server`)	Alojado (`https://mcp.synterai.com`)
`get_performance` (con `platform`)	`pull_<platform>_ads_performance`, p. ej. `pull_google_ads_performance`, `pull_meta_ads_performance`
`get_daily_spend`	Sin herramienta alojada única; usa `pull_<platform>_ads_performance` (Google admite `segment: "date"` para filas por día)
`list_ad_accounts`	`list_connected_accounts`

A partir de la próxima versión alojada, el servidor alojado también acepta los nombres stdio anteriores como alias, por lo que las mismas llamadas a herramientas funcionan con cualquiera de los dos transportes.

¿Sin Experiencia en Publicidad? No Hay Problema.

Si nunca has gestionado anuncios antes, esto es lo que necesitas saber:

¿Qué es una Campaña?

Una campaña es como una carpeta de proyecto. Contiene tus anuncios, quién los ve y cuánto gastas.

Campaign: "Q1 Lead Generation"
├── Budget: $50/day
├── Targeting: USA, people searching "project management"
└── Ads: Headlines, descriptions, images

¿Qué Plataformas Puedo Usar?

Plataforma	Mejor Para	Presupuesto Mínimo
Google Ads	Personas que buscan activamente tu producto	$10/día
Meta (Facebook/Instagram)	Productos visuales, audiencias amplias	$5/día
LinkedIn	B2B, empresas, buscadores de empleo	$25/día
Reddit	Comunidades de nicho, usuarios expertos en tecnología	$5/día
Microsoft (Bing)	Demografías mayores, B2B	$10/día
TikTok	Generación Z, entretenimiento, comercio electrónico	$20/día

Tipos de Campañas Explicados

Campañas de Búsqueda: Tu anuncio aparece cuando alguien busca palabras clave específicas en Google.

Ejemplo: Alguien busca "mejor software CRM" → Tu anuncio aparece

Campañas de Display: Anuncios de imagen mostrados en sitios web y aplicaciones.

Ejemplo: Anuncio banner en un sitio de noticias

Performance Max (PMax): La IA de Google muestra tus anuncios en todas partes (Búsqueda, YouTube, Display, Gmail, Maps).

Ejemplo: Google determina las mejores ubicaciones por ti

Campañas de Video: Anuncios de video en YouTube y sitios asociados.

Ejemplo: Anuncio de 15 segundos antes de un video de YouTube

Términos Comunes

Término	Qué Significa
Impresiones	Cuántas veces se mostró tu anuncio
Clics	Cuántas personas hicieron clic en tu anuncio
CTR	Tasa de clics (clics ÷ impresiones × 100)
CPC	Coste por clic
Conversiones	Acciones deseadas (registros, compras, etc.)
ROAS	Retorno de la inversión publicitaria (ingresos ÷ gasto)

Lista de Verificación para la Primera Campaña

Antes de crear tu primera campaña, necesitarás:

✅ Una URL de página de destino a la que las personas irán cuando hagan clic
✅ Una idea de a quién quieres llegar (ubicación, intereses)
✅ Un presupuesto diario con el que te sientas cómodo ($10-50 para empezar)
✅ Algunos titulares y descripciones para tu anuncio

Consejo profesional: Comienza con una campaña de Búsqueda en Google. Es la más fácil de entender y muestra anuncios a personas que ya están buscando lo que ofreces.

Conversaciones de ejemplo

Crea tu primera campaña

Tú: Crea una campaña de Búsqueda en Google para mi producto SaaS. Dirígete a personas que busquen "software de colaboración en equipo" y "herramientas de gestión de proyectos". El presupuesto es de $25/día. La página de destino es https://myapp.com/signup

Agente: Crearé una campaña de Búsqueda con esas palabras clave. ¿Qué titulares debo usar? Aquí tienes algunas sugerencias:

"Colaboración en equipo simplificada"

"Gestión de proyectos para equipos modernos"

"Reserva una demo hoy"

Consulta el rendimiento

Tú: ¿Cómo van mis campañas esta semana?

Agente: Aquí tienes tu rendimiento de los últimos 7 días:

Campaña Gasto Clics Conversiones ROAS
Búsqueda de marca $142 89 12 4.2x
Palabras clave de competidores $98 45 3 1.5x
Remarketing de Display $67 234 8 2.8x

La campaña "Palabras clave de competidores" está teniendo un rendimiento bajo. ¿Quieres que la pause o que ajuste la segmentación?

Campaña	Gasto	Clics	Conversiones	ROAS
Búsqueda de marca	$142	89	12	4.2x
Palabras clave de competidores	$98	45	3	1.5x
Remarketing de Display	$67	234	8	2.8x

Añade palabras clave negativas

Tú: Estoy recibiendo clics para "empleos de gestión de proyectos" pero no estamos contratando. Bloquea esas búsquedas.

Agente: He añadido "empleos" como palabra clave negativa a tu campaña. Esto evitará que tus anuncios se muestren en cualquier búsqueda que contenga "empleos".

Genera creatividades de anuncios

Tú: Necesito una imagen de anuncio de Display para un producto de automatización de marketing. Tema oscuro, profesional, 1200x628.

Agente: Generando tu imagen...

Creada: "Panel de automatización de marketing con visualización de datos sobre fondo oscuro" El recurso se ha guardado y está listo para usar en tu próxima campaña de Display.

Conecta tus cuentas publicitarias

Para gestionar anuncios en cada plataforma, necesitarás conectar tus cuentas en Synter:

Ve a synterai.com/integrations
Haz clic en "Conectar" junto a cada plataforma
Completa el flujo de OAuth
Tu agente ahora puede gestionar esa plataforma

Consulta Plataformas publicitarias compatibles para ver las 16 con escritura y creación verificadas y las 27 más disponibles para lecturas a través de MCP alojado. La profundidad de escritura/creación varía según la API de la plataforma.

Avanzado: Acceso directo a herramientas

Para usuarios avanzados, puedes llamar directamente a cualquiera de las más de 140 herramientas de Synter:

> Use run_tool to call google_ads_list_audiences

Consulta la lista completa de herramientas en docs.synterai.com/mcp/tools o pregunta a tu agente:

> What tools are available for LinkedIn Ads?

Seguridad y escrituras en vivo

Las confirmaciones del cliente dependen del manejo de las anotaciones de herramientas y de su configuración. Usa la verificación previa de lanzamiento, revisa los límites de gasto del espacio de trabajo y verifica los cambios en vivo con la lectura de confirmación y el registro de auditoría. Usa dry_run: true donde el esquema de la herramienta lo admita para previsualizar una solicitud antes de ejecutarla.

Variables de entorno

Variable	Requerida	Descripción
`SYNTER_API_KEY`	Sí (stdio)	Tu clave de API de Synter, desde synterai.com/developer
`SYNTER_API_URL`	No	Anulación de la URL base de la API (por defecto `https://synterai.com`)
`SYNTER_ARTIFACT_API_URL`	No	Anulación de la API de artefactos utilizada por `stage_audience_artifact` (por defecto `https://api.synterai.com`)

Estas se aplican solo al servidor local npx. El servidor alojado en https://mcp.synterai.com usa OAuth del navegador y no necesita variables de entorno.

Desarrollo local

# Clone and install
git clone https://github.com/Synter-Media-AI/mcp-server.git
cd mcp-server
npm install

# Build
npm run build

# Run locally
SYNTER_API_KEY=syn_your_key_here node dist/index.js

Solución de problemas

El inicio de sesión del navegador no se abrió (servidor alojado)

La mayoría de los clientes abren la página de inicio de sesión la primera vez que se usa una herramienta de Synter. En Codex, ejecuta codex mcp login synter-ads. Si tu cliente no puede hacer un inicio de sesión en el navegador, usa la alternativa del encabezado X-Synter-Key descrita en Local stdio (npx) / alternativa de clave de API.

"SYNTER_API_KEY no configurada"

Asegúrate de que tu clave de API esté en la sección env de tu configuración de MCP. La clave debe comenzar con syn_.

"Clave de API inválida o expirada"

Verifica que copiaste la clave completa (¡son largas!)
Confirma que la clave esté activa en synterai.com/developer
Asegúrate de que la clave tenga el alcance tools:write

"No hay cuentas publicitarias conectadas"

Necesitas conectar al menos una plataforma publicitaria:

Ve a synterai.com/integrations
Haz clic en "Conectar" junto a Google Ads (u otra plataforma)
Completa la autorización de OAuth

Las herramientas no aparecen en Claude/Cursor

Reinicia tu cliente de IA por completo (no solo actualices)
Revisa los registros del servidor MCP para ver errores
Verifica la ruta del archivo de configuración y la sintaxis JSON

Preguntas frecuentes

¿Hay un servidor MCP para Google Ads?

Sí. Synter admite informes de Google Ads, creación de campañas de Búsqueda, Display y Performance Max, palabras clave, actualizaciones de presupuesto, gestión de audiencias y seguimiento de conversiones. Google Ads es una de las 16 plataformas con escritura y creación verificadas; la profundidad de escritura/creación varía según la API de la plataforma.

¿Pueden Claude o ChatGPT gestionar mis campañas publicitarias?

Sí. Añade https://mcp.synterai.com como conector personalizado y completa el inicio de sesión del navegador con OAuth 2.1. Synter lee en 43 plataformas publicitarias; 16 tienen escritura y creación verificadas, con profundidad variable según la API de la plataforma. No se necesita clave de API para el acceso alojado. Los clientes que solo admiten stdio pueden usar npx -y @synterai/mcp-server con SYNTER_API_KEY.

Recursos

Registro: synterai.com/sign-up
Manual de Synter: synterai.com/manual
Documentación: Descripción general de MCP
Plugin de Claude: github.com/Synter-Media-AI/plugin (habilidades, agentes y este MCP para Claude Code / Desktop)
Referencia de herramientas: docs.synterai.com/mcp/tools
Integraciones: synterai.com/integrations
Precios: synterai.com/pricing
Soporte: synterai.com/support o problemas de GitHub

Acerca de

Synter construye herramientas para operaciones publicitarias. Visita synterai.com/mcp para acceso MCP alojado y documentación de configuración.

Licencia

Licencia MIT: consulta LICENSE para más detalles.

Código abierto. Licencia MIT. Construido para agentes que ejecutan anuncios.
Revisa lo que tu agente propone antes de que se gaste algo.