Conectar Claude Code con GoHighLevel permite convertir una instrucción en operaciones sobre contactos, oportunidades y notas. El valor está en mantener el contexto comercial mientras el agente realiza pasos que normalmente harías en distintas pantallas del CRM.
En el video del 27 de abril de 2026 mostré una solicitud de ejemplo: buscar un contacto, crearlo si faltaba, añadir una oportunidad y dejar una nota de seguimiento. Después comprobé los resultados dentro de GoHighLevel. Puedes ver la conexión y los ejemplos en YouTube.
Qué parte del negocio estamos conectando
GoHighLevel reúne funciones de CRM, calendarios, comunicaciones y otros procesos comerciales. En este caso nos interesa operar información existente: quién es el contacto, en qué etapa está y qué debe pasar después.
Una orden como “crea la oportunidad y deja pendiente la revisión del viernes” contiene varias acciones. Primero hay que identificar al contacto, después localizar el pipeline y luego añadir los datos correctos. La conexión técnica permite hacerlo, pero necesitas explicar el significado de cada dato.
Por ejemplo, una oportunidad con valor de 5.000 no es automáticamente un ingreso de 5.000. Puede ser una estimación de una venta todavía abierta. Esa diferencia importa al pedir resúmenes o al usar el CRM para decidir qué seguimiento hacer.
MCP y API son dos formas de acceder a funciones autorizadas
La guía oficial del servidor MCP de HighLevel documenta una conexión mediante un Private Integration Token y un identificador de subcuenta, llamado location ID. Las herramientas disponibles dependen de sus capacidades y de los permisos del token.
En el video también configuré la posibilidad de usar la API para operaciones que no estaban expuestas como herramientas MCP. Eso amplía las opciones de implementación, pero no elimina los permisos del servicio. Si una acción está prohibida para el token, cambiar de MCP a API no la autoriza.
La guía de skills, MCP y operación de herramientas explica esta distinción entre procedimiento, conexión y resultado verificable.
Elige la subcuenta y los permisos que necesitas
En la grabación distinguí los accesos de agencia y de subcuenta. Para gestionar los contactos de un negocio, identifica primero la subcuenta correcta. No necesitas administrar otras empresas para registrar un lead en la que estás trabajando.
La versión de la demo exploraba permisos amplios. Para implementar el caso de esta guía, empieza por los necesarios: lectura de contactos y oportunidades, y las operaciones de escritura que realmente vayas a probar. Si después necesitas otra capacidad, puedes revisar su permiso específico.
El token es una credencial. El location ID identifica la subcuenta. Guarda ambos en la configuración apropiada, pero no publiques el token ni lo incluyas en un repositorio compartido. Las capturas de esta guía evitan los pasos donde aparecían claves en la grabación.
Un ejemplo de configuración sin incrustar la clave
El servidor documentado de HighLevel es https://services.leadconnectorhq.com/mcp/. Este ejemplo adapta su conexión al formato de Claude Code usando variables de entorno:
{
"mcpServers": {
"ghl": {
"type": "http",
"url": "https://services.leadconnectorhq.com/mcp/",
"headers": {
"Authorization": "Bearer ${GHL_PIT_TOKEN}",
"locationId": "${GHL_LOCATION_ID}"
}
}
}
}
Debes definir esas variables en el entorno desde el que inicia Claude Code. Escribir sus nombres en el archivo no crea sus valores ni autentica la cuenta. La documentación de MCP en Claude Code explica la expansión de variables y la comprobación del servidor.
En la grabación faltaba el tipo de transporte y la conexión no aparecía como esperaba. Al especificar http y reiniciar la sesión, pude continuar. El aprendizaje es revisar la configuración y su estado real, no asumir que guardar un archivo ya dejó el servicio conectado.
Comprueba primero una consulta de lectura
Después de conectar, pide que identifique la subcuenta y consulte un contacto de prueba conocido. Comprueba que el resultado corresponde al negocio correcto y que los campos tienen el significado esperado.
Luego puedes probar una escritura acotada. Este ejemplo editorial sirve para repetir el caso:
Busca el contacto de prueba por su correo exacto.
Si hay más de una coincidencia, explica la ambigüedad.
Si no existe, prepara su creación con los datos que te entregué.
Asócialo al pipeline y etapa indicados, usando sus identificadores.
Añade una nota de seguimiento con fecha explícita.
Al terminar, devuelve el ID del contacto, la oportunidad y la nota.
No envíes mensajes ni enlaces de pago en esta prueba.
Usar una fecha explícita es mejor que conservar “el viernes” sin contexto. Si la instrucción se ejecuta después o queda guardada para otra sesión, el significado relativo puede cambiar.
Revisa duplicados antes de volver a intentar
Un error de conexión no siempre significa que la escritura falló. El servicio pudo crear el contacto y después perderse la respuesta. Si el agente repite inmediatamente la operación, puede duplicar el registro.
El mismo cuidado se aplica al fallback de MCP a API. Primero intenta averiguar qué ocurrió: buscar por el identificador recibido o consultar el contacto y su historial. Después decide si hay que repetir, completar un paso o informar que el estado es incierto.
| Resultado observado | Revisión útil |
|---|---|
| Contacto creado | Correo, nombre e identificador correctos |
| Oportunidad creada | Pipeline, etapa, moneda y valor esperados |
| Nota añadida | Texto, fecha y contacto asociados |
| Respuesta incompleta | Consultar el estado antes de repetir escrituras |
| Operación no permitida | Revisar el permiso necesario y el alcance |
Estas comprobaciones convierten la respuesta “listo” en evidencia que puedes contrastar en el CRM. Son especialmente útiles cuando una orden contiene varios pasos y solo algunos terminan bien.
Gestionar desde Telegram añade otra capa
En el video también mostré ejemplos de interacción mediante Telegram. Ese canal puede facilitar pedir acciones por voz o texto, pero necesita su propia conexión y una sesión o servicio que esté disponible para atenderlas.
No forma parte automáticamente de instalar el MCP de GoHighLevel. Hay que controlar quién puede enviar instrucciones y cómo se asocian con el negocio correcto. Para explorar la diferencia entre un proyecto de Claude Code y un asistente persistente, puedes seguir la comparación con OpenClaw.
Antes de habilitar comunicaciones externas, revisa destinatarios, contenido y reglas del proceso. Una consulta de pipeline y un correo enviado a un cliente tienen efectos diferentes. El flujo debe distinguirlos con claridad.
Dónde aparece el valor comercial
La tesis del video es reducir fricción en el seguimiento: registrar lo que se conversó, mantener oportunidades actualizadas y no depender de recordar cada paso después de una llamada. Eso puede hacer el trabajo más consistente.
Para medirlo, observa tiempo de respuesta, registros completos y seguimientos pendientes. Evita convertir el valor de las oportunidades abiertas en ingresos garantizados. La integración es una herramienta operativa; el resultado depende de tu oferta, tus clientes y el proceso comercial.
Video completo y recursos
Ve la demo de Claude Code y GoHighLevel para seguir los pasos y comprobar las operaciones del ejemplo. La documentación enlazada en esta guía es la referencia para los permisos y la conexión actuales.
En Imperio Agéntico compartimos recursos de implementación y trabajamos con procesos reales de negocio. Puedes suscribirte al canal para seguir las demostraciones.
Preguntas frecuentes
¿Qué necesito para conectar Claude Code con GoHighLevel?
Una integración autorizada con Private Integration Token, el location ID de la subcuenta y la configuración del servidor MCP. Los permisos deben cubrir las operaciones que quieras realizar.
¿Debo dar todos los permisos de GoHighLevel al agente?
Para este caso conviene comenzar con los necesarios para consultar y gestionar los registros de prueba. Añade capacidades cuando el trabajo las requiera, manteniendo claro el alcance.
¿Por qué incluir type http en la configuración MCP?
Indica el transporte utilizado por ese servidor remoto. En la grabación la configuración incompleta impidió que la conexión apareciera como se esperaba; se corrigió y se reinició la sesión.
¿Usar la API permite evitar los permisos que limitan el MCP?
No. La API puede ofrecer operaciones adicionales, pero sigue sujeta a la autorización del servicio. Un permiso faltante no se resuelve cambiando el mecanismo de llamada.
¿Cómo evito duplicados si falla una operación del CRM?
Consulta el estado del contacto o la oportunidad antes de repetir la escritura. Un error al recibir la respuesta no demuestra que el servicio no haya creado el registro.
¿La integración con GoHighLevel instala también Telegram?
No. Telegram requiere una conexión y un servicio o sesión disponibles para recibir instrucciones. Es una capa adicional a la configuración del MCP del CRM.