Claude MCP en GoHighLevel: conéctalo y analiza tu CRM
Claude MCP en GoHighLevel: conecta Claude a tus subcuentas sin apps externas y pídele en español dashboards, contactos y los prospectos sin respuesta.
HighLevel Playbook Problemas reales y soluciones prácticas.
Capítulos del video · 12
- 00:00Conectar Claude con GoHighLevel vía MCP
- 00:32Claude Desktop y el archivo claude_desktop_config.json
- 02:03El código del MCP: Bearer y location ID
- 03:09Conectar varias subcuentas de GoHighLevel
- 03:54Crear la Private Integration y sus scopes
- 05:07Pegar tu API key y el location ID
- 06:57Reiniciar Claude y activar el conector
- 08:28Caso 1: dashboard de oportunidades con Claude
- 09:43Contactos y oportunidades: lo que el MCP sí y no hace
- 13:43Caso 2: conversaciones sin respuesta
- 15:18Error de scope: cómo darle permisos a Claude
- 16:10Seguimientos sugeridos para cada prospecto
En este artículo 9
- Paso a paso
- Qué es el MCP de GoHighLevel y por qué conectarlo a Claude
- Las dos formas de conectar Claude a GoHighLevel hoy
- Conectar Claude a GoHighLevel con el código, paso por paso
- Varias subcuentas de GoHighLevel en el mismo Claude
- Lo que Claude puede hacer en tu CRM (y lo que no podía)
- El caso que más sirve: los prospectos que nadie contestó
- El error «el token no está autorizado para este scope»
- Preguntas frecuentes
Paso a paso
- Crea tu cuenta de Claude e instala la app de escritorio en tu computadora (00:32).
- En Claude, ve a tu nombre → Configuración → Desarrollador → Editar configuración y abre claude_desktop_config.json con VS Code (01:03).
- Pega el código de este post y cambia el nombre de la conexión por el de tu subcuenta (02:03).
- En GoHighLevel, entra a Settings → Private Integrations → Create new integration, ponle «Claude MCP» y elige los scopes (03:54).
- Copia el token y pégalo después de «Bearer », sin borrar el espacio (05:07).
- Copia el location ID de la URL de tu subcuenta y pégalo en su línea (05:38).
- Guarda, cierra Claude por completo, ábrelo de nuevo y activa el conector en + → Conectores (06:57).
- Pídele que se conecte a tu subcuenta y dale permiso cuando te lo pida (07:44).
Qué es el MCP de GoHighLevel y por qué conectarlo a Claude
No necesitas saber qué es un MCP para usarlo. Piensa en él como el puente entre Claude y tu cuenta de HighLevel: del otro lado del puente están tus contactos, tus oportunidades y tus conversaciones, y Claude puede cruzarlo para leerlos o, si tú se lo permites, para cambiarlos.
La diferencia con exportar un CSV y subirlo a un chat es que aquí Claude trabaja con los datos de hoy, no con los del archivo que bajaste la semana pasada. Le preguntas y va a buscar la respuesta a tu subcuenta.
¿Para qué sirve en la práctica? En el video hago dos pruebas. En la primera le pido que analice las oportunidades de mi pipeline y me arme un dashboard, sin decirle nada más: trajo 14 oportunidades con su campaña, su valor y su estado (08:28). En la segunda le pido las conversaciones donde el prospecto mandó el último mensaje y nadie le contestó (13:43). Esa segunda es la que más le sirve a un gerente comercial o al dueño del negocio, y la explico abajo.
Si quieres ver qué más se puede hacer con IA dentro de la plataforma, en IA en HighLevel están todos los posts del tema.
Las dos formas de conectar Claude a GoHighLevel hoy
Desde que grabé el video, HighLevel sacó una segunda forma de conectarlo. Las dos sirven; elige según lo que necesites.
Opción 1: el conector oficial (sin código)
Es la más sencilla. No tocas ningún archivo ni copias tokens: inicias sesión con tu usuario de HighLevel, eliges la subcuenta y apruebas los permisos.
- En Claude, ve a Configuración → Conectores → Agregar conector personalizado.
- Pega esta URL:
https://services.leadconnectorhq.com/mcp/anthropic/v2 - Dale a Conectar, inicia sesión en LeadConnector, elige tu subcuenta y aprueba.
- Abre un chat nuevo: las herramientas de HighLevel ya están disponibles.
Fíjate en algo que cambió: con este conector Claude ya puede crear oportunidades, que era justo lo que no podía hacer cuando grabé. Y antes de cualquier cambio en tu cuenta te pide confirmación.
Opción 2: con una Private Integration (el método del video)
Es la que ves en el video. Te pide editar un archivo, pero tiene una ventaja: tú decides exactamente qué permisos le das a Claude en cada subcuenta, y puedes dejar una subcuenta solo con lectura. Ahí te va.
Conectar Claude a GoHighLevel con el código, paso por paso
1. Instala Claude de escritorio
Esto sí es importante: el archivo de configuración solo existe en la app de escritorio, no en la versión web (00:32). Descárgala desde claude.ai, instálala y entra con tu cuenta.
Luego ve al menú → tu nombre → Configuración → Desarrollador → Editar configuración. Se abre la carpeta con el archivo claude_desktop_config.json. Yo te recomiendo abrirlo con VS Code: arrastras el archivo y listo (01:03). La realidad es que no le tienes que tener miedo; son unas cuantas líneas y solo cambias tres datos.
2. Pega el código
Este es el código que prometí en el video. Borra lo que tenga el archivo (si nunca lo has tocado, está vacío o casi), pega esto y guárdalo:
{
"mcpServers": {
"GHL Mi Subcuenta": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://services.leadconnectorhq.com/mcp/",
"--header",
"Authorization: Bearer pit-TU-TOKEN",
"--header",
"locationId: TU-LOCATION-ID"
]
}
}
}
Es el mismo código que uso en el video: el Authorization va en la línea 10. Este formato usa mcp-remote y necesita Node.js instalado en la computadora.
Tres cosas cambias: el nombre (en el video le puse «GHL Attribution», que es como se llama mi subcuenta; pon el nombre de la tuya para reconocerla), el token y el location ID (02:03).
3. Crea la Private Integration y elige los scopes
En tu subcuenta de GoHighLevel ve a Settings → Private Integrations → Create new integration. Ponle un nombre que reconozcas, como «Claude MCP», y dale Next (03:54).
Ahora eliges los scopes, es decir, qué va a poder hacer Claude en tu subcuenta (04:06):
- View: solo ver la información, traerla, resumirla y trabajarla.
- Edit: crear, editar y actualizar. Con edit en contactos, Claude puede crear contactos.
- Conversations write: enviar mensajes. Piénsalo dos veces antes de darlo.
En el video le doy acceso a todo porque es un tutorial. En tu cuenta real, yo te recomiendo empezar con view y subir permisos cuando los necesites. Imagínate que le pides algo ambiguo y tiene permiso de enviar mensajes a tus clientes: mejor que no pueda.
4. Pega el token y el location ID
Al crear la integración, GHL te muestra el token, que empieza con «pit-». Cópialo y pégalo en el código, después de «Bearer ». Ten en cuenta el espacio entre «Bearer» y el token: es normal, no lo borres (05:07).
El location ID es el ID de tu subcuenta y está en la URL: busca la parte que dice locations; el código que sigue es tu location ID (05:38). Pégalo en su línea y guarda.
Ojo con el token: es la llave de tu subcuenta. No lo compartas ni lo pegues en un documento que vean otros. Si se te escapa, bórralo en Private Integrations y crea otro.
5. Reinicia Claude y activa el conector
Cierra Claude por completo, no solo la ventana, y ábrelo otra vez (06:57). En el chat, dale a + → Conectores: ahí aparece tu conexión con el nombre que le pusiste. Actívala.
Para probar, escríbele algo como «conéctate a mi subcuenta de GoHighLevel con el conector GHL Mi Subcuenta». A veces te pide el location ID otra vez; no te preocupes, se lo pegas. Y cuando te pida permiso para usar la herramienta, le dices que sí (07:44).
Varias subcuentas de GoHighLevel en el mismo Claude
Cada bloque del código es una conexión a una subcuenta. Para agregar otra, copias el bloque completo de la conexión, le pones una coma al final del primero, lo pegas debajo y le cambias el nombre (03:09). Si dos se llaman igual, VS Code te marca una línea amarilla: es la señal de que te faltó cambiar el nombre.
Cada subcuenta lleva su propia Private Integration, con su token y su location ID. Fíjate que en el video a la segunda subcuenta solo le doy permisos de ver conversaciones, contactos y oportunidades (05:54). Así puedes tener una subcuenta donde Claude trabaja y otra donde solo consulta.
Después, en el chat, le dices con cuál trabajar por su nombre. Si no responde, revisa que ese conector esté activado en + → Conectores; a mí me pasó en el video (14:28).
Lo que Claude puede hacer en tu CRM (y lo que no podía)
En el video le pido crear un contacto, Fernando Aguilar, con la etiqueta «lead nuevo» (09:43). Lo creó, pero el dictado no me entendió y le puso un ID como etiqueta. Lección: cuando le pidas algo que cambia tu cuenta, escríbelo claro y revisa el resultado en GHL.
Luego le pido crear una oportunidad para ese contacto, y ahí topa: con el token, el MCP solo traía herramientas para buscar y actualizar oportunidades, no para crearlas (10:55). La creé a mano y le pedí que la moviera a la etapa «Contacted»: eso sí lo hizo (12:57). Si estás armando tus etapas, te explico cómo pensarlas en el post del pipeline en GoHighLevel.
Como te dije arriba, el conector oficial ya trae la herramienta para crear oportunidades. Si tu caso necesita crear oportunidades desde Claude, empieza por esa opción.
Y el dashboard del primer caso salió así de completo porque esa subcuenta guarda la campaña de origen de cada oportunidad. Si quieres que tus datos tengan esa atribución, eso lo armo en el tracking de leads en GoHighLevel.
El caso que más sirve: los prospectos que nadie contestó
Mucha gente tiene esta duda: ¿cómo estamos atendiendo a los prospectos? ¿Cuáles se quedaron sin contestar? ¿Se les está dando seguimiento? En vez de abrir conversación por conversación, se lo preguntas a Claude.
Este es el prompt que uso en el video (16:10), un poco limpio para que lo copies:
Analiza las conversaciones de las últimas 12 horas e identifica aquellas en las que el prospecto envió el último mensaje y no ha tenido respuesta de nuestra parte. Crea una tabla con un mensaje de seguimiento para cada una, con base en el contexto de la conversación. Analiza solo 10 conversaciones que cumplan estos criterios.
Lo de las 10 conversaciones es para la prueba: si le pides todas, tarda mucho. El resultado fue una tabla con el contexto de cada hilo, un seguimiento sugerido y cuatro casos críticos con intención clara de compra, «los primeros en atacar». Uno era un lead nuevo que había mandado el PDF de su proyecto y no había recibido ni un saludo (18:14).
Un tip de privacidad: pídele que use IDs en lugar de nombres y teléfonos (17:17). Así puedes enseñar el análisis o trabajarlo con tu equipo sin exponer los datos de tus clientes.
Este análisis te dice a quién le debes un mensaje hoy. Para que no vuelva a pasar, lo que sigue es automatizar el seguimiento automático en GoHighLevel. Y si quieres analizar meses de conversaciones de golpe, ahí conviene exportar las conversaciones de HighLevel y trabajarlas con IA.
El error «el token no está autorizado para este scope»
Si Claude te dice que el token no está autorizado para un scope, no es que algo esté roto: le estás pidiendo algo para lo que no le diste permiso (15:18). En el video me pasó con la segunda subcuenta, porque le había dado muy pocos permisos.
Para arreglarlo:
- Ve a Settings → Private Integrations en esa subcuenta y edita la integración de Claude.
- Agrega el scope que falta (Claude suele decirte cuál).
- Si GHL te da un token nuevo, cámbialo en el código y guarda.
- Cierra Claude por completo y ábrelo otra vez.
Así de sencillo. Y qué bueno que surgen errores, porque así ya sabes qué hacer cuando te pase.
Menos teoría. Más acción.
HighLevel Playbook
Problemas reales y soluciones prácticas. Lo que importa para trabajar mejor con HighLevel.
Preguntas frecuentes
¿Necesito pagar alguna app para conectar Claude a GoHighLevel?
No. Con cualquiera de las dos formas conectas Claude directo al MCP de HighLevel, sin apps de terceros. Solo necesitas tu cuenta de Claude y tu cuenta de HighLevel.
¿Puedo darle a Claude acceso de solo lectura?
Sí. En la Private Integration eliges solo los scopes de view: Claude podrá consultar y analizar, pero no crear, editar ni enviar mensajes. Es lo que te recomiendo para empezar.
¿Qué ventaja tiene sobre la IA que ya trae GoHighLevel?
Con Claude trabajas con varias subcuentas desde el mismo chat y conviertes los datos en tablas, dashboards o análisis a tu medida, con tus propios prompts. Y puedes cruzar lo que trae de GHL con otros archivos o herramientas que ya usas en Claude.
¿Claude puede enviar mensajes a mis clientes?
Solo si le das el permiso de conversations write. Sin ese scope, puede leer las conversaciones y sugerirte el mensaje, pero el envío lo haces tú. Para un negocio que apenas empieza a usarlo, así es más seguro.
¿Te sirvió este tutorial?
