Como conectar o Claude ao GoHighLevel (MCP)

Em resumo

• O GoHighLevel tem um servidor MCP oficial ao qual o Claude se conecta diretamente.
• Você precisa de um token do GoHighLevel e de alguns minutos nas configurações do Claude.
• O Claude só vê e mexe no que o seu token permite, nada além disso.

O que significa "conectar o Claude ao GoHighLevel"?

MCP é a sigla de Model Context Protocol. É um padrão aberto que permite a um assistente de IA chamar uma ferramenta externa por um conjunto definido de ações, em vez de adivinhar o que há em uma tela. O GoHighLevel publica um servidor MCP oficial, e o Claude é uma das ferramentas de IA feitas para falar esse protocolo.

Com os dois conectados, você pode pedir ao Claude algo como "encontre os contatos que não agendaram uma ligação esta semana" em um chat normal, e o Claude entra na sua conta do GoHighLevel pelo servidor MCP para trazer a resposta real. Sem clicar pelo painel e sem exportar uma planilha antes.

Você não instala nada dentro do GoHighLevel. Você dá ao Claude uma chave (o token do Passo 1 abaixo) e aponta para um endereço que o GoHighLevel já mantém no ar. O GoHighLevel controla o que essa chave pode ver e fazer.

O que você precisa antes de começar?

Três coisas, e a configuração leva cerca de 10 minutos:

• Uma conta do GoHighLevel em qualquer plano, com acesso de administrador em Settings.
• O Claude, seja o app web, o app de desktop ou o Claude Code, em um plano que permita conectar ferramentas externas.
• Alguns minutos para criar um token e colar dois valores no Claude.

Você não precisa escrever código no caminho web ou desktop abaixo. O Claude Code é a única opção feita para desenvolvedores, e é opcional, não obrigatória.

Passo 1: crie um Private Integration Token no GoHighLevel

No GoHighLevel, vá em Settings, depois Private Integrations e depois Create New Integration. Dê um nome que você reconheça depois, como "Claude MCP".

Selecione só as permissões (scopes) que você quer que o Claude use. Se você quer que o Claude leia e resuma os seus contatos e conversas, escolha os scopes de contatos e conversas e pare por aí. Deixe desligados os scopes de apagar e de escrita até você confiar na configuração, já que alguns scopes deixam uma ferramenta conectada remover dados.

Copie o token antes de fechar a tela. Ele começa com "pit-" e o GoHighLevel mostra uma única vez. É a única peça que o GoHighLevel trata como segredo, então guarde em um lugar privado, do mesmo jeito que uma senha.

Passo 2: encontre o Location ID do GoHighLevel

O Location ID diz ao servidor MCP em qual subconta do GoHighLevel trabalhar. Você encontra em Settings, depois Company e depois Locations, e copia o ID ao lado da conta que você quer que o Claude use.

Você também pode ler na barra de endereço do navegador enquanto está dentro dessa subconta. É a sequência longa de letras e números que vem depois de "/location/" na URL.

Passo 3: adicione o servidor MCP do GoHighLevel ao Claude

O jeito de fazer isso depende da versão do Claude que você usa. A maioria usa o app web ou o app de desktop, então comece por aí.

App web do Claude ou app de desktop do Claude (sem código)

Abra Settings dentro do Claude e procure uma seção chamada Connectors ou Integrations. Escolha a opção de adicionar um conector personalizado ou de servidor remoto.

Cole o endereço do servidor MCP do GoHighLevel e depois cole o seu token e o Location ID nos campos que o formulário do conector pedir. O texto exato desses menus pode mudar quando a Anthropic atualizar a interface, então, se os nomes acima parecerem um pouco diferentes no seu app, procure qualquer coisa chamada Connectors, Integrations ou MCP servers.

Salve o conector e reinicie o Claude se ele pedir. O GoHighLevel deve aparecer como uma ferramenta conectada na próxima vez que você iniciar um chat.

Claude Code (para desenvolvedores)

O Claude Code guarda a configuração de MCP em um arquivo chamado ~/.claude.json. Adicione um bloco em mcpServers com o endereço do GoHighLevel, o seu token e o seu Location ID, ou rode o comando "claude mcp add" e cole esses valores quando ele pedir.

~/.claude.json

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

Reinicie o Claude Code e digite "/mcp" para confirmar que o GoHighLevel aparece na lista de ferramentas conectadas.

Passo 4: confirme que a conexão funciona

Peça primeiro ao Claude algo pequeno e seguro, como "liste os meus 5 contatos mais recentes do GoHighLevel". Se o Claude voltar com nomes reais da sua conta, a conexão funciona.

Se o Claude disser que não tem nenhuma ferramenta do GoHighLevel disponível, confira três coisas: se o token começa com "pit-", se os scopes que você escolheu cobrem o que você pediu e se você reiniciou o Claude depois de adicionar o conector. Essas três cobrem quase todos os erros de configuração.

O que o Claude consegue fazer de verdade depois de conectado?

Exatamente o que o seu token permite, e nada além. O servidor MCP do GoHighLevel alcança contatos, conversas, agendas, oportunidades e alguns outros módulos, mas o Claude só ganha uma porta para os que estão cobertos pelos scopes que você escolheu no Passo 1.

Na prática, com contatos, conversas e oportunidades ativados, as pessoas pedem ao Claude coisas como "resuma as conversas desta semana e marque quem parecer insatisfeito", "crie uma oportunidade para este lead" ou "faça um resumo rápido antes da minha próxima ligação". O Claude lê ou escreve pelas mesmas regras que o GoHighLevel aplica a qualquer outra integração, ele não recebe acesso especial.

Como manter a conexão segura?

O token é toda a superfície de controle, então trate-o assim.

• Comece só com leitura. Dê apenas os scopes de que você precisa hoje. Adicione permissão de escrita depois, quando confiar no que o Claude devolve.
• Evite os scopes de apagar. Deixe desligados, a menos que você tenha um motivo específico para querê-los.
• Use um token por conta. Se você gerencia mais de uma location do GoHighLevel, crie um token separado para cada uma, assim você revoga um sem mexer nos outros.
• Revogue se expôs. Se um token vazar, revogue no GoHighLevel na hora em vez de esperar.

Mais da RocketLauncher

• Calculadora de custo do GoHighLevel