Aprende a configurar HighLevel MCP Server para conectar Claude, ChatGPT y agentes IA con contactos, oportunidades, calendarios y CRM.
HighLevel MCP Server permite que clientes y agentes compatibles con MCP consulten y ejecuten acciones dentro del CRM usando lenguaje natural y permisos controlados.
HighLevel MCP Server conectado con Claude y ChatGPT
HighLevel MCP Server: cómo conectar Claude, ChatGPT y agentes con tu CRM
Convierte HighLevel en un conjunto de herramientas que un asistente compatible con MCP puede descubrir, consultar y utilizar para trabajar con contactos, oportunidades, calendarios, conversaciones y más.
HighLevel MCP Server permite que asistentes y agentes compatibles con Model Context Protocol interactúen con herramientas y datos de HighLevel mediante una conexión estandarizada.
Por ejemplo, un usuario puede pedirle a un asistente que busque un contacto, revise oportunidades o consulte eventos del calendario. Además, cuando el token incluye permisos de escritura, el agente puede ejecutar determinadas acciones aprobadas dentro del CRM.
Esto evita tener que desarrollar una integración distinta para cada operación. En consecuencia, MCP puede funcionar como una capa común entre el modelo y HighLevel.
Puntos clave de HighLevel MCP Server
Qué es HighLevel MCP Server
En términos generales, MCP significa Model Context Protocol. Es un protocolo que permite que aplicaciones de inteligencia artificial descubran herramientas y trabajen con servicios externos mediante una interfaz común.
Además, HighLevel utiliza este protocolo para exponer diferentes operaciones de su CRM. Por tanto, un cliente compatible no necesita conocer todos los endpoints internos de la API antes de empezar.
Después, el cliente se conecta al servidor MCP, descubre las herramientas disponibles y utiliza únicamente aquellas autorizadas por los permisos de la conexión.
Cursor · Agente
MCP SERVER
Calendario · Mensajes
Qué puede hacer un agente mediante HighLevel MCP
En primer lugar, la cobertura depende de las herramientas disponibles y de los scopes que autorices. Sin embargo, la documentación oficial ya muestra operaciones para varias áreas importantes del CRM.
Contactos
Buscar, crear o actualizar contactos y trabajar con información disponible según los permisos.
Tags
Añadir o eliminar etiquetas cuando la integración dispone del scope correspondiente.
Conversaciones
Consultar historial y utilizar herramientas de mensajería compatibles con la conexión.
Calendarios
Recuperar eventos e información relacionada con calendarios y citas soportadas.
Oportunidades
Buscar oportunidades y actualizar determinados datos si autorizas operaciones de escritura.
Pagos
Consultar información disponible sobre órdenes o transacciones según las herramientas habilitadas.
Qué necesitas antes de conectar HighLevel MCP Server
En primer lugar, para la conexión general, HighLevel documenta cuatro elementos principales. Conviene prepararlos antes de configurar Claude, ChatGPT u otro cliente.
En HighLevel
- Acceso a la subcuenta deseada
- Private Integration Token
- Scopes requeridos
- Location ID de la subcuenta
En el cliente IA
- Compatibilidad con MCP remoto por HTTP
- Soporte de autenticación requerido
- Capacidad para descubrir tools
- Permisos administrativos cuando aplique
Cómo crear un Private Integration Token en HighLevel
En términos generales, HighLevel utiliza Private Integration Tokens para conexiones internas o de una ubicación concreta. El token representa los permisos que tendrá la integración.
Abre la subcuenta
Entra en la location que quieres conectar. Después, abre Settings.
Ve a Private Integrations
Abre la sección correspondiente y selecciona Create New Integration.
Selecciona scopes
Otorga únicamente los permisos que necesita el agente. Evita marcar todos los scopes por comodidad.
Crea la integración
HighLevel generará el token. Cópialo y guárdalo en un lugar seguro.
Trátalo como una credencial sensible. No lo pegues en una página pública, repositorio abierto, captura de pantalla ni código frontend.
Cómo configurar el endpoint de HighLevel MCP Server
En primer lugar, el endpoint general documentado por HighLevel es:
https://services.leadconnectorhq.com/mcp/.
Además, la petición debe incluir el Private Integration Token y el
locationId correspondiente a la subcuenta.
{
"mcpServers": {
"highlevel": {
"url": "https://services.leadconnectorhq.com/mcp/",
"headers": {
"Authorization": "Bearer TU_PRIVATE_INTEGRATION_TOKEN",
"locationId": "TU_LOCATION_ID"
}
}
}
}La sintaxis exacta puede cambiar según el cliente. Sin embargo, los tres elementos centrales permanecen: URL del servidor, autenticación y location.
locationId
de HighLevel
Cómo conectar Claude con HighLevel MCP
Por otra parte, HighLevel ofrece una experiencia especialmente interesante para Claude. Además del endpoint general, documenta un endpoint Anthropic multi-account pensado para agencias.
El endpoint específico actual es:
https://services.leadconnectorhq.com/mcp/anthropic/v2.
HighLevel indica que esta conexión puede utilizarse con Claude.ai, Claude Code y Claude Cowork. Asimismo, permite autorizar varias subcuentas y cambiar entre ellas dentro de la misma conversación.
Claude Code · Cowork
Multi-Account
Location B · Location C
Ejemplos de uso de HighLevel MCP con Claude
Ejemplos de instrucciones para Claude
Consulta
“Busca a María López en la subcuenta Clínica Centro y resume sus conversaciones recientes.”
Oportunidades
“Revisa las oportunidades abiertas de la subcuenta Agencia Norte y ordénalas por etapa.”
Calendario
“Muéstrame las citas de mañana en la location Consultorio MX.”
Acción
“Añade la etiqueta seguimiento-prioritario al contacto seleccionado.”
Cómo utilizar HighLevel MCP con ChatGPT
En términos generales, ChatGPT también admite aplicaciones MCP personalizadas para conectar herramientas y datos internos. Sin embargo, la disponibilidad depende del plan, del workspace y del nivel de permisos.
Actualmente, OpenAI está desplegando soporte MCP completo con acciones de escritura y modificación en beta para Business, Enterprise y Edu. Por tanto, una integración destinada a actualizar el CRM debe validarse contra las capacidades disponibles en tu plan.
En los espacios compatibles, un administrador puede habilitar Developer Mode y crear una app personalizada respaldada por un servidor MCP remoto.
Comprueba tu plan y rol
Verifica que tu workspace permita custom MCP apps y Developer Mode.
Habilita el modo desarrollador
La ruta exacta depende del tipo de workspace y de los permisos administrativos.
Crea una app MCP
Configura el servidor remoto y la autenticación admitida por la experiencia actual de ChatGPT.
Prueba antes de publicar
Valida herramientas de lectura y, posteriormente, acciones de escritura únicamente cuando tu workspace las permita.
Las funciones, planes y permisos pueden cambiar. Antes de publicar una integración para clientes, revisa la documentación vigente de OpenAI y prueba la autenticación con el endpoint de HighLevel.
Qué scopes deberías dar a un agente
En primer lugar, el principio más importante es el mínimo privilegio. Si un agente solamente necesita consultar contactos, no debería recibir permisos para modificar usuarios, pagos o datos no relacionados.
| Objetivo | Tipo de acceso | Recomendación |
|---|---|---|
| Buscar contactos | Lectura | Empieza con scopes read-only cuando sea posible |
| Enviar mensajes | Escritura | Limita el alcance y define cuándo requiere confirmación |
| Actualizar oportunidades | Escritura | Valida contacto, pipeline y etapa antes de ejecutar |
| Consultar calendario | Lectura | Ideal para asistentes informativos |
| Modificar registros | Escritura | Utiliza reglas y confirmaciones para cambios sensibles |
Casos de uso prácticos de HighLevel MCP Server
En la práctica, la ventaja de MCP aparece cuando una conversación puede convertirse en una secuencia de consultas y acciones dentro del CRM.
Resumen comercial
“Busca las oportunidades nuevas de esta semana y dime cuáles necesitan seguimiento.”
Soporte
“Encuentra al contacto por teléfono y resume sus últimas conversaciones.”
Agenda
“Muéstrame las citas de mañana y señala las que no tienen información completa.”
Higiene del CRM
“Busca contactos sin email dentro de esta lista y crea un resumen.”
Seguimiento
“Añade una etiqueta a los leads seleccionados después de mi aprobación.”
Pagos
“Revisa la información disponible de una transacción antes de escalar el caso.”
Workflow conversacional con MCP y HighLevel
Ejemplo de workflow conversacional
contacto”
HighLevel
la siguiente acción
Este patrón es especialmente útil porque separa la consulta de la ejecución. Primero el agente recupera información. Después, el usuario confirma una acción sensible.
HighLevel MCP multi-account para agencias
En términos generales, las agencias suelen administrar muchas locations. Crear una conexión independiente dentro de Claude para cada subcuenta sería poco práctico.
Por eso, HighLevel documenta un endpoint Anthropic multi-account que permite autorizar varias locations y seleccionar la cuenta correcta durante la conversación.
Ejemplo para una agencia
Puedes pedir: “En la subcuenta Restaurante Centro, revisa los contactos creados hoy”. Después, dentro de la misma conversación, puedes cambiar de location y solicitar otra operación.
Esto convierte Claude en una interfaz operativa sobre varias cuentas. Sin embargo, cada ejecución continúa limitada por la autorización y los permisos correspondientes.
Seguridad y mejores prácticas para HighLevel MCP
En primer lugar, dar acceso de escritura a un agente puede ahorrar tiempo. No obstante, también aumenta el impacto de una instrucción equivocada o de un prompt mal interpretado.
Autoriza únicamente los scopes necesarios para la función concreta
Solicita aprobación antes de acciones irreversibles o de alto impacto
Usa credenciales distintas por integración o entorno cuando sea posible
Registra qué tool utilizó el agente y qué operación se ejecutó
Empieza en una subcuenta o entorno de prueba antes de escalar
Revoca integraciones que ya no se utilizan y revisa scopes periódicamente
Buscar un contacto y eliminar un registro no tienen el mismo riesgo. Diseña el sistema para que el grado de autonomía dependa del impacto de cada operación.
HighLevel MCP Server vs API REST tradicional
En términos generales, MCP no reemplaza todas las integraciones REST. Ambos enfoques resuelven problemas distintos.
| Característica | MCP | API REST |
|---|---|---|
| Interfaz | Tools descubiertas por el cliente IA | Endpoints definidos explícitamente por el desarrollador |
| Lenguaje natural | Ideal para agentes y copilotos | Normalmente requiere lógica de aplicación propia |
| Control determinista | Depende de tool selection y orchestration | Muy alto cuando programas cada paso |
| Automatización tradicional | Útil cuando la IA decide qué tool usar | Ideal para flujos fijos y procesos backend |
| Mejor uso | Agentes, asistentes y interfaces conversacionales | Integraciones deterministas y aplicaciones tradicionales |
Errores frecuentes al conectar HighLevel MCP Server
Dar todos los scopes al token
Parece más rápido, pero aumenta innecesariamente el riesgo. Empieza con lectura y añade permisos según la función.
Usar el locationId equivocado
Comprueba que la location corresponde a la subcuenta que quieres exponer al agente.
Exponer la credencial
Nunca publiques el Private Integration Token dentro de documentación pública o repositorios abiertos.
No distinguir lectura de escritura
Define políticas distintas para consultar datos y modificar registros.
Asumir que todos los clientes MCP funcionan igual
Revisa transporte, autenticación, headers y permisos compatibles con cada cliente.
No probar prompts ambiguos
Comprueba qué hace el agente cuando existen dos contactos, dos locations o varias oportunidades parecidas.
Checklist antes de usar MCP con clientes reales
- El Private Integration Token pertenece a la location correcta
- Los scopes siguen el principio de mínimo privilegio
- Las consultas de lectura funcionan correctamente
- Las acciones de escritura fueron probadas por separado
- Existen confirmaciones para operaciones sensibles
- El agente sabe qué hacer cuando encuentra varios registros
- Los prompts especifican la subcuenta cuando existe multi-account
- El token está almacenado de forma segura
- Existe un proceso para revocar la integración
- Los logs permiten revisar acciones realizadas
- El equipo entiende qué herramientas puede utilizar el agente
- Las pruebas incluyen contactos y oportunidades con nombres similares
- Los permisos de ChatGPT o Claude fueron verificados para el plan actual
- La documentación se revisa antes de cambios importantes
Por qué HighLevel MCP puede cambiar la forma de operar un CRM
En primer lugar, un CRM tradicional obliga al usuario a navegar entre contactos, oportunidades, conversaciones y calendarios. MCP añade otra interfaz: lenguaje natural.
En lugar de aprender cada menú, una persona puede describir el resultado que necesita. Después, el agente utiliza herramientas autorizadas para consultar o ejecutar la operación correspondiente.
Sin embargo, la mejor implementación no busca reemplazar toda la interfaz. Debe automatizar tareas repetitivas y mantener control humano en decisiones sensibles.
Preguntas frecuentes sobre HighLevel MCP Server
¿Qué es HighLevel MCP Server?
Es un servidor basado en Model Context Protocol que permite a clientes compatibles descubrir y ejecutar herramientas autorizadas de HighLevel.
¿Cuál es el endpoint MCP de HighLevel?
El endpoint general documentado es
https://services.leadconnectorhq.com/mcp/.
¿Qué necesito para conectarlo?
Para la configuración general necesitas acceso a la location, un Private Integration Token, los scopes necesarios, el locationId y un cliente compatible con MCP.
¿Puedo conectar Claude con HighLevel?
Sí. Además, HighLevel documenta compatibilidad con clientes Claude y también ofrece un endpoint Anthropic multi-account para Claude.ai, Claude Code y Claude Cowork.
¿Puedo conectar ChatGPT con HighLevel mediante MCP?
ChatGPT admite custom MCP apps en experiencias compatibles. La disponibilidad de acciones de lectura y escritura depende del plan, workspace y permisos vigentes.
¿Puede un agente actualizar contactos?
De hecho, el agente puede actualizar contactos cuando la herramienta correspondiente está disponible y el token incluye los scopes necesarios de escritura.
Permisos, mensajes y multi-account
¿Puede enviar mensajes?
HighLevel documenta herramientas relacionadas con conversaciones y mensajería. El acceso depende de los scopes de la conexión.
¿Necesito instalar un SDK?
No para la conexión general. HighLevel documenta MCP como una conexión estandarizada por HTTP.
¿Puedo limitar qué puede hacer el agente?
Sí. Por otra parte, los scopes asignados al Private Integration Token controlan qué datos y operaciones quedan disponibles.
¿HighLevel MCP sirve para varias subcuentas?
HighLevel documenta una experiencia multi-account específica para Claude, que permite autorizar varias locations y cambiar entre ellas.
¿MCP reemplaza la API de HighLevel?
No. En cambio, MCP es especialmente útil para agentes y herramientas de IA. La API REST sigue siendo apropiada para integraciones deterministas, backends y workflows programados.
Conclusión
En términos generales, HighLevel MCP Server convierte el CRM en un conjunto de herramientas que asistentes y agentes compatibles pueden descubrir y utilizar mediante una conexión estandarizada.
Para empezar, crea una Private Integration, selecciona solamente los scopes necesarios y conecta el endpoint con el locationId correcto. Después, valida primero operaciones de lectura.
A continuación, añade acciones de escritura de forma gradual. Además, utiliza confirmaciones para tareas que puedan modificar datos importantes o comunicarse con clientes.
Finalmente, aprovecha MCP para crear interfaces conversacionales sobre contactos, oportunidades, calendarios y otros datos del CRM sin convertir al agente en un administrador sin límites.
Fuentes oficiales sobre HighLevel MCP Server
Fuentes oficiales consultadas
¿Quieres conectar un agente de IA con HighLevel?
En Zadrig Technology podemos configurar HighLevel MCP Server, Claude, ChatGPT, agentes de IA, permisos, CRM y automatizaciones para que tu equipo pueda consultar y ejecutar procesos mediante lenguaje natural sin perder control sobre los datos.
Hablar con Zadrig Technology →
