L'essentiel à retenir : HighLevel propose un serveur MCP qui permet à Claude, ChatGPT ou Codex de lire et de modifier les données de ton CRM à partir d'une simple demande en français. Claude et les clients OpenAI ont désormais chacun leur adresse de connexion, l'authentification passe par OAuth (sans token à copier) et le catalogue dépasse les 550 opérations. Reste à bien régler les accès : une IA connectée en écriture peut aussi envoyer des messages à tes clients.

Ce guide explique ce que fait réellement le serveur MCP de HighLevel, quelle adresse utiliser selon ton assistant, comment le brancher pas à pas, et quelles limites poser avant de laisser une IA toucher à ton CRM.

MCP, c'est quoi (et pourquoi c'est différent de l'API)

Le Model Context Protocol (MCP) est un protocole ouvert qui standardise la façon dont un assistant IA se connecte à des outils externes. Côté HighLevel, le serveur MCP expose les données et les actions du CRM sous une forme que l'assistant sait découvrir et utiliser seul.

Par rapport à l'API GoHighLevel, tu n'as pas besoin de connaître les détails techniques des appels : tu écris une phrase, et l'assistant cherche lui-même l'opération qui correspond, vérifie les paramètres attendus, puis l'exécute. La documentation développeur du serveur MCP donne cet exemple : « Trouve le contact avec l'email [email protected], ajoute le tag vip-2026 et crée une opportunité de 5 000 $ dans le pipeline “Sales Pipeline” » (traduit de l'anglais). L'assistant enchaîne la recherche du contact, l'ajout du tag et la création de l'opportunité, puis te renvoie une seule confirmation.

Deux façons de se connecter : l'adresse universelle et les adresses par assistant

C'est le point qui sème la confusion, parce que les deux coexistent et que les fiches d'aide (mises à jour entre juillet et août 2026) ne décrivent pas toutes la même chose.

Adresse universelleAdresses par assistant (v2)
URL…/mcp/…/mcp/anthropic/v2 (Claude), …/mcp/openai/v2/ (ChatGPT, Codex), …/mcp/muse/v2/ (Muse)
AuthentificationPrivate Integration Token + identifiant du sous-compte en en-têtes (la fiche d'août mentionne aussi OAuth, selon le client)OAuth : connexion HighLevel, choix du sous-compte, validation des scopes (les autorisations de lecture, création, modification ou suppression)
CouvertureJeu d'outils restreint (contacts, conversations, calendriers, opportunités, paiements, sous-compte, champs personnalisés…)Plus de 550 opérations actives sur 38 domaines
ClientsTout client MCP HTTP (Cursor, Windsurf, n8n, app maison…)Le client prévu pour cette adresse
Plusieurs sous-comptesNon, un seul par connexionOption agence en cours de déploiement

Toutes les URL commencent par https://services.leadconnectorhq.com. HighLevel précise que l'adresse universelle reste supportée : rien ne t'oblige à migrer une connexion qui fonctionne.

Sur la couverture, les chiffres bougent. La fiche d'aide mise à jour le 7 août annonçait 625 opérations au catalogue sur 40 domaines, dont 571 actives. La doc développeur actuelle parle de « plus de 550 opérations actives sur 38 domaines ». Elles vont des contacts et conversations aux factures, au Social Planner, au blog, aux objets personnalisés, à Voice AI et aux Brand Boards. Retiens surtout que la liste exacte dépend des autorisations que tu accordes.

Une poignée d'outils au lieu de centaines

Plutôt que d'afficher chaque opération comme un outil séparé (ce qui saturerait la mémoire de travail de l'IA), les adresses v2 exposent un petit jeu d'outils génériques. La doc développeur actuelle en liste quatre (les fiches d'aide d'août en citaient cinq ou six, avec search et fetch : elles se contredisent, on suit ici la doc développeur) :

  • list_locations : liste les sous-comptes accessibles par la connexion ;
  • search_operations : trouve les opérations qui correspondent à la demande ;
  • describe_operation : affiche les champs attendus, les scopes requis et les informations de sécurité ;
  • execute_operation : lance l'opération, dans la limite de tes autorisations.

En pratique, tu n'as pas à connaître ces noms. Ils servent surtout à comprendre ce que tu vois défiler quand l'assistant travaille.

Brancher Claude à GoHighLevel

Selon la fiche HighLevel MCP pour Claude, l'adresse https://services.leadconnectorhq.com/mcp/anthropic/v2 fonctionne avec Claude.ai, Claude Code et Claude Cowork.

  1. Claude.ai : Paramètres → Connecteurs → Ajouter un connecteur personnalisé. Colle l'URL, clique sur Connecter, connecte-toi à HighLevel, choisis le ou les sous-comptes, puis valide les autorisations. Ouvre ensuite une nouvelle conversation : les outils HighLevel y sont disponibles.
  2. Claude Code : dans un terminal, lance claude mcp add --transport http leadconnector https://services.leadconnectorhq.com/mcp/anthropic/v2. Au premier usage, un navigateur s'ouvre pour l'autorisation HighLevel. Vérifie avec claude mcp list.
  3. Claude Cowork : même principe que Claude.ai, depuis les réglages des connecteurs.

Pour tester, HighLevel suggère une question simple : « Trouve les 5 derniers contacts ajoutés dans HighLevel ». Commence par une lecture, jamais par une écriture.

Brancher ChatGPT ou Codex

Les clients OpenAI utilisent https://services.leadconnectorhq.com/mcp/openai/v2/, toujours en OAuth.

  • ChatGPT : selon la doc développeur HighLevel, active le mode développeur dans Paramètres → Sécurité et connexion. Ouvre ensuite ChatGPT Plugins, clique sur le bouton +, donne un nom et une description, puis ajoute l'URL comme serveur MCP dans la partie Connection. Après l'autorisation HighLevel, ouvre une nouvelle conversation et ajoute la connexion depuis le menu des outils. Les menus de ChatGPT bougent souvent : HighLevel fournit une vidéo de démonstration.
  • Codex : codex mcp add leadconnector --url https://services.leadconnectorhq.com/mcp/openai/v2/, puis codex mcp login leadconnector pour lancer l'autorisation.

Cursor, Windsurf, n8n : l'adresse universelle avec un token

Pour un client qui n'a pas d'adresse dédiée, la fiche de configuration du serveur MCP (mise à jour en juillet 2026) décrit la méthode par token. La fiche d'août indique que cette adresse accepte aussi OAuth, si ton client le gère.

La méthode par token :

  1. dans le sous-compte, va dans Settings → Private Integrations → Create New Integration ;
  2. coche uniquement les scopes utiles, crée l'intégration et copie le token ;
  3. dans ton client, déclare l'URL https://services.leadconnectorhq.com/mcp/ avec deux en-têtes : Authorization: Bearer <ton-token> et locationId: <id-du-sous-compte>.

HighLevel indique aussi que cette adresse fonctionne avec n8n sans plugin. Si tu automatises déjà avec Make ou n8n, c'est une piste pour donner à un agent IA l'accès au CRM au milieu d'un scénario.

Agences : un assistant pour plusieurs sous-comptes

Pour une agence, c'est le point qui change le plus le quotidien. En installant la connexion au niveau agence, tu choisis un, plusieurs ou tous les sous-comptes. Ensuite, tu nommes simplement le client dans ta demande : « montre-moi les dernières opportunités de Cabinet Dupont », puis « fais pareil pour Garage Martin ». Si le sous-compte visé est ambigu, l'assistant appelle list_locations et te demande de choisir.

Deux garde-fous : chaque requête ne vise qu'un seul sous-compte à la fois, et la connexion ne peut jamais atteindre un sous-compte que tu n'as pas sélectionné à l'installation. Attention au calendrier : la doc développeur précise que ce mode multi-comptes est en cours de déploiement (une fiche d'aide du 7 août affirmait encore « une connexion = un sous-compte »). Si l'écran d'autorisation ne te propose qu'un seul sous-compte, l'option n'est pas encore activée pour toi.

Ce que tu peux en faire au quotidien

  • Revue de pipeline : « liste les opportunités de l'étape Devis envoyé ». Utile en complément de tes pipelines. Pour filtrer par ancienneté, tout dépend des champs que l'assistant peut lire : vérifie le résultat.
  • Retrouver des contacts, ajouter ou retirer des tags sur une sélection précise, sans passer par un export.
  • Préparation de rendez-vous : résumer l'historique des conversations avec un prospect avant un appel.
  • Contenu : le catalogue couvre le blog, les modèles d'email et le Social Planner. Fais-toi proposer un texte, relis-le, et ne valide la création ou la publication qu'ensuite.

Tu peux utiliser MCP dans une conversation, ou l'intégrer à un agent dans un scénario n8n. Il vient en complément de tes workflows et des outils de l'AI Employee, pas à leur place.

Sécurité : les réglages à faire avant d'ouvrir l'accès

Une IA qui peut envoyer des messages ou supprimer des contacts doit être traitée comme un nouvel utilisateur : accès minimum, et surveillance au début.

HighLevel prévoit des contrôles supplémentaires avant les opérations sensibles ou irréversibles, et tu peux révoquer l'accès OAuth à tout moment depuis ton compte. Ça ne dispense pas de poser tes propres règles :

  • Accorde le minimum de scopes. Pour un usage d'analyse, la lecture suffit. N'active l'écriture que pour un besoin précis.
  • Demande une confirmation avant chaque écriture. Écris-le dans ta consigne : « montre-moi ce que tu vas modifier et attends mon accord ».
  • Teste sur un sous-compte de démo avant de connecter un client réel.
  • Avec un token, ne le colle jamais dans un prompt partagé, une capture d'écran ou un dépôt de code, et remplace-le régulièrement.
  • Pense aux données personnelles. Les données renvoyées par les outils sont lisibles par l'assistant connecté. Vérifie où ton client IA les traite et les conserve, ses conditions de traitement et la cohérence avec tes obligations, détaillées dans notre guide GoHighLevel et RGPD.

L'accès de l'IA reste aussi borné par les droits de l'utilisateur qui l'autorise : HighLevel indique que les opérations bloquées par les contrôles de rôle sont refusées. Raison de plus pour soigner tes rôles et permissions d'équipe.

Récap : par où commencer

  1. Tu utilises Claude, ChatGPT ou Codex : prends l'adresse v2 de ton assistant et connecte-toi en OAuth.
  2. Tu utilises un autre client (Cursor, Windsurf, n8n, outil maison) : adresse universelle, avec un Private Integration Token aux scopes limités (ou OAuth si ton client le gère).
  3. Commence par des questions en lecture, sur un sous-compte de test.
  4. Ouvre l'écriture au cas par cas, avec confirmation systématique.
  5. En agence, vérifie si l'option multi-sous-comptes apparaît à l'autorisation.

Le serveur MCP évolue vite, et les descriptions diffèrent déjà d'un document HighLevel à l'autre (adresses, nombre d'opérations, clients compatibles). Avant de former ton équipe, relis la doc officielle à la date du jour.