# MCP Leads

**Manejá tus leads y las empresas guardadas desde tu agente IA.** Le pedís cosas en lenguaje natural y trabaja sobre tu cartera de Synara: filtra, agrega contactos nuevos, actualiza los que ya tenés, y arma la estructura del CRM (columnas y vistas).

Disponible para todos los planes desde {plan:free}.

> [!TIP] Antes de ejecutar — preguntale al asistente "¿qué podés hacer con esto?"
> Lee las tools que este MCP expone y te enumera el catálogo en lenguaje natural. También podés pedirle recomendaciones según tu situación: *"según mi cartera, ¿qué columnas me convendría crear?"*.

## ¿Para qué sirve?

Cuando tu cartera tiene cientos o miles de leads, abrir la app y revisarlos uno a uno se vuelve tedioso. Con el MCP Leads conectado, le pedís al asistente cosas como:

```text
Mostrame los restaurantes de Mendoza con WhatsApp y rating mayor a 4.
```

```text
Marcá como contactado a todos los del rubro "software" en Buenos Aires.
```

Y trabaja directo contra tu cartera. Además, el agente puede **armar la estructura de tu CRM** ([Tu cartera de empresas](/crm/companies)): crear columnas a medida (prioridad, estado, próximo paso), armar vistas tipo pipeline visual agrupadas por cualquier campo, ocultar columnas que no usás, y reordenar todo. **Lo que harías con clicks, se lo pedís en una frase.**

**Lo que este MCP NO hace:**

- No busca empresas nuevas (eso es la [Búsqueda Avanzada](/docs/busqueda/avanzada)).
- No maneja conversaciones de WhatsApp (para eso están los [MCPs de WhatsApp](/docs/mcps/whatsapp)).

## Cómo conectarlo

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

1. En tu cliente IA (Claude o cualquier compatible) agregás un servidor nuevo y pegás la URL.
2. Synara se abre en el navegador y te pide entrar con tu cuenta si no tenés sesión.
3. Te muestra una pantalla con los **permisos** que pide el MCP. Apretás **"Autorizar"** y volvés al cliente. **Ya podés empezar.**

### Qué permisos pedimos

| Permiso | Para qué sirve |
|---|---|
| Ver tus leads y la estructura del CRM | Listar, filtrar, ver detalles, leer columnas y vistas guardadas |
| Modificar tus leads y el CRM | Crear y actualizar leads, crear y editar columnas, crear y activar vistas |
| Eliminar leads, columnas y vistas | Borrar con **confirmación previa** — siempre te pide el "sí" antes de tocar nada |

**Los permisos los podés revocar cuando quieras** desde [Conexiones](/conexiones).

## Qué le podés pedir al asistente

Las capacidades del MCP están agrupadas en 12 categorías. **Abrí solo las que te interesan** — son ~70 frases en total, ningún usuario las lee todas.

<details>
<summary>Explorar tu cartera</summary>

<ul>
<li><code>Mostrame un resumen general de mis leads.</code></li>
<li><code>¿Cuántos contactos tengo con WhatsApp en Argentina?</code></li>
<li><code>Top 5 categorías con WhatsApp.</code></li>
<li><code>¿En qué estado de seguimiento están mis leads?</code></li>
</ul>

</details>

<details>
<summary>Filtrar en lenguaje natural</summary>

<ul>
<li><code>Empresas con WhatsApp en Mendoza del sector gastronómico, sin email.</code></li>
<li><code>Restaurantes en CABA con sitio web activo y rating mayor a 4,5.</code></li>
<li><code>¿Tengo a Juan Pérez en mi cartera?</code></li>
</ul>

</details>

<details>
<summary>Listar y ver detalle de un lead</summary>

<ul>
<li><code>Listame los primeros 50 con WhatsApp en Argentina.</code></li>
<li><code>Mostrame el detalle del registro 12345.</code></li>
<li><code>Traeme los detalles de los registros 100, 200, 300 y 400.</code></li>
</ul>

</details>

<details>
<summary>Cargar contactos nuevos</summary>

<ul>
<li><code>Creá un registro: Pizzería La Esquina, +5491133334444, La Plata.</code></li>
<li><code>Cargá estos 50 leads en lote, te paso el listado.</code></li>
</ul>

</details>

<details>
<summary>Actualizar muchos a la vez</summary>

<ul>
<li><code>Marcá como "cliente" a los registros 100 al 150.</code></li>
<li><code>Marcá como "Contactado" a todos los argentinos sin email.</code></li>
<li><code>Poné destacado="VIP" a todos los que tengan rating mayor a 4,8.</code></li>
</ul>

</details>

<details>
<summary>Borrar con seguridad</summary>

<ul>
<li><code>Borrá el registro 12345.</code></li>
<li><code>Eliminá todos los registros sin email cargados antes del 1 de enero.</code></li>
</ul>

<p>El asistente <strong>siempre te muestra el conteo y una previsualización</strong> antes de aplicar operaciones masivas. <strong>Nada se borra ni se modifica sin tu "sí" explícito.</strong></p>

</details>

<details>
<summary>Crear y manejar columnas del CRM</summary>

<ul>
<li><code>Creá una columna "Prioridad" tipo select con opciones Alta (rojo), Media (amarillo) y Baja (verde).</code></li>
<li><code>Agregá una columna "Próximo seguimiento" tipo fecha.</code></li>
<li><code>Creá la columna "Notas internas" como texto largo.</code></li>
<li><code>Eliminá la columna "test" que creé el otro día.</code></li>
<li><code>Ocultame la columna "Reviews" — no me sirve.</code></li>
<li><code>Mové "Prioridad" al principio de la tabla.</code></li>
</ul>

<p>Tipos disponibles: texto, número, moneda, fecha, URL, email, teléfono, select (con opciones de colores), multi-select, checkbox y rating. <strong>El agente elige el tipo correcto</strong> según cómo describas el dato.</p>

</details>

<details>
<summary>Manejar opciones de un campo select</summary>

<ul>
<li><code>En la columna "Prioridad", agregá la opción "Urgente" en rojo.</code></li>
<li><code>Cambiale el color a "Media" — ponela en naranja.</code></li>
<li><code>Eliminá la opción "Inactivo" del campo "Estado".</code></li>
<li><code>Reordená las opciones de "Prioridad": primero Urgente, después Alta, Media, Baja.</code></li>
</ul>

</details>

<details>
<summary>Crear y manejar vistas guardadas</summary>

<ul>
<li><code>Armame una vista "Pipeline por prioridad" tipo tablero agrupada por Prioridad, mostrando solo nombre, categoría y ciudad.</code></li>
<li><code>Vista "Argentinos sin email" filtrada por país AR y sin email cargado.</code></li>
<li><code>Marcá como activa la vista "Pipeline por prioridad".</code></li>
<li><code>Borrá la vista "experimento" que ya no uso.</code></li>
<li><code>Marcá "Pipeline por prioridad" como favorita.</code></li>
<li><code>¿Cuál es mi vista por defecto?</code></li>
<li><code>Mostrame el detalle de la vista <em>vista-simple-aB3xK9</em> (lo copié de un link).</code></li>
</ul>

<p>Las vistas guardan filtros, qué columnas se ven, en qué orden, cómo se agrupan y la ordenación. La <strong>favorita</strong> es la default que se abre al entrar a tu cartera.</p>

</details>

<details>
<summary>Recuperar búsquedas pasadas</summary>

<ul>
<li><code>Mostrame mis búsquedas Maps de los últimos 7 días.</code></li>
<li><code>¿Qué busqué en Apollo este mes?</code></li>
<li><code>Listame las últimas 20 búsquedas sin filtrar tipo.</code></li>
<li><code>De mi búsqueda del 15 de mayo, mostrame los registros.</code></li>
<li><code>Marcá como favorita esa búsqueda — no la quiero perder.</code></li>
</ul>

<p>Cada búsqueda que ejecutás en la app se guarda como una <strong>vista temporal</strong> en el colapsable <em>"Última búsqueda"</em> de tu cartera. Mantenemos las últimas 50; las que <strong>marques como favoritas</strong> sobreviven indefinidamente. El agente puede filtrar por tipo (simple / maps / apollo) y rango de fechas, y darte estadísticas de cuántas búsquedas hiciste por mes.</p>

</details>

<details>
<summary>Compartir vistas con tu equipo</summary>

<ul>
<li><code>Compartí "Pipeline por prioridad" con ana@empresa.com como lectura.</code></li>
<li><code>Buscá usuarios con email que empiece en "ana" — no me acuerdo el dominio.</code></li>
<li><code>Subile a edición el acceso de ana@empresa.com a esa vista.</code></li>
<li><code>¿Quiénes tienen acceso a "Pipeline por prioridad"?</code></li>
<li><code>Quitale el acceso a juan@empresa.com.</code></li>
<li><code>Reenviá el email de invitación a ana — no le llegó.</code></li>
<li><code>Mostrame el historial de quién accedió y qué le di a esta vista.</code></li>
</ul>

<p>Tres niveles de permisos:</p>
<ul>
<li><strong>Lectura</strong>: ve los datos sin tocar nada.</li>
<li><strong>Edición</strong>: puede editar registros y crear columnas. <em>No puede</em> cambiar los filtros del owner ni borrar registros.</li>
<li><strong>Acceso completo</strong>: edición + borrar + cambiar filtros + re-compartir.</li>
</ul>

<p>El invitado recibe <strong>notificación in-app + push (si tiene PWA) + email</strong> automáticamente. Si re-invitás al mismo email, no le llega notificación duplicada.</p>

<p>Límites: hasta <strong>100 personas por vista</strong> y <strong>50 invitaciones nuevas por día</strong> (por seguridad anti-spam). Re-invitar a alguien que ya tiene acceso no cuenta contra el límite.</p>

</details>

<details>
<summary>Vistas que te compartieron</summary>

<ul>
<li><code>¿Qué vistas me compartieron mis compañeros?</code></li>
<li><code>Mostrame el detalle de la vista que me compartió ana@empresa.com.</code></li>
<li><code>Renombrá esa vista como "Pipeline del equipo de Ana" — solo para mí.</code></li>
<li><code>Mostrame los leads de esa vista compartida.</code></li>
<li><code>Marcá como contactados los leads 100, 101 y 102 de esa vista.</code></li>
<li><code>Salí de esa vista compartida — ya no me sirve.</code></li>
</ul>

<p>Las vistas compartidas <strong>aparecen en tu sidebar</strong> de Synara, separadas de las propias. El <strong>alias local</strong> que les pongas es solo tuyo — el dueño y los otros invitados siguen viendo el nombre original. Lo que podés hacer depende del permiso que te dieron.</p>

</details>

<details>
<summary>Enlace público de una vista</summary>

<ul>
<li><code>Activá el enlace público de "Pipeline por prioridad" como lectura.</code></li>
<li><code>¿Está activo el link público de esa vista?</code></li>
<li><code>Mostrame el link público — quiero ver cómo se ve antes de activarlo.</code></li>
<li><code>Desactivá el enlace público.</code></li>
</ul>

<p>El enlace público es una URL del estilo <code>synara.ar/crm/companies/shared/&lt;id&gt;</code>. <strong>Cualquier usuario verificado de Synara que la abra se une automáticamente</strong> a la vista con el permiso que vos decidiste (lectura, edición o acceso completo). Cuando desactivás el enlace, los que ya entraron <strong>siguen teniendo acceso</strong> — para sacarlos usá "quitar acceso" puntual.</p>

<p>Ideal para compartir con un equipo grande sin invitar uno por uno. El historial registra cada auto-unión con la marca <em>"vía enlace público"</em>.</p>

</details>

<details>
<summary>Ver eventos recientes de una vista</summary>

<ul>
<li><code>¿Qué cambios hubo en la vista "Pipeline por prioridad" hoy?</code></li>
<li><code>Mostrame los últimos 50 eventos.</code></li>
<li><code>¿Quién editó qué celdas en esa vista compartida?</code></li>
</ul>

<p>Útil cuando colaborás con varios y querés ver <strong>quién hizo qué</strong>: ediciones de celdas, cambios de filtros, columnas creadas/eliminadas, invitaciones, salidas. <strong>Retención de 7 días</strong> — para historial más largo de invitaciones específicamente, usá <em>"mostrame el historial de accesos"</em>.</p>

</details>

## Ejemplos completos

> [!TIP] Resumen panorámico de tu cartera
>
> **Vos**: `Recién entré, mostrame qué tengo guardado.`
>
> **Resultado**: *"Tu cartera: **3.247 registros totales**. Por país: AR 71%, UY 12%, CL 9%. Con WhatsApp: 2.108 (65%). Con email: 1.892 (58%). Sectores top: gastronomía 31%, retail 22%. ¿Profundizamos en alguno?"*

> [!TIP] Filtro complejo en lenguaje natural
>
> **Vos**: `Quiero todas las empresas con WhatsApp pero sin email cargado, en Mendoza, del sector gastronómico.`
>
> **Resultado**: *"Filtro armado: con WhatsApp + sin email + Mendoza + gastronomía. **84 coincidencias**. ¿Previsualizo 20 o listamos los 84?"*

> [!TIP] Cargar varios leads desde un Excel
>
> **Vos**: `Tengo estos 30 leads en un Excel, te paso el listado. Confirmame costo y cargalos.`
>
> **Resultado**: *"Detecté **30 registros válidos** (0 errores). Costo: **30 coins**. Previsualización de los primeros 5 lista. ¿Confirmo?"* Vos respondés "sí" y se cargan.

> [!TIP] Armar un pipeline visual de cero en 2 frases
>
> **Vos**: `Quiero un pipeline visual. Creá una columna "Etapa" con: Prospecto (gris), Contactado (azul), Reunión (amarillo), Propuesta (naranja), Ganado (verde), Perdido (rojo). Después armame una vista tablero agrupada por Etapa.`
>
> **Resultado**: *"Listo. Creé la columna **Etapa** con 6 opciones y la vista **Pipeline visual** (tablero agrupado por Etapa). La dejé activa. Abrí [Tu cartera](/crm/companies) y vas a ver tus leads ya repartidos por columnas — moverlos entre etapas es arrastrar."*

> [!TIP] Compartir un pipeline con tu equipo sin recordar emails
>
> **Vos**: `Compartí "Pipeline por prioridad" con todo el equipo de marketing — son las personas con email del dominio @empresa.com.`
>
> **Resultado**: *"Encontré 4 usuarios verificados con dominio empresa.com: **ana@, juan@, lucia@, pablo@**. ¿Les doy acceso de **lectura, edición o completo**?"* Vos respondés "edición" y manda las 4 invitaciones. Cada uno recibe email + push + notificación in-app.

> [!TIP] Recuperar una búsqueda de hace dos semanas
>
> **Vos**: `Hace dos semanas hice una búsqueda Maps de pizzerías en Córdoba. ¿La tengo guardada?`
>
> **Resultado**: *"Encontré **1 búsqueda Maps** del 3 de mayo con la query "pizzerías", país Argentina, ciudad Córdoba — 47 registros. ¿La marco como favorita para que no se pierda y te muestro los registros?"*

## Planes y límites

El MCP Leads está disponible en **todos los planes**, incluso {plan:free}. Estos son los límites operacionales:

| Cosa | Límite |
|---|---|
| Leads por consulta | Hasta 50 (para más, el agente pagina automáticamente) |
| Leads por carga en lote | Hasta 100 (si tenés más, los parte en varios lotes) |
| Operaciones en masa | Hasta 500 leads por corrida |
| Costo de crear | 1 coin por registro |
| Costo de buscar, filtrar, listar y actualizar | **Gratis** (no consume coins) |
| Costo de crear/editar columnas, vistas y compartir | **Gratis** (cambios de estructura, no de datos) |
| Opciones máximas al crear un campo select | 50 (después podés agregar más una por una) |
| Personas con acceso a una misma vista compartida | Hasta 100 |
| Invitaciones nuevas que podés mandar por día | Hasta 50 (re-invitar a alguien que ya tiene acceso no cuenta) |
| Búsquedas guardadas en "Última búsqueda" | Hasta 50 (las marcadas como favoritas sobreviven aparte) |
| Reenvíos del email de invitación a un mismo invitado | Hasta 5 por día |
| Eventos recientes de una vista (cambios, ediciones) | Últimos 7 días |
| Historial de accesos (invitaciones, cambios de permiso) | Últimos 365 días |

## Errores comunes

**Cada error es un desplegable** — solo abrí el que te apareció.

<details>
<summary>"Tu filtro tiene demasiados resultados"</summary>

<p>Pasa cuando tu filtro coincide con miles de registros y traerlos todos saturaría la respuesta.</p>
<p><strong>Solución:</strong> refiná con criterios más estrictos, o pediile al agente que pagine: <em>"traeme los primeros 50 y después los siguientes 50."</em></p>

</details>

<details>
<summary>"Conteo más alto del esperado, confirmá antes de borrar"</summary>

<p>Cuando pedís una operación en masa, el agente <strong>te muestra el conteo exacto</strong> y espera tu "sí" explícito antes de tocar la base. Es por seguridad: nada se borra sin que lo veas primero.</p>

</details>

<details>
<summary>"Email no se puede modificar"</summary>

<p>El campo email es el <strong>identificador del contacto</strong>. Si necesitás cambiarlo, borrá el lead y volvelo a crear con el email nuevo.</p>

</details>

<details>
<summary>"No se puede eliminar un campo del sistema"</summary>

<p>Las columnas base (nombre, teléfono, email, etc.) <strong>no se borran</strong> — son las que Synara usa para identificar a tus leads. Sí podés <strong>ocultarlas</strong> con <em>"ocultame la columna X"</em>.</p>

</details>

<details>
<summary>"Para eliminar este campo se requiere confirmación"</summary>

<p>Pasa cuando la columna que querés borrar <strong>tiene valores cargados</strong> en leads (por ejemplo, un select con opciones asignadas). Decile al agente <em>"sí, eliminala igual"</em> y procede. Los valores guardados en los leads quedan archivados (la app los ignora silenciosamente).</p>

</details>

<details>
<summary>"El campo ya existe"</summary>

<p>Si pedís crear <em>"Prioridad"</em> y ya hay un campo con ese nombre, el agente <strong>crea el siguiente disponible</strong> (<code>prioridad_2</code>). Si querés sobrescribir, primero borrá el viejo.</p>

</details>

<details>
<summary>"Sesión expirada"</summary>

<p>Tu autorización venció. <strong>Reconectá el MCP</strong> desde <a href="/conexiones">Conexiones</a> — toma 10 segundos.</p>

</details>

<details>
<summary>"No encontré ese usuario"</summary>

<p>Cuando intentás compartir y ponés un email que <strong>no está verificado en Synara</strong>, no se puede invitar. Pedile al destinatario que <strong>se registre y confirme su email</strong>, después volvé a compartir.</p>

</details>

<details>
<summary>"Esta vista ya alcanzó el máximo de 100 personas"</summary>

<p>Cada vista compartida soporta <strong>hasta 100 invitados</strong>. Si llegaste al tope, primero quitá a alguien que ya no necesita acceso y volvé a invitar.</p>

</details>

<details>
<summary>"Llegaste al límite diario de invitaciones"</summary>

<p>Por seguridad, podés mandar <strong>hasta 50 invitaciones nuevas por día</strong>. Re-invitar a alguien que ya tiene acceso no cuenta. El contador se reinicia a las 24h.</p>

</details>

<details>
<summary>"No podés compartir 'Última búsqueda'"</summary>

<p>"Última búsqueda" es solo un <strong>agrupador en tu sidebar</strong>, no una vista con datos propios. Si querés compartir el resultado, marcá la búsqueda específica que te interesa como favorita y compartila individualmente.</p>

</details>

<details>
<summary>"Conflicto al editar — la vista fue modificada por otro"</summary>

<p>Pasa en vistas compartidas cuando <strong>dos personas editan a la vez</strong>. El agente te avisa que tu cambio quedaría desactualizado. <strong>Solución:</strong> pedile <em>"recargá la vista y mostrame los cambios actuales"</em> antes de volver a aplicar el tuyo.</p>

</details>

## ¿Y ahora?

| Destino | Cuándo te conviene |
|---|---|
| [WhatsApp Campañas →](/docs/mcps/whatsapp-campaigns) | Prospectar a leads ya segmentados en automático |
| [WhatsApp Inbox →](/docs/mcps/whatsapp-inbox) | Las conversaciones entrantes te saturan |
| [Índice de MCPs →](/docs/mcps) | Volver al panorama de los 5 MCPs |