Questo articolo ti mostra come sfruttare il nuovo server MCP (Model Context Protocol) di GoHighLevel per potenziare i tuoi agenti AI e copiloti, permettendo loro di accedere ai dati e agli strumenti di GoHighLevel senza problemi — tutto tramite un protocollo HTTP sicuro e standardizzato.

INDICE DEI CONTENUTI

Cos'è il Server MCP?

Il server MCP di GoHighLevel è un protocollo standardizzato e sicuro che consente agli agenti AI di leggere e scrivere dati in GoHighLevel senza necessità di SDK o integrazioni personalizzate complesse. Ora puoi fornire ai tuoi agenti l'accesso a strumenti critici come Calendari, Contatti, Conversazioni, Opportunità e Pagamenti tramite un'unica interfaccia unificata.

Principali vantaggi del Server MCP

Collegare i tuoi agenti AI a GoHighLevel non è mai stato così semplice e sicuro.

Accesso standardizzato: Interroga e aggiorna i dati tramite un protocollo unificato.
Integrazione rapida: Non servono SDK; funziona con qualsiasi client che supporti HTTP.
Sicuro: Utilizza token di integrazione privati (PIT) per un accesso granulare basato sui permessi.
Scalabile: Progettato per l'espansione futura a 250+ strumenti.
Flessibile: Supporta client popolari come Cursor, Windsurf e OpenAI Playground.

36 Strumenti disponibili

Di seguito è riportato il set iniziale di strumenti che i tuoi agenti AI possono utilizzare oggi:

#	Strumento	Endpoint	Descrizione
1	Ottieni eventi calendario	calendars_get-calendar-events	Ottieni eventi calendario utilizzando userId, groupId o calendarId.
2	Ottieni note appuntamento	calendars_get-appointment-notes	Recupera le note per un appuntamento specifico.
3	Ottieni tutti i compiti	contacts_get-all-tasks	Recupera tutti i compiti per un contatto.
4	Aggiungi tag	contacts_add-tags	Aggiungi tag a un contatto.
5	Rimuovi tag	contacts_remove-tags	Rimuovi tag da un contatto.
6	Ottieni contatto	contacts_get-contact	Recupera i dettagli del contatto.
7	Aggiorna contatto	contacts_update-contact	Aggiorna un contatto.
8	Upsert contatto	contacts_upsert-contact	Aggiorna o crea un contatto.
9	Crea contatto	contacts_create-contact	Crea un nuovo contatto.
10	Ottieni contatti	contacts_get-contacts	Recupera tutti i contatti.
11	Cerca conversazione	conversations_search-conversation	Cerca/filtra/ordina conversazioni.
12	Ottieni messaggi	conversations_get-messages	Recupera messaggi per ID conversazione.
13	Invia nuovo messaggio	conversations_send-a-new-message	Invia un messaggio a un thread di conversazione.
14	Ottieni location	locations_get-location	Ottieni i dettagli della location per ID.
15	Ottieni campi personalizzati	locations_get-custom-fields	Recupera le definizioni dei campi personalizzati per una location.
16	Cerca opportunità	opportunities_search-opportunity	Cerca opportunità per criteri.
17	Ottieni pipeline	opportunities_get-pipelines	Recupera tutte le pipeline di opportunità.
18	Ottieni opportunità	opportunities_get-opportunity	Recupera i dettagli dell'opportunità per ID.
19	Aggiorna opportunità	opportunities_update-opportunity	Aggiorna i dettagli dell'opportunità.
20	Ottieni ordine per ID	payments_get-order-by-id	Recupera i dettagli dell'ordine di pagamento.
21	Elenca transazioni	payments_list-transactions	Recupera l'elenco paginato delle transazioni.
22	Verifica slug URL blog	blogs_check-url-slug-exists	Verifica lo slug del blog necessario prima di pubblicare un post.
23	Aggiorna post blog	blogs_update-blog-post	Aggiorna post blog per un determinato sito blog
24	Crea post blog	blogs_create-blog-post	Crea post blog per un determinato sito blog
25	Ottieni autori blog	blogs_get-all-blog-authors-by-location	Ottieni autori blog per un ID location determinato
26	Ottieni categorie blog	blogs_get-all-categories-by-location	Ottieni categorie blog per un ID location determinato
27	Ottieni post blog per ID blog	blogs_get-blog-post	Ottieni post blog per un determinato sito blog utilizzando l'ID blog
28	Ottieni blog per location	blogs_get-blogs	Ottieni blog utilizzando l'ID location
29	Crea template email	emails_create-template	Crea un nuovo template
30	Ottieni template email	emails_fetch-template	Recupera template email per ID location
31	Ottieni account social media	socialmediaposting_get-account	Ottieni elenco di account e gruppi
32	Ottieni statistiche social media	socialmediaposting_get-social-media-statistics	Recupera i dati di analisi per più account social media
33	Crea post social media	socialmediaposting_create-post	Crea post per tutte le piattaforme supportate
34	Ottieni post social media	socialmediaposting_get-post	Ottieni post social media
35	Ottieni post social media	socialmediaposting_get-posts	Ottieni post social media
36	Aggiorna post social media	socialmediaposting_edit-post	Modifica post social media

Come configurare il Server MCP

Passaggio 1: Configura il tuo agente/client

Aggiungi l'endpoint MCP e le intestazioni alla configurazione del tuo agente:

json

CopyEdit

{

"mcpServers": {

"prod-ghl-mcp": {

"url": "https://services.leadconnectorhq.com/mcp/",

"headers": {

"Authorization": "Bearer <your-token>",

"locationId": "<sub-account-id>"

}

Passaggio 2: Ottieni il tuo Token di Integrazione Privata (PIT)

Vai a Impostazioni → Integrazioni private nella tua location GoHighLevel.
Fai clic su Crea nuova integrazione.
Seleziona gli scope richiesti (elencati di seguito).
Copia e conserva in modo sicuro il tuo token.

Scope richiesti

Assicurati che il tuo PIT includa:

Visualizza/Modifica Contatti
Visualizza/Modifica Conversazioni
Visualizza/Modifica messaggi conversazione
Visualizza/Modifica Opportunità
Visualizza calendari e eventi calendario
Visualizza Location
Visualizza ordini di pagamento e transazioni
Visualizza campi personalizzati
Visualizza moduli
Verifica slug post blog
Aggiorna post blog
Crea post blog
Visualizza autori blog
Visualizza categorie blog
blogspostsreadonly
blogslistreadonly
Crea, aggiorna ed elimina template email
Visualizza template email
Visualizza account social media
Visualizza statistiche social media
Modifica post social media
Visualizza post social media

Passaggio 3: Inizia a costruire!

I tuoi agenti possono ora chiamare strumenti utilizzando istruzioni in linguaggio naturale, tradotte senza problemi in chiamate API sicure tramite MCP.

Esempio di Chiamata Tool

Esempio in Python:

python

CopyEdit

import requests

headers = {

"Authorization": "Bearer YOUR_PIT_TOKEN",

"locationId": "YOUR_LOCATION_ID"

}

data = {

"tool": "contacts_get-contact",

"input": {

"contactId": "abc123"

}

response = requests.post(

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

headers=headers,

json=data

)

print(response.json())

Roadmap e Visione

Questa versione iniziale di MCP è solo l'inizio. La nostra roadmap include:

Server MCP individuali dedicati a servizi specifici per workflow mirati.
Pacchetto npx per supportare client senza supporto HTTP nativo (ad es. Claude Desktop).
Supporto OAuth per flussi di autorizzazione avanzati.
Espansione a 250+ strumenti per creare un vero e proprio livello orchestrator unificato per agenti AI.
Abilitare l'automazione completa dei processi aziendali su tutti i moduli di GoHighLevel.

Domande Frequenti

D: Posso utilizzare questo con OpenAI Playground o Claude?
Sì! Qualsiasi client che supporti richieste HTTP può integrarsi con MCP.

D: Devo installare un SDK?
No, non è richiesto alcun SDK — MCP utilizza un protocollo HTTP standard.

D: I miei dati sono al sicuro?
Sì. L'accesso ai dati è completamente limitato tramite token di integrazione privati e protetto tramite HTTPS.

D: Posso limitare quali strumenti un agente può utilizzare?
Sì. Puoi controllare l'accesso limitando gli scope nel tuo PIT.

D: Cosa succede se ho bisogno di un nuovo strumento o endpoint?
Condividi il tuo feedback! Stiamo attivamente espandendo il set di strumenti disponibili.

Prossimi Passi

Crea il tuo Token di Integrazione Privata e configura gli scope.
Aggiorna la configurazione del tuo agente AI o client con l'endpoint MCP.
Inizia a costruire automazioni e integrazioni guidate da agenti oggi!
Fornisci feedback per aiutare a plasmare le espansioni future e il supporto dei nuovi strumenti.

INDICE DEI CONTENUTI

Cos'è il Server MCP?
Principali vantaggi del Server MCP
36 Strumenti disponibili
Esempio di Chiamata Tool
Roadmap e Visione
Domande Frequenti
Prossimi Passi

Cos'è il Server MCP?

Principali vantaggi del Server MCP

Collegare i tuoi agenti AI a GoHighLevel non è mai stato così semplice e sicuro.

Accesso standardizzato: Interroga e aggiorna i dati tramite un protocollo unificato.
Integrazione rapida: Non servono SDK; funziona con qualsiasi client che supporti HTTP.
Sicuro: Utilizza token di integrazione privati (PIT) per un accesso granulare basato sui permessi.
Scalabile: Progettato per l'espansione futura a 250+ strumenti.
Flessibile: Supporta client popolari come Cursor, Windsurf e OpenAI Playground.

36 Strumenti disponibili

Di seguito è riportato il set iniziale di strumenti che i tuoi agenti AI possono utilizzare oggi:

#	Strumento	Endpoint	Descrizione
1	Ottieni eventi calendario	calendars_get-calendar-events	Ottieni eventi calendario utilizzando userId, groupId o calendarId.
2	Ottieni note appuntamento	calendars_get-appointment-notes	Recupera le note per un appuntamento specifico.
3	Ottieni tutti i compiti	contacts_get-all-tasks	Recupera tutti i compiti per un contatto.
4	Aggiungi tag	contacts_add-tags	Aggiungi tag a un contatto.
5	Rimuovi tag	contacts_remove-tags	Rimuovi tag da un contatto.
6	Ottieni contatto	contacts_get-contact	Recupera i dettagli del contatto.
7	Aggiorna contatto	contacts_update-contact	Aggiorna un contatto.
8	Upsert contatto	contacts_upsert-contact	Aggiorna o crea un contatto.
9	Crea contatto	contacts_create-contact	Crea un nuovo contatto.
10	Ottieni contatti	contacts_get-contacts	Recupera tutti i contatti.
11	Cerca conversazione	conversations_search-conversation	Cerca/filtra/ordina conversazioni.
12	Ottieni messaggi	conversations_get-messages	Recupera messaggi per ID conversazione.
13	Invia nuovo messaggio	conversations_send-a-new-message	Invia un messaggio a un thread di conversazione.
14	Ottieni location	locations_get-location	Ottieni i dettagli della location per ID.
15	Ottieni campi personalizzati	locations_get-custom-fields	Recupera le definizioni dei campi personalizzati per una location.
16	Cerca opportunità	opportunities_search-opportunity	Cerca opportunità per criteri.
17	Ottieni pipeline	opportunities_get-pipelines	Recupera tutte le pipeline di opportunità.
18	Ottieni opportunità	opportunities_get-opportunity	Recupera i dettagli dell'opportunità per ID.
19	Aggiorna opportunità	opportunities_update-opportunity	Aggiorna i dettagli dell'opportunità.
20	Ottieni ordine per ID	payments_get-order-by-id	Recupera i dettagli dell'ordine di pagamento.
21	Elenca transazioni	payments_list-transactions	Recupera l'elenco paginato delle transazioni.
22	Verifica slug URL blog	blogs_check-url-slug-exists	Verifica lo slug del blog necessario prima di pubblicare un post.
23	Aggiorna post blog	blogs_update-blog-post	Aggiorna post blog per un determinato sito blog
24	Crea post blog	blogs_create-blog-post	Crea post blog per un determinato sito blog
25	Ottieni autori blog	blogs_get-all-blog-authors-by-location	Ottieni autori blog per un ID location determinato
26	Ottieni categorie blog	blogs_get-all-categories-by-location	Ottieni categorie blog per un ID location determinato
27	Ottieni post blog per ID blog	blogs_get-blog-post	Ottieni post blog per un determinato sito blog utilizzando l'ID blog
28	Ottieni blog per location	blogs_get-blogs	Ottieni blog utilizzando l'ID location
29	Crea template email	emails_create-template	Crea un nuovo template
30	Ottieni template email	emails_fetch-template	Recupera template email per ID location
31	Ottieni account social media	socialmediaposting_get-account	Ottieni elenco di account e gruppi
32	Ottieni statistiche social media	socialmediaposting_get-social-media-statistics	Recupera i dati di analisi per più account social media
33	Crea post social media	socialmediaposting_create-post	Crea post per tutte le piattaforme supportate
34	Ottieni post social media	socialmediaposting_get-post	Ottieni post social media
35	Ottieni post social media	socialmediaposting_get-posts	Ottieni post social media
36	Aggiorna post social media	socialmediaposting_edit-post	Modifica post social media

Come configurare il Server MCP

Passaggio 1: Configura il tuo agente/client

Aggiungi l'endpoint MCP e le intestazioni alla configurazione del tuo agente:

json

CopyEdit

{

"mcpServers": {

"prod-ghl-mcp": {

"url": "https://services.leadconnectorhq.com/mcp/",

"headers": {

"Authorization": "Bearer <your-token>",

"locationId": "<sub-account-id>"

}

Passaggio 2: Ottieni il tuo Token di Integrazione Privata (PIT)

Vai a Impostazioni → Integrazioni private nella tua location GoHighLevel.
Fai clic su Crea nuova integrazione.
Seleziona gli scope richiesti (elencati di seguito).
Copia e conserva in modo sicuro il tuo token.

Scope richiesti

Assicurati che il tuo PIT includa:

Visualizza/Modifica Contatti
Visualizza/Modifica Conversazioni
Visualizza/Modifica messaggi conversazione
Visualizza/Modifica Opportunità
Visualizza calendari e eventi calendario
Visualizza Location
Visualizza ordini di pagamento e transazioni
Visualizza campi personalizzati
Visualizza moduli
Verifica slug post blog
Aggiorna post blog
Crea post blog
Visualizza autori blog
Visualizza categorie blog
blogspostsreadonly
blogslistreadonly
Crea, aggiorna ed elimina template email
Visualizza template email
Visualizza account social media
Visualizza statistiche social media
Modifica post social media
Visualizza post social media

Passaggio 3: Inizia a costruire!

I tuoi agenti possono ora chiamare strumenti utilizzando istruzioni in linguaggio naturale, tradotte senza problemi in chiamate API sicure tramite MCP.

Esempio di Chiamata Tool

Esempio in Python:

python

CopyEdit

import requests

headers = {

"Authorization": "Bearer YOUR_PIT_TOKEN",

"locationId": "YOUR_LOCATION_ID"

}

data = {

"tool": "contacts_get-contact",

"input": {

"contactId": "abc123"

}

response = requests.post(

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

headers=headers,

json=data

)

print(response.json())

Roadmap e Visione

Questa versione iniziale di MCP è solo l'inizio. La nostra roadmap include:

Server MCP individuali dedicati a servizi specifici per workflow mirati.
Pacchetto npx per supportare client senza supporto HTTP nativo (ad es. Claude Desktop).
Supporto OAuth per flussi di autorizzazione avanzati.
Espansione a 250+ strumenti per creare un vero e proprio livello orchestrator unificato per agenti AI.
Abilitare l'automazione completa dei processi aziendali su tutti i moduli di GoHighLevel.

Domande Frequenti

D: Posso utilizzare questo con OpenAI Playground o Claude?
Sì! Qualsiasi client che supporti richieste HTTP può integrarsi con MCP.

D: Devo installare un SDK?
No, non è richiesto alcun SDK — MCP utilizza un protocollo HTTP standard.

D: I miei dati sono al sicuro?
Sì. L'accesso ai dati è completamente limitato tramite token di integrazione privati e protetto tramite HTTPS.

D: Posso limitare quali strumenti un agente può utilizzare?
Sì. Puoi controllare l'accesso limitando gli scope nel tuo PIT.

D: Cosa succede se ho bisogno di un nuovo strumento o endpoint?
Condividi il tuo feedback! Stiamo attivamente espandendo il set di strumenti disponibili.

Prossimi Passi

Crea il tuo Token di Integrazione Privata e configura gli scope.
Aggiorna la configurazione del tuo agente AI o client con l'endpoint MCP.
Inizia a costruire automazioni e integrazioni guidate da agenti oggi!
Fornisci feedback per aiutare a plasmare le espansioni future e il supporto dei nuovi strumenti.

Come usare il Server MCP di GoHighLevel / Squadd

Cos'è il Server MCP?

Principali vantaggi del Server MCP

36 Strumenti disponibili

Passaggio 1: Configura il tuo agente/client

Passaggio 2: Ottieni il tuo Token di Integrazione Privata (PIT)

Scope richiesti

Passaggio 3: Inizia a costruire!

Esempio di Chiamata Tool

Roadmap e Visione

Domande Frequenti

Prossimi Passi

Come usare il Server MCP di GoHighLevel / Squadd

Cos'è il Server MCP?

Principali vantaggi del Server MCP

36 Strumenti disponibili

Passaggio 1: Configura il tuo agente/client

Passaggio 2: Ottieni il tuo Token di Integrazione Privata (PIT)

Scope richiesti

Passaggio 3: Inizia a costruire!

Esempio di Chiamata Tool

Roadmap e Visione

Domande Frequenti

Prossimi Passi