> ## Documentation Index
> Fetch the complete documentation index at: https://docs.omnifact.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# HubSpot einrichten

> Verbinden Sie HubSpot CRM über MCP mit Omnifact: Integration aus dem Katalog installieren, automatische Einrichtung oder eigene HubSpot-OAuth-App wählen, Tool-Freigaben festlegen und Benutzerkonten verknüpfen.

Durch die Anbindung von **HubSpot CRM** an Omnifact über das **Model Context Protocol (MCP)** greifen Vertrieb, Account-Management, Kundenservice und Marketing direkt im Chat auf aktuelle CRM-Daten zu. Ihr Team kann vor Kundenterminen in Sekunden ein Briefing über Kontakte, Unternehmen, Deals und Tickets abrufen, HubSpot-Postfächer durchsuchen und Gesprächsnotizen oder Deal-Phasen direkt aus der Unterhaltung heraus aktualisieren.

## Ablauf der HubSpot-Einrichtung im Überblick

HubSpot wird als OAuth-basierte MCP-Integration in drei Schritten eingerichtet:

> [card] 1. Organisations-Admin
>
> Fügt **HubSpot** einmalig unter **Team-Einstellungen > Integrationen > Katalog** hinzu und prüft die Zugriffsrichtlinien pro Tool (**Immer**, **Nachfragen** oder **Deaktiviert**).

> [card] 2. Teammitglieder
>
> Melden sich unter **Kontoeinstellungen > Verbindungen** mit ihrem persönlichen HubSpot-Konto an, sodass alle HubSpot-Berechtigungen pro Person gewahrt bleiben.

> [card] 3. Im Chat
>
> Der Agent (Ein KI-System, das Sie durch Konversation bei Aufgaben unterstützt und Aktionen in Ihrem Auftrag ausführen kann) liest CRM-Einträge bei Bedarf live aus und holt vor dem Anlegen oder Ändern von Datensätzen immer eine interaktive Bestätigung im Chat ein.

***

## Schritt 1: HubSpot für Ihre Organisation installieren (Admin)

Ein **Owner** oder **Admin** Ihrer Organisation richtet die HubSpot-Integration einmalig in den Team-Einstellungen ein.

**1. Integrationskatalog öffnen**

Klicken Sie unten links auf Ihren **Benutzer-Avatar**, wechseln Sie zu **[Team-Einstellungen > Integrationen](https://docs.omnifact.ai/de/platform/team-administration/integrations.md)** und öffnen Sie den Reiter **Katalog**.

**2. HubSpot auswählen**

Filtern Sie nach **Vertrieb & Service** (oder suchen Sie nach `HubSpot`) und klicken Sie auf der Karte **HubSpot** auf **Hinzufügen** (**Add**).

**3. Automatische Einrichtung oder eigene HubSpot-OAuth-App wählen**

Prüfen Sie im Dialog **Integration hinzufügen** die Verbindungsübersicht (`https://mcp.hubspot.com`) und wählen Sie den Authentifizierungsmodus:

* **Automatische Einrichtung (Standard in der Omnifact Cloud):** Omnifact stellt eine vorkonfigurierte HubSpot-OAuth-App bereit, sodass Sie HubSpot sofort per Ein-Klick-Anmeldung verbinden können, ohne selbst eine App in HubSpot registrieren zu müssen.
* **Eigene OAuth-App verwenden (Optional oder bei On-Premise):** Möchte Ihre Organisation eine eigene registrierte HubSpot-App verwenden, klicken Sie auf **Eigene OAuth-App verwenden**, hinterlegen Sie die angezeigte **Weiterleitungs-URI** (`https://chat.omnifact.ai/oauth/mcp-callback`) in Ihrem HubSpot-Entwicklerkonto und tragen Sie **Client-ID** sowie **Client-Secret** ein. Details finden Sie unter [Eigenen OAuth-Client registrieren](https://docs.omnifact.ai/de/platform/team-administration/mcp-servers.md#eigenen-oauth-client-registrieren-eigene-zugangsdaten).

**4. Anmelden und Tools erkennen**

Klicken Sie auf **Mit HubSpot anmelden** (**Sign in with HubSpot**). Melden Sie sich im Pop-up-Fenster bei HubSpot an, wählen Sie Ihren HubSpot-Account (Portal) aus und bestätigen Sie den Zugriff.

Omnifact prüft die Verbindung, liest die verfügbaren HubSpot-Tools aus und öffnet anschließend direkt die Detailseite des HubSpot-Servers unter **Team-Einstellungen > Integrationen > Installiert**.

![Der Reiter Katalog unter Team-Einstellungen > Integrationen mit Kategoriefiltern, Suchfeld und kuratierten Integrationskarten.](https://mintcdn.com/omnifact/tRH9Gi0LEITIC1Eu/images/Documentation/settings-integrations-catalog-de.png?fit=max\&auto=format\&n=tRH9Gi0LEITIC1Eu\&q=85\&s=cce3d554c6eea302abdcf89cf55eb440)

***

## Schritt 2: Zugriffsrichtlinien für Tools prüfen (Admin)

Unmittelbar nach dem Hinzufügen von HubSpot gelangen Sie auf die Verwaltungsseite für die erkannten CRM-Tools. Jedes Tool des HubSpot-MCP-Servers wird mit einer von drei Richtlinien gesteuert:

* **Immer (Always):** Sichere Lesezugriffe (etwa das Suchen von Kontakten, Abrufen von Unternehmensdaten, Prüfen von Deal-Pipelines oder Auflisten von Tickets) werden vom Agenten selbstständig ohne Unterbrechung ausgeführt.
* **Nachfragen (Approval):** Schreibende Aktionen (wie das Anlegen oder Aktualisieren von Kontakten, Verschieben von Deal-Phasen oder Speichern von Gesprächsnotizen und Aufgaben) pausieren die Ausführung und blenden ein interaktives Freigabebanner im Chat ein.
* **Deaktiviert (Disable):** Blendet das Tool vollständig aus, sodass KI-Modelle es weder sehen noch aufrufen können.

> [!TIP]
>
> **Empfohlene Einstellung:** Belassen Sie lesende HubSpot-Abfragen auf **Immer** für schnelle Kunden-Briefings, setzen Sie sämtliche schreibenden Tools auf **Nachfragen**, damit Benutzer jede CRM-Änderung vor dem Speichern kontrollieren, und stellen Sie nicht benötigte Tools auf **Deaktiviert**.

> [!WARNING]
>
> **Sicherheitsgrenze des Privacy Filters bei MCP-Servern:** Tool-Aufrufe an externe MCP-Server (`https://mcp.hubspot.com`) **umgehen den Privacy Filter (Ein System, das automatisch unterstützte sensible Informationen erkennt und maskiert, bevor sie KI-Modelle erreichen) in beiden Richtungen**. An HubSpot übergebene Suchparameter (wie echte Kontaktnamen, E-Mail-Adressen oder Deal-IDs) werden unmaskiert gesendet, damit HubSpot den Datensatz findet, und CRM-Antworten fließen ungefiltert in den Chat ein.

***

## Schritt 3: Persönliches HubSpot-Konto verknüpfen (Alle Benutzer)

Durch die Installation in den Team-Einstellungen wird HubSpot im Workspace bereitgestellt, **die Tools sind für einzelne Teammitglieder im Chat jedoch erst aktiv, sobald sie ihr eigenes HubSpot-Konto verbunden haben**. Da sich jede Person selbst anmeldet, greift der Agent ausschließlich auf die Kontakte, Unternehmen, Deals und Tickets zu, für die das jeweilige HubSpot-Konto berechtigt ist.

**1. Verbindungen öffnen**

Klicken Sie unten links auf Ihren **Benutzer-Avatar**, wählen Sie **Kontoeinstellungen** und öffnen Sie **[Verbindungen](https://docs.omnifact.ai/de/platform/core-features/account-settings/connections.md)** (oder rufen Sie direkt `https://chat.omnifact.ai/account/connections` auf).

**2. HubSpot unter MCP-Server verbinden**

Scrollen Sie zum Abschnitt **MCP-Server**, suchen Sie die Karte **HubSpot** und klicken Sie auf **Verbinden**.

**3. HubSpot-Account auswählen und autorisieren**

Melden Sie sich im Pop-up-Fenster bei HubSpot an, wählen Sie das HubSpot-Portal Ihres Unternehmens und bestätigen Sie die Berechtigungen. Auf der Karte erscheint anschließend das Badge **Verbunden**.

![Bereich MCP-Server unter Kontoeinstellungen > Verbindungen mit der HubSpot-Karte zum Verknüpfen des persönlichen Kontos.](https://mintcdn.com/omnifact/eFN-x5hJg72gP6In/images/user-settings-connections-mcp-de.png?fit=max\&auto=format\&n=eFN-x5hJg72gP6In\&q=85\&s=af5a25076a8356dd28e155a9dc48199d)

> [!NOTE]
>
> **Automatischer Hinweis im Chat:** Wenn ein Teammitglied den Agenten im Chat nach HubSpot-Daten fragt, bevor das eigene Konto verknüpft wurde (oder nachdem die Sitzung abgelaufen ist), weist der Agent direkt im Chat darauf hin, HubSpot unter **Kontoeinstellungen > Verbindungen** zu verbinden.

***

## Schritt 4: HubSpot im Chat nutzen & Änderungen freigeben

Sobald Ihr HubSpot-Konto verbunden ist, können Sie in jedem Chat oder Space (Eine dedizierte Umgebung mit einem spezialisierten Agenten und optionalen Hochgeladenen Dateien) direkt in natürlicher Sprache mit Ihren CRM-Daten arbeiten:

> [card] Briefing vor einem Kundentermin
>
> *„Erstelle mir ein kurzes Briefing für meinen Termin mit der Acme GmbH aus HubSpot: wichtigste Kontakte, offene Deals mit Phase und Betrag, offene Support-Tickets sowie eine Zusammenfassung der letzten drei Notizen oder E-Mails.“*

> [card] Gesprächsnotizen & Aufgaben protokollieren
>
> *„Hier sind meine Stichpunkte aus dem Gespräch mit der Acme GmbH. Speichere sie als Notiz am Deal in HubSpot, lege eine Follow-up-Aufgabe für kommenden Freitag an und setze die Deal-Phase auf Angebot gesendet.“*

> [card] Pipeline und Deals auswerten
>
> *„Zeige mir alle offenen HubSpot-Deals über 20.000 € mit Abschluss in diesem Quartal, gruppiert nach Deal-Phase, und markiere Deals ohne Aktivität in den letzten 14 Tagen.“*

> [card] Tickets und Postfächer prüfen
>
> *„Liste alle offenen HubSpot-Support-Tickets für die Acme GmbH auf und prüfe, ob es offene Konversationen im verbundenen HubSpot-Postfach gibt.“*

### Schreibvorgänge im Chat bestätigen

Sobald der Agent ein HubSpot-Tool aufruft, für das die Richtlinie **Nachfragen** gilt:

1. Die Antwortgenerierung pausiert und direkt über dem Chat-Eingabefeld erscheint ein interaktives **Tool-Freigabebanner**.
2. Sie können die Detailansicht ausklappen, um den genauen Tool-Namen und alle zu übertragenden Felder vorab zu prüfen.
3. Klicken Sie auf **Erlauben**, um die Änderung in HubSpot auszuführen, oder auf **Ablehnen**, um den Vorgang ohne Datenänderung abzubrechen.

![Interaktives Tool-Freigabebanner über dem Chat-Eingabefeld mit den Schaltflächen Ablehnen und Erlauben.](https://mintcdn.com/omnifact/vLeigdfrLhBPb253/images/Documentation/feature-drop-mcp-servers-approval-de.png?fit=max\&auto=format\&n=vLeigdfrLhBPb253\&q=85\&s=93856545f3a93da3784bf62f3c966d85)

***

## Häufige Fragen & Fehlerbehebung

> [accordion] Warum meldet der Agent, dass er nicht auf HubSpot zugreifen kann?
>
> Prüfen Sie zwei Punkte:
>
> 1. **Persönliche Kontoverbindung:** Öffnen Sie **[Kontoeinstellungen > Verbindungen](https://docs.omnifact.ai/de/platform/core-features/account-settings/connections.md)** und vergewissern Sie sich, dass bei **HubSpot** im Bereich **MCP-Server** der Status **Verbunden** angezeigt wird. Steht dort **Erneute Autorisierung erforderlich**, klicken Sie auf **Erneut verbinden**.
> 2. **Tool-Richtlinien:** Bitten Sie einen Administrator, unter **Team-Einstellungen > Integrationen > Installiert > HubSpot** zu prüfen, ob die benötigten HubSpot-Tools auf **Immer** oder **Nachfragen** (und nicht auf **Deaktiviert**) gesetzt sind.

> [accordion] Welche HubSpot-Datensätze können Kolleginnen und Kollegen über Omnifact einsehen?
>
> Ausschließlich die Kontakte, Unternehmen, Deals, Tickets und Kampagnen, für die **ihr eigenes HubSpot-Benutzerkonto** berechtigt ist. Da sich jede Person individuell per OAuth anmeldet und kein geteilter Admin-Schlüssel verwendet wird, bleiben alle Team- und Eigentümerberechtigungen aus HubSpot unverändert wirksam.

> [accordion] Kopiert oder indiziert Omnifact unsere gesamte HubSpot-Datenbank vorab?
>
> Nein. Anders als bei [Verbundenen Quellen](https://docs.omnifact.ai/de/platform/core-features/spaces/connected-sources.md) für Cloud-Speicher fragt der Agent HubSpot-Einträge über MCP nur genau dann live ab, wenn Ihre Chat-Anfrage dies erfordert. Ihre CRM-Datenbank verbleibt vollständig in HubSpot.

> [accordion] Wie wechseln wir nachträglich auf eine eigene HubSpot-OAuth-App?
>
> Ein Administrator kann unter **Team-Einstellungen > Integrationen > Installiert > HubSpot** auf **Bearbeiten** (**Edit**) klicken, **Eigene OAuth-App verwenden** auswählen, die **Client-ID** und das **Client-Secret** Ihrer HubSpot-App (mit `https://chat.omnifact.ai/oauth/mcp-callback` als hinterlegter Weiterleitungs-URI) eintragen und mit **Verbinden & speichern** bestätigen.

## Verwandte Ressourcen

> [card] [MCP-Server](https://docs.omnifact.ai/de/platform/team-administration/mcp-servers.md)
>
> Ausführlicher Leitfaden zur MCP-Einrichtung, eigenen OAuth-Clients und Tool-Zugriffsrichtlinien.

> [card] [App-Verbindungen](https://docs.omnifact.ai/de/platform/core-features/account-settings/connections.md)
>
> So verbinden, erneuern und verwalten Benutzer ihre persönlichen Werkzeug-Konten.

> [card] [Integrationen verwalten](https://docs.omnifact.ai/de/platform/team-administration/integrations.md)
>
> Alle über 35 Konnektoren im Integrationskatalog entdecken und verwalten.

> [card] [SharePoint einrichten](https://docs.omnifact.ai/de/guides/connections-setup/sharepoint.md)
>
> Microsoft SharePoint anbinden, um Dokumentenbibliotheken in Spaces zu synchronisieren.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.