GoHighLevel MCP con Claude: risposta diretta
Per collegare Claude a GoHighLevel via MCP si usa l’endpoint dedicato ad Anthropic https://services.leadconnectorhq.com/mcp/anthropic/v2 con autenticazione OAuth. Scegli tu gli scope e il sub-account durante l’autorizzazione. Ogni singola richiesta lavora su un solo sub-account alla volta. Il vecchio endpoint /mcp/ funziona ancora ma espone meno scope.
GoHighLevel ha aperto il proprio CRM al Model Context Protocol, e questo cambia concretamente il modo in cui si può lavorare su contatti, opportunità e pipeline. Invece di aprire il pannello, cercare il record, aggiornare un campo e chiudere, dici a Claude cosa fare in linguaggio naturale e lui esegue. Il catalogo attivo conta [DOC] 571 operazioni su 40 domini — quelle che ti restano disponibili dipendono dagli scope che hai approvato. Questa guida copre i tre client Claude supportati, la differenza tra OAuth e token, il comportamento su più sub-account e le contraddizioni che la documentazione ufficiale non ha ancora risolto.
OAuth contro Private Integration Token: cosa cambia davvero
La documentazione GoHighLevel raccomanda OAuth come strada principale per il leadconnector MCP. Il motivo è pratico: nessun token da generare, conservare o ruotare. Il flusso apre il browser, ti fa autenticare su HighLevel, ti mostra gli scope e li approva in un colpo solo.
L’alternativa è un Private Integration Token, creato da Settings → Private Integrations e passato come Bearer pit-... nell’header della richiesta. Funziona, ma porta meno scope rispetto a OAuth — il che significa meno operazioni disponibili in Claude. Se la tua agenzia ha già token in circolazione per altre integrazioni, tienili separati: il token per MCP non è lo stesso oggetto.
| Metodo | Setup | Scope disponibili | Token da gestire |
|---|---|---|---|
| OAuth | Browser + approvazione scope | Completi | No |
| Private Integration Token | Genera da Settings → Private Integrations | Ridotti | Sì, manuale |
Collegare Claude.ai, Claude Code e Cowork: i passi
I tre client seguono la stessa logica — endpoint identico, flusso OAuth identico — ma il punto di ingresso cambia.
Claude.ai
- Vai su Settings → Connectors → Add custom connector.
- Incolla l’URL
https://services.leadconnectorhq.com/mcp/anthropic/v2. - Clicca Connect: si apre il browser su HighLevel.
- Accedi, seleziona il sub-account, approva gli scope.
- Torna su Claude.ai: il connettore compare nella lista.
Prima di fare qualsiasi scrittura, prova con una lettura semplice: «Trova gli ultimi 5 contatti che ho aggiunto». Se risponde con dati reali, il collegamento funziona.
Claude Code
- Da terminale:
claude mcp add --transport http leadconnector https://services.leadconnectorhq.com/mcp/anthropic/v2. - In alternativa, aggiungi una voce
mcpServersnel file.mcp.jsonalla radice del progetto. - Al primo utilizzo si apre il browser per l’autorizzazione OAuth.
- Verifica con
claude mcp list: il server leadconnector deve comparire attivo.
Claude Code è il client più utile se lavori su automazioni o stai costruendo workflow: puoi interrogare il CRM e usare i dati direttamente nel contesto del progetto, senza uscire dall’editor.
Claude Cowork
- Vai nelle impostazioni connettori.
- Seleziona Add custom connector.
- Stesso URL, stesso flusso OAuth degli altri client.
Lavorare su più sub-account con highlevel MCP
Questo è il punto dove la documentazione ufficiale GoHighLevel crea più confusione, e vale dirlo chiaramente.
Un articolo pubblicato il 6 agosto descrive la possibilità di autorizzare uno, alcuni o tutti i sub-account di un’agenzia in un’unica connessione OAuth. Una volta autorizzati, puoi dire a Claude il nome del sub-account nella richiesta — per esempio «crea un contatto in Westside Dental» — e lui usa list_locations per identificare la location giusta se non è disambiguata.
Un articolo pubblicato il 7 agosto afferma l’opposto: una connessione OAuth corrisponde sempre a una sola location, mai a livello agenzia, e per ogni sub-account aggiuntivo serve una connessione separata.
I due articoli non concordano. La fonte è la stessa: la documentazione ufficiale GoHighLevel. La cosa più onesta da fare è verificare direttamente sul tuo account cosa ti mostra il flusso di autorizzazione. Se l’opzione multi-sub-account compare, è disponibile per te; se non compare, probabilmente è in rollout e non ancora attiva.
Quello che vale in ogni caso: ogni singola richiesta lavora su un solo sub-account. Se hai autorizzato più location, cita il nome nella richiesta. Se Claude non è sicuro, usa list_locations e te lo chiede.
Attenzione
La contraddizione nella documentazione ufficiale non è risolta
I due articoli GoHighLevel sul multi-sub-account si contraddicono su un punto chiave: se una connessione OAuth può coprire più location o ne supporta una sola. Non interpretare questa guida come verdetto finale: apri il flusso di autorizzazione sul tuo account e guarda cosa ti mostra.
- Multi-account — se l’opzione compare nel tuo flusso OAuth, è attiva per te
- altrimenti è in rollout
- Citare il sub-account — scrivi il nome nella richiesta, non lasciare ambiguità
- Revoca accesso — da Settings puoi rivedere e revocare i permessi in qualsiasi momento
Operazioni disponibili e operazioni distruttive
Il catalogo GoHighLevel MCP conta [DOC] 625 operazioni su 40 domini, di cui 571 attive. Quelle che vedi davvero in Claude dipendono dagli scope approvati durante l’OAuth: se non hai approvato lo scope contacts.write, Claude non può creare o modificare contatti, indipendentemente da quello che gli chiedi.
Sul numero di tool esposti ai client c’è un’altra discrepanza tra i due articoli ufficiali: uno parla di cinque tool, l’altro di sei, con list_locations come elemento in più. Anche qui, verifica su ciò che vedi nel tuo client dopo la connessione.
Le operazioni distruttive — eliminare un contatto, cancellare un’opportunità — chiedono conferme aggiuntive prima di eseguire. Non è una guardia che metti tu: è il comportamento default del server MCP. Funziona come freno, ma non sostituisce la logica di verificare cosa stai autorizzando al momento dell’approvazione degli scope.
La regola pratica: inizia sempre con operazioni di lettura. Poi scritture su record di test. Solo dopo vai sulle operazioni in produzione. Un agente AI senza questa progressione esegue sbagliato con la stessa sicurezza con cui esegue giusto.
Make e agenti AI
Make è il layer che dà le braccia all’agente
Un agente AI decide cosa fare. Make esegue le azioni nel mondo reale: crea record, sposta dati, triggera webhook. Nei primi giorni connetti un modulo HTTP al tuo CRM, mappa tre campi, esegui. Il piano gratuito da 1.000 operazioni al mese è abbastanza per capire se la macchina funziona prima di spendere un euro.
- Giorno 1 — crea uno scenario che legge contatti da GoHighLevel e li scrive in un foglio
- Giorno 3 — aggiungi una condizione: se il campo è vuoto, salta
- Giorno 7 — collega l’output di Claude a un modulo Make per automatizzare la scrittura nel CRM
Apri il piano gratuito di Make →
Link di affiliazione: se ti iscrivi da qui io prendo una commissione, tu paghi uguale. Lo linko perché ci lavoro dentro ogni giorno.
Revocare l’accesso e tenere la macchina sotto controllo
La connessione MCP non è permanente per natura: puoi rivedere e revocare i permessi dalle impostazioni di GoHighLevel in qualsiasi momento. La revoca toglie immediatamente l’accesso al sub-account autorizzato. Se consegni un sub-account a un cliente o chiudi un mandato, revocare la connessione è il primo passo, non l’ultimo.
Sul collegamento a più sub-account: se hai autorizzato un set di location e ne vuoi aggiungere una che non era nella selezione originale, devi ri-autorizzare la connessione. Non puoi raggiungerla in altro modo con la stessa sessione OAuth.
Per chi gestisce più clienti su GoHighLevel — il caso tipico di un’agenzia in white label — il flusso da tenere a mente è questo: ogni sub-account che vuoi esporre a Claude richiede una decisione esplicita al momento dell’autorizzazione. Non è un accesso globale. È una scelta per scope. Questo è un vantaggio, non un limite: significa che puoi dare a Claude accesso solo a quello che serve davvero, con una superficie di rischio definita.
Se stai costruendo un sistema dove Claude esegue azioni su GoHighLevel in modo ricorrente — aggiornare opportunità, spostare contatti tra pipeline, creare task — il pezzo successivo da considerare è come il CRM si connette al resto dei tuoi tool. L’articolo su Invoke Managed Agent nei workflow GoHighLevel mostra come far girare un agente AI direttamente dentro un’automazione del CRM. E se il nodo è capire come si progetta il processo prima ancora di toccare il tool, l’articolo sul significato di workflow e la differenza tra un diagramma e un sistema che gira da solo è il punto di partenza corretto. Chi vuole capire come MCP si integra più in profondità nei workflow di automazione può leggere anche la guida su n8n e Model Context Protocol per agenti AI.
GoHighLevel MCP con Claude è uno degli esempi più concreti di come gli agenti AI smettono di essere una demo e diventano un layer operativo reale sul CRM. La connessione prende cinque minuti. Capire quali scope approvare, quale sub-account esporre e dove mettere le guardie — quello richiede un po’ più di attenzione. Ma è il lavoro che vale.
Domande frequenti
Serve un piano GoHighLevel specifico per usare MCP con Claude?
La documentazione ufficiale non indica un piano minimo richiesto. La funzione MCP risulta disponibile sugli account GoHighLevel standard. Se non vedi l’opzione multi-sub-account nel flusso OAuth, potrebbe essere in rollout e non ancora attiva sul tuo account.
Posso usare lo stesso endpoint MCP con ChatGPT o altri client AI?
L’endpoint https://services.leadconnectorhq.com/mcp/anthropic/v2 è dedicato ai client Anthropic. GoHighLevel ha endpoint separati per altri client AI. Usare l’endpoint Anthropic con un client diverso non è il percorso supportato.
Cosa succede se Claude esegue un’operazione distruttiva per errore?
Le operazioni distruttive — eliminazioni o modifiche irreversibili — chiedono una conferma aggiuntiva prima di procedere. È un comportamento default del server MCP GoHighLevel, non una guardia che configuri tu. Non elimina il rischio, ma introduce un passaggio di verifica esplicito.
Il mcp crm agenzia funziona anche senza approvare tutti gli scope?
Sì. Approvi solo gli scope che ti servono: se non hai bisogno che Claude scriva su contatti, non approvare lo scope write. Le operazioni disponibili in Claude si riducono di conseguenza. Meno scope significa meno superficie esposta, il che per un’agenzia con più clienti è quasi sempre la scelta corretta.
Trasparenza: in questo articolo c’è un link di affiliazione. Se ti iscrivi da lì io ricevo una commissione, per te non cambia niente. Linko solo strumenti che uso in produzione.
