# MCP Meta Ads

**Manejá todo lo de Facebook e Instagram desde un solo asistente.** Campañas, anuncios, métricas, leads de formularios, posts y reels, mensajes directos, programación de Instagram con reintentos automáticos — todo en una conversación.

Requiere {plan:pro}+ y tener Meta conectado.

> [!TIP] Antes de ejecutar — preguntale al asistente "¿qué podés hacer con esto?"
> Lee las tools del MCP Meta Ads y te enumera lo disponible (lanzar campañas, ver métricas, programar IG, descargar leads). También podés pedirle: *"según mi presupuesto y objetivo, ¿qué campaña me convendría armar?"*.

## ¿Qué es Meta Ads?

Por si te resulta nuevo: **Meta** es la empresa dueña de Facebook e Instagram. **Meta Ads** es su plataforma de publicidad, donde se hacen los anuncios que ves en ambas redes.

Si manejás publicidad para tu negocio en Facebook o Instagram, terminás abriendo varias herramientas (Ads Manager, Meta Business Suite, Lead Center) y perdiendo contexto al saltar entre ellas.

## ¿Para qué sirve el MCP?

Consolida todo en un solo asistente. Podés:

- **Lanzar campañas** con previsualización antes de activar.
- **Descargar leads** que vinieron por formularios y sincronizarlos al CRM.
- **Programar publicaciones** en Instagram (con reintentos automáticos si Meta falla).
- **Responder comentarios y mensajes directos**.
- **Enviar eventos de conversión** al pixel.
- **Ver métricas** de campañas y anuncios.

Si manejás varias **cuentas publicitarias** o varias páginas, el MCP las maneja todas. Si tenés una sola, se elige por defecto.

**Lo que este MCP NO hace:**

- No diseña creativos pixel-perfect (eso lo hacés en Photoshop/Figma o, si es para Instagram, con el [MCP Placas](/docs/mcps/placas)).
- No reemplaza al panel visual de Meta cuando solo querés ver gráficos lindos de tus posts orgánicos.

## Glosario rápido

| Término | Qué significa |
|---|---|
| **Cuenta publicitaria** | La cuenta donde se cobran tus anuncios. Una empresa puede tener varias. |
| **Campaña** | Un objetivo de publicidad (ej: "Lanzamiento Mayo"). |
| **Conjunto de anuncios** | Dentro de una campaña, define **a quién** y **con qué presupuesto** mostrar los anuncios. |
| **Anuncio** | El creativo final (imagen + texto + botón). |
| **Lead Ads** | Formularios de Meta donde los usuarios dejan sus datos sin salir de Facebook/Instagram. |
| **Pixel** | Un fragmento de código en tu sitio web que registra acciones (compras, formularios) para mejorar las campañas. |
| **CAPI** | Forma de enviar esos mismos eventos desde el servidor en vez del navegador — más confiable. |
| **ROAS** | "Retorno sobre la inversión publicitaria": cuánto ingreso generó cada peso gastado. |
| **CPM** | "Costo por mil impresiones": cuánto cuesta que el anuncio se vea 1.000 veces. |

## Cómo conectarlo

> [!INFO] URL del servidor
> `https://synara.ar/api/mcp-meta-ads`

1. En tu cliente IA agregás un servidor nuevo y pegás la URL.
2. Synara se abre en el navegador y te pide entrar con tu cuenta.
3. Aparece la pantalla de permisos. Apretás **"Autorizar"** y volvés al cliente.

> [!WARNING] Plan Pro o superior + Meta conectado
> Meta Ads requiere {plan:pro}, {plan:business} o {plan:especial}. {plan:free} y {plan:go} reciben el mensaje "se requiere actualización" con enlace a la [página de planes](/precios).
>
> Además, necesitás haber **conectado tus credenciales de Meta** en [Mi cuenta → Integraciones](/mi-cuenta?section=meta). Sin esa conexión, el MCP avisa con un mensaje claro pidiéndote configurarlo antes.

### Qué permisos pedimos

| Permiso | Para qué sirve |
|---|---|
| Ver tus cuentas publicitarias y páginas | Listar anuncios, campañas, conjuntos de anuncios y métricas |
| Crear y modificar campañas | Lanzar, pausar, reactivar, ajustar presupuestos |
| Publicar en Facebook e Instagram | Posts, reels, historias, carruseles + responder comentarios |
| Manejar mensajes directos | Messenger e Instagram (respetando las reglas de Meta) |
| Descargar leads de formularios (Lead Ads) | Sincronizarlos al CRM de Synara |
| Enviar eventos al pixel | Conversiones desde el servidor (CAPI) |

## Qué le podés pedir al asistente

<details>
<summary>Campañas y anuncios</summary>

<ul>
<li><code>¿Qué campañas tengo activas?</code></li>
<li><code>Creá una campaña "Lanzamiento Mayo" con objetivo conversiones y presupuesto USD 500 por día.</code></li>
<li><code>Pausá la campaña "Black Friday".</code></li>
<li><code>Creá un conjunto de anuncios apuntando a mujeres 25-35 en CABA con USD 50 por día.</code></li>
<li><code>Mostrame una previsualización del anuncio 234 antes de publicarlo.</code></li>
</ul>

</details>

<details>
<summary>Métricas</summary>

<ul>
<li><code>Métricas de "Lanzamiento Mayo" de los últimos 7 días.</code></li>
<li><code>Mostrame el ROAS y el CPM del último mes.</code></li>
<li><code>Métricas del último trimestre.</code> (los rangos largos arrancan un cálculo en segundo plano)</li>
<li><code>¿Cuál sería el alcance estimado si apunto a mujeres 25-35 en LATAM?</code></li>
</ul>

</details>

<details>
<summary>Publicar en Facebook e Instagram</summary>

<ul>
<li><code>Publicá en la Página Synara: "Lanzamos integración con Meta" con esta imagen.</code></li>
<li><code>Publicá el mismo contenido en FB y en IG.</code></li>
<li><code>Listame los comentarios del post 234 y respondé al que pregunta por el precio.</code></li>
</ul>

</details>

<details>
<summary>Programar en Instagram</summary>

<ul>
<li><code>Programá un post en IG para mañana 9 AM con esta imagen y caption "Lanzamiento."</code></li>
<li><code>Programá una historia para mañana al mediodía.</code></li>
<li><code>Programá estos 7 posts, uno cada día a las 9 AM durante la semana próxima.</code></li>
<li><code>Pausá el post programado #234 — voy a hacer cambios.</code></li>
<li><code>Reintentá el post fallido #234, ya reconecté Meta.</code></li>
<li><code>Cancelá toda la campaña "lanzamiento-mayo".</code> (cancela varios posts agrupados)</li>
</ul>

</details>

<details>
<summary>Lead Ads (formularios)</summary>

<ul>
<li><code>Listame los formularios de Lead Ads activos.</code></li>
<li><code>Descargame los últimos 100 leads del formulario "Mayo Promo".</code></li>
<li><code>Sincronizá los leads del formulario 123 al CRM de Synara.</code></li>
</ul>

</details>

<details>
<summary>Mensajes directos</summary>

<ul>
<li><code>Conversaciones de IG sin responder.</code></li>
<li><code>Mandale un DM a @cliente: "Te paso info por acá."</code> (válido si te escribió en las últimas 24 horas)</li>
<li><code>Mandale un DM al usuario que comentó "¿precio?" en el post 234.</code></li>
</ul>

<blockquote>
<p><strong>Sobre los DMs salientes.</strong> Meta tiene reglas estrictas. <strong>No podés iniciar un DM a alguien que NO te escribió primero</strong>, salvo que sea una <strong>"Respuesta privada"</strong> (responder por DM a alguien que comentó en tu post). Esa ventana dura <strong>7 días</strong> desde el comentario, y solo permite <strong>1 DM por comentario</strong>.</p>
</blockquote>

</details>

<details>
<summary>Pixel y eventos de conversión</summary>

<ul>
<li><code>Listame los pixeles.</code></li>
<li><code>Mandá un evento de Compra con valor USD 500 al pixel principal.</code></li>
<li><code>Estadísticas del pixel principal en los últimos 7 días.</code></li>
</ul>

</details>

## Ejemplos completos

> [!TIP] Crear una campaña completa desde cero
>
> **Vos**: `Creá una campaña de conversiones para "Lanzamiento Mayo": USD 500/día, apuntando a mujeres 25-35 en CABA, copy "Sumá leads automáticos", imagen X. Mostrame todo y confirmá antes de activar.`
>
> **Lo que pasa**: el asistente arma todo como borrador (campaña + conjunto + anuncio + previsualización), te muestra un resumen con alcance estimado (180.000-220.000), y **espera tu OK** para activar.
>
> **Resultado**: *"Activa. Empieza a entregar en 15-30 minutos. Te aviso si gasta más del 20% del presupuesto en la primera hora (eso suele ser señal de mala calidad del anuncio)."*

> [!TIP] Lead Ads → CRM → WhatsApp, todo en una conversación
>
> **Vos**: `Descargame los leads del formulario "Mayo Promo" que llegaron hoy, sincronizalos al CRM de Synara, y arrancame una campaña de WhatsApp saludándolos.`
>
> **Lo que pasa**: el asistente descarga 23 leads, los sincroniza al CRM (crea 23 registros nuevos), filtra los 8 que tienen WhatsApp, propone un mensaje personalizable, **espera OK** y arranca la campaña.
>
> **Resultado**: *"Campaña activa: 1 mensaje cada 30 segundos = unos 4 minutos en total. Las respuestas crean oportunidades automáticamente en el CRM."*

> [!TIP] Programar 5 posts de campaña agrupados
>
> **Vos**: `Tengo 5 placas listas en mi biblioteca para una campaña "lanzamiento-mayo". Programá los 5 posts en IG, uno cada día a las 10 AM de lunes a viernes, agrupados como campaña.`
>
> **Lo que pasa**: el asistente valida los 5 (enlaces HTTPS, formato compatible, captions ≤ 2.200 caracteres, hashtags razonables), te avisa si encuentra algo raro, y los programa en lote con una etiqueta de campaña común.
>
> **Resultado**: *"Cola programada: lunes a viernes 10 AM. Si querés cancelar toda la campaña: 'cancelá la campaña lanzamiento-mayo.'"*

## Planes y límites

| Plan | Acceso |
|---|---|
| {plan:free} / {plan:go} | ❌ — el MCP responde "se requiere actualización" con enlace a la [página de planes](/precios) |
| {plan:pro} / {plan:business} / {plan:especial} | ✅ acceso completo (también necesitás Meta conectado) |

Detalles operacionales:

- **Multi-cuenta**: si tenés varias cuentas publicitarias conectadas, el MCP usa la predeterminada. Confirmá con `¿qué cuentas tengo?` antes de operar — sino podrías crear una campaña en la cuenta equivocada.
- **Métricas**: rangos cortos (≤ 30 días) responden en segundos. Rangos largos disparan un cálculo en segundo plano que tarda unos minutos.
- **Programación en Instagram**: el sistema chequea la cola cada 30 segundos. **3 reintentos automáticos** con espaciado creciente (5 min → 15 min → 45 min) si Meta falla por temas transitorios. Errores permanentes (autorización revocada, contenido contra políticas) se marcan como fallidos al toque y te llega notificación.
- **Lead Ads**: Meta retiene los leads por 90 días. **Programá una sincronización diaria para no perder ninguno.**
- **DMs**: Meta tiene reglas estrictas. Mandar DM a alguien que **NO** te escribió primero solo es legal con **Respuesta privada** (responder por DM a alguien que comentó en tu post). Ventana: 7 días desde el comentario, 1 solo DM por comentario.

> [!WARNING] Cuidado con qué cuenta usás
> Si tenés varias cuentas publicitarias, **siempre confirmá cuál vas a usar** antes de crear una campaña. Una vez creada en la cuenta equivocada, **mover una campaña entre cuentas no es trivial**.

## Errores comunes

<details>
<summary>"Se requiere plan Pro"</summary>

<p>{plan:free} y {plan:go} no acceden al MCP.</p>
<p><strong>Solución:</strong> <a href="/precios">actualizar plan</a>.</p>

</details>

<details>
<summary>"Meta no está conectado"</summary>

<p><strong>Solución:</strong> andá a <a href="/mi-cuenta?section=meta">Mi cuenta → Integraciones</a> y conectá tu <strong>System User Token</strong> (un token que Meta genera para que otras herramientas puedan operar en tu cuenta). Sin esa conexión, nada del MCP funciona — el asistente te avisa con el enlace directo.</p>

</details>

<details>
<summary>"Carousel falló: container expirado"</summary>

<p>Meta expira los carruseles a las 24 horas. Para carruseles programados con más de 23 horas de anticipación, <strong>el asistente arma el carrusel al momento de publicar</strong>, no antes. No necesitás hacer nada — confiá en el flujo automático.</p>

</details>

<details>
<summary>"Token revocado / Meta desconectado durante la programación"</summary>

<p>Si desconectaste Meta mientras tenías posts programados, Synara los cancela y te avisa cuáles.</p>
<p><strong>Solución:</strong> reconectá Meta y pediile al asistente <em>"reintentá el post #234"</em> (o cloná el post con nueva fecha).</p>

</details>

<details>
<summary>"Respuesta privada rechazada: ventana de 7 días vencida"</summary>

<p>Solo podés enviar respuesta privada a comentarios de los <strong>últimos 7 días</strong>. Si pasó más tiempo, <strong>no hay forma legal de enviar DM</strong> a ese contacto.</p>

</details>

<details>
<summary>"Sesión expirada" (del MCP)</summary>

<p>Tu autorización venció. <strong>Reconectá</strong> desde <a href="/conexiones">Conexiones</a>.</p>

</details>

## ¿Y ahora?

| Destino | Cuándo te conviene |
|---|---|
| [MCP Placas →](/docs/mcps/placas) | Generar imágenes para IG con instrucciones simples |
| [WhatsApp Campañas →](/docs/mcps/whatsapp-campaigns) | Prospectar por WhatsApp a los leads de Lead Ads |
| [Índice de MCPs →](/docs/mcps) | Volver al panorama de los 5 MCPs |