Synter Ads

oficial

Gestión de campañas publicitarias multiplataforma para agentes de IA en Google, Meta, LinkedIn, Reddit, TikTok y más. Más de 140 herramientas con acceso de lectura/escritura.

¿Qué puedes hacer con Synter Ads MCP?

  • List campaigns across platforms — Pídele a tu asistente que extraiga todas las campañas de las cuentas publicitarias conectadas con list_campaigns.
  • Create search campaigns — Usa create_search_campaign para lanzar una campaña de Google Search con palabras clave, anuncios y presupuesto.
  • Pause underperformers — Detén cualquier campaña al instante mediante pause_campaign cuando el gasto o el ROAS se vean mal.
  • Pull performance metrics — Obtén impresiones, clics, gasto, conversiones y ROAS con get_performance.
  • Generate ad creatives — Haz que generate_image o generate_video produzcan activos publicitarios listos para subir.
  • Run any of 140+ tools — Accede al catálogo completo de Synter directamente con run_tool para acciones avanzadas.

Documentación

Servidor MCP de Synter

npm version License: MIT

El servidor MCP más completo para publicidad.

Informes en 19 plataformas publicitarias y creación completa de campañas en 14 de ellas (acciones de escritura en 16), abarcando todos los principales canales de compra, con confirmaciones integradas para acciones destructivas.

Crea campañas. Ajusta presupuestos. Pausa las de bajo rendimiento. Genera creatividades. Obtén datos de rendimiento. Todo mediante conversación natural, en Google, Meta, LinkedIn, Microsoft, Reddit, TikTok, X y más.

Este es el primer servidor Model Context Protocol (MCP) que da a los agentes de IA una tarjeta de crédito.

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.


Cómo se Compara Synter

El servidor MCP oficial de Google Ads es de solo lectura por diseño: según la documentación de Google, es "estrictamente de solo lectura" y "no puede modificar pujas, pausar campañas ni crear nuevos activos". La mayoría de los servidores MCP de publicidad de terceros cubren una sola plataforma. Construimos Synter para hacer ambas partes del trabajo, en todos los principales canales de compra, desde un solo servidor.

Synter MCPServidor MCP oficial de Google AdsMCP de publicidad de terceros típicos
AccesoLectura en las 19 plataformas, creación de campañas en 14, acciones de escritura en 16Solo lectura (versión actual)A menudo solo lectura o escritura parcial
Plataformas19 para informes, 14 con creación completa de campañas (listas abajo)Solo Google AdsGeneralmente una sola plataforma
Crear campañas✅ Google Search, Display, PMax, Meta, LinkedIn, Reddit, más vía run_tool❌Raramente
Presupuestos y pausas✅❌Varía
Generación de creatividades con IA✅ Imágenes, video, texto❌❌
Sincronización de audiencias✅ Google, Meta, LinkedIn, Microsoft, Reddit, TikTok, X❌❌
SeguridadConfirmaciones para acciones destructivasn/a (solo lectura)Varía
Código abierto✅ MIT✅Varía

Cobertura de informes (19 plataformas): Google Ads, Microsoft Ads (Bing), Meta (Facebook e Instagram), LinkedIn Ads, X (Twitter) Ads, Reddit Ads, TikTok Ads, Snapchat Ads, Pinterest Ads, Spotify Ads, Amazon Ads, Amazon DSP, Walmart Connect, Instacart Ads, Target Roundel, Criteo, The Trade Desk, Display & Video 360 y OpenAI Ads (ChatGPT).

Creación completa de campañas (14 plataformas): Google Ads, Microsoft Ads, Meta, LinkedIn, X, Reddit, TikTok, Snapchat, Pinterest, Spotify, Amazon Ads (Sponsored Products, Brands y Display), Amazon DSP, The Trade Desk y OpenAI Ads. Display & Video 360 y StackAdapt también admiten acciones de escritura (pausa, actualizaciones de presupuesto y de elementos de línea, carga de audiencias) sin creación de campañas. Las 4 restantes (Walmart Connect, Instacart, Target Roundel y Criteo) son solo de informes por ahora.

El paquete npx incluye herramientas tipadas para las operaciones más comunes, además de acceso run_tool al catálogo completo de más de 140 herramientas de Synter. El servidor remoto en https://mcp.syntermedia.ai/mcp/ expone el conjunto completo de herramientas alojadas, incluidos los informes de rendimiento para cada plataforma mencionada.

Para el descubrimiento de MCP estilo registro, server.json es la fuente de verdad legible por máquina. Mantenlo alineado con package.json, manifest.json y los ejemplos de configuración en este README.


⚠️ Advertencia Justa

Tu agente de IA podrá:

  • Crear campañas que empiecen a gastar tu presupuesto de inmediato
  • Ajustar pujas que afecten cuánto pagas por clic
  • Pausar campañas (a veces eso es algo bueno)
  • Añadir palabras clave que cambien quién ve tus anuncios
  • Generar creatividades y subirlas a tus cuentas

Incorporamos confirmaciones para acciones destructivas. Pero aun así, quizás no se lo des a un agente que acabas de conocer.


Inicio Rápido

1. Obtén Tu Clave de API

Regístrate en syntermedia.ai y crea una clave de API en Developer Settings.

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": ["@synterai/mcp-server"],
      "env": {
        "SYNTER_API_KEY": "syn_your_api_key_here"
      }
    }
  }
}

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

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

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

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

Remoto (Streamable HTTP): Para ChatGPT, n8n, Zapier o cualquier cliente MCP que admita transporte HTTP:

URL: https://mcp.syntermedia.ai/mcp/
Header: X-Synter-Key: syn_your_api_key_here

No se necesita instalación local. Funciona con cualquier cliente MCP que admita transporte Streamable HTTP.

3. Empieza a Usarlo

Reinicia tu cliente de IA y empieza a conversar:

"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"


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

Este paquete es el servidor MCP base. 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 un gancho de seguridad de aprobación antes de gastar:

/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

HerramientaDescripción
list_campaignsLista campañas en todas las plataformas conectadas
create_search_campaignCrea una campaña de Google Search con palabras clave y anuncios
create_display_campaignCrea una campaña de Google Display con imágenes
create_pmax_campaignCrea una campaña de Performance Max
create_meta_campaignCrea una campaña de Facebook/Instagram
create_linkedin_campaignCrea una campaña de LinkedIn para B2B
create_reddit_campaignCrea una campaña de Reddit
pause_campaignPausa cualquier campaña
update_campaign_budgetCambia el presupuesto diario

📈 Rendimiento y Analítica

HerramientaDescripción
get_performanceObtén impresiones, clics, gasto, conversiones, ROAS
get_daily_spendDesglose de gasto diario por plataforma

🎯 Palabras Clave y Segmentación

HerramientaDescripción
add_keywordsAñade palabras clave a una campaña o grupo de anuncios
add_negative_keywordsBloquea términos de búsqueda no deseados

🔄 Seguimiento de Conversiones

HerramientaDescripción
create_conversionConfigura una acción de conversión
list_conversionsLista las acciones de conversión existentes
diagnose_trackingComprueba si el seguimiento está instalado correctamente

🎨 Generación de Creatividades

HerramientaDescripción
generate_imageGenera imágenes de anuncios con IA
generate_videoGenera anuncios de video con IA
upload_imageSube imágenes como activos de anuncios

🔧 Utilidades

HerramientaDescripción
list_ad_accountsLista todas las cuentas publicitarias conectadas
run_toolEjecuta cualquiera de las más de 140 herramientas de Synter directamente

¿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?

PlataformaIdeal ParaPresupuesto Mínimo
Google AdsPersonas que buscan activamente tu producto$10/día
Meta (Facebook/Instagram)Productos visuales, audiencias amplias$5/día
LinkedInB2B, empresas, buscadores de empleo$25/día
RedditComunidades de nicho, usuarios expertos en tecnología$5/día
Microsoft (Bing)Demografías mayores, B2B$10/día
TikTokGeneració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 (Search, 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érminoQué Significa
ImpresionesCuántas veces se mostró tu anuncio
ClicsCuántas personas hicieron clic en tu anuncio
CTRPorcentaje de clics (clics ÷ impresiones × 100)
CPCCoste por clic
ConversionesAcciones deseadas (registros, compras, etc.)
ROASRetorno 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:

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

Consejo profesional: Empieza con una campaña de Search en Google. Es la más fácil de entender y muestra anuncios a personas que ya buscan lo que ofreces.


Conversaciones de Ejemplo

Crea Tu Primera Campaña

Tú: Crea una campaña de Google Search para mi producto SaaS. Segmenta a personas que buscan "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 Search con esas palabras clave. ¿Qué titulares debo usar? Aquí tienes algunas sugerencias:

  • "Colaboración en Equipo Simplificada"
  • "Gestión de Proyectos para Equipos Modernos"
  • "Empieza Gratis - Sin Tarjeta de Crédito"

Consulta el Rendimiento

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

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

CampañaGastoClicsConversionesROAS
Búsqueda de Marca$14289124.2x
Palabras Clave de Competidores$984531.5x
Retargeting de Display$6723482.8x

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

Añade Palabras Clave Negativas

Tú: Estoy recibiendo clics por "gestión de proyectos gratis", pero no tenemos un plan gratuito. Bloquea esos.

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

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" Activo guardado y listo para usar en tu próxima campaña de Display.


Conecta Tus Cuentas Publicitarias

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

  1. Ve a syntermedia.ai/settings/credentials
  2. Haz clic en "Conectar" junto a cada plataforma
  3. Completa el flujo de OAuth
  4. Tu agente ya puede gestionar esa plataforma

Plataformas compatibles (19; ✅ = informes + ejecución completa de campañas, 📊 = solo informes):

  • Google Ads ✅
  • Meta (Facebook/Instagram) ✅
  • LinkedIn Ads ✅
  • Microsoft Ads (Bing) ✅
  • Reddit Ads ✅
  • TikTok Ads ✅
  • X (Twitter) Ads ✅
  • Snapchat Ads ✅
  • Pinterest Ads ✅
  • Spotify Ads ✅
  • Amazon DSP ✅
  • The Trade Desk ✅
  • Amazon Ads 📊
  • Walmart Connect 📊
  • Instacart Ads 📊
  • Target Roundel 📊
  • Criteo 📊
  • Display & Video 360 📊
  • OpenAI Ads (ChatGPT) 📊

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.syntermedia.ai/tools o pregunta a tu agente:

> What tools are available for LinkedIn Ads?

Seguro por Defecto: execute Ejecuciones de Prueba a Menos que se Indique lo Contrario

La herramienta universal execute nunca ejecuta una acción en la primera llamada a menos que optes por ello. De forma predeterminada (dry_run: true) valida la solicitud y se detiene ahí: nada se ejecuta, nada gasta dinero. Pasa dry_run: false para ejecutar realmente la acción; para cualquier cosa que implique gastar dinero, hazlo solo con la aprobación del propietario de la cuenta.


Variables de entorno

VariableRequeridaDescripción
SYNTER_API_KEYSíTu clave de API de Synter
SYNTER_API_URLNoAnulación de la URL de la API (predeterminada: https://syntermedia.ai)

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

"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 no válida o caducada"

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

"No hay cuentas de anuncios conectadas"

Debes conectar al menos una plataforma de anuncios:

  1. Ve a syntermedia.ai/settings/credentials
  2. Haz clic en "Conectar" junto a Google Ads (u otra plataforma)
  3. Completa la autorización OAuth

Las herramientas no aparecen en Claude/Cursor

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

Preguntas frecuentes

¿Existe un servidor MCP para Google Ads?

Sí, de dos tipos. Google ofrece un servidor MCP oficial de Google Ads, que es de solo lectura en su versión actual: puede consultar informes, métricas y metadatos, pero según la documentación de Google "no puede modificar pujas, pausar campañas ni crear nuevos activos". Nuestro servidor MCP cubre Google Ads con lectura y escritura: crea campañas de Búsqueda, Display y Performance Max, añade palabras clave y palabras clave negativas, ajusta presupuestos, pausa campañas, gestiona audiencias de Customer Match, configura el seguimiento de conversiones y extrae datos de rendimiento. El mismo servidor informa en otras 18 plataformas de anuncios y ofrece ejecución completa de campañas en 11 de ellas.

¿Pueden Claude o ChatGPT gestionar mis campañas de anuncios?

Sí. Con el servidor MCP de Synter conectado, Claude (Claude Desktop, Claude Code), ChatGPT, Cursor y cualquier otro cliente compatible con MCP pueden crear campañas, ajustar presupuestos, pausar las de bajo rendimiento, generar creatividades y sincronizar audiencias en 14 plataformas de anuncios (acciones de escritura en 16), y extraer datos de rendimiento en las 19. Claude y otros clientes stdio se conectan mediante npx @synterai/mcp-server con un SYNTER_API_KEY; ChatGPT y otros clientes HTTP se conectan al servidor remoto en https://mcp.syntermedia.ai/mcp/ con un encabezado X-Synter-Key. Las acciones destructivas tienen confirmaciones integradas.

¿Cuál es la diferencia entre el MCP oficial de Google Ads y Synter?

Dos cosas: acceso de escritura y cobertura de plataformas. El MCP oficial de Google Ads es de solo lectura en su versión actual y cubre únicamente Google Ads. Synter informa en 19 plataformas y ofrece creación completa de campañas en 14 de ellas, incluyendo Google Ads, Meta, LinkedIn, Microsoft, TikTok, Amazon Ads, Amazon DSP, OpenAI Ads y The Trade Desk. Si solo necesitas informes de Google Ads, el servidor oficial es una opción sólida. Si quieres un agente que pueda actuar sobre lo que encuentra, en Google y en todos los demás lugares donde publicitas, para eso construimos Synter.


Recursos


Licencia

Licencia MIT: consulta LICENSE para más detalles.


Synter
La extensión MCP que no quieren que uses.
Porque los agentes de IA con presupuestos publicitarios lo cambian todo.