Servidor MCP de GoHighLevel: guía completa para cada herramienta de IA

En resumen

• GoHighLevel tiene un servidor MCP oficial que permite a herramientas de IA como Claude, Cursor y n8n leer y escribir en tu cuenta.
• Esta guía reúne en una página cada herramienta de IA, la comparación entre oficial y comunitario, la seguridad y prompts reales para agencias.
• Viene incluido en cualquier plan de GoHighLevel. Solo necesitas un Private Integration Token y unos 5 minutos.

Comandos y configuración verificados por última vez el 2026-08-10 con la documentación oficial de GoHighLevel.

Elige tu herramienta

• MCP para quien no programa. ¿Nuevo en MCP? Empieza aquí con la versión en lenguaje claro antes de tocar un token.
• Conecta Claude a GoHighLevel. La guía específica de Claude, del token al primer prompt.
• Conecta ChatGPT a GoHighLevel. Todavía no hay servidor MCP oficial en la mayoría de los planes. La ruta con Custom GPT y Zapier que funciona hoy.

Qué es el servidor MCP de GoHighLevel

MCP son las siglas de Model Context Protocol. Es un estándar abierto que permite a una herramienta de IA llamar a un servicio externo mediante un conjunto de herramientas con nombre. El servidor MCP de GoHighLevel es la versión oficial de GoHighLevel de esa puerta. Cuando lo conectas, un asistente de IA puede actuar directamente sobre tu cuenta de GoHighLevel en vez de que tú hagas clic por el panel.

El servidor vive en un único endpoint: https://services.leadconnectorhq.com/mcp/. Llega a las partes principales de tu cuenta: contactos, conversaciones, calendarios, oportunidades, pagos, ubicaciones, publicación en redes sociales, blogs y emails. Tú decides cuáles de ellas puede tocar la IA al crear tu token, así que nunca tiene más acceso del que concedes.

En palabras simples: en vez de abrir GoHighLevel y buscar un lead, puedes pedirle a Claude "encuentra los leads que respondieron esta semana y no han reservado una llamada" y saca la respuesta de tu cuenta en directo. Eso es lo que hace posible el servidor MCP.

Qué puedes automatizar con él

En la práctica, la mayoría lo conecta para unas pocas tareas recurrentes. Algunas concretas:

• Triaje de contactos. Encuentra cada lead que respondió pero nunca reservó, sin recorrer el pipeline a mano.
• Actualizaciones del pipeline. Crea o mueve una oportunidad a la etapa correcta con una petición en lenguaje normal, sin clics por el panel.
• Resúmenes de conversaciones. Resume una semana de mensajes y marca a quien parece listo para comprar o está molesto, antes de tu revisión del lunes.
• Preparación de llamadas. Trae el historial completo de un contacto en un resumen corto justo antes de marcar.
• Limpieza de listas. Saca todos los contactos con una etiqueta concreta y comprueba cuáles aún tienen una oportunidad abierta.

Cada una de estas tareas pasa por los mismos scopes que pusiste en tu token, así que la IA solo toca los módulos que aprobaste. Mira los ejemplos de prompts completos más abajo en esta página.

Si es gratis y lo que necesitas

Sí, el servidor MCP oficial viene incluido en cualquier plan de GoHighLevel. No hay un cargo extra por MCP. La gente se confunde porque las herramientas de IA que conectas (Claude, Cursor y otras) tienen su propio precio, pero el lado de GoHighLevel no cuesta nada más allá de tu suscripción normal.

Necesitas tres cosas, y la configuración lleva unos 5 minutos:

• Una cuenta de GoHighLevel (cualquier plan).
• Un Private Integration Token, creado en Settings (se explica a continuación).
• Tu Location ID, que identifica la subcuenta en la que quieres que trabaje la IA.

Paso 1: crea tu Private Integration Token

En GoHighLevel, ve a Settings, luego Private Integrations y luego Create New Integration. Ponle un nombre claro (por ejemplo "Claude MCP, cliente Acme"). Selecciona solo los scopes que necesites y copia el token.

Importante: tiene que ser un Private Integration Token.

El token empieza por pit-. Una clave de API normal o una clave de API v1 antigua no funciona y es la causa número uno de los errores 401. El token se muestra una sola vez, así que cópialo en un lugar seguro antes de cerrar la pantalla.

Un conjunto mínimo de scopes razonable

Para la mayoría del trabajo de agencia, empieza en solo lectura y añade scopes de escritura solo donde quieras que la IA haga cambios. Un conjunto inicial seguro es acceso de lectura a contactos, conversaciones y oportunidades. Añade acceso de escritura a contactos y oportunidades cuando confíes en la configuración. Deja desactivados los scopes de borrar salvo que tengas un motivo claro, porque algunos scopes permiten a la IA eliminar datos.

Paso 2: encuentra tu Location ID

El Location ID nombra la subcuenta en la que trabaja la IA. Hay dos formas de encontrarlo:

• En la app: ve a Settings, luego Company y luego Locations, y copia el ID de la cuenta que quieres.
• Desde la URL: abre la subcuenta y lee el ID en la barra de direcciones. Es la cadena larga después de /location/.

Una nota de la documentación oficial: la cabecera locationId es opcional. Puedes pasarla en la cabecera como se muestra abajo, o dejarla fuera y nombrar la ubicación dentro de tus prompts. Ponerla en la cabecera es más simple cuando solo trabajas en una cuenta.

Paso 3: conecta tu herramienta de IA

La mayoría de las herramientas de IA modernas hablan MCP sobre HTTP, así que la configuración tiene la misma forma en todas partes: el endpoint, una cabecera Authorization con tu token y una cabecera opcional con el Location ID. Esta es la configuración base que usan Cursor, Windsurf y el OpenAI Playground.

Configuración HTTP base (Cursor, Windsurf, OpenAI Playground)

{
  "mcpServers": {
    "ghl": {
      "url": "https://services.leadconnectorhq.com/mcp/",
      "headers": {
        "Authorization": "Bearer YOUR_PIT_TOKEN",
        "locationId": "YOUR_LOCATION_ID"
      }
    }
  }
}

Claude Code

Claude Code guarda su configuración de MCP en ~/.claude.json. Añade el bloque ghl de arriba bajo mcpServers, o ejecuta claude mcp add y pega el endpoint y las cabeceras cuando te los pida. Reinicia Claude Code y escribe /mcp para confirmar que las herramientas de GoHighLevel aparecen en la lista.

Claude Desktop

Claude Desktop todavía no se conecta por HTTP directo, así que usa el envoltorio mcp-remote de npx, que une el servidor HTTP con la conexión local que espera Claude Desktop. Añade esto a la configuración de Claude Desktop y reinicia la app. Confirma el método actual en la documentación oficial cuando lo configures, porque es la parte con más probabilidad de cambiar.

Configuración de Claude Desktop (envoltorio mcp-remote)

{
  "mcpServers": {
    "ghl": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://services.leadconnectorhq.com/mcp/",
        "--header",
        "Authorization: Bearer YOUR_PIT_TOKEN",
        "--header",
        "locationId: YOUR_LOCATION_ID"
      ]
    }
  }
}

Cursor y Windsurf

Los dos se conectan por HTTP directo. Abre los ajustes de MCP, añade la configuración base del principio de esta sección y guarda. Las herramientas de GoHighLevel aparecen en la lista cuando el editor se recarga. Si no aparece nada, revisa que el token empiece por pit-.

Gemini CLI

Añade el mismo bloque de servidor al archivo de ajustes de Gemini CLI, en su sección de servidores MCP, con el endpoint y la cabecera Authorization. Reinicia la CLI y ejecuta su comando para listar MCP y confirmar la conexión. Gemini es además el único rastreador de IA que renderiza JavaScript, pero eso no tiene relación con la conexión MCP de aquí.

OpenAI Playground

En el Playground, añade un servidor MCP remoto, pega el endpoint y pon la cabecera Authorization como Bearer YOUR_PIT_TOKEN. Guarda y las herramientas de GoHighLevel quedan disponibles para el modelo en esa sesión.

Conecta n8n

n8n se conecta sin ningún plugin personalizado. Añade el nodo MCP Client a tu flujo, pon la URL https://services.leadconnectorhq.com/mcp/, elige el transporte HTTP Streamable y usa autenticación por cabecera con tu token pit-. Necesitas una versión reciente de n8n (1.104 o superior en el momento de escribir esto). Si no ves la opción de transporte Streamable, actualiza n8n primero.

Desde ahí, las herramientas de GoHighLevel están disponibles para cualquier nodo de agente de IA de tu flujo, así que puedes encadenar acciones de GoHighLevel con los cientos de otras apps a las que se conecta n8n.

Para desarrolladores

Si estás creando tu propio agente, la documentación oficial incluye un ejemplo de LangChain y LangGraph en Python. El adaptador de MCP carga todas las herramientas de GoHighLevel, y tu agente puede llamarlas como cualquier otra herramienta. Así se ve.

Python: agente LangGraph con el servidor MCP de GoHighLevel

# pip install langchain-mcp-adapters langgraph langchain-openai
import asyncio
from langchain_mcp_adapters.client import MultiServerMCPClient
from langgraph.prebuilt import create_react_agent

async def main():
    client = MultiServerMCPClient({
        "ghl": {
            "url": "https://services.leadconnectorhq.com/mcp/",
            "transport": "streamable_http",
            "headers": {
                "Authorization": "Bearer YOUR_PIT_TOKEN",
                "locationId": "YOUR_LOCATION_ID",
            },
        }
    })
    tools = await client.get_tools()
    agent = create_react_agent("openai:gpt-4.1", tools)
    result = await agent.ainvoke(
        {"messages": "List my 5 most recent contacts"}
    )
    print(result["messages"][-1].content)

asyncio.run(main())

El mismo adaptador funciona desde Node y otros entornos de LangChain. Si quieres crear un servidor personalizado que envuelva endpoints de GoHighLevel que el oficial aún no cubre, mira nuestra receta para crear tu propio servidor MCP.

Servidor oficial frente a servidores comunitarios

El servidor oficial de GoHighLevel es el lugar donde empezar. La comunidad también ha creado servidores MCP de código abierto en GitHub que exponen muchas más herramientas al envolver más partes de la API. No son oficiales ni tienen soporte, y los alojas tú. Esta es una comparación honesta.

La regla general: empieza con el oficial. Recurre a un servidor comunitario solo cuando encuentres un hueco real, y entiende que asumes el alojamiento y la seguridad de ejecutarlo tú.

Ask AI integrado frente al servidor MCP externo

GoHighLevel tiene Ask AI dentro de la app. Va muy bien para ayuda rápida mientras trabajas en el panel. El servidor MCP es otra cosa: permite que tus propias herramientas de IA lleguen a la cuenta desde fuera. Usa Ask AI para preguntas dentro de la app. Usa el servidor MCP cuando quieras que GoHighLevel sea un paso de un flujo de IA más grande que controlas tú, encadenado con otras herramientas.

Ejemplos reales de prompts

Una vez conectado, hablas con tu cuenta en lenguaje normal. Estos cinco prompts hacen trabajo real de agencia.

1. Encontrar leads calientes y redactar seguimientos. "Encuentra los contactos que respondieron en los últimos 7 días pero no tienen cita reservada, y redacta un mensaje de seguimiento corto para cada uno." Un buen resultado es una lista corta con un mensaje a medida por lead, lista para que la envíes.
2. Crear una oportunidad. "Crea una nueva oportunidad para Jane Doe en el pipeline Sales, en la etapa Proposal, por valor de 2.500 dólares." Devuelve la nueva oportunidad con la etapa y el valor correctos.
3. Resumir una semana de conversaciones. "Resume todas las conversaciones de esta semana y marca a quien parezca molesto." Obtienes un resumen más una lista corta de clientes en riesgo.
4. Limpiar una etiqueta. "Lista todos los contactos con la etiqueta trial-expired y dime cuáles aún tienen una oportunidad abierta." Útil antes de una campaña de reactivación.
5. Preparar una llamada. "Trae el historial completo del contacto con este email y dame un resumen de 3 líneas antes de mi llamada." Lee el contacto, las conversaciones y las oportunidades y te entrega el resumen.

Para agencias con varias subcuentas

Es la pregunta más común de las agencias. Usa un Private Integration Token por cada subcuenta de cliente. Cada token está ligado a una sola ubicación, así que un token por cliente mantiene los datos de cada cliente totalmente separados y te deja revocar uno sin afectar al resto.

Pon a cada token el nombre del cliente para no mezclarlos nunca. Cuando conectes una herramienta de IA para un cliente concreto, usa el token y el Location ID de ese cliente. Si un cliente se va, revoca su token y el acceso desaparece. Compartir un token entre clientes rompe esa separación y es lo que hay que evitar.

Necesitas una cuenta de GoHighLevel para usar el servidor MCP. Empieza la prueba de 30 días con nuestro enlace.

Seguridad y rotación del token

El miedo es real: a la gente le preocupa que la IA borre contactos o estropee la cuenta de un cliente. La solución no es la confianza, es el control de acceso. La IA solo puede hacer lo que permitan los scopes de tu token.

• Concede el menor acceso. Selecciona solo los scopes que necesites. Deja desactivados los scopes de borrar salvo que de verdad los quieras. Los tokens de solo lectura no pueden cambiar nada.
• Rota cada 90 días. Genera un token nuevo, actualiza tu configuración, confirma la conexión y deja ir el antiguo. La opción de rotar mantiene el token antiguo funcionando 7 días durante el cambio para que nada se rompa.
• Un token por cliente. Tokens separados significan que una sola revocación quita limpiamente el acceso de un cliente.
• Revoca si se expone. Si un token se filtra alguna vez, revócalo de inmediato en vez de esperar a la siguiente rotación.

Ten en cuenta que las claves de API v1 antiguas están obsoletas, y esa es parte de la razón por la que el Private Integration Token es ahora el camino obligatorio.

MCP frente a Zapier

Resuelven problemas distintos. Zapier y herramientas parecidas son mejores para automatizaciones fijas con disparador: cuando pasa X, haz Y. El servidor MCP es mejor para trabajo de IA abierto, donde el asistente decide qué acciones tomar según lo que le pides. Mucha gente usa los dos: Zapier para las tuberías predecibles, MCP para las tareas guiadas por IA.

Si estás eligiendo entre Zapier, Make, n8n y la API directa solo para automatizar, explicamos esa decisión en detalle en la receta Zapier vs Make vs n8n vs API directa.

Solución de problemas

• 401 por el tipo de clave equivocado. El token debe empezar por pit-. Una clave de API normal o antigua devuelve 401. Vuelve a crear el token en Private Integrations.
• Clave v1 obsoleta. Las claves de API v1 antiguas ya no funcionan con MCP. Cambia a un Private Integration Token.
• Location ID ausente o incorrecto. Si las acciones llegan a la cuenta equivocada o fallan, revisa la cabecera locationId o nombra la ubicación en tu prompt.
• Límites de velocidad. Las ráfagas intensas pueden chocar con los límites. Espacia las llamadas repetidas o agrupa el trabajo.
• Sesión caducada. Si las herramientas dejan de responder, reinicia tu herramienta de IA para limpiar la sesión y volver a conectar.

Más de RocketLauncher

• Voice AI de GoHighLevel