HubSpot Integration

Der HubSpot MCP-Server ermöglicht die nahtlose Integration mit deinem HubSpot CRM. Verwalte Kontakte, Unternehmen, Tickets und greife auf Konversationen zu – alles direkt aus deinem Assistenten heraus.

Einrichtung

Voraussetzungen

Ein HubSpot-Konto (Professional oder Enterprise)
Super Admin-Rechte oder die Berechtigung App Marketplace Access in deinem HubSpot-Account
Organisations-Admin-Rechte in meinGPT (um Integrationen zu konfigurieren)

Du bist dir nicht sicher, ob du die nötigen Rechte hast? Frage deinen HubSpot-Admin — unter Einstellungen → Benutzer & Teams kannst du deine Berechtigungen prüfen.

Schritt-für-Schritt-Anleitung

Private App in HubSpot erstellen

Logge dich in deinen HubSpot-Account ein
Klicke oben rechts auf das Zahnrad-Symbol (⚙️ Einstellungen)
Navigiere in der linken Seitenleiste zu Integrationen → Private Apps
Klicke auf Private App erstellen

HubSpot Einstellungen: Private Apps Seite

Button "Private App erstellen"

Fülle die Grundinformationen aus:

App-Name: z.B. meinGPT Integration (frei wählbar — dient nur zur internen Zuordnung)
Beschreibung: z.B. Verbindung zwischen meinGPT und HubSpot CRM (optional)
Logo: optional, hilft bei der Wiedererkennung

Private App erstellen: Grundinformationen

Berechtigungen (Scopes) konfigurieren

Wechsle zum Tab Scopes im Erstellungsdialog. Hier legst du fest, auf welche HubSpot-Daten meinGPT zugreifen darf.

Nutze das Suchfeld, um die benötigten Scopes zu finden und zu aktivieren.

Scopes-Tab mit Suchfeld

Option A: Minimaler Lesezugriff

Wenn du nur Daten aus HubSpot lesen möchtest (kein Erstellen/Ändern):

Scope	Beschreibung
`crm.objects.contacts.read`	Kontakte lesen
`crm.objects.companies.read`	Unternehmen lesen
`crm.objects.deals.read`	Deals lesen
`crm.objects.owners.read`	Eigentümer-Infos lesen
`conversations.read`	Konversationen lesen
`files`	Dateien lesen/suchen

Option B: Vollzugriff (empfohlen)

Für die volle Funktionalität inkl. Erstellen und Bearbeiten von CRM-Objekten:

Scope	Beschreibung
`crm.objects.contacts.read`	Kontakte lesen
`crm.objects.contacts.write`	Kontakte erstellen/bearbeiten
`crm.objects.companies.read`	Unternehmen lesen
`crm.objects.companies.write`	Unternehmen erstellen/bearbeiten
`crm.objects.deals.read`	Deals lesen
`crm.objects.deals.write`	Deals erstellen/bearbeiten
`crm.objects.owners.read`	Eigentümer-Infos lesen
`conversations.read`	Konversationen lesen
`files`	Dateien lesen/suchen

Optionale Scopes

Je nach Bedarf kannst du zusätzlich aktivieren:

Scope	Beschreibung
`tickets`	Ticket-Verwaltung
`sales-email-read`	E-Mail-Objekte lesen (für generische CRM-Suche)

Du kannst Scopes jederzeit nachträglich hinzufügen. Starte ruhig mit weniger Berechtigungen und erweitere sie bei Bedarf — du musst dann nur einen neuen Token generieren.

App erstellen und Access Token kopieren

Klicke auf App erstellen
Bestätige im Dialog, dass du die App erstellen möchtest
Dein Access Token wird jetzt angezeigt — kopiere ihn sofort!

Access Token nach Erstellung

Wichtig: Der Access Token wird nur einmal angezeigt! Kopiere ihn jetzt und speichere ihn an einem sicheren Ort. Wenn du den Token verlierst, musst du unter Private Apps → Deine App → Auth einen neuen generieren.

HubSpot in meinGPT verbinden

Öffne meinGPT und navigiere zu Einstellungen → Integrationen (du brauchst Org-Admin-Rechte)
Suche HubSpot in der Connector-Liste und aktiviere die Integration
Füge den kopierten Access Token in das Feld HubSpot Access Token ein
Die Verbindung wird automatisch getestet — ein grüner Haken bestätigt, dass alles funktioniert

HubSpot in meinGPT verbinden

HubSpot für Assistenten aktivieren

Öffne den Assistenten-Editor für den gewünschten Assistenten
Scrolle zum Abschnitt Tools
Aktiviere das HubSpot-Tool
Optional: Konfiguriere den Zugriff auf Methoden-Ebene (z.B. nur Lese-Methoden freigeben)

Dein Assistent kann jetzt auf HubSpot-Daten zugreifen! Probiere es z.B. mit: „Zeige mir die letzten 5 aktiven Kontakte aus HubSpot"

Scope-Profile (Wann brauche ich welche Scopes?)

Use Case	Benötigte Scopes
Basis CRM Read (Owner + Suche/Abruf für Kontakte/Unternehmen/Deals)	`crm.objects.owners.read`, `crm.objects.contacts.read`, `crm.objects.companies.read`, `crm.objects.deals.read`
CRM Write (Kontakt/Unternehmen/Deal erstellen)	`crm.objects.contacts.write`, `crm.objects.companies.write`, `crm.objects.deals.write`
Konversationen (`hubspot_get_recent_conversations`)	`conversations.read`
Dateien (`hubspot_search_files`, `hubspot_get_file`)	`files`
Ticket-Workflows (`hubspot_get_tickets`, Ticket-Pipelines/Threads)	`tickets` (abhängig von Account/Feature)
Generische Suche für weitere Objekte	objekt-spezifische Scopes aus der jeweiligen HubSpot-Endpoint-Doku (für E-Mails: `sales-email-read`)

Methode-zu-Scope-Mapping

Methode	Scopes
`hubspot_get_owners`	`crm.objects.owners.read`
`hubspot_get_active_contacts`	`crm.objects.contacts.read`
`hubspot_create_contact`	`crm.objects.contacts.write`
`hubspot_get_active_companies`	`crm.objects.companies.read`
`hubspot_create_company`	`crm.objects.companies.write`
`hubspot_get_deals`	`crm.objects.deals.read`
`hubspot_create_deal`	`crm.objects.deals.write`
`hubspot_search_crm_objects`	objekt-spezifische Scopes aus Endpoint-Doku (für `emails`: `sales-email-read`)
`hubspot_retrieve_crm_object`	objekt-spezifische Scopes aus Endpoint-Doku
`hubspot_get_recent_conversations`	`conversations.read`
`hubspot_search_files`	`files`
`hubspot_get_file`	`files`
`hubspot_get_tickets`, `hubspot_get_ticket_conversation_threads`, Ticket-Pipelines	`tickets` (abhängig von HubSpot-Setup)

Hauptfunktionen

Unternehmensmanagement

hubspot_create_company: Erstellt ein neues Unternehmen mit Name, Domain und weiteren Eigenschaften
hubspot_get_company_activity: Zeigt die Aktivitätshistorie eines Unternehmens
hubspot_get_active_companies: Listet kürzlich aktive Unternehmen auf

Kontaktmanagement

hubspot_create_contact: Erstellt einen neuen Kontakt mit E-Mail, Namen und weiteren Details
hubspot_get_active_contacts: Zeigt kürzlich aktive Kontakte an

Generische Suche & Retrieve

hubspot_search_crm_objects: Generische CRM-Suche (Kontakte, Unternehmen, Deals, Notizen, Tasks, Calls, Meetings, E-Mails)
hubspot_retrieve_crm_object: Einzelnes CRM-Objekt per ID abrufen, optional mit Associations

Dateizugriff

hubspot_search_files: HubSpot-Dateien (Metadaten) durchsuchen
hubspot_get_file: Datei-Metadaten und Signed URL abrufen

Konversationen

hubspot_get_recent_conversations: Ruft aktuelle Konversations-Threads mit Nachrichten ab
- Unterstützt Filterung nach Zeitraum
- Inkludiert vollständige Nachrichtenhistorie

Ticketverwaltung

hubspot_get_tickets: Listet Tickets mit umfangreichen Filteroptionen
- Filter nach Status, Priorität, Pipeline
- Sortierung und Paginierung
hubspot_get_ticket_conversation_threads: Zeigt alle Konversationen zu einem spezifischen Ticket

Verwendungsbeispiele

Neuen Kontakt erstellen

Erstelle einen neuen Kontakt in HubSpot:
- E-Mail: max.mustermann@beispiel.de
- Vorname: Max
- Nachname: Mustermann
- Unternehmen: Beispiel GmbH

Unternehmen mit Aktivitäten abrufen

Zeige mir die letzten Aktivitäten der Firma "Beispiel GmbH" in HubSpot

Offene Support-Tickets anzeigen

Liste alle offenen Support-Tickets mit hoher Priorität auf

Konversationen durchsuchen

Zeige mir alle Konversationen der letzten 7 Tage

CRM-Objekt abrufen

Suche den neuesten Deal der Firma "Beispiel GmbH" und lade danach die Deal-Details per ID

Dateien suchen und laden

Suche in HubSpot-Dateien nach "Rechnung" und gib mir die Signed Download-URL des neuesten Treffers

Best Practices

Sicherheit

Token-Verwaltung: Speichere deinen Access Token niemals im Code
Regelmäßige Rotation: Erneuere Tokens regelmäßig
Minimale Berechtigungen: Aktiviere nur benötigte Scopes
Aktivitätsüberwachung: Prüfe regelmäßig die App-Logs in HubSpot

Performance

Nutze Paginierung für große Datenmengen
Implementiere Caching für häufig abgerufene Daten
Beachte HubSpots API-Rate-Limits (100 Requests/10 Sekunden)

Datenqualität

Validiere E-Mail-Adressen vor dem Erstellen von Kontakten
Nutze aussagekräftige Ticket-Beschreibungen
Halte Unternehmens- und Kontaktdaten aktuell

Fehlerbehebung

Token wird nicht akzeptiert (401 Unauthorized)

Stelle sicher, dass du den Token korrekt kopiert hast (keine Leerzeichen am Anfang/Ende)
Prüfe, ob der Token noch gültig ist — unter Einstellungen → Integrationen → Private Apps in HubSpot
Falls der Token widerrufen wurde, generiere einen neuen unter deiner Private App

Fehlende Berechtigungen (403 Forbidden)

Eine bestimmte HubSpot-Funktion gibt einen 403-Fehler zurück? Dann fehlt wahrscheinlich ein Scope.
Öffne deine Private App in HubSpot und prüfe die aktivierten Scopes
Füge den fehlenden Scope hinzu und generiere einen neuen Token
Aktualisiere den Token in meinGPT unter Einstellungen → Integrationen

Token verloren oder abgelaufen

Navigiere in HubSpot zu Einstellungen → Integrationen → Private Apps
Wähle deine App aus und gehe zum Tab Auth
Klicke auf Token anzeigen oder generiere einen neuen
Aktualisiere den Token in meinGPT

Rate Limit (429 Too Many Requests)

HubSpot erlaubt 100 Requests pro 10 Sekunden
Reduziere die Anzahl gleichzeitiger Anfragen
Nutze Paginierung und Batch-Operationen wo möglich

Weiterführende Ressourcen

Token widerrufen

Falls du den Zugriff widerrufen musst:

Navigiere zu: Einstellungen → Integrationen → Private Apps

Wähle deine App aus

Klicke auf "App löschen" oder generiere einen neuen Token

Das Widerrufen oder Erneuern des Tokens unterbricht sofort alle bestehenden Integrationen.

HubSpot Integration

Auf dieser Seite