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
Gehe zu Settings → Private Integrations in deinem GoHighLevel-Standort
Klicke auf Create New Integration
Wähle die benötigten Berechtigungen (Scopes)
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