HubSpot über MCP mit Gemini verbinden

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

HubSpot + Gemini

Lass deine KI im HubSpot CRM arbeiten: Kontakte, Unternehmen, Deals und Tickets suchen und aktualisieren, sehen, wer mit wem verknüpft ist, Pipelines und Zuständige prüfen und Notizen und Aufgaben festhalten. Ein Konto, über einen Service-Key, den du selbst anlegst.

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:

HUBSPOT_ACCESS_TOKEN

Schritt 1 — Zugangsdaten holen

1. Öffne in HubSpot in der linken Seitenleiste Development, dann Keys → Service keys, und klicke auf Create service key. Dafür musst du Super-Admin sein oder Zugriff auf die Developer-Tools haben.
2. Gib dem Key einen Namen (zum Beispiel „AnythingMCP“), klicke auf Add new scope, hake die unten aufgeführten Scopes an und klicke dann auf Update und Create.
3. Öffne den Key, klicke auf Show und dann auf Copy. Service-Keys beginnen mit pat- (zum Beispiel pat-eu1-...).
4. Trage den Key ohne das Wort Bearer in HUBSPOT_ACCESS_TOKEN ein, dann installiere den Connector.
5. Beginne mit hubspot_get_account: Das Tool zeigt, zu welchem HubSpot-Konto (Hub ID) der Key gehört, sowie dessen Zeitzone und Währung.

Ältere Private Apps: Ältere Konten haben eventuell noch eine Private App (Development → Legacy apps, früher Settings → Integrations → Private Apps). Ihr Access-Token funktioniert genauso: Trage ihn in HUBSPOT_ACCESS_TOKEN ein.

Scopes:

• Lesen: crm.objects.contacts.read (deckt auch Notizen und Aufgaben ab), crm.objects.companies.read, crm.objects.deals.read, crm.objects.tickets.read, crm.objects.owners.read.
• Schreiben: crm.objects.contacts.write (auch für Notizen und Aufgaben nötig), crm.objects.companies.write, crm.objects.deals.write, crm.objects.tickets.write.

Nur lesen: Gib dem Key nur die Lese-Scopes und deaktiviere hubspot_create_object, hubspot_update_object, hubspot_associate_records, hubspot_create_note und hubspot_create_task.

Bei der Installation ausgeschaltet: hubspot_archive_object. Schalte das Tool nur ein, wenn die KI Datensätze löschen soll. Archivierte Datensätze landen im Papierkorb von HubSpot und lassen sich dort 90 Tage lang wiederherstellen.

Datenschutzeinstellungen: Wenn in deinem HubSpot-Konto der Datenschutz (DSGVO) aktiviert ist, verlangt HubSpot bei jedem neuen Kontakt eine Rechtsgrundlage für die Verarbeitung, die Eigenschaft hs_legal_basis. Sag der KI, welche Rechtsgrundlage sie beim Anlegen von Kontakten verwenden soll; ohne sie antwortet HubSpot mit „The following required properties were missing“.

Limits: HubSpot erlaubt bei Free und Starter 100 Anfragen pro 10 Sekunden und Key (mehr bei Professional und Enterprise), 250.000 Anfragen pro Tag und Konto sowie 5 Suchanfragen pro Sekunde. Wird ein Limit überschritten, antwortet HubSpot mit 429: Warte ein paar Sekunden und versuche es erneut.

Häufige Fehler: 401 heißt, dass der Key falsch oder abgelaufen ist oder rotiert wurde: Kopiere ihn erneut. 403 nennt den fehlenden Scope: Füge ihn dem Key unter Edit hinzu. 404 heißt, dass die ID oder der Objekttyp falsch ist. 400 VALIDATION_ERROR nennt die Eigenschaft oder den Filter, der nicht stimmt, zum Beispiel einen unbekannten Eigenschaftsnamen oder einen Dropdown-Wert, der nicht zu den Optionen gehört.

Der Connector unterstützt keine Marketing-E-Mails, Formulare, Listen, Workflows, Dateien, Angebote und Positionspreise, Zusammenführungen oder Batch-Schreibvorgänge.

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 Gemini 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.

Gemini CLI liest MCP-Server aus ~/.gemini/settings.json (unter Windows %USERPROFILE%\.gemini\settings.json). Füge hinzu:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "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 gemini neu.
3. Führe in der Gemini CLI /mcp aus (oder gemini mcp list im Terminal): anythingmcp sollte als verbunden erscheinen.
4. Leg los: Gemini CLI kann jetzt die HubSpot-Tools aufrufen.

Verfügbare Tools

Beispiel-Prompts

• „Welche Deals in der Sales-Pipeline sollen voraussichtlich diesen Monat abgeschlossen werden, und wer ist jeweils zuständig?“
• „Finde den Kontakt [email protected] und zeig mir ihr Unternehmen und ihre offenen Deals.“
• „Verschieb den Deal Acme Corp in die nächste Phase und füge eine Notiz mit einer Zusammenfassung des heutigen Telefonats hinzu.“
• „Leg mir eine Follow-up-Aufgabe zum Globex-Deal an, fällig nächsten Freitag.“

FAQ

Wo sucht Gemini CLI nach MCP-Servern? In ~/.gemini/settings.json für deinen Benutzer oder in .gemini/settings.json innerhalb eines Projekts. gemini mcp list zeigt jeden Server und ob er sich verbindet.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden
• Mit Cursor verbinden
• Mit Meta Muse verbinden