El servidor MCP (Model Context Protocol) de Leadway conecta de forma segura a asistentes de IA compatibles con MCP con tu CRM. Según los permisos (scopes) que autorices, el asistente puede buscar registros y realizar las acciones de lectura, creación, actualización y eliminación que le hayas permitido.

> **Elige la URL que corresponda a tu cliente de IA:** Claude se conecta en `https://services.leadconnectorhq.com/mcp/anthropic/v2`, mientras que ChatGPT, Codex y otros clientes compatibles con OpenAI se conectan en `https://services.leadconnectorhq.com/mcp/openai/v2/`.

## ¿Qué es MCP?

MCP es un protocolo abierto que estandariza la forma en que las aplicaciones le dan contexto a los modelos de lenguaje (LLM). El servidor MCP de Leadway le da a los asistentes de IA una forma estandarizada de trabajar con los datos y operaciones de tu cuenta, sin que tú ni el modelo necesiten conocer los detalles internos de cómo funcionan las APIs por debajo.

## Autenticación

Las conexiones al servidor MCP de Leadway usan **OAuth**. Al conectarte, tu cliente abre la pantalla de inicio de sesión y consentimiento de Leadway. Ahí eliges la subcuenta (o subcuentas) a la que la conexión podrá acceder y apruebas los permisos solicitados.

La integración solo puede realizar las operaciones que permitan los permisos que otorgaste. Puedes revisar o revocar su acceso en cualquier momento desde tu cuenta de Leadway.

Cada **solicitud** opera sobre una sola subcuenta. El endpoint también permite que una **agencia se conecte una sola vez y trabaje con varias subcuentas**, eligiendo la subcuenta correspondiente en cada solicitud (ver [Trabajar con varias subcuentas](#trabajar-con-varias-subcuentas-agencias)).

## Conéctate usando el endpoint de tu cliente

Usa el endpoint de OAuth que corresponda a tu cliente. Ambos endpoints dan acceso al catálogo activo de operaciones del servidor MCP de Leadway.

**Disponibles hoy:**

- **Claude:** `https://services.leadconnectorhq.com/mcp/anthropic/v2`
- **ChatGPT, Codex y otros clientes compatibles con OpenAI:** `https://services.leadconnectorhq.com/mcp/openai/v2/`

- **Amplia cobertura del CRM**: más de 550 operaciones activas de lectura, creación, actualización y eliminación, distribuidas en 38 áreas. Las operaciones exactas que ve el asistente dependen de los permisos de tu autorización OAuth.
- **OAuth**: te conectas a través del flujo de inicio de sesión y consentimiento de Leadway, sin tener que crear ni rotar tokens manualmente.
- **Una subcuenta, o toda tu agencia**: puedes conectarte a una **sola subcuenta** (la opción por defecto) o, como **agencia**, conectarte **una sola vez y trabajar con varias subcuentas** desde la misma conexión. Cada solicitud sigue ejecutándose sobre una sola subcuenta a la vez, la que tú elijas (ver [Trabajar con varias subcuentas](#trabajar-con-varias-subcuentas-agencias)).
- **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 las operaciones disponibles para tu conexión.

> **Una sola subcuenta:** con OAuth, tu cliente abre el navegador en la pantalla de inicio de sesión de Leadway. Inicias sesión, eliges la subcuenta que quieres exponer y apruebas el acceso. La conexión opera sobre esa subcuenta durante toda su vigencia.
>
> **Agencia, varias subcuentas:** al instalar como agencia, eliges **cuáles** subcuentas incluir. Esa misma conexión puede entonces trabajar con todas ellas. El asistente usa la subcuenta que le indiques, o te pregunta cuál usar cuando no es claro, y puedes cambiar entre subcuentas dentro del mismo chat. La conexión nunca toca subcuentas distintas a las que seleccionaste.

## 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 |
| --- | --- |
| `list_locations` | Lista las subcuentas que esta conexión puede usar, o regresa la única subcuenta vinculada, para poder elegir el contexto de CRM correcto |
| `search_operations` | Descubre operaciones activas según la intención, incluyendo búsqueda de registros y acciones de lectura, creación, actualización o eliminación |
| `describe_operation` | Revisa los datos de entrada de una operación, un ejemplo de payload, los permisos requeridos y la información de seguridad antes de ejecutarla |
| `execute_operation` | Ejecuta una operación, sujeta a los permisos de OAuth, los permisos de usuario, los límites de la cuenta y las validaciones de seguridad integradas |

Detrás de estas cuatro herramientas está el catálogo activo del servidor MCP de Leadway: **más de 550 operaciones en 38 áreas**. Usa `search_operations` en cualquier momento para ver exactamente qué está disponible para tu autorización OAuth.

## Un solo prompt en acción

Una vez conectado, no necesitas conocer la API de Leadway, simplemente preguntas. Por ejemplo:

> _"Busca el contacto con el correo jane@example.com, agrégale la etiqueta 'vip-2026' y crea una nueva oportunidad en el embudo de 'Ventas' para él/ella por $5,000."_

Detrás de escena, el asistente hace lo siguiente:

1. `search_operations` → descubre las operaciones para buscar el contacto, agregar etiquetas y crear una oportunidad
2. `describe_operation` → revisa los datos de entrada, los permisos y la información de seguridad de cada operación
3. `execute_operation` → encuentra el contacto de Jane
4. `execute_operation` → agrega la etiqueta y crea la oportunidad

Y recibes una sola confirmación, en lenguaje natural.

## Trabajar con varias subcuentas (agencias)

Un usuario individual se conecta a una sola subcuenta y no vuelve a pensar en el tema. Las **agencias**, en cambio, pueden conectarse **una sola vez** y trabajar con **varias** subcuentas desde la misma conexión, sin necesidad de una conexión distinta por cada subcuenta.

**Cómo funciona:**

1. **Instala para tu agencia.** Al conectarte, eliges **cuáles** subcuentas incluir (una, varias o todas). La conexión solo podrá trabajar con esas, y con ninguna otra.
2. **Nombra la subcuenta, o deja que el asistente pregunte.** En tu solicitud, menciona la subcuenta por su nombre (por ejemplo, _"en la Clínica Centro, ..."_). Si no lo indicas y hay ambigüedad, el asistente llama a `list_locations` y te pide que elijas.
3. **Cambia libremente dentro del mismo chat.** Pregunta sobre una subcuenta y luego sobre otra, sin reconectarte: _"ahora haz lo mismo para la sucursal Norte."_

**Ejemplo:**

> _"Lista los contactos con la etiqueta 'vip-2026' en la Clínica Centro, y luego compara el total con Spa Norte."_

El asistente usa `list_locations` para identificar las subcuentas por nombre, ejecuta la consulta en cada una y te reporta ambos resultados, cada solicitud autorizada según tu instalación.

> **Una subcuenta a la vez, siempre autorizada.** Cada solicitud se ejecuta sobre una sola subcuenta que elegiste al momento de instalar la conexión. Una solicitud sobre una subcuenta que no incluiste (o que no forma parte de tu instalación) se rechaza. La conexión nunca puede llegar más allá de las subcuentas que seleccionaste.

> **Disponibilidad:** las conexiones individuales a una sola subcuenta ya están disponibles. Las conexiones de agencia con varias subcuentas se están **liberando de forma gradual**, una agencia las habilita al instalar con la opción de varias subcuentas (masiva). Si tu instalación solo ofrece una subcuenta, esa opción todavía no está habilitada para tu app.

## Qué puedes hacer

El catálogo activo de operaciones MCP incluye:

- **Contactos** — obtener y buscar contactos; crear, actualizar, eliminar y upsert; búsqueda de duplicados; etiquetas, notas, tareas, seguidores, campañas, citas, asignación de negocio e inscripción a automatizaciones
- **Conversaciones y mensajes** — crear, obtener, actualizar, eliminar y buscar conversaciones; leer y enviar mensajes; adjuntos, mensajes programados, actualizaciones de estatus, grabaciones, transcripciones, exportaciones e indicadores de "escribiendo"
- **Oportunidades y embudos de ventas** — embudos, motivos de pérdida, búsqueda, creación, actualización, eliminación, upsert, seguidores y cambios de estatus
- **Calendarios y citas** — calendarios, grupos, citas, eventos, notas, notificaciones, horarios libres y bloqueados, recursos, horarios de disponibilidad, servicios, ubicaciones de servicio y reservaciones
- **Pagos** — cupones, configuración de proveedores de pago, integraciones, órdenes, cumplimiento (fulfillment), pagos registrados, suscripciones y transacciones
- **Productos y tienda** — productos, precios, colecciones, inventario, reseñas, ubicación en tienda, paqueterías, zonas y tarifas, y configuración de la tienda
- **Facturas, cotizaciones y documentos** — facturas, cotizaciones, plantillas, calendarios de pago, pagos manuales, acciones de envío y anulación, conversión de cotización a factura, propuestas y enlaces a documentos
- **Planeador de redes sociales** — cuentas sociales, publicaciones, comentarios, categorías, etiquetas, importaciones CSV, colas por categoría, vistas de calendario, sesiones de edición y estadísticas
- **Blogs** — sitios de blog, autores, categorías, publicaciones y verificación de slugs
- **Correo electrónico** — plantillas, carpetas e importaciones, campañas, programación, estadísticas de campañas, campañas de acción masiva, campañas por automatización y verificación de correos
- **Formularios y encuestas** — formularios, encuestas y sus respuestas
- **Sitios (embudos)** — embudos, páginas de embudo, conteo de páginas y redirecciones
- **Automatizaciones** — búsqueda de automatizaciones; la inscripción y remoción de contactos está disponible a través de las operaciones de contactos
- **Agentes de voz con IA** — agentes, acciones de agente y bitácoras de llamadas
- **Sistema telefónico** — grupos de números, números activos y disponibles, y compra de números
- **Base de conocimiento** — bases de conocimiento, rastreo y entrenamiento de sitios web, estatus de rastreo, preguntas frecuentes y archivos
- **Biblioteca de medios y archivos** — archivos y carpetas, creación de carpetas, y actualización y eliminación masiva de medios
- **Tableros de marca** — kits de diseño, voces de marca y configuración de marca predeterminada
- **Objetos personalizados, campos y asociaciones** — esquemas de objetos, registros, búsqueda de registros, campos y carpetas personalizadas, definiciones de asociación y relaciones entre registros
- **Subcuentas y configuración del CRM** — búsqueda y consulta de subcuentas, canales de conversación, valores personalizados, tareas recurrentes, etiquetas, plantillas, zonas horarias y búsqueda de tareas
- **Negocios y usuarios** — negocios y usuarios, incluyendo búsqueda, creación, actualización y eliminación
- **Marketplace y monedero** — detalles del instalador, cargos al monedero, verificación de fondos y transacciones del monedero de la subcuenta
- **Anuncios y afiliados** — operaciones compatibles de publicidad en Facebook, Google y LinkedIn; audiencias, formularios de prospectos, reportes, afiliados, comisiones y pagos
- **Otras áreas del CRM** — widgets de chat, enlaces, snapshots, campañas y cursos

Las operaciones disponibles dependen de tus permisos y alcance de OAuth. Pídele a `search_operations` las operaciones exactas disponibles para tu conexión.

## Conectar Claude (`/mcp/anthropic/v2`)

Claude se conecta a `https://services.leadconnectorhq.com/mcp/anthropic/v2` mediante OAuth.

### Claude.ai

1. Abre **Claude.ai** → **Settings** → **Connectors** → **Add custom connector**.
2. Ingresa como URL del servidor `https://services.leadconnectorhq.com/mcp/anthropic/v2`.
3. Haz clic en **Connect** y completa el inicio de sesión de Leadway (inicia sesión → elige la(s) subcuenta(s) → aprueba).
4. Abre un chat nuevo, las herramientas de Leadway ya estarán disponibles.

> **Tip:** pregunta _"Busca los últimos 5 contactos que agregué en Leadway"_ para confirmar que la conexión funciona.

### Claude Code (CLI)

```
claude mcp add --transport http leadway https://services.leadconnectorhq.com/mcp/anthropic/v2
```

O agrégalo al archivo `.mcp.json` en la raíz de tu proyecto:

```
{
  "mcpServers": {
    "leadway": {
      "type": "http",
      "url": "https://services.leadconnectorhq.com/mcp/anthropic/v2"
    }
  }
}
```

La primera vez que lo uses, Claude Code abrirá un navegador para la autorización de Leadway. Verifica con `claude mcp list`.

### Claude Cowork

1. En **Claude Cowork**, abre la configuración de **connectors / integrations** y elige **Add custom connector**.
2. Ingresa como URL del servidor `https://services.leadconnectorhq.com/mcp/anthropic/v2`.
3. Completa el inicio de sesión de Leadway (inicia sesión → elige la(s) subcuenta(s) → aprueba).
4. Tus agentes de Cowork ya pueden usar las herramientas de Leadway.

## Conectar clientes de OpenAI (`/mcp/openai/v2/`)

ChatGPT, Codex y otros clientes compatibles con OpenAI se conectan a `https://services.leadconnectorhq.com/mcp/openai/v2/` mediante OAuth.

### ChatGPT

1. En ChatGPT, abre **Settings** → **Security and login** y activa el **Developer mode**.
2. Abre **ChatGPT Plugins**, selecciona el botón de más (+) y crea un plugin nuevo.
3. Ingresa un nombre y una descripción. En **Connection**, agrega `https://services.leadconnectorhq.com/mcp/openai/v2/` como URL del servidor MCP y crea la conexión.
4. Completa el flujo de OAuth de Leadway (inicia sesión → elige la(s) subcuenta(s) → aprueba).
5. Inicia una conversación nueva y agrega la conexión de Leadway desde el menú de herramientas.

### Codex

Agrega el servidor de Leadway y luego inicia el flujo de OAuth:

```
codex mcp add leadway --url https://services.leadconnectorhq.com/mcp/openai/v2/
codex mcp login leadway
```

En la extensión de Codex para tu IDE, abre el menú de engranaje → **MCP servers** → **Add server**, elige **Streamable HTTP** e ingresa la misma URL. Selecciona **Authenticate** para completar el OAuth cuando se te solicite.

Otros clientes compatibles con OpenAI pueden usar el mismo endpoint como un servidor MCP remoto Streamable HTTP y completar el flujo de OAuth de Leadway cuando se les solicite.

## Permisos y seguridad

- **Tú eliges las subcuentas.** Al momento de conectarte, seleccionas sobre qué subcuenta(s) puede operar la conexión, una sola, o (para agencias) varias. Nunca llega a una subcuenta que no incluiste, y cada solicitud se autoriza contra tu instalación antes de ejecutarse.
- **Limitado a tu autorización.** El asistente solo puede realizar las operaciones que permitan tus permisos de 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.

## Pruébalo y déjanos tu opinión

- Prueba el servidor MCP y cuéntanos qué te pareció, tu opinión nos ayuda a mejorar.
- Conecta Claude, ChatGPT o Codex.
- Si tienes dudas o necesitas soporte, contáctanos.