---
type: SOP
asset_id: SOP-EL-GHL-ClaudeCode-MCPConexion-v01
version: v01
status: Draft
owner: Juan Carlos
sherpa_owner: JuanCarlosX
fecha_creacion: 2026-06-10
fecha_ultima_actualizacion: 2026-06-10
intellbank: IB-EL-EmpowerLabs
subbank: BOS-EL-WORX-OS
proposito: Procedimiento para conectar el servidor MCP oficial de GoHighLevel a Claude Code en 4 pasos · Windows y Mac · incluye 20 prompts avanzados de uso
---

## Asset Header

- **Asset ID:** SOP-EL-GHL-ClaudeCode-MCPConexion-v01
- **Version:** v01
- **Status:** Draft
- **Owner:** Juan Carlos
- **Sherpa:** JuanCarlosX
- **IntellBank:** IB-EL-EmpowerLabs
- **SubBank:** BOS-EL-WORX-OS
- **Tipo:** SOP — Procedimiento Operativo Estándar
- **Propósito:** Procedimiento para conectar el servidor MCP oficial de GoHighLevel a Claude Code en 4 pasos · Windows y Mac · incluye 20 prompts avanzados de uso
- **Fecha creación:** 2026-06-10
- **Última actualización:** 2026-06-10

---

# Guía de Integración: GoHighLevel + Claude Code

Conecta tu CRM a la IA en menos de 5 minutos · Funciona en Windows y Mac

---

## ✅ Hallazgos de validación — 2026-06-10

Validado en segunda computadora (Windows, sin Node.js, misma cuenta de Claude):

- **El script PowerShell (Opción B) funciona correctamente** sin Node.js instalado.
- **Claude Code se auto-conecta al MCP** si detecta que la conexión no está activa al intentar ejecutar una tarea de GHL. No siempre es necesario verificar manualmente con `/mcp`.
- La integración funciona end-to-end: obtener contactos, agregar contactos, etiquetar y más, todo desde lenguaje natural en Claude Code.

---

## Descripción general

Este SOP cubre una sola cosa: conectar el servidor MCP oficial de GoHighLevel a Claude Code para que Claude pueda leer y escribir tus datos de GHL usando lenguaje natural.

Sin herramientas de terceros. Sin Zapier. Sin llamadas manuales a la API. Un comando, una configuración, listo.

**Lo que esto desbloquea:**
Obtener contactos · Buscar conversaciones · Enviar mensajes · Mover negocios en el pipeline · Revisar eventos de calendario · Obtener transacciones · Publicar en redes sociales · Gestionar entradas del blog — todo desde un solo prompt dentro de Claude Code.

### Los 4 Pasos

1. Crear tu Token de Integración Privada (PIT) dentro de GHL
2. Obtener tu Location ID de GHL
3. Ejecutar el comando de instalación segura (Windows o Mac)
4. Verificar que la conexión está activa

### Antes de Comenzar

Necesitas:
1. Claude Code instalado y funcionando
2. Una cuenta de GoHighLevel con acceso de administrador
3. Node.js instalado — [nodejs.org/es/download](https://nodejs.org/es/download)

---

## Paso 1 — Crear tu Token de Integración Privada (PIT)

El PIT es la clave API segura de GHL. Le indica a GHL exactamente a qué puede acceder Claude. Crea uno por ubicación que quieras conectar.

### Dentro de GoHighLevel:

1. Ve a tu subcuenta → Configuración → Integraciones Privadas
2. Haz clic en "Crear nueva integración"
3. Nómbrala: por ejemplo, "Claude Code MCP"
4. Selecciona **TODOS** los alcances listados a continuación
5. Haz clic en Crear → copia el token inmediatamente y guárdalo en tu gestor de contraseñas

### Selecciona Todos Estos Alcances (SCOPES):

| Scope | Scope |
| :---- | :---- |
| ✅ Ver Contactos | ✅ Ver Publicaciones en Redes Sociales |
| ✅ Editar Contactos | ✅ Editar Publicaciones en Redes Sociales |
| ✅ Ver Conversaciones | ✅ Ver Cuentas de Redes Sociales |
| ✅ Editar Conversaciones | ✅ socialplannerstatisticsreadonly |
| ✅ Ver Mensajes de Conversación | ✅ Crear, Actualizar y Eliminar Plantillas de Email |
| ✅ Editar Mensajes de Conversación | ✅ Ver Plantillas de Email |
| ✅ Ver Oportunidades | ✅ blogslistreadonly |
| ✅ Editar Oportunidades | ✅ blogspostsreadonly |
| ✅ Ver Calendarios | ✅ Ver Autores del Blog |
| ✅ Ver Eventos de Calendario | ✅ Ver Categorías del Blog |
| ✅ Editar Eventos de Calendario | ✅ Actualizar Entrada del Blog |
| ✅ Editar Calendarios | ✅ Verificar Slug de Entrada del Blog |
| ✅ Ver Órdenes de Pago | ✅ Crear Entrada del Blog |
| ✅ Ver Transacciones de Pago | |
| ✅ Ver Campos Personalizados | |
| ✅ Ver Formularios | |
| ✅ Ver Ubicaciones | |

> **🔐 Guarda tu Token Ahora.** El token solo se muestra una vez. Cópialo y guárdalo antes de continuar. Si lo pierdes, tendrás que generar uno nuevo.

---

## Paso 2 — Obtener tu Location ID

El Location ID le indica a GHL con qué subcuenta está trabajando Claude.

1. En GHL → Configuración → Empresa → Ubicaciones
2. Encuentra tu subcuenta en la lista
3. Copia el Location ID — es una cadena alfanumérica corta

> **💡 Consejo Pro:** El Location ID es opcional en la configuración. Si prefieres omitirlo, inclúyelo directamente en tu prompt: *"Mi GHL location ID es [TU_ID]"* — Claude lo usará dinámicamente en esa sesión.

---

## Paso 3 — Ejecutar el Comando de Instalación Segura

> **⚠️ NO edites el archivo de configuración manualmente.** El archivo `.claude.json` tiene más de 1.000 líneas de JSON. Una coma incorrecta o un corchete faltante y todos los servidores MCP dejarán de funcionar. Usa el comando a continuación — edita el archivo de forma segura y automática.

Este comando usa Node.js para inyectar de forma segura el bloque MCP de GHL en tu archivo de configuración. Detecta automáticamente la ruta correcta sin importar tu nombre de usuario.

### Solo Necesitas Reemplazar 2 Cosas:

| Marcador | Dónde Encontrarlo |
| :---- | :---- |
| `YOUR_PIT_TOKEN_HERE` | GHL → Configuración → Integraciones Privadas |
| `YOUR_LOCATION_ID_HERE` | GHL → Configuración → Empresa → Ubicaciones |

### 🪟 Windows — Opción A: Node.js (si está instalado)

Abre una terminal normal — **NO Claude Code**. Pega esto, reemplaza los dos marcadores y presiona Enter:

```
node -e "const fs=require('fs');const p='C:\\Users\\'+require('os').userInfo().username+'\\.claude.json';const c=JSON.parse(fs.readFileSync(p,'utf8'));c.mcpServers['ghl-mcp']={type:'http',url:'https://services.leadconnectorhq.com/mcp/',headers:{Authorization:'Bearer YOUR_PIT_TOKEN_HERE',locationId:'YOUR_LOCATION_ID_HERE'}};fs.writeFileSync(p,JSON.stringify(c,null,2));console.log('Done! GHL MCP added.')"
```

### 🪟 Windows — Opción B: PowerShell puro (sin Node.js)

Si Node.js no está instalado, usa este comando en PowerShell. Reemplaza los dos marcadores y ejecuta con Claude Code cerrado:

```powershell
$path = "$env:USERPROFILE\.claude.json"
$config = Get-Content $path -Raw | ConvertFrom-Json
$ghlMcp = [PSCustomObject]@{
    type = "http"
    url = "https://services.leadconnectorhq.com/mcp/"
    headers = [PSCustomObject]@{
        Authorization = "Bearer YOUR_PIT_TOKEN_HERE"
        locationId    = "YOUR_LOCATION_ID_HERE"
    }
}
$config.mcpServers | Add-Member -NotePropertyName "ghl-mcp" -NotePropertyValue $ghlMcp -Force
$config | ConvertTo-Json -Depth 10 | Set-Content $path
Write-Host "Done! GHL MCP added."
```

> **Nota:** La Opción B no requiere ninguna instalación adicional — PowerShell viene preinstalado en Windows 10/11.

### 🍎 Mac — Terminal

Abre Terminal — NO Claude Code. Pega esto, reemplaza los dos marcadores y presiona Enter:

```
node -e "const fs=require('fs');const p=require('os').homedir()+'/.claude.json';const c=JSON.parse(fs.readFileSync(p,'utf8'));c.mcpServers['ghl-mcp']={type:'http',url:'https://services.leadconnectorhq.com/mcp/',headers:{Authorization:'Bearer YOUR_PIT_TOKEN_HERE',locationId:'YOUR_LOCATION_ID_HERE'}};fs.writeFileSync(p,JSON.stringify(c,null,2));console.log('Done! GHL MCP added.')"
```

**Resultado esperado:** `Done! GHL MCP added.`

> Si ves un error de JSON parse, asegúrate de que Claude Code esté completamente cerrado antes de ejecutar.

### Cómo Encuentra tu Archivo de Configuración

| SO | Método |
| :---- | :---- |
| **Windows** | `require('os').userInfo().username` → detecta automáticamente el usuario activo |
| **Mac** | `require('os').homedir()` → resuelve a `/Users/QUIEN_SEA` automáticamente |

---

## Paso 4 — Verificar la Conexión

1. Cierra completamente Claude Code (sal del programa, no solo la ventana)
2. Vuelve a abrir Claude Code
3. Escribe `/mcp` y presiona Enter
4. Busca `ghl-mcp · ✔ conectado` en la lista de MCPs de Usuario

### Prompts de Verificación:

```
# Lista todas las herramientas MCP disponibles
Lista todas las herramientas MCP que tienes disponibles.

# Confirma que el token y location ID son correctos
Obtén mis últimos 5 contactos de GoHighLevel.

# Prueba completa del pipeline
Obtén todos mis pipelines de GoHighLevel y muéstrame cuántas oportunidades hay en cada etapa.
```

### Si No Conecta — Revisa Estas 4 Cosas:

1. **¿Error de JSON parse?** → Claude Code debe estar completamente cerrado al ejecutar el comando
2. **¿Error de token?** → Verifica que reemplazaste AMBOS marcadores (token Y location ID)
3. **¿Muestra desconectado?** → Confirma que tu token PIT tiene todos los scopes del Paso 1
4. **¿Sigue fallando?** → Ejecuta el comando de nuevo — es seguro, solo sobreescribe la entrada

---

## 20 Prompts Avanzados

### 👥 Contactos

| # | Prompt |
| :--- | :---- |
| 1 | *"Obtén todos los contactos creados en los últimos 7 días. Muestra nombre, email, teléfono y etiquetas. Marca a quien no tenga tarea de seguimiento."* |
| 2 | *"Encuentra todos los contactos etiquetados 'Webinar-Attendee' que NO tengan la etiqueta 'Follow-Up-Sent'. Añade la etiqueta 'Follow-Up-Sent' a todos ellos."* |
| 3 | *"Haz upsert de este contacto: [Nombre, Email, Teléfono, Empresa]. Etiquétalo 'Hot-Lead' y 'Agency-Interest'."* |
| 4 | *"Busca todos los contactos que no tengan número de teléfono. Dame sus nombres y emails."* |

### 💬 Conversaciones

| # | Prompt |
| :--- | :---- |
| 5 | *"Busca todas las conversaciones no leídas de las últimas 48 horas. Resume cada una en una oración. Dime cuáles necesitan respuesta urgente."* |
| 6 | *"Encuentra la conversación con [nombre del contacto]. Lee los últimos 5 mensajes. Redacta una respuesta de seguimiento — directa, preguntando si están listos para avanzar."* |
| 7 | *"Envía un mensaje a [nombre del contacto]: 'Hola [nombre], solo haciendo seguimiento — ¿tienes 20 minutos esta semana?'"* |
| 8 | *"Busca en todas las conversaciones la palabra 'reembolso'. Resume cada una — nombre del contacto, el problema, estado actual."* |

### 🏆 Pipeline y Oportunidades

| # | Prompt |
| :--- | :---- |
| 9 | *"Obtén todas las oportunidades en todos los pipelines. Agrupa por etapa. Muestra cantidad y valor total por etapa. Marca las que no se hayan actualizado en 7+ días."* |
| 10 | *"Encuentra todas las oportunidades abiertas no modificadas en 14+ días. Lista nombre del contacto, valor, etapa y días desde la última actualización."* |
| 11 | *"Crea una nueva oportunidad para [nombre del contacto]. Pipeline: [nombre]. Etapa: Discovery Call Booked. Valor: $[monto]. Cierre: 30 días desde hoy."* |
| 12 | *"Mueve la oportunidad de [nombre del contacto] a la etapa 'Proposal Sent' y actualiza la fecha de cierre a [fecha]."* |

### 📅 Calendario y Pagos

| # | Prompt |
| :--- | :---- |
| 13 | *"Obtén todos los eventos de calendario de hoy. Lista hora, nombre del contacto y notas. Marca sesiones consecutivas con menos de 15 minutos de diferencia."* |
| 14 | *"Obtén todos los eventos de calendario de esta semana. Organiza por día. Marca los días con más de 4 sesiones."* |
| 15 | *"Lista las últimas 20 transacciones. Muestra nombre del contacto, monto, fecha, estado. Marca reembolsos o pagos fallidos."* |
| 16 | *"Encuentra la orden de [nombre del contacto o ID de orden]. Muestra qué compraron, monto y estado actual."* |

### ⚡ Combinaciones Avanzadas

| # | Prompt |
| :--- | :---- |
| 17 | *"Nuevo lead: [nombre, email, teléfono]. 1) Upsert del contacto. 2) Etiqueta 'New-Lead' y '[fuente]'. 3) Crea oportunidad en [pipeline] en etapa 'New Lead' valorada en $[monto]. 4) Añade tarea: Dar seguimiento en 24 horas."* |
| 18 | *"Brief de CRM matutino: 1) Nuevos contactos de ayer. 2) Conversaciones no leídas que necesitan respuesta. 3) Negocios sin movimiento en 7+ días. 4) Citas de hoy. Dame una lista de acciones prioritarias."* |
| 19 | *"Encuentra todos los contactos etiquetados 'Webinar-[fecha]'. Para cada uno: verifica si hay oportunidad abierta, crea una en 'Webinar Leads' en etapa 'Attended' si no existe, etiqueta 'Post-Webinar-Follow-Up'."* |
| 20 | *"Encuentra todos los clientes activos sin conversación en 30 días. Márcalos como riesgo de churn. Redacta un mensaje de 'solo comprobando' para cada uno para que yo lo revise."* |

---

## Referencia Rápida

| Campo | Valor |
| :---- | :---- |
| URL del Servidor MCP | `https://services.leadconnectorhq.com/mcp/` |
| Header de Autorización | `Authorization: Bearer YOUR_PIT_TOKEN` |
| Header de Ubicación | `locationId: YOUR_LOCATION_ID` |
| Archivo de Configuración Windows | `C:\Users\USERNAME\.claude.json` |
| Archivo de Configuración Mac | `~/.claude.json` |
| Ubicación del Token PIT | GHL → Configuración → Integraciones Privadas |
| Ubicación del Location ID | GHL → Configuración → Empresa → Ubicaciones |
| Total de Herramientas Disponibles | 36 (roadmap: 250+) |
| Verificar Conexión | `/mcp` → busca `ghl-mcp · ✔ conectado` |

### Roadmap GHL MCP

- **250+ herramientas** — expansión desde 36 en todos los módulos de GHL
- **Paquete npx** — soporte stdio para Claude Desktop (próximamente)
- **Soporte OAuth** — desbloqueará Claude.ai web + conectores de Cowork
- **Integración AskAI** — acciones MCP dentro del chat nativo de GHL