# El MCP de Elocuenti, paso a paso.

URL: https://www.elocuenti.com/mcp/docs

El servidor MCP de Elocuenti permite que un asistente de IA como Claude o ChatGPT trabaje sobre tu negocio con tu propia cuenta: consulta tus resultados, arma segmentos, prepara campañas y configura tu agente de IA. Esta página explica cómo conectarlo, cómo funciona el inicio de sesión, qué puede hacer y dónde pedir ayuda.

## Conecta Claude (web, escritorio y móvil)

La dirección del servidor es https://mcp.elocuenti.com/mcp. Necesitas un plan de Claude que permita conectores.

- **Abre los conectores.** En Claude entra a Personalizar, luego a Conectores. En un plan Team o Enterprise, primero lo agrega un Owner desde la configuración de la organización.
- **Agrega un conector personalizado.** Elige Agregar conector personalizado y escribe https://mcp.elocuenti.com/mcp como URL del servidor. Deja vacías las credenciales OAuth.
- **Inicia sesión con tu cuenta de Elocuenti.** Haz clic en Conectar. Se abre la página de acceso de Elocuenti: escribe el correo y la contraseña de tu cuenta, elige a cuáles de tus negocios puede llegar el asistente y aprueba.
- **Pídele algo.** Empieza con «¿Con qué cuenta estoy conectado?» o «¿Cómo me fue en mis últimas campañas?». Las herramientas que cambian o borran datos vienen marcadas, para que tu asistente te pregunte antes.

## Conecta ChatGPT

- **Abre donde se agrega un conector.** En ChatGPT abre la configuración donde se crea un conector personalizado (servidor MCP). En planes de empresa, puede que un administrador del espacio de trabajo deba permitirlo antes.
- **Pega la URL del servidor.** Usa https://mcp.elocuenti.com/mcp y elige OAuth si te pide la autenticación.
- **Inicia sesión y aprueba.** Se abre la misma página de acceso de Elocuenti. Cuando apruebas, el conector queda listo en tus chats.

## Conecta Claude Code

- **Agrega el servidor.** En tu terminal ejecuta: claude mcp add --transport http elocuenti https://mcp.elocuenti.com/mcp
- **Autentícate.** Dentro de Claude Code ejecuta /mcp, elige elocuenti e inicia sesión en la ventana del navegador que se abre.
- **Pídele algo.** Claude Code carga las herramientas cuando las necesita y pide tu aprobación antes de ejecutar una que cambie datos.

## Cómo funciona el inicio de sesión

El MCP usa el flujo estándar OAuth 2.0 de código de autorización con PKCE. El asistente te lleva a la página de acceso de Elocuenti, así que tu contraseña se escribe en Elocuenti y nunca llega a Claude ni a ChatGPT.
- Tú eliges a cuáles de tus negocios puede llegar el asistente. Puedes dejar fuera los que quieras.
- Tu rol en cada negocio (lector, editor o admin) decide qué puede leer y cambiar el asistente en tu nombre.
- El asistente recibe un token de acceso de corta vida (15 minutos) y lo renueva solo cada vez que lo usa: sólo te vuelve a pedir que inicies sesión si pasan 30 días sin usarlo.
- Puedes desconectarlo cuando quieras desde la configuración de conectores de tu asistente; desde ese momento ya no puede renovar su acceso.
- Si desarrollas, tienes la referencia técnica con clientes, vida de los tokens y errores en www.elocuenti.com/docs/mcp.

## Qué puedes hacer, por área

Cada área tiene herramientas para leer y, donde tiene sentido, para cambiar. Cada herramienta indica si solo lee o si puede cambiar datos, así tu asistente sabe cuándo preguntarte antes.

- **Agente de IA** Reglas, objetivos, tipos de caso, razones de escalación y herramientas propias, en lenguaje natural, y una conversación de prueba para ver cómo responde el agente.
- **Base de conocimiento** Consulta, agrega y corrige lo que el agente sabe de tu negocio.
- **Segmentos y audiencias** Describes a quién buscas, cuentas cuántos son antes de guardar y dejas la lista lista para una campaña.
- **Plantillas y campañas** Escribes la plantilla, la mandas a validar, previsualizas la campaña y la lanzas cuando apruebas, por WhatsApp, Instagram, Messenger o por llamada.
- **Embudos y automatizaciones** Creas etapas, mueves conversaciones y defines las automatizaciones que dispara cada etapa.
- **Contactos, etiquetas y atributos** Consultas el perfil de un cliente, etiquetas personas y defines los datos que captura tu agente.
- **Conversaciones** Asignas, cierras o devuelves una conversación a la IA, y resuelves escalaciones.
- **Resultados y atribución de anuncios** Preguntas por conversaciones, campañas y ventas con tus datos reales, ves qué anuncio trae ventas y lees tus resultados de Elopay en Colombia.

## Ejemplos con llamadas reales

Cada uno se ejecutó de principio a fin contra un negocio de demostración.

| Tú pides | Qué hace el MCP | Qué obtienes |
| --- | --- | --- |
| «¿Cómo me fue en mis últimas campañas?» | Lista tus campañas y lee una en detalle. | Enviados, entregados, leídos y respondidos de cada una, por ejemplo 8 enviados, 7 entregados y 5 leídos en la promoción de agosto. |
| «Arma un segmento con mis clientes de Bogotá.» | Primero cuenta los contactos que cumplen. Después el asistente te muestra el resultado y te pregunta antes de guardar el segmento (esa pregunta la hace el asistente, no el servidor). | Un segmento guardado y el conteo que tenía al crearlo. |
| «Envía una promoción del 15 % a mi lista VIP.» | Prepara una vista previa con el mensaje exacto, cuántas personas lo reciben y un grupo de control, y espera tu aprobación antes de crear la campaña. | No se envía nada hasta que apruebas. Después, la campaña se crea con el plan que viste. |
| «Nunca prometas fechas exactas de entrega.» | Crea una regla para tu agente de IA y la muestra junto a tus otras reglas. | Una regla nueva y activa que el agente sigue en cada conversación nueva. |

## Hecho para que tú mandes

- Las campañas siempre pasan por una vista previa, y la campaña se crea solo con el plan y la frase de confirmación de esa vista previa, después de que la apruebas.
- Las herramientas que cambian o borran datos vienen marcadas, para que Claude y ChatGPT pregunten antes de ejecutarlas.
- El texto escrito por clientes o por tu equipo llega como dato, nunca como instrucciones para el asistente.
- Se respeta el consentimiento de marketing: quien se dio de baja queda fuera de las vistas previas de campañas.
- Tus pagos siguen en tus flujos de cobro: el MCP lee los resultados de Elopay (Colombia) y no cobra, no reembolsa ni transfiere dinero.
- Cada solicitud tiene un límite por usuario y herramienta para evitar accidentes.

## Soporte y contacto

Si necesitas ayuda para conectar el MCP, tienes una duda sobre una herramienta o quieres reportar un problema o un tema de seguridad, escribe a contacto@elocuenti.com. También puedes agendar una llamada con el botón de abajo y lo conectamos contigo.
Dentro del asistente, el prompt report_problem envía un error, una mejora o una pregunta directo al equipo de Elocuenti, con el detalle de lo que pasó.

## Sigue leyendo

- MCP de Elocuenti: Qué es el MCP y qué puedes manejar con él.
- Claude con Elocuenti: Maneja tu negocio conversando con Claude.
- ChatGPT con Elocuenti: Lo mismo, desde ChatGPT.
- MCP de Meta Ads: Atribución de anuncios a ventas reales, conversando.
- Política de privacidad: Cómo tratamos tus datos, incluida la sección del MCP.
- Términos de servicio: Los términos que aplican a Elocuenti y a su MCP.
- Planes y precios: Planes por cupo mensual de conversaciones con IA.

## Preguntas frecuentes sobre conectar el MCP

- **¿Qué dirección uso para conectar?** https://mcp.elocuenti.com/mcp. La misma dirección sirve para Claude, ChatGPT y Claude Code.
- **¿Necesito una clave de API?** No. Inicias sesión con tu cuenta de Elocuenti mediante OAuth, así que no hay claves que copiar ni rotar.
- **¿El asistente puede escribirles a mis clientes por su cuenta?** Solo mediante una campaña, y solo después de que apruebas la vista previa. No existe una herramienta que escriba a un solo contacto por sí sola.
- **¿Cómo protegen los datos?** Ciframos la información en tránsito y en reposo, aislamos los datos de cada negocio y controlamos el acceso por rol. Los pagos los procesa la pasarela: no guardamos datos de tarjetas.