Servidor MCP do GoHighLevel: guia completo para cada ferramenta de IA

Em resumo

• O GoHighLevel tem um servidor MCP oficial que deixa ferramentas de IA como Claude, Cursor e n8n lerem e escreverem na sua conta.
• Este guia reúne em uma página cada ferramenta de IA, a comparação entre oficial e da comunidade, a segurança e prompts reais para agências.
• Vem incluído em qualquer plano do GoHighLevel. Você só precisa de um Private Integration Token e de uns 5 minutos.

Comandos e configuração verificados pela última vez em 2026-08-10 com a documentação oficial do GoHighLevel.

Escolha a sua ferramenta

• MCP para quem não programa. Novo em MCP? Comece aqui pela versão em linguagem simples antes de mexer em um token.
• Conecte o Claude ao GoHighLevel. O passo a passo específico do Claude, do token ao primeiro prompt.
• Conecte o ChatGPT ao GoHighLevel. Ainda não há servidor MCP oficial na maioria dos planos. O caminho com Custom GPT e Zapier que funciona hoje.

O que é o servidor MCP do GoHighLevel

MCP é a sigla de Model Context Protocol. É um padrão aberto que permite a uma ferramenta de IA chamar um serviço externo por um conjunto de ferramentas com nome. O servidor MCP do GoHighLevel é a versão oficial do GoHighLevel dessa porta. Depois de conectar, um assistente de IA pode agir direto na sua conta do GoHighLevel em vez de você clicar pelo painel.

O servidor fica em um único endpoint: https://services.leadconnectorhq.com/mcp/. Ele alcança as partes principais da sua conta: contatos, conversas, agendas, oportunidades, pagamentos, locations, publicação em redes sociais, blogs e e-mails. Você decide quais delas a IA pode tocar ao criar o seu token, então ela nunca tem mais acesso do que você der.

Em palavras simples: em vez de abrir o GoHighLevel e procurar um lead, você pode pedir ao Claude "encontre os leads que responderam esta semana e não agendaram uma ligação", e ele traz a resposta da sua conta ao vivo. É isso que o servidor MCP torna possível.

O que você pode automatizar com ele

Na prática, a maioria conecta para um punhado de tarefas recorrentes. Algumas concretas:

• Triagem de contatos. Encontre cada lead que respondeu mas nunca agendou, sem rolar o pipeline à mão.
• Atualizações do pipeline. Crie ou mova uma oportunidade para a etapa certa com um pedido em linguagem normal, sem cliques no painel.
• Resumos de conversas. Resuma uma semana de mensagens e marque quem parece pronto para comprar ou insatisfeito, antes da sua revisão de segunda-feira.
• Preparação de ligações. Traga o histórico completo de um contato em um resumo curto logo antes de discar.
• Limpeza de listas. Puxe todo contato com uma tag específica e confira quais ainda têm uma oportunidade aberta.

Todas essas tarefas passam pelos mesmos scopes que você definiu no seu token, então a IA só toca nos módulos que você aprovou. Veja os exemplos completos de prompts mais abaixo nesta página.

É grátis, e o que você precisa

Sim, o servidor MCP oficial vem incluído em qualquer plano do GoHighLevel. Não há cobrança extra de MCP. As pessoas se confundem porque as ferramentas de IA que você conecta (Claude, Cursor e outras) têm preço próprio, mas o lado do GoHighLevel não custa nada além da sua assinatura normal.

Você precisa de três coisas, e a configuração leva uns 5 minutos:

• Uma conta do GoHighLevel (qualquer plano).
• Um Private Integration Token, criado em Settings (explicado a seguir).
• O seu Location ID, que identifica a subconta em que você quer que a IA trabalhe.

Passo 1: crie o seu Private Integration Token

No GoHighLevel, vá em Settings, depois Private Integrations e depois Create New Integration. Dê um nome claro (por exemplo "Claude MCP, cliente Acme"). Selecione só os scopes de que precisa e copie o token.

Importante: tem que ser um Private Integration Token.

O token começa com pit-. Uma chave de API comum ou uma chave de API v1 antiga não funciona e é a causa número um dos erros 401. O token aparece uma única vez, então copie para um lugar seguro antes de fechar a tela.

Um conjunto mínimo de scopes sensato

Para a maior parte do trabalho de agência, comece só com leitura e adicione scopes de escrita apenas onde você quiser que a IA faça mudanças. Um conjunto inicial seguro é acesso de leitura a contatos, conversas e oportunidades. Adicione acesso de escrita a contatos e oportunidades quando confiar na configuração. Deixe os scopes de apagar desligados, a menos que você tenha um motivo claro, porque alguns scopes deixam a IA remover dados.

Passo 2: encontre o seu Location ID

O Location ID dá nome à subconta em que a IA trabalha. Há duas formas de encontrar:

• No app: vá em Settings, depois Company e depois Locations, e copie o ID da conta que você quer.
• Pela URL: abra a subconta e leia o ID na barra de endereço. É a sequência longa depois de /location/.

Uma observação da documentação oficial: o cabeçalho locationId é opcional. Você pode passá-lo no cabeçalho como mostrado abaixo, ou deixar de fora e citar a location nos seus prompts. Colocar no cabeçalho é mais simples quando você trabalha em uma conta só.

Passo 3: conecte a sua ferramenta de IA

A maioria das ferramentas de IA modernas fala MCP sobre HTTP, então a configuração tem o mesmo formato em todo lugar: o endpoint, um cabeçalho Authorization com o seu token e um cabeçalho opcional com o Location ID. Esta é a configuração base usada pelo Cursor, pelo Windsurf e pelo OpenAI Playground.

Configuração 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

O Claude Code guarda a configuração de MCP em ~/.claude.json. Adicione o bloco ghl acima em mcpServers, ou rode claude mcp add e cole o endpoint e os cabeçalhos quando ele pedir. Reinicie o Claude Code e digite /mcp para confirmar que as ferramentas do GoHighLevel aparecem na lista.

Claude Desktop

O Claude Desktop ainda não conecta por HTTP direto, então usa o wrapper mcp-remote do npx, que liga o servidor HTTP à conexão local que o Claude Desktop espera. Adicione isto à configuração do Claude Desktop e reinicie o app. Confirme o método atual na documentação oficial quando for configurar, porque essa é a parte com mais chance de mudar.

Configuração do Claude Desktop (wrapper 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 e Windsurf

Os dois conectam por HTTP direto. Abra as configurações de MCP, adicione a configuração base do início desta seção e salve. As ferramentas do GoHighLevel aparecem na lista quando o editor recarrega. Se nada aparecer, confira se o token começa com pit-.

Gemini CLI

Adicione o mesmo bloco de servidor ao arquivo de configurações do Gemini CLI, na seção de servidores MCP, com o endpoint e o cabeçalho Authorization. Reinicie a CLI e rode o comando de listar MCP para confirmar a conexão. O Gemini também é o único crawler de IA que renderiza JavaScript, mas isso não tem relação com a conexão MCP daqui.

OpenAI Playground

No Playground, adicione um servidor MCP remoto, cole o endpoint e defina o cabeçalho Authorization como Bearer YOUR_PIT_TOKEN. Salve e as ferramentas do GoHighLevel ficam disponíveis para o modelo naquela sessão.

Conecte o n8n

O n8n conecta sem nenhum plugin personalizado. Adicione o nó MCP Client ao seu fluxo, coloque a URL https://services.leadconnectorhq.com/mcp/, escolha o transporte HTTP Streamable e use autenticação por cabeçalho com o seu token pit-. Você precisa de uma versão recente do n8n (1.104 ou mais nova no momento em que escrevemos). Se você não vir a opção de transporte Streamable, atualize o n8n primeiro.

Daí em diante, as ferramentas do GoHighLevel ficam disponíveis para qualquer nó de agente de IA do seu fluxo, então você pode encadear ações do GoHighLevel com as centenas de outros apps aos quais o n8n se conecta.

Para desenvolvedores

Se você está criando o seu próprio agente, a documentação oficial inclui um exemplo de LangChain e LangGraph em Python. O adaptador de MCP carrega todas as ferramentas do GoHighLevel, e o seu agente pode chamá-las como qualquer outra ferramenta. Este é o formato.

Python: agente LangGraph com o servidor MCP do 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())

O mesmo adaptador funciona no Node e em outros ambientes do LangChain. Se você quer criar um servidor personalizado que envolva endpoints do GoHighLevel que o oficial ainda não cobre, veja a nossa receita para criar o seu próprio servidor MCP.

Servidor oficial versus servidores da comunidade

O servidor oficial do GoHighLevel é o lugar para começar. A comunidade também criou servidores MCP de código aberto no GitHub que expõem muito mais ferramentas ao envolver mais partes da API. Eles são não oficiais e sem suporte, e você mesmo hospeda. Esta é uma comparação honesta.

A regra prática: comece pelo oficial. Recorra a um servidor da comunidade só quando encontrar uma lacuna real, e entenda que você assume a hospedagem e a segurança de rodá-lo por conta própria.

Ask AI embutido versus o servidor MCP externo

O GoHighLevel tem o Ask AI dentro do app. É ótimo para ajuda rápida enquanto você trabalha no painel. O servidor MCP é outra coisa: ele deixa as suas próprias ferramentas de IA alcançarem a conta de fora. Use o Ask AI para perguntas dentro do app. Use o servidor MCP quando quiser que o GoHighLevel seja um passo de um fluxo de IA maior que você controla, encadeado com outras ferramentas.

Exemplos reais de prompts

Depois de conectado, você conversa com a sua conta em linguagem normal. Estes cinco prompts fazem trabalho real de agência.

1. Encontrar leads quentes e redigir follow-ups. "Encontre os contatos que responderam nos últimos 7 dias mas não têm agendamento marcado, e redija uma mensagem curta de follow-up para cada um." Um bom resultado é uma lista curta com uma mensagem sob medida por lead, pronta para você enviar.
2. Criar uma oportunidade. "Crie uma nova oportunidade para Jane Doe no pipeline Sales, na etapa Proposal, no valor de 2.500 dólares." Ele devolve a nova oportunidade com a etapa e o valor certos.
3. Resumir uma semana de conversas. "Resuma todas as conversas desta semana e marque quem parecer insatisfeito." Você recebe um resumo e uma lista curta de clientes em risco.
4. Limpar uma tag. "Liste todos os contatos com a tag trial-expired e diga quais ainda têm uma oportunidade aberta." Útil antes de uma campanha de reengajamento.
5. Preparar uma ligação. "Traga o histórico completo do contato com este e-mail e me dê um resumo de 3 linhas antes da minha ligação." Ele lê contato, conversas e oportunidades e entrega o resumo.

Para agências com várias subcontas

É a pergunta mais comum das agências. Use um Private Integration Token por subconta de cliente. Cada token está ligado a uma única location, então um token por cliente mantém os dados de cada cliente totalmente separados e deixa você revogar um sem afetar o resto.

Dê a cada token o nome do cliente para nunca misturar. Ao conectar uma ferramenta de IA para um cliente específico, use o token e o Location ID desse cliente. Se um cliente sair, revogue o token dele e o acesso acaba. Compartilhar um token entre clientes quebra essa separação e é o que se deve evitar.

Você precisa de uma conta do GoHighLevel para usar o servidor MCP. Comece o teste de 30 dias pelo nosso link.

Segurança e rotação do token

O medo é real: as pessoas se preocupam que a IA apague contatos ou bagunce a conta de um cliente. A solução não é confiança, é controle de acesso. A IA só pode fazer o que os scopes do seu token permitem.

• Dê o menor acesso. Selecione só os scopes de que precisa. Deixe os scopes de apagar desligados, a menos que você realmente os queira. Tokens de só leitura não conseguem alterar nada.
• Rotacione a cada 90 dias. Gere um token novo, atualize a sua configuração, confirme a conexão e deixe o antigo ir embora. A opção de rotacionar mantém o token antigo funcionando por 7 dias durante a troca, para nada quebrar.
• Um token por cliente. Tokens separados significam que uma única revogação remove o acesso de um cliente de forma limpa.
• Revogue se expôs. Se um token vazar, revogue imediatamente em vez de esperar a próxima rotação.

Observe que as chaves de API v1 antigas estão obsoletas, e isso é parte do motivo de o Private Integration Token ser agora o caminho obrigatório.

MCP versus Zapier

Eles resolvem problemas diferentes. O Zapier e ferramentas parecidas são melhores para automações fixas com gatilho: quando X acontece, faça Y. O servidor MCP é melhor para trabalho de IA em aberto, em que o assistente decide quais ações tomar conforme o que você pede. Muita gente usa os dois: Zapier para os encanamentos previsíveis, MCP para as tarefas guiadas por IA.

Se você está escolhendo entre Zapier, Make, n8n e a API direta só para automação, explicamos essa decisão em detalhe na receita Zapier vs Make vs n8n vs API direta.

Solução de problemas

• 401 por tipo de chave errado. O token precisa começar com pit-. Uma chave de API comum ou antiga retorna 401. Crie o token de novo em Private Integrations.
• Chave v1 obsoleta. As chaves de API v1 antigas não funcionam mais com MCP. Troque para um Private Integration Token.
• Location ID ausente ou errado. Se as ações atingem a conta errada ou falham, confira o cabeçalho locationId ou cite a location no seu prompt.
• Limites de taxa. Rajadas pesadas podem bater nos limites. Espace as chamadas repetidas ou agrupe o trabalho.
• Sessão velha. Se as ferramentas pararem de responder, reinicie a sua ferramenta de IA para limpar a sessão e reconectar.

Mais da RocketLauncher

• Voice AI do GoHighLevel