So nutzt du den HighLevel MCP-Server


Dieser Artikel zeigt dir, wie du den neuen GoHighLevel MCP-Server (Model Context Protocol) nutzen kannst, um deine KI-Agenten und Copiloten zu befähigen, nahtlos auf GoHighLevel-Daten und -Tools zuzugreifen – alles über ein sicheres, standardisiertes HTTP-Protokoll.


INHALTSVERZEICHNIS

  • Was ist der MCP-Server?

  • Zentrale Vorteile der Nutzung des MCP-Servers

  • Die wichtigsten 36 verfügbaren Tools

  • Beispiel für einen Tool-Aufruf

  • Roadmap & Vision

  • Häufig gestellte Fragen

  • Nächste Schritte


Was ist der MCP-Server?

Der GoHighLevel MCP-Server ist ein standardisiertes, sicheres Protokoll, mit dem KI-Agenten Daten in GoHighLevel lesen und schreiben können – ganz ohne SDKs oder aufwendige, individuelle Integrationen.
Du kannst Agenten nun über eine einzige, einheitliche Schnittstelle Zugriff auf wichtige Tools wie Kalender, Kontakte, Konversationen, Opportunities und Zahlungen geben.


Zentrale Vorteile der Nutzung des MCP-Servers

Die Anbindung deiner KI-Agenten an GoHighLevel war noch nie so einfach und sicher:

  • Standardisierter Zugriff: Daten abfragen und aktualisieren über ein einheitliches Protokoll

  • Schnelle Integration: Keine SDKs erforderlich; funktioniert mit jedem HTTP-fähigen Client

  • Sicher: Nutzung von Private Integration Tokens (PITs) für granularen, rollenbasierten Zugriff

  • Skalierbar: Für eine zukünftige Erweiterung auf über 250 Tools ausgelegt

  • Flexibel: Unterstützt gängige Clients wie Cursor, Windsurf und OpenAI Playground


Die wichtigsten 36 verfügbaren Tools

Nachfolgend die erste Auswahl an Tools, die deine KI-Agenten bereits heute nutzen können:

#

Tool

Endpoint

Beschreibung

1

Kalenderereignisse abrufen

calendars_get-calendar-events

Kalenderereignisse über userId, groupId oder calendarId abrufen

2

Terminnotizen abrufen

calendars_get-appointment-notes

Notizen zu einem bestimmten Termin abrufen

3

Alle Aufgaben abrufen

contacts_get-all-tasks

Alle Aufgaben eines Kontakts abrufen

4

Tags hinzufügen

contacts_add-tags

Tags zu einem Kontakt hinzufügen

5

Tags entfernen

contacts_remove-tags

Tags von einem Kontakt entfernen

6

Kontakt abrufen

contacts_get-contact

Kontaktdetails abrufen

7

Kontakt aktualisieren

contacts_update-contact

Kontakt aktualisieren

8

Kontakt upserten

contacts_upsert-contact

Kontakt erstellen oder aktualisieren

9

Kontakt erstellen

contacts_create-contact

Neuen Kontakt erstellen

10

Kontakte abrufen

contacts_get-contacts

Alle Kontakte abrufen

11

Konversation suchen

conversations_search-conversation

Konversationen suchen, filtern oder sortieren

12

Nachrichten abrufen

conversations_get-messages

Nachrichten anhand der Konversations-ID abrufen

13

Neue Nachricht senden

conversations_send-a-new-message

Nachricht in einer Konversation senden

14

Standort abrufen

locations_get-location

Standortdetails per ID abrufen

15

Benutzerdefinierte Felder abrufen

locations_get-custom-fields

Custom-Field-Definitionen eines Standorts abrufen

16

Opportunity suchen

opportunities_search-opportunity

Opportunities nach Kriterien suchen

17

Pipelines abrufen

opportunities_get-pipelines

Alle Opportunity-Pipelines abrufen

18

Opportunity abrufen

opportunities_get-opportunity

Opportunity-Details abrufen

19

Opportunity aktualisieren

opportunities_update-opportunity

Opportunity aktualisieren

20

Bestellung per ID abrufen

payments_get-order-by-id

Zahlungsbestellung abrufen

21

Transaktionen auflisten

payments_list-transactions

Paginierte Liste von Transaktionen abrufen

22

Blog-URL-Slug prüfen

blogs_check-url-slug-exists

Prüfen, ob ein Blog-Slug bereits existiert

23

Blogbeitrag aktualisieren

blogs_update-blog-post

Blogbeitrag aktualisieren

24

Blogbeitrag erstellen

blogs_create-blog-post

Blogbeitrag erstellen

25

Blog-Autoren abrufen

blogs_get-all-blog-authors-by-location

Autoren eines Standorts abrufen

26

Blog-Kategorien abrufen

blogs_get-all-categories-by-location

Kategorien eines Standorts abrufen

27

Blogposts abrufen

blogs_get-blog-post

Blogposts über Blog-ID abrufen

28

Blogs abrufen

blogs_get-blogs

Blogs über Standort-ID abrufen

29

E-Mail-Template erstellen

emails_create-template

Neues E-Mail-Template erstellen

30

E-Mail-Templates abrufen

emails_fetch-template

E-Mail-Templates abrufen

31

Social-Media-Accounts abrufen

socialmediaposting_get-account

Accounts und Gruppen abrufen

32

Social-Media-Statistiken

socialmediaposting_get-social-media-statistics

Analytics-Daten abrufen

33

Social-Media-Post erstellen

socialmediaposting_create-post

Social-Media-Posts erstellen

34

Social-Media-Post abrufen

socialmediaposting_get-post

Einzelnen Post abrufen

35

Social-Media-Posts abrufen

socialmediaposting_get-posts

Mehrere Posts abrufen

36

Social-Media-Post bearbeiten

socialmediaposting_edit-post

Social-Media-Post bearbeiten


So richtest du den MCP-Server ein

Schritt 1: Agenten / Client konfigurieren

Füge den MCP-Endpoint und die Header zu deiner Agent-Konfiguration hinzu:

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

Schritt 2: Private Integration Token (PIT) erstellen

  1. Gehe zu Settings → Private Integrations in deinem GoHighLevel-Standort

  2. Klicke auf Create New Integration

  3. Wähle die benötigten Berechtigungen (Scopes)

  4. Kopiere und speichere das Token sicher

Erforderliche Scopes (Auswahl):

  • Kontakte anzeigen/bearbeiten

  • Konversationen anzeigen/bearbeiten

  • Nachrichten anzeigen/bearbeiten

  • Opportunities anzeigen/bearbeiten

  • Kalender & Termine anzeigen

  • Standorte anzeigen

  • Zahlungen & Transaktionen anzeigen

  • Benutzerdefinierte Felder anzeigen

  • Blogposts erstellen, aktualisieren, prüfen

  • E-Mail-Templates erstellen und anzeigen

  • Social-Media-Posts anzeigen, bearbeiten und analysieren


Schritt 3: Loslegen!

Deine Agenten können nun Tools über natürliche Sprache aufrufen, die über MCP automatisch in sichere API-Aufrufe übersetzt werden.


Beispiel für einen Tool-Aufruf (Python)

import requests
 
headers = {
"Authorization": "Bearer DEIN_PIT_TOKEN",
"locationId": "DEINE_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 & Vision

Der aktuelle MCP-Release ist erst der Anfang. Geplant sind unter anderem:

  • Eigene MCP-Server pro Service für gezielte Workflows

  • Ein npx-Package für Clients ohne native HTTP-Unterstützung

  • OAuth-Support für erweiterte Autorisierungs-Flows

  • Erweiterung auf 250+ Tools

  • Vollständige Automatisierung von Geschäftsprozessen in allen GoHighLevel-Modulen


Häufig gestellte Fragen

F: Kann ich MCP mit OpenAI Playground oder Claude nutzen?
Ja, jeder HTTP-fähige Client kann MCP integrieren.

F: Benötige ich ein SDK?
Nein, MCP basiert auf einem standardisierten HTTP-Protokoll.

F: Sind meine Daten sicher?
Ja, der Zugriff ist vollständig über PITs abgesichert und erfolgt über HTTPS.

F: Kann ich einschränken, welche Tools ein Agent nutzen darf?
Ja, über die Scopes im Private Integration Token.

F: Was, wenn ich ein neues Tool benötige?
Gib uns Feedback – der Tool-Umfang wird kontinuierlich erweitert.


Nächste Schritte

  • Erstelle dein Private Integration Token und konfiguriere die Scopes

  • Aktualisiere die Konfiguration deines KI-Agenten mit dem MCP-Endpoint

  • Baue agentenbasierte Automatisierungen und Integrationen

  • Teile Feedback, um zukünftige Erweiterungen mitzugestalten



War dieser Artikel hilfreich?