Synter Ads MCP Server

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.

GitHub

Documentación

Servidor MCP de Synter

La extensión MCP que Claude no quiere que uses.

Porque una vez que la instalas, tu agente de IA puede gastar dinero real.

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

Este es el primer servidor de Protocolo de Contexto de Modelo (MCP) que le da una tarjeta de crédito a los agentes de IA.

¿Por qué Synter?

La mayoría de los servidores MCP de publicidad son de solo lectura y de una sola plataforma. Synter es el único servidor MCP multiplataforma de gestión publicitaria con capacidades completas de lectura y escritura:

Característica	Synter	Google Ads MCP	Amazon Ads MCP	Otros
Plataformas	9+ (Google, Meta, LinkedIn, Microsoft, Reddit, TikTok, X, StackAdapt, TTD)	Solo Google	Solo Amazon	1-2
Crear campañas	✅	❌ Solo lectura	✅ Solo Amazon	❌
Ajustar presupuestos	✅	❌	✅	❌
Pausar campañas	✅	❌	✅	❌
Generación de creatividades con IA	✅ (Imagen 4, Veo, Flux)	❌	❌	❌
Optimización de pujas	✅	❌	❌	❌
Estratega de IA	✅	❌	❌	❌
Código abierto	✅	✅	❌	Varía

Un solo servidor MCP. Todas las plataformas publicitarias. Lectura y escritura.

⚠️ Advertencia

Tu agente de IA podrá:

Crear campañas que inmediatamente empiezan a gastar tu presupuesto
Ajustar pujas que afectan cuánto pagas por clic
Pausar campañas (a veces eso es bueno)
Añadir palabras clave que cambian quién ve tus anuncios
Generar creatividades y subirlas a tus cuentas

Hemos incorporado confirmaciones para acciones destructivas. Pero aún así, quizás no le des esto a un agente que acabas de conocer.

Inicio Rápido

1. Obtén tu Clave API

Regístrate en syntermedia.ai y crea una clave API en la 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": ["@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 (HTTP Transmisible) — Para ChatGPT, n8n, Zapier o cualquier cliente MCP que soporte transporte HTTP:

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

No necesita instalación local. Funciona con cualquier cliente MCP que soporte transporte HTTP Transmisible.

3. Empieza a Usarlo

Reinicia tu cliente de IA y 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"

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

Este paquete es el servidor MCP básico. 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 sin interfaz del SDK de Agente Claude para automatización. Consulta el repositorio del plugin o la guía del Plugin 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`	Listar campañas en todas las plataformas conectadas
`create_search_campaign`	Crear una campaña de Búsqueda de Google con palabras clave y anuncios
`create_display_campaign`	Crear una campaña de Display de Google con imágenes
`create_pmax_campaign`	Crear una campaña de Performance Max
`create_meta_campaign`	Crear una campaña de Facebook/Instagram
`create_linkedin_campaign`	Crear una campaña de LinkedIn para B2B
`create_reddit_campaign`	Crear una campaña de Reddit
`pause_campaign`	Pausar cualquier campaña
`update_campaign_budget`	Cambiar el presupuesto diario

📈 Rendimiento y Analíticas

Herramienta	Descripción
`get_performance`	Obtener 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ñadir palabras clave a una campaña o grupo de anuncios
`add_negative_keywords`	Bloquear términos de búsqueda no deseados

🔄 Seguimiento de Conversiones

Herramienta	Descripción
`create_conversion`	Configurar una acción de conversión
`list_conversions`	Listar acciones de conversión existentes
`diagnose_tracking`	Verificar si el seguimiento está instalado correctamente

🎨 Generación de Creatividades

Herramienta	Descripción
`generate_image`	Generar imágenes de anuncios con IA (Imagen 4, Flux, SDXL)
`generate_video`	Generar anuncios de video con IA (Veo, Runway, Luma)
`upload_image`	Subir imágenes como recursos publicitarios

🔧 Utilidad

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

¿Sin Experiencia en Anuncios? No Hay Problema.

Si nunca has gestionado anuncios, 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	Ideal Para	Presupuesto Mín.
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ía de mayor edad, B2B	$10/día
TikTok	Generación Z, entretenimiento, comercio electrónico	$20/día

Tipos de Campaña Explicados

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

Ejemplo: Alguien busca "mejor software CRM" → Aparece tu anuncio

Campañas de Display — Anuncios de imagen que se muestran en sitios web y aplicaciones.

Ejemplo: Anuncio de 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 para 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	Significado
Impresiones	Cuántas veces se mostró tu anuncio
Clics	Cuántas personas hicieron clic en tu anuncio
CTR	Porcentaje 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 donde irán las personas 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 títulos y descripciones para tu anuncio

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

Ejemplos de Conversaciones

Crea tu Primera Campaña

Tú: Crea una campaña de Búsqueda de Google 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 Búsqueda con esas palabras clave. ¿Qué títulos 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"

Revisa el Rendimiento

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

Agente: Aquí está 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
Retargeting de Display $67 234 8 2.8x

La campaña "Palabras Clave de Competidores" tiene bajo rendimiento. ¿Quieres que la pause o 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
Retargeting de Display	$67	234	8	2.8x

Añade Palabras Clave Negativas

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

Agente: Se añadió "gratis" como palabra clave negativa a tu campaña. Esto evitará que tus anuncios se muestren en búsquedas que contengan "gratis".

Genera Creatividad Publicitaria

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

Agente: Generando tu imagen con Imagen 4...

Creado: "Panel de automatización de marketing con visualización de datos sobre fondo oscuro" Recurso guardado y 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 syntermedia.ai/settings/credentials
Haz clic en "Conectar" junto a cada plataforma
Completa el flujo OAuth
Tu agente ya puede gestionar esa plataforma

Plataformas Soportadas:

Google Ads ✅
Meta (Facebook/Instagram) ✅
LinkedIn Ads ✅
Microsoft Ads (Bing) ✅
Reddit Ads ✅
TikTok Ads ✅
X (Twitter) Ads ✅
StackAdapt ✅
The Trade Desk ✅

Avanzado: Acceso Directo a Herramientas

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

> Use run_tool to call google_ads_list_audiences

Consulta la lista completa de herramientas en docs.syntermedia.ai/tools o pregúntale a tu agente:

> What tools are available for LinkedIn Ads?

Variables de Entorno

Variable	Requerida	Descripción
`SYNTER_API_KEY`	Sí	Tu clave API de Synter
`SYNTER_API_URL`	No	Anulación de URL de API (por defecto: 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 establecida"

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

"Clave API inválida o expirada"

Verifica que copiaste la clave completa (¡son largas!)
Comprueba que la clave esté activa en syntermedia.ai/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 syntermedia.ai/settings/credentials
Haz clic en "Conectar" junto a Google Ads (u otra plataforma)
Completa la autorización OAuth

Las herramientas no aparecen en Claude/Cursor

Reinicia tu cliente de IA completamente (no solo actualices)
Revisa los registros del servidor MCP en busca de errores
Verifica la ruta del archivo de configuración y la sintaxis JSON

Recursos

Manual de Synter: syntermedia.ai/manual
Documentación de la API: docs.syntermedia.ai
Plugin de Claude: github.com/Synter-Media-AI/plugin — habilidades, agentes y este MCP para Claude Code / Desktop
Referencia de Herramientas: docs.syntermedia.ai/tools
Comparativa de Servidores MCP: syntermedia.ai/blog/best-ad-platform-mcp-servers
Habilidades de Agente Gratuitas (47 de código abierto): github.com/Synter-Media-AI/free-skills — también en skills.sh
Soporte: [email protected]

Licencia

Licencia MIT - consulta LICENSE para más detalles.

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