Instructivo: Conectar Claude Desktop con GoHighLevel (TellBid)

¿Necesitas ayuda? Escriba su cadena de búsqueda. Se requiere un mínimo de 4 caracteres.

1. Propósito

Este instructivo permite que cualquier miembro del equipo IDEA conecte su instalación de Claude Desktop directamente al CRM de GoHighLevel (TellBid), habilitando consultas y operaciones con lenguaje natural.

ℹ️ ¿Qué es MCP?

MCP (Model Context Protocol) es la tecnología que permite a Claude Desktop conectarse a sistemas externos como GoHighLevel. Una vez configurado, puedes preguntarle a Claude cosas como «Busca los últimos 10 contactos» o «Muéstrame los pipelines activos».

2. Requisitos Previos

✅ Claude Desktop instalado (descargar aquí)
✅ Acceso a tu sub-cuenta de GoHighLevel (TellBid CRM)
✅ Conexión a internet estable
✅ Windows 10 o Windows 11

3. Paso 1 — Instalar Node.js

Node.js es necesario para que Claude se comunique con GoHighLevel.

Ve a 👉 https://nodejs.org
Descarga la versión LTS (botón verde grande)
Ejecuta el instalador y acepta todas las opciones por defecto
Reinicia la computadora después de instalar

Verificar la instalación

Presiona Windows + R, escribe cmd y ejecuta:

node --version
npx --version

Ambos deben mostrar un número de versión (ejemplo: v20.9.0 y 10.1.0).

⚠️ Advertencia

Si dice «no se reconoce como comando», reinicia la computadora e intenta de nuevo.

4. Paso 2 — Generar tu Token (PIT) en GoHighLevel

El PIT (Private Integration Token) es la «llave» que le da permiso a Claude para acceder a tu cuenta.

Entra a tu sub-cuenta de GoHighLevel
Ve a Settings → Private Integrations
Haz clic en Create New Integration
Ponle un nombre (ejemplo: Claude Desktop)
Selecciona los permisos (scopes) de la tabla siguiente:

Categoría	Permisos a activar
Contactos	View/Edit Contacts
Conversaciones	View/Edit Conversations & Messages
Oportunidades	View/Edit Opportunities
Calendarios	View Calendars & Calendar Events
Ubicaciones	View Locations, View Custom Fields
Pagos	View Payment Orders & Transactions
Users	View Users (para ver nombres de asesores)

Haz clic en Crear
Copia el token (formato: pit-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)

🔴 Importante

El token solo se muestra una vez. Guárdalo en un lugar seguro. Si lo pierdes, tendrás que crear uno nuevo.

5. Paso 3 — Obtener tu Location ID

Entra al dashboard de GoHighLevel y mira la barra de dirección:

https://app.gohighlevel.com/v2/location/XXXXXXXXXXXXXXXX/dashboard

El código entre /location/ y /dashboard es tu Location ID.

💡 Ejemplo

Si la URL es https://app.gohighlevel.com/v2/location/0BjprY04XsBsrxQJeVYH/dashboard, tu Location ID es 0BjprY04XsBsrxQJeVYH

6. Paso 4 — Configurar Claude Desktop

6A. Abrir el archivo de configuración

Presiona Windows + R y escribe:

Si instalaste Claude desde la Microsoft Store:

%LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude

Si instalaste Claude desde claude.ai/download (instalador .exe):

%APPDATA%\Claude

Busca el archivo claude_desktop_config.json. Si no existe, créalo.

6B. Editar el archivo

Si el archivo está vacío o no existía, pega esto completo:

{
  "mcpServers": {
    "gohighlevel": {
      "command": "npx.cmd",
      "args": [
        "-y",
        "mcp-remote",
        "https://services.leadconnectorhq.com/mcp/",
        "--header",
        "Authorization: Bearer TU_PIT_TOKEN",
        "--header",
        "locationId: TU_LOCATION_ID"
      ]
    }
  }
}

6C. Reemplazar los valores

Donde dice TU_PIT_TOKEN → pega tu token completo (incluyendo pit-)
Donde dice TU_LOCATION_ID → pega tu Location ID

Guarda con Ctrl + S.

ℹ️ Importante para Windows

DEBE decir npx.cmd, no npx. Sin la extensión .cmd la conexión fallará con error «Server disconnected».

7. Paso 5 — Reiniciar Claude Desktop

Ve a la bandeja del sistema (esquina inferior derecha, junto al reloj)
Busca el ícono de Claude
Click derecho → Quit (o Salir)
Espera 5 segundos
Abre Claude Desktop de nuevo

⚠️ No basta con cerrar la ventana

Debes hacer Quit desde la bandeja del sistema. Si sigue sin funcionar, abre Administrador de Tareas (Ctrl+Shift+Esc) y mata todos los procesos «claude».

8. Paso 6 — Verificar la conexión

En Claude Desktop, ve a Configuración (⚙️) → Desarrollador
Deberías ver gohighlevel en la lista de Servidores MCP
El estado debe ser activo (sin errores rojos)

Probar con un comando

Abre un chat nuevo y escribe cualquiera de estos:

«Busca los últimos 10 contactos en mi CRM»
«Muéstrame los pipelines de mi cuenta de GoHighLevel»
«¿Cuáles son los próximos eventos en mi calendario?»

9. Solución de Problemas

Problema	Solución
«Server disconnected»	Verifica que diga `npx.cmd` (no `npx`)
«npx no se reconoce»	Reinstala Node.js y reinicia la computadora
«No son configuraciones válidas»	JSON con error de sintaxis. Valídalo en jsonlint.com
El MCP no aparece	Cierra Claude desde la bandeja del sistema (Quit)
Error 401 / Unauthorized	PIT token incompleto o scopes incorrectos
Error 404 / Location not found	Location ID incorrecto (sin espacios extra)

10. Seguridad

El PIT solo da acceso a los permisos que seleccionaste al crearlo
Puedes revocar el token en cualquier momento: GHL → Settings → Private Integrations → Eliminar
Nunca compartas tu PIT públicamente
Toda la comunicación viaja por HTTPS (encriptada)
Claude siempre pide confirmación antes de ejecutar acciones de escritura

Guía creada por el equipo técnico de IDEA Aviation · Junio 2026