Claude mit HubSpot oder Salesforce über MCP: Wege, Rechte und typische Fehler

Claude mit HubSpot oder Salesforce über MCP zu verbinden heißt: Das Sprachmodell Claude erhält über eine standardisierte Schnittstelle Zugriff auf Kontakte, Deals und Notizen in Ihrem CRM. Es liest dort Daten und kann, wenn Sie es erlauben, Datensätze anlegen oder ändern. Dieser Leitfaden richtet sich an Unternehmen, deren CRM nicht von Zoho stammt, und zeigt die verfügbaren Wege, die kritischen Rechte und einen ersten Prozess.

Das Model Context Protocol, kurz MCP, ist laut der MCP-Dokumentation von Anthropic eine quelloffene Norm für die Anbindung von KI an Werkzeuge und Datenquellen. Ein MCP-Server setzt diese Norm für ein bestimmtes System um, hier für HubSpot oder Salesforce. Ein MCP-Client ist die Anwendung, in der Sie mit Claude arbeiten, etwa Claude.ai, Claude Desktop oder Claude Code, die Kommandozeilenversion für Entwickler.

Anthropic betont, dass MCP-Server nicht an einen einzelnen Client gebunden sind. Eine Einrichtungsanleitung für Claude Desktop lässt sich daher meist auf andere Clients übertragen. Coffee beschreibt außerdem den Vorteil, dass ein einmal gebauter und gepflegter Server von allen KI-Anwendungen im Unternehmen genutzt werden kann, statt die Anbindung jedes Mal neu zu bauen.

Ein MCP-Server bietet laut Coffee drei Bausteine an: Resources für reine Lesedaten, Tools für Aktionen und Prompts als wiederverwendbare Vorlagen. Für Ihre Risikoabwägung ist genau diese Trennung entscheidend, denn Lesen und Handeln brauchen unterschiedliche Freigaben.

Für HubSpot nennt SyncGTM drei Einrichtungswege. Der erste ist die offizielle HubSpot-Kommandozeile (CLI) ab Version 8.2.0, die Node.js ab Version 18 voraussetzt. Der zweite ist ein quelloffener Server namens mcp-hubspot, der auf GitHub liegt und über Smithery oder durch manuelles Klonen installiert wird. Der dritte ist der HubSpot-Connector für Claude, der ohne Arbeit im Terminal auskommt.

Den Connector beschreibt HubSpot in seiner Anleitung zum HubSpot-Connector für Claude. Voraussetzung ist ein kostenpflichtiges Anthropic-Abonnement: Pro, Max, Team oder Enterprise. Die Anmeldung läuft bei allen HubSpot-Wegen laut SyncGTM entweder über ein Zugriffstoken einer Private App oder über OAuth, ein Verfahren, bei dem Sie der Anwendung Rechte erteilen, ohne ein Passwort weiterzugeben.

Für Salesforce enthält unsere Quellenlage keinen vergleichbaren Hersteller-Connector. CData beschreibt die Anbindung über den eigenen Connector Connect AI MCP, den Sie in Claude.ai unter Einstellungen, dann Connectors und „Browse Connectors“ hinzufügen. Wichtig ist die Salesforce-Edition: Laut CData stellt die Professional Edition den nötigen API-Zugang für Integrationen von Drittanbietern nicht bereit, erforderlich ist Enterprise oder höher.

Gibt es für ein System keinen MCP-Server, verweist Coffee auf einen Umweg: Claude erzeugt strukturierte Daten im JSON-Format, die an einen Zapier-Webhook gehen und von dort in verbundene Anwendungen fließen. Ein Nutzer auf Reddit berichtet zudem, dass er HubSpot seit rund drei Wochen über Claude Code und die Kommandozeile steuert statt über MCP, weil er dort die Fehlercodes sieht.

Die Wahl hängt weniger von der Technik ab als davon, wer die Verbindung nutzt und wer sie pflegt. Die folgende Tabelle fasst die Wege zusammen. Die Einrichtungszeiten stammen von SyncGTM, die Grenzen des Connectors von HubSpot und SyncGTM, die Salesforce-Angaben von CData.

Als Faustregel gilt: Arbeitet Ihr Vertrieb in HubSpot und soll ohne IT-Abteilung starten, ist der Connector der naheliegende Anfang. Brauchen Sie eigene Objekte oder feinere Rechte, ist ein selbst betriebener Server die bessere Wahl, verlangt aber jemanden, der ihn pflegt. Bei Salesforce klären Sie zuerst die Edition, bevor Sie Zeit in die Einrichtung stecken.

Der häufigste Fehler ist, Claude am ersten Tag Schreibrechte zu geben. Der HubSpot-Connector unterstützt laut HubSpot Anzeigen, Erstellen und Aktualisieren, aber keine Löschvorgänge. Das begrenzt den Schaden, schützt aber nicht vor falsch überschriebenen Feldern. SyncGTM beschreibt, dass der Connector Lesezugriff auf Interaktionen standardmäßig gewährt, während Schreibzugriff eine ausdrückliche Freigabe verlangt.

In Claude können Sie für die Schreibwerkzeuge des HubSpot-Connectors die Einstellung Genehmigung erforderlich wählen. Dann fragt Claude vor jeder Aktualisierung nach Ihrer Zustimmung. Bei der Einstellung Immer zulassen werden Änderungen ohne Nachfrage geschrieben. Für den Anfang gehört jede Schreibaktion in die erste Gruppe.

Bei Svennis schalten wir Schreibwerkzeuge erst frei, wenn das Team über einige Wochen nur Lesefragen gestellt und die Antworten gegen die CRM-Oberfläche geprüft hat. Erst so sehen Sie, ob Claude Ihre Felder, Pipelines und Bezeichnungen richtig versteht, bevor es etwas daran ändert.

Gute Lesefragen für diese Phase sind etwa: Welche offenen Deals haben seit zwei Wochen keine Aktivität? Welche Kontakte eines Unternehmens sind doppelt angelegt? Beachten Sie dabei den Hinweis von Anthropic, dass Server, die externe Inhalte abrufen, ein Risiko der Prompt-Injektion bergen. Gemeint ist, dass präparierter Text in einer E-Mail oder Webseite Claude Anweisungen unterschieben kann. Wer zunächst nur liest, hält die Folgen eines solchen Angriffs klein.

Wer den HubSpot-Connector verknüpfen darf, regelt HubSpot klar: Super-Admins und Benutzer mit App-Marketplace-Berechtigung können ihn ohne vorherige Genehmigung verbinden. Alle anderen brauchen zuerst die Freigabe eines Super-Admins. Dasselbe gilt für externe Agenturen oder Berater, sofern sie diese Rechte in Ihrem Account haben. Prüfen Sie deshalb vor dem Start, wer außerhalb Ihres Hauses Super-Admin ist.

Über den Connector sieht jeder Benutzer nur die Daten, die seine bestehenden HubSpot-Berechtigungen zulassen. Das ist eine gute Nachricht, setzt aber voraus, dass diese Rechte sauber gepflegt sind. Für Salesforce verlangt die Integration laut CData Systemadministrator-Zugang, für HubSpot Super-Admin-Rechte.

Tokens und Schlüssel

Wer eine Private App anlegt, sollte zwei Punkte kennen, die SyncGTM beschreibt. HubSpot zeigt das erzeugte Zugriffstoken nur einmal an. Erweitern Sie später die Berechtigungen, müssen Sie das Token neu erzeugen, denn das alte übernimmt neue Berechtigungen nicht. Coffee rät für den Produktivbetrieb davon ab, API-Schlüssel in Umgebungsvariablen abzulegen, und empfiehlt einen Tresor wie AWS Secrets Manager oder HashiCorp Vault.

Das richtige Konto

Pro Claude-Account lässt sich laut HubSpot jeweils nur ein HubSpot-Account verknüpfen. Der Reddit-Nutzer berichtet, dass seine MCP-Werkzeuge sich beim falschen Portal anmeldeten und deshalb bei jeder Abfrage null Ergebnisse lieferten. Leere Antworten sind also oft ein Kontoproblem, kein Datenproblem.

Feldzuordnung bedeutet, festzulegen, welche Information in welches CRM-Feld gehört, etwa welcher Wert als Dealphase gilt und in welchem Format ein Datum gespeichert wird. Claude kennt Ihre Konventionen nicht von selbst. SyncGTM nennt zwei Grenzen des HubSpot-Connectors, die hier wichtig sind: Benutzerdefinierte Objekte werden noch nicht unterstützt, und benutzerdefinierte Validierungsregeln greifen bei Connector-Aktionen nicht. Prüfregeln, auf die Sie sich in der Oberfläche verlassen, schützen Sie hier also nicht.

Wer über die API oder die Kommandozeile arbeitet, stößt auf weitere Stolpersteine. Der Reddit-Nutzer schildert mehrere davon aus seiner Praxis:

• Eine Notiz einem Deal zuzuordnen verlangt die associationTypeId 214 mit der Kategorie HUBSPOT_DEFINED. Eine falsche ID scheitert ohne Fehlermeldung.
• Die Notizerstellung braucht hs_timestamp in ISO-8601 UTC mit dem Suffix Z. Andere Formate scheitern still.
• Ein PATCH auf einen Deal führt Eigenschaften nach seiner Beobachtung nicht zusammen, sondern ersetzt sie.
• Eigenschaftsgruppen müssen bereits existieren, sonst landet eine neue Eigenschaft in einem Standardabschnitt.
• Die Dealsuche zerlegt eine Abfrage in einzelne Wörter und findet Treffer für jedes Wort getrennt.

CData nennt als typische Probleme Abweichungen zwischen Systemen und die Zuordnung derselben Person oder Firma über mehrere Plattformen. Auch strukturierte Ausgaben helfen nur begrenzt: Laut Coffee garantiert die eingeschränkte Dekodierung Form und Datentyp, aber nicht, dass der Inhalt stimmt. Ein Feld kann also korrekt formatiert und trotzdem falsch sein.

Ein guter erster Prozess ist klein, häufig und leicht zu prüfen. Wir nehmen als Beispiel die Nachbereitung eines Kundentermins in HubSpot: Claude liest den Deal, formuliert eine Gesprächsnotiz und schlägt eine neue Dealphase vor. CData empfiehlt genau diesen Einstieg: zuerst eine einzelne Aktualisierung wie das Ändern einer Dealphase, bevor Sie Massenänderungen versuchen.

1. Ein Super-Admin genehmigt den HubSpot-Connector für Claude, damit die Vertriebsmitarbeiter ihn verknüpfen können.
2. Jeder Mitarbeiter verbindet den Connector in Claude.ai unter Einstellungen und Connectors und meldet sich mit dem eigenen HubSpot-Benutzer an, nicht mit einem Sammelkonto.
3. Die Schreibwerkzeuge stehen auf Genehmigung erforderlich.
4. Der erste Durchlauf läuft an einem Testdeal. Eine Anweisung könnte lauten: „Lies den Deal Muster GmbH, fasse meine Stichpunkte zum Termin als Notiz zusammen und schlage die passende Dealphase vor. Schreibe erst nach meiner Bestätigung.“
5. Nach der Bestätigung prüfen Sie Notiz und Phase in der HubSpot-Oberfläche und im Audit-Protokoll. Dort werden Aktionen laut HubSpot sowohl dem Benutzer als auch dem Claude-Connector zugeschrieben.

Erst wenn dieser Ablauf an mehreren echten Deals fehlerfrei läuft, erweitern Sie ihn. Auch dann gilt die Grenze des Connectors: höchstens 10 Datensätze gleichzeitig erstellen oder aktualisieren. Für Salesforce ist der Ablauf derselbe, nur über den gewählten MCP-Connector und mit der Edition, die den API-Zugang erlaubt.

Wer einen Server selbst betreibt, muss einige Einstellungen kennen. Anthropic empfiehlt HTTP als Transport für entfernte MCP-Server, weil HTTP OAuth unterstützt. Der Transport über Server-Sent Events (SSE) ist veraltet, WebSocket unterstützt kein OAuth. Lokale stdio-Server laufen als Prozess auf dem eigenen Rechner und werden von Claude Code nach einem Abbruch nicht automatisch neu verbunden, entfernte Server dagegen bis zu fünfmal.

Große Abfragen stoßen an eine Ausgabegrenze: Claude Code warnt ab 10.000 Tokens Werkzeugausgabe und begrenzt sie standardmäßig auf 25.000 Tokens. Ein vollständiger Pipeline-Export passt deshalb oft nicht in eine Antwort, gefilterte Abfragen schon.

Hinzu kommen die API-Kontingente der CRM-Hersteller. SyncGTM nennt für HubSpot Private Apps 100 Anfragen pro 10 Sekunden. Laut CData erhält eine Salesforce Enterprise Edition mit 50 Benutzern rund 1.000.000 API-Aufrufe pro Tag. Wird ein Kontingent überschritten, stocken KI-Abläufe oder brechen ab. Der Reddit-Nutzer kritisiert, dass MCP die Wiederholungslogik verbirgt und den Status versteckt, während die Kommandozeile Fehlercodes sichtbar lässt. Planen Sie daher eine Protokollierung ein, die Ihnen zeigt, warum ein Schreibvorgang fehlschlug.

In Claude Code gelten zudem Konfigurationsebenen: lokal nur für Sie, projektweit über die Datei .mcp.json oder benutzerweit für alle Ihre Projekte. Ein geklontes Repository kann seine eigenen Server laut Anthropic nicht selbst genehmigen.

Eine MCP-Verbindung verschiebt Arbeit, sie ersetzt keine Verantwortung. Vier Entscheidungen sollten auch nach der Einführung bei einem Mitarbeiter liegen.

• Jede Freigabe einer Schreibaktion, solange der Prozess neu ist. Die Einstellung „Immer zulassen“ ist erst sinnvoll, wenn Sie Fehlerquote und Art der Fehler kennen.
• Massenänderungen und Bereinigungen. Das Zusammenführen doppelter Kontakte oder das Umbenennen von Phasen betrifft viele Datensätze und lässt sich schwer zurückdrehen.
• Preise, Rabatte und Angebote. Claude kann Texte entwerfen, die Zahlen gehören aus dem System und die Freigabe zu Ihnen. Wie das aufgebaut ist, zeigt unser Beitrag zu Angeboten mit Claude und menschlicher Freigabe.
• Die Deutung unklarer Daten. Ist eine Angabe mehrdeutig oder unvollständig, kann Claude einen plausiblen, aber falschen Wert eintragen. Das Prüfen solcher Fälle bleibt Aufgabe des zuständigen Mitarbeiters.

Legen Sie diese Punkte schriftlich fest, bevor Sie Schreibrechte erweitern. So weiß jeder im Team, welche Änderungen Claude vorbereiten darf und welche nur ein Mensch bestätigt.

Für Unternehmen im deutschsprachigen Raum stehen Datenfluss und Nachvollziehbarkeit im Mittelpunkt. HubSpot gibt an, dass der Connector den Rechenzentrumsstandort respektiert, weil die Daten über HubSpot-Server laufen. Bei Accounts, die in der EU gehostet werden, gehen die Anfragen laut HubSpot über das EU-Rechenzentrum von HubSpot. Die Verarbeitung durch Claude selbst erfolgt bei Anthropic und ist gesondert zu prüfen.

Ob Anthropic Inhalte zum Training verwendet, hängt von Ihrem Tarif und dessen Datenschutzeinstellungen ab. Prüfen Sie das in den Bedingungen Ihres Anthropic-Tarifs, bevor Sie Kundendaten verbinden. Klären Sie außerdem intern, ob Mitarbeiter Feedback-Funktionen nutzen dürfen.

HubSpot kann außerdem Zusammenfassungen von Werkzeugaufrufen erfassen, einschließlich der Absicht der Anfrage und ob sie erfolgreich war. Dieser Punkt gehört in Ihre Datenschutzprüfung.

Ist in Ihrem HubSpot-Account die Funktion für vertrauliche Daten aktiviert, kann Claude nicht auf Interaktionsdaten zugreifen. Das schützt sensible Inhalte, schränkt aber Auswertungen von Gesprächen und E-Mails ein.

Coffee nennt SOC 2 Type II als Mindestanforderung vieler Vertriebsteams. Für Unternehmen in Deutschland und Österreich gilt die DSGVO unabhängig von der Branche, für Unternehmen in der Schweiz das Datenschutzgesetz (DSG) und bei Angeboten an Personen in der EU oft zusätzlich die DSGVO. Regulierte Branchen verlangen oft zusätzlich ISO 27001.

Praktisch heißt das: Stimmen Sie die Anbindung vor dem Start mit Ihrem Datenschutzbeauftragten ab, sofern vorhanden, und dokumentieren Sie, welche Benutzer den Connector nutzen. Das Audit-Protokoll, das Aktionen Benutzer und Connector zuordnet, ergänzt dabei das Verzeichnis von Verarbeitungstätigkeiten und den Auftragsverarbeitungsvertrag als Nachweis.

Manchmal liegt das Problem nicht in der Anbindung, sondern im CRM darunter. Drei Anzeichen sprechen dafür, die Grundlage zu überdenken, bevor Sie in MCP investieren.

Erstens die Salesforce-Edition: Arbeiten Sie mit der Professional Edition, fehlt laut CData der nötige API-Zugang, und die Anbindung setzt ein Upgrade auf Enterprise voraus. Zweitens benutzerdefinierte Objekte in HubSpot: Bildet Ihr Geschäft seine Kernprozesse darüber ab, kann der Connector sie noch nicht bedienen, und Sie brauchen einen selbst betriebenen Server. Drittens verteilte Daten: Liegen Kunden, Angebote und Rechnungen in mehreren Systemen, steigt der Aufwand für die Zuordnung derselben Firma über alle Plattformen.

Wer ohnehin vor einer CRM-Entscheidung steht, kann ein System wählen, bei dem Vertrieb, Service und Buchhaltung auf einer Plattform liegen. Wie die MCP-Anbindung bei Zoho CRM aussieht, beschreiben wir im Leitfaden Claude mit Zoho CRM über MCP verbinden. Sollen zusätzlich Buchhaltungsdaten angebunden werden, lesen Sie unseren Beitrag zu Claude mit DATEV, lexoffice oder sevdesk.

Wenn Sie beim bestehenden CRM bleiben, gehen Sie in dieser Reihenfolge vor. Jeder Schritt lässt sich in wenigen Tagen erledigen und liefert eine klare Entscheidungsgrundlage für den nächsten.

1. Voraussetzungen prüfen: kostenpflichtiges Anthropic-Abonnement, bei Salesforce die Enterprise Edition oder höher, Liste aller Super-Admins und Systemadministratoren, auch externer.
2. Weg wählen: anhand der Tabelle oben Connector, CLI, eigenen Server oder Drittanbieter-Connector festlegen.
3. Mitarbeiter schulen: Sorgen Sie dafür, dass alle, die den Connector nutzen, Grenzen und Risiken von Claude kennen, etwa Prompt-Injektion und plausible, aber falsche Werte, und dokumentieren Sie diese Maßnahme.
4. Lesephase starten: einige Wochen nur Lesefragen, Antworten gegen die CRM-Oberfläche prüfen, Abweichungen notieren.
5. Feldzuordnung dokumentieren: Phasen, Pflichtfelder, Datumsformate und Zuordnungen schriftlich festhalten, bevor Claude schreibt.
6. Einen Schreibprozess freigeben: Gesprächsnotiz und Dealphase mit der Einstellung „Genehmigung erforderlich“, erst an einem Testdeal.
7. Datenschutz abstimmen: Prüfen Sie, ob Ihr Anthropic-Tarif einen Auftragsverarbeitungsvertrag vorsieht, und verarbeiten Sie Kundendaten nur in einem Tarif, bei dem das der Fall ist. Prüfen Sie außerdem die Rechtsgrundlage für die Übermittlung in Drittländer, ergänzen Sie das Verzeichnis von Verarbeitungstätigkeiten und legen Sie Feedback-Regeln und Audit-Protokoll fest, gegebenenfalls mit Ihrem Datenschutzbeauftragten. Ergänzen Sie außerdem Ihre Datenschutzhinweise um Anthropic als Empfänger und um die Übermittlung in Drittländer, und prüfen Sie, ob eine Datenschutz-Folgenabschätzung erforderlich ist.
8. Betriebsrat beteiligen: Gibt es in Ihrem Unternehmen einen Betriebsrat, beteiligen Sie ihn vor dem Start, denn Audit-Protokolle, die Aktionen einzelnen Mitarbeitern zuordnen, sind mitbestimmungspflichtig.

Soll Claude im Team nicht nur im Chat, sondern als Arbeitsumgebung mit geregelten Rechten laufen, finden Sie die Einrichtung im Leitfaden Claude Cowork im Unternehmen einsetzen. Welche Erweiterungen sich für kleinere Teams lohnen, beschreibt unser Beitrag zur Auswahl von Claude Plugins.