Nos da mucho gusto anunciar que el servidor MCP (Model Context Protocol) de Leadway ya está **disponible y listo para usarse**. Esto abre la puerta a que asistentes de IA avanzados hablen directamente con los datos y las herramientas de tu CRM. Piénsalo como un puente: ahora puedes **consultar, automatizar y orquestar** todo lo que pasa en tu cuenta de Leadway usando IA. **La mejor forma de conectar tus agentes a Leadway es el endpoint por cliente `https://services.leadconnectorhq.com/mcp/{client}/v2`, disponible hoy para Claude en `/mcp/anthropic/v2`, con más clientes en camino.** *Nota: Puedes encontrar nuestra documentación API en el siguiente: *[*https://developers.leadwaycrm.com/landing*](https://developers.leadwaycrm.com/landing) ## ¿Qué es MCP? MCP es un protocolo abierto que estandariza la forma en que las aplicaciones le dan contexto a los modelos de lenguaje grandes (LLM). El servidor MCP de Leadway le da a los asistentes de IA una manera estandarizada de trabajar con tus datos y operaciones de Leadway, sin que tú o el modelo necesiten conocer los detalles internos de cómo funcionan las APIs por debajo. ## Autenticación (ambos endpoints) Todos los endpoints MCP de Leadway soportan **ambos** métodos de autenticación, elige el que prefiera tu cliente. En **ambos** flujos, **tú decides exactamente qué permisos (scopes) otorgar** a la integración: * **OAuth (recomendado)**: inicio de sesión de un clic a través del flujo de consentimiento de Leadway (no hay nada que guardar ni rotar). **Apruebas los permisos** en la pantalla de consentimiento, y OAuth habilita el **conjunto más amplio de permisos**. * **Token de Integración Privada (PIT)**: crea un token en **Configuración → Integraciones privadas**, **seleccionando los permisos** que quieres que tenga, y pásalo en el encabezado `Authorization`. Un PIT ofrece un **conjunto de permisos más limitado que OAuth**. Como OAuth expone un conjunto de permisos más amplio que un PIT, desbloquea más operaciones del catálogo, otra razón por la que es la opción recomendada. De cualquier forma, la integración solo puede hacer lo que los permisos que otorgaste le permiten. Ambos endpoints son funciones a **nivel de subcuenta**, no funcionan de manera global para toda la cuenta. Cada conexión o solicitud apunta a una sola subcuenta. ## Qué endpoint usar | | `**/mcp/{client}/v2**` (recomendado) | `**/mcp/**` (original) | | ----------------- | ------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------ | | **Endpoint** | `https://services.leadconnectorhq.com/mcp/anthropic/v2` (disponible), más clientes planeados | `https://services.leadconnectorhq.com/mcp/` | | **Autenticación** | OAuth **o** Token de Integración Privada | OAuth **o** Token de Integración Privada | | **Clientes** | Por cliente; **Claude disponible hoy**, otros planeados (ver hoja de ruta) | Cualquier cliente MCP basado en HTTP (Cursor, Windsurf, n8n, agentes propios, y más) | | **Cobertura** | **La más amplia**: el catálogo completo de operaciones, cientos de operaciones en **40 dominios** | **Limitada**: un conjunto enfocado de herramientas centrales | | **Nivel** | Subcuenta | Subcuenta | **Recomendación:** usa `/mcp/{client}/v2` para obtener la cobertura más amplia. **Ya está disponible para Claude** en `/mcp/anthropic/v2`. El endpoint original `/mcp/` funciona con **cualquier** cliente MCP (vía OAuth o PIT), pero expone un conjunto de herramientas más limitado. ## Recomendado: el endpoint por cliente (`/mcp/{client}/v2`) La forma recomendada de conectar tus agentes. Cada cliente tiene un endpoint dedicado que sigue el patrón `https://services.leadconnectorhq.com/mcp/{client}/v2`, respaldado por el **catálogo completo de operaciones de Leadway**. **Disponible hoy:** `https://services.leadconnectorhq.com/mcp/anthropic/v2` (Claude). Otros clientes están en la hoja de ruta (ver abajo). * **Cobertura más amplia**: el catálogo completo de operaciones (cientos de operaciones en 40 dominios), muy por encima del conjunto de herramientas del endpoint original `/mcp/`. Las operaciones exactas que ve un asistente están filtradas según los permisos que otorgaste. * **OAuth o PIT**: conéctate con OAuth de un clic (recomendado) o con un Token de Integración Privada en el encabezado `Authorization`. * **A nivel de subcuenta**: es una función a **nivel de subcuenta**, no funciona de manera global para toda la cuenta. No existe una conexión única que abarque todas tus subcuentas a la vez. * **Una subcuenta por conexión**: cada conexión trabaja con una **sola subcuenta**, elegida al momento de conectar. Para trabajar con otra subcuenta, agrega una conexión distinta. * **Un conjunto de herramientas pequeño y estable**: en lugar de cientos de herramientas individuales compitiendo por la atención del modelo, el servidor expone un conjunto compacto de herramientas unificadas (ver abajo). El asistente las usa para descubrir y ejecutar todo lo demás. > **Nivel de subcuenta, una sola ubicación:** con OAuth, tu cliente abre el navegador hacia la pantalla de inicio de sesión de Leadway, inicias sesión, eliges la **única** subcuenta que quieres exponer, y apruebas. La conexión entonces opera sobre esa subcuenta durante toda su vida y no accederá a tus otras subcuentas ni a tu cuenta completa. ## Un conjunto de herramientas pequeño y unificado En lugar de listar cada operación como una herramienta independiente, el servidor presenta un puñado de herramientas unificadas. Solo hay que aprender unas cuantas, el asistente se encarga del resto. | Herramienta | Qué hace | | -------------------- | ------------------------------------------------------------------------------------------------------ | | `search` | Busca registros de clientes o del negocio por nombre, correo, teléfono, etiqueta o criterios similares | | `fetch` | Obtiene el detalle completo de uno o más registros devueltos por `search` | | `search_operations` | Descubre las operaciones disponibles según la intención: listar, crear, actualizar, eliminar, y más | | `describe_operation` | Revisa los datos de entrada que necesita una operación antes de ejecutarla | | `execute_operation` | Ejecuta una operación, sujeta a tus permisos y a las validaciones de seguridad integradas | Detrás de estas herramientas está el catálogo completo de operaciones de Leadway: **cientos de operaciones en 40 dominios**. Usa `search_operations` en cualquier momento para ver qué está disponible según tus permisos. ## Un solo prompt en acción Una vez conectado, no necesitas conocer la API de Leadway, solo preguntas. Por ejemplo: > *"Busca el contacto con correo *[*jane@example.com*](mailto:jane@example.com)*, agrégale la etiqueta 'vip-2026', y créale una nueva oportunidad en el 'Embudo de Ventas' por $5,000."* Detrás de escena, el asistente: 1. `search` → encuentra el contacto de Jane 2. `search_operations` → descubre las operaciones para "agregar etiquetas" y "crear oportunidad" 3. `describe_operation` → revisa los datos que espera cada operación 4. `execute_operation` → agrega la etiqueta y crea la oportunidad Y tú recibes una sola confirmación, en lenguaje natural. ## Qué puedes hacer La cobertura abarca toda tu cuenta de Leadway, incluyendo: * **Contactos**: obtener, listar, buscar, crear, actualizar, eliminar, upsert, búsqueda de duplicados, etiquetas, notas, tareas, seguidores, citas y asignación de negocio * **Conversaciones y mensajes**: crear, obtener, actualizar, eliminar y buscar conversaciones; leer y enviar mensajes; estatus de mensajes * **Oportunidades y embudos**: embudos, razones de pérdida, búsqueda, crear, actualizar, eliminar, upsert, seguidores y cambios de estatus * **Calendarios y citas**: calendarios, grupos, citas, eventos, notas, notificaciones, horarios libres/bloqueados, recursos, horarios, servicios y reservación de servicios * **Pagos**: cupones, integraciones, órdenes, cumplimiento de órdenes, suscripciones y transacciones * **Productos y tienda**: productos, precios, colecciones, inventario, reseñas, paqueterías/zonas/tarifas de envío, y configuración de la tienda * **Facturas y cotizaciones**: facturas, cotizaciones, plantillas, programación y acciones de envío/anulación * **Planificador social**: cuentas, publicaciones, categorías, etiquetas, vistas de calendario y estadísticas * **Blogs**: sitios de blog, autores, categorías, publicaciones y verificación de slugs * **Correos**: plantillas, carpetas de plantillas, campañas, programación y estadísticas de campañas * **Formularios y encuestas**: formularios, encuestas y sus respuestas ...y más. Pregúntale a `search_operations` cuáles son las operaciones exactas disponibles según tus permisos. ## Conectar Claude (`/mcp/anthropic/v2`) Claude se conecta a `https://services.leadconnectorhq.com/mcp/anthropic/v2`. Se recomienda OAuth de un clic; un Token de Integración Privada también funciona. ### [Claude.ai](http://Claude.ai) 1. Abre [**Claude.ai**](http://Claude.ai) → **Configuración** → **Conectores** → **Agregar conector personalizado**. 2. Configura la URL del servidor como `https://services.leadconnectorhq.com/mcp/anthropic/v2`. 3. Da clic en **Conectar** y completa el inicio de sesión de Leadway (inicia sesión → elige la subcuenta → aprueba). 4. Inicia un nuevo chat, las herramientas de Leadway ya están disponibles. > **Tip:** Pregunta *"Encuentra los últimos 5 contactos que agregué en Leadway"* para confirmar que la conexión funciona. ### Claude Code (CLI) ``` claude mcp add --transport http leadconnector https://services.leadconnectorhq.com/mcp/anthropic/v2 ``` O agrégalo a `.mcp.json` en la raíz de tu proyecto: ``` { "mcpServers": { "leadconnector": { "type": "http", "url": "https://services.leadconnectorhq.com/mcp/anthropic/v2" } } } ``` La primera vez que lo uses, Claude Code abrirá el navegador para autorizar el acceso a Leadway. Verifica con `claude mcp list`. ### Claude Cowork 1. En **Claude Cowork**, abre la configuración de **conectores / integraciones** y elige **Agregar conector personalizado**. 2. Configura la URL del servidor como `https://services.leadconnectorhq.com/mcp/anthropic/v2`. 3. Completa el inicio de sesión de Leadway (inicia sesión → elige la subcuenta → aprueba). 4. Tus agentes de Cowork ya pueden usar las herramientas de Leadway. > **¿Prefieres usar un token?** En lugar de OAuth, puedes pasar un Token de Integración Privada en el encabezado `Authorization` (`Bearer pit-tu-token`), revisa la nota de configuración del PIT más arriba. ## Permisos y seguridad * **Tú eliges la subcuenta.** Al momento de conectar, seleccionas con qué subcuenta va a trabajar la conexión, **una subcuenta por conexión**. No llega a tus otras subcuentas; agrega una conexión distinta para cada subcuenta que quieras usar. * **Limitado a lo que otorgaste.** El asistente solo puede realizar las operaciones que tus permisos de OAuth (o de tu PIT) le permiten. Con OAuth puedes revisar o revocar el acceso en cualquier momento desde tu cuenta de Leadway. * **Validaciones de seguridad.** Las operaciones sensibles o irreversibles pasan por confirmaciones y validaciones de seguridad adicionales antes de ejecutarse. ## También disponible: el endpoint original (`/mcp/`) **Endpoint:** `https://services.leadconnectorhq.com/mcp/` El endpoint MCP original de Leadway. Funciona con **cualquier cliente MCP basado en HTTP** (Cursor, Windsurf, n8n, o tu propio agente), soporta **tanto OAuth como Token de Integración Privada**, y es una función a **nivel de subcuenta**. Expone un conjunto **más limitado y enfocado de herramientas centrales** (contactos, conversaciones, oportunidades, calendarios, pagos, planificador social, blogs, correos) con un alcance más reducido que el catálogo de `/mcp/{client}/v2`. > Para la cobertura más amplia, usa el endpoint por cliente recomendado descrito arriba. **Conectar con OAuth:** apunta tu cliente MCP a `https://services.leadconnectorhq.com/mcp/` y completa el inicio de sesión cuando se te pida. **Conectar con un Token de Integración Privada:** crea un token en **Configuración → Integraciones privadas** (seleccionando los permisos que tu IA necesita), y agrega el endpoint y los encabezados a tu cliente. El encabezado `locationId` es opcional, también se puede proporcionar en los prompts. ``` { "mcpServers": { "leadconnector-mcp": { "url": "https://services.leadconnectorhq.com/mcp/", "headers": { "Authorization": "Bearer pit-tu-token", "locationId": "tu-location-id" } } } } ``` ## Hoja de ruta La experiencia recomendada de OAuth por cliente se entrega cliente por cliente, cada uno con su propio endpoint siguiendo el patrón: `https://services.leadconnectorhq.com/mcp/{client}/v2` * **Disponible ahora**: `/mcp/anthropic/v2` (Claude: [Claude.ai](http://Claude.ai), Claude Code, Claude Cowork). * **Planeado, próximamente**: un endpoint dedicado `/mcp/{client}/v2` para: * **OpenAI (ChatGPT y Codex)** * **Cursor** * **Windsurf** * **VS Code** * ...y más. Mientras el endpoint dedicado de un cliente no esté disponible, se puede conectar hoy mismo a través del endpoint original `/mcp/` (OAuth o PIT). Vuelve a revisar esta guía conforme cada uno se vaya liberando. ## Pruébalo y déjanos tu feedback * Prueba el servidor MCP y cuéntanos qué te parece, tu feedback nos importa. * Conecta Claude, o construye tu propio agente sobre cualquiera de los dos endpoints. * Si tienes dudas o necesitas soporte, no dudes en contactarnos.