GoHighLevel / Squadd MCP Server (Model Context Protocol)

Connetti agenti AI e client MCP-compatibili a GoHighLevel / Squadd usando il Server MCP. Questo consente agli assistenti AI di recuperare dati in modo sicuro, eseguire chiamate agli strumenti, automatizzare workflow e interagire con i servizi di GoHighLevel / Squadd tramite una connessione HTTP standardizzata.

• Cos'è il Server MCP di GoHighLevel / Squadd?
• Vantaggi principali del Server MCP
• Client MCP supportati
• Prerequisiti
• Generare un Token di Integrazione Privata
• Configurare un client MCP-compatibile
• Strumenti MCP disponibili
• Esempi di Workflow MCP
• Esempio: accesso ai dati dei Contatti
• Esempio: strumento Conversazioni
• Esempio: Workflow Opportunità
• Usare MCP in Cursor
• Sicurezza e autenticazione
• Best Practice
• Domande frequenti
• Articoli correlati

Cos'è il Server MCP di GoHighLevel / Squadd?

Il Server MCP (Model Context Protocol) di GoHighLevel / Squadd offre un modo sicuro per gli agenti AI e le applicazioni MCP-compatibili di interagire con gli strumenti e i servizi di GoHighLevel / Squadd. Tramite il Server MCP, gli assistenti AI possono recuperare record, aggiornare dati, automatizzare workflow ed eseguire azioni direttamente all'interno di GoHighLevel / Squadd.

Il Server MCP supporta integrazioni su più servizi di GoHighLevel / Squadd, tra cui Contatti (Contacts), Conversazioni (Conversations), Calendari (Calendars), Opportunità (Opportunities), pagamenti e Location.

Endpoint MCP di produzione

https://services.leadconnectorhq.com/mcp/

Vantaggi principali del Server MCP

Il Server MCP aiuta sviluppatori e builder AI a creare workflow sicuri, scalabili e basati su AI all'interno di GoHighLevel / Squadd.

• Accesso AI centralizzato: Connetti agenti AI a più servizi di GoHighLevel / Squadd attraverso un unico endpoint MCP.
  
  
• Autenticazione sicura: Usa Token di Integrazione Privata con permessi con ambito limitato per un accesso sicuro.
  
  
• Automazione in linguaggio naturale: Permetti agli assistenti AI di eseguire workflow tramite prompt conversazionali.
  
  
• Connettività multi-servizio: Accedi a Contatti, Conversazioni, Opportunità, Calendari, pagamenti e altro ancora.
  
  
• Flessibilità MCP-compatibile: Connettiti con Cursor, Windsurf, OpenAI Playground, client compatibili con Claude e applicazioni MCP personalizzate.

Client MCP supportati

Il Server MCP di GoHighLevel / Squadd supporta applicazioni MCP-compatibili in grado di connettersi tramite HTTP.

I client supportati includono:

• Cursor
  
  
• Windsurf
  
  
• OpenAI Playground
  
  
• Client MCP compatibili con Claude
  
  
• Applicazioni MCP personalizzate

Prerequisiti

Una configurazione corretta garantisce un accesso MCP sicuro e affidabile per i tuoi workflow AI.

Prima di configurare il Server MCP, assicurati di avere:

• Accesso a una Location di GoHighLevel / Squadd
  
  
• Un Token di Integrazione Privata
  
  
• Gli ambiti (scope) di integrazione richiesti abilitati
  
  
• Un client MCP-compatibile

Generare un Token di Integrazione Privata

I Token di Integrazione Privata consentono ai client MCP-compatibili di autenticarsi in modo sicuro con i servizi di GoHighLevel / Squadd.

Come creare un token

1. Accedi a GoHighLevel / Squadd.
   
   
2. Apri la Location desiderata.
   
   
3. Vai su Impostazioni (Settings).
4. Clicca su Private Integrations.
   
   
5. Seleziona Create New Integration.
   
   
6. Scegli gli ambiti (scope) richiesti.
   
   
7. Clicca su Create Integration.
   
   
8. Copia e conserva in modo sicuro il token generato.

Configurare un client MCP-compatibile

Aggiungere l'endpoint MCP e le intestazioni di autenticazione permette al tuo client AI di individuare ed eseguire gli strumenti MCP di GoHighLevel / Squadd.

Esempio di configurazione MCP

{  "mcpServers": {    "prod-ghl-mcp": {      "url": "https://services.leadconnectorhq.com/mcp/",      "headers": {        "Authorization": "Bearer <your-token>",        "locationId": "<your-location-id>"      }    }  } }

Ambiti richiesti (Required Scopes)
Gli ambiti controllano a quali risorse e azioni di GoHighLevel / Squadd possono accedere gli agenti AI. Concedi solo i permessi necessari per i tuoi workflow.

Ambiti consigliati

Contatti

• Visualizza Contatti
  
  
• Modifica Contatti
  
  

Conversazioni

• Visualizza Conversazioni
  
  
• Modifica Conversazioni
  
  
• Visualizza Messaggi delle Conversazioni
  
  
• Modifica Messaggi delle Conversazioni
  
  

Opportunità

• Visualizza Opportunità
  
  
• Modifica Opportunità
  
  

Calendari

• Visualizza Calendari
  
  
• Modifica Calendari
  
  
• Visualizza Eventi del Calendario
  
  
• Modifica Eventi del Calendario
  
  

Pagamenti

• Visualizza Ordini di Pagamento
  
  
• Visualizza Transazioni di Pagamento
  
  

Altro

• Visualizza Campi personalizzati (Custom Fields)
  
  
• Visualizza Form
  
  
• Visualizza Location

Strumenti MCP disponibili

Il Server MCP di GoHighLevel / Squadd include attualmente strumenti per più servizi.

Strumenti Calendario

• calendars_get-calendar-events
  
  
• calendars_get-appointment-notes
  
  

Strumenti Contatti

• contacts_get-all-tasks
  
  
• contacts_add-tags
  
  
• contacts_remove-tags
  
  
• contacts_get-contact
  
  
• contacts_update-contact
  
  
• contacts_upsert-contact
  
  
• contacts_create-contact
  
  
• contacts_get-contacts

Strumenti Conversazioni

• conversations_search-conversation
  
  

• conversations_get-messages
  
  
• conversations_send-a-new-message

Strumenti Location

• locations_get-location
  
  
• locations_get-custom-fields

Strumenti Opportunità

• opportunities_search-opportunity
  
  
• opportunities_get-pipelines
  
  
• opportunities_get-opportunity
  
  
• opportunities_update-opportunity

Strumenti Pagamenti

• payments_get-order-by-id
  
  
• payments_list-transactions
  
  

Esempi di Workflow MCP

Il Server MCP consente agli agenti AI di eseguire azioni all'interno di GoHighLevel / Squadd tramite richieste in linguaggio naturale ed esecuzione di strumenti MCP.

Workflow MCP comuni

• Ricerca di Contatti
  
  
• Aggiornamento di Opportunità
  
  
• Invio di messaggi
  
  
• Recupero di eventi del Calendario
  
  
• Gestione della cronologia delle Conversazioni
  
  
• Accesso ai dati di pagamento

Esempio: accesso ai dati dei Contatti

Gli agenti AI possono recuperare e gestire i dati dei Contatti direttamente tramite gli strumenti MCP.

Azioni supportate sui Contatti

• Trovare Contatti
  
  
• Leggere i dettagli del Contatto
  
  
• Accedere ai Tag
  
  
• Consultare l'attività recente
  
  
• Gestire i task
  
  

Esempio: strumento Conversazioni

Gli strumenti per le Conversazioni consentono agli agenti AI di recuperare messaggi e inviare risposte direttamente dai client MCP-compatibili.

Azioni supportate sulle Conversazioni

• Cercare Conversazioni
  
  
• Recuperare la cronologia dei messaggi
  
  
• Inviare nuovi messaggi
  
  

Esempio: Workflow Opportunità

Gli strumenti per le Opportunità aiutano gli agenti AI a interagire con le Pipeline e a gestire i workflow di vendita direttamente tramite strumenti MCP.

Azioni supportate sulle Opportunità

• Recuperare le Pipeline
  
  
• Cercare Opportunità
  
  
• Aggiornare i record delle Opportunità
  
  
• Gestire i workflow di vendita
  
  

Usare MCP in Cursor

Cursor può connettersi direttamente al Server MCP di GoHighLevel / Squadd tramite le impostazioni di configurazione MCP. Una volta connesso, Cursor può individuare gli strumenti, eseguire azioni MCP e interagire con GoHighLevel / Squadd tramite prompt in linguaggio naturale.

Funzionalità MCP di Cursor

• Individuare gli strumenti disponibili
  
  
• Eseguire chiamate agli strumenti MCP
  
  
• Interrogare i dati di GoHighLevel / Squadd
  
  
• Attivare aggiornamenti tramite prompt AI
  
  

Sicurezza e autenticazione

Il Server MCP utilizza l'autenticazione basata su token per proteggere l'accesso AI alle risorse di GoHighLevel / Squadd.

Ogni richiesta richiede:

• Un Token di Integrazione Privata valido
  
  
• Un locationId valido
  
  

Mantieni i token di integrazione al sicuro ed evita di esporli pubblicamente.

Best Practice

Seguire le best practice di sicurezza migliora l'affidabilità e riduce i rischi di accessi non autorizzati.

• Usa solo gli ambiti (scope) necessari per i tuoi workflow.
  
  
• Conserva i token in modo sicuro.
  
  
• Testa le integrazioni prima del rilascio in produzione.
  
  
• Monitora l'attività AI quando abiliti i permessi di scrittura.
  
  
• Ruota periodicamente i token di integrazione.

Domande frequenti

D: Cosa significa MCP?

MCP sta per Model Context Protocol. È un protocollo standardizzato che consente ad agenti AI e copiloti di interagire in modo sicuro con strumenti e servizi esterni.

D: Quali client MCP sono supportati?

I client supportati includono Cursor, Windsurf, OpenAI Playground, client MCP compatibili con Claude e applicazioni MCP personalizzate.

D: Come mi autentico con il Server MCP?

L'autenticazione richiede un Token di Integrazione Privata valido e il locationId, che devono essere aggiunti alle intestazioni di configurazione del client MCP.

D: Gli agenti AI possono aggiornare i dati di GoHighLevel / Squadd tramite MCP?

Sì. Gli strumenti MCP supportano sia azioni di lettura che di scrittura, a seconda degli ambiti assegnati al Token di Integrazione Privata.

D: Quali servizi sono attualmente supportati?

La versione attuale del Server MCP supporta Contatti, Conversazioni, Calendari, Opportunità, pagamenti, Location e Campi personalizzati.

D: OAuth è attualmente supportato?

No. Il supporto OAuth è previsto per una versione futura.

D: Posso usare MCP con agenti AI personalizzati?

Sì. Qualsiasi applicazione personalizzata che supporta MCP su HTTP può connettersi al Server MCP di GoHighLevel / Squadd.

Articoli correlati

• Documentazione API di GoHighLevel / Squadd 
  
  
• Documenti e Contratti: API pubbliche