GoHighLevel über MCP mit Cursor verbinden

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → GoHighLevel klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein git clone, kein lokaler Server.

GoHighLevel + Cursor

GoHighLevel (HighLevel, LeadConnector) CRM für ein Sub-Account: Kontakte mit Tags, Notizen und Aufgaben, Konversationen und Versand von SMS, E-Mail oder WhatsApp, Opportunities und Pipelines, Kalender und Termine, Workflows, Formular- und Umfrageeinträge, Rechnungen, Zahlungen und Social-Planner-Beiträge. Verbindung über ein Private-Integration-Token.

Voraussetzungen

Die vollständige Setup-Anleitung ist in den Connector eingebaut (im Store sichtbar, wenn du den Connector auswählst). Benötigte Umgebungsvariablen für diesen Connector:

GOHIGHLEVEL_API_TOKEN, GOHIGHLEVEL_LOCATION_ID

Schritt 1 — Zugangsdaten holen

Die Einrichtung dauert etwa 5 Minuten. Du brauchst Admin-Rechte im HighLevel-Sub-Account (Location), in dem die KI arbeiten soll.

1. Öffne im Sub-Account Settings, Private Integrations und klicke auf Create new Integration. Gib ihr einen Namen, zum Beispiel AnythingMCP.
2. Wähle die Scopes, die die Tools brauchen: locations.readonly, locations/customFields.readonly, locations/tags.readonly, contacts.readonly, contacts.write, conversations.readonly, conversations/message.readonly, conversations/message.write, opportunities.readonly, opportunities.write, calendars.readonly, calendars/events.readonly, calendars/events.write, users.readonly, workflows.readonly, forms.readonly, surveys.readonly, invoices.readonly, invoices.write, payments/orders.readonly, payments/transactions.readonly, payments/subscriptions.readonly, socialplanner/account.readonly, socialplanner/post.readonly, socialplanner/post.write. Lass die Schreib-Scopes weg, die die KI nicht haben soll.
3. Kopiere das Token (es beginnt mit pit- und wird nur einmal angezeigt) in GOHIGHLEVEL_API_TOKEN. Es wird als Authorization: Bearer <token> gesendet; füge es ohne Bearer-Präfix ein.
4. Kopiere die Location ID aus Settings, Business Profile (oder aus der URL nach /location/) in GOHIGHLEVEL_LOCATION_ID. Alle Tools arbeiten in diesem Sub-Account.
5. Installiere den Connector und führe gohighlevel_get_location aus: Es zeigt den Sub-Account und bestätigt Token und Location ID.

Den von HighLevel verlangten Version-Header sendet der Connector selbst (2021-07-28, für Konversationen und Kalender 2021-04-15).

Was er liest: die Daten des Sub-Accounts, Custom Fields (IDs für customFields), Tags, Benutzer (IDs für assignedTo), Pipelines mit ihren Stages, Kalender und Workflows; Kontakte per Freitext oder Filter, mit Tags, Quelle, DND-Einstellungen, Custom-Field-Werten, Notizen, Aufgaben und Terminen; Konversationen über SMS, E-Mail, WhatsApp, Facebook, Instagram und Live-Chat mit ihren Nachrichten; Opportunities nach Pipeline, Stage, Status, Kontakt, zuständiger Person oder Datum; freie Kalender-Slots und Kalendereinträge; Formulare, Umfragen und ihre Einträge; Rechnungen mit Positionen und offenen Beträgen, Zahlungsaufträge, Transaktionen (Zahlungen und Erstattungen) und Abonnements; verbundene Social-Planner-Konten und Beiträge.

Was er schreibt: Alle schreibenden Tools sind bei der Installation aktiv, deshalb bestimmen die Scopes der Private Integration, was die KI ändern darf. Kontakte: gohighlevel_create_contact, gohighlevel_upsert_contact (keine Dubletten nach E-Mail oder Telefon), gohighlevel_update_contact, Tags mit gohighlevel_add_contact_tags und gohighlevel_remove_contact_tags, gohighlevel_create_contact_note, gohighlevel_create_contact_task und gohighlevel_update_contact_task. Automationen: gohighlevel_add_contact_to_workflow und gohighlevel_remove_contact_from_workflow (nur veröffentlichte Workflows) oder ein Tag, auf das ein Workflow reagiert. Vertrieb: gohighlevel_create_opportunity, gohighlevel_update_opportunity (Stage wechseln) und gohighlevel_update_opportunity_status (won, lost, abandoned). Termine: gohighlevel_get_free_slots, dann gohighlevel_create_appointment, und gohighlevel_update_appointment zum Verschieben, Bestätigen, Absagen oder Markieren als No-Show. Geld: gohighlevel_create_invoice (als Entwurf) und gohighlevel_send_invoice. Social: gohighlevel_create_social_post.

Was bei Menschen ankommt: gohighlevel_send_message schickt SMS, E-Mail, WhatsApp oder Social-Nachrichten sofort an den Kontakt und kann SMS- oder E-Mail-Guthaben verbrauchen; Kontakte mit DND auf einem Kanal werden dort nicht erreicht. gohighlevel_send_invoice schickt dem Kontakt einen Zahlungslink, und gohighlevel_create_social_post veröffentlicht zum geplanten Zeitpunkt öffentlich. Vor all dem zeigt dir die KI Text, Empfänger oder Beitrag und wartet auf dein Ja. Bei der Installation ist kein Tool deaktiviert.

Datenformate: IDs sind Strings mit 20 Zeichen. Datumsangaben in Datensätzen sind ISO 8601 in UTC; freie Kalender-Slots und Kalendereinträge nehmen Unix-Zeit in Millisekunden; Beginn und Ende eines Termins sind ISO 8601 mit Offset; die Opportunity-Suche nimmt Daten als mm-dd-yyyy; Filter für Formulare, Umfragen, Rechnungen und Zahlungen nehmen YYYY-MM-DD. Rechnungs- und Zahlungsbeträge sind in Währungseinheiten (120.5 = 120,50), nicht in Cent. Telefonnummern sind E.164. Freie Slots umfassen pro Aufruf höchstens 31 Tage.

Blättern: Kontakte nutzen page und page_limit (bis zu 500 pro Seite und 10.000 Ergebnisse insgesamt; darüber hinaus übergibt die KI search_after des letzten Kontakts). Opportunities nutzen page und limit (bis 100) oder startAfter und startAfterId aus meta. Konversationen nutzen limit und start_after_date, Nachrichten last_message_id mit nextPage. Rechnungen und Zahlungen nutzen limit und offset, Formulare und Umfragen page und limit.

Limits: HighLevel erlaubt 100 Anfragen pro 10 Sekunden und 200.000 pro Tag und Sub-Account; darüber antwortet es mit 429.

Häufige Fehler: 401 bedeutet ein falsches oder gelöschtes Token oder ein Token eines anderen Sub-Accounts. 403 oder „The token is not authorized for this scope“ bedeutet, dass der Private Integration der Scope fehlt: Bearbeite sie, ergänze den Scope und speichere. 422 listet die ungültigen Felder auf.

Der Connector arbeitet in einem Sub-Account, nicht agenturweit. Er löscht keine Datensätze, baut oder bearbeitet keine Workflows, Funnels oder Kalender und veranlasst keine Erstattungen.

Schritt 2 — Adapter installieren

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Schritt 3 — Connector in Cursor hinzufügen

Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese Anleitung YOUR_SERVER_ID zeigt.

Cursor liest MCP-Server aus ~/.cursor/mcp.json. Füge diesen Eintrag hinzu:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Erstelle in AnythingMCP unter MCP Servers → dein Server → API keys einen MCP-API-Key und setze ihn anstelle von YOUR_MCP_API_KEY ein.
2. Speichere die Datei und starte Cursor neu.
3. Öffne Cursor → Settings → MCP und prüfe, ob anythingmcp aufgeführt und verbunden ist.
4. Leg los: Der Agent kann jetzt die GoHighLevel-Tools aufrufen.

Verfügbare Tools

Beispiel-Prompts

• „Finde den Kontakt mit der E-Mail [email protected] und zeig mir ihre Tags, Notizen und offenen Aufgaben.“
• „Welche Konversationen haben gerade ungelesene Nachrichten? Fass jeweils die letzte Nachricht zusammen.“
• „Verschieb die Opportunity „Website-Relaunch“ von Müller GmbH in die Stage Angebot verschickt und setz den Wert auf 4.500.“
• „Such im Kalender Vertrieb einen freien 30-Minuten-Slot am nächsten Dienstag und buche ihn für den Kontakt Marco Rossi. Zeig mir die Buchung vor dem Speichern.“
• „Liste die Rechnungen auf, die verschickt, aber noch nicht bezahlt sind, mit Kontakt, offenem Betrag und Fälligkeitsdatum.“

FAQ

Unterstützt Cursor eigene MCP-Server im kostenlosen Tarif? Ja, MCP gibt es in den Tarifen Hobby, Pro und Business.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden
• Mit Gemini verbinden
• Mit Meta Muse verbinden
• Mit Microsoft Copilot verbinden