Ahmed Essam Alle BeiträgeEN
CRM und KIGetestet an einem Mock-CRM8 Prompts zum Kopieren

Claude mit Ihrem CRM verbinden: MCP oder API und was dabei schiefgeht

Wer Claude mit dem CRM verbinden will, sollte wissen, welche CRMs einen offiziellen MCP-Server für Claude haben, wann ein API-Key in einem Skript der bessere Weg ist und welche 3 Gewohnheiten die Fehler abfangen, die niemand sieht. Gezeigt an einem Mock-CRM, das Sie herunterladen können.

Kurzfassung
  • Für Fragen im Chat nehmen Sie den offiziellen MCP-Connector Ihres CRM, für alles Wiederholbare und jede Massenänderung die API mit einem Key in einem Skript. Starten Sie bei beidem mit reinem Lesezugriff: Blockieren Sie die Schreib-Tools des Connectors, und geben Sie dem Skript einen Read-only-Key oder einen Nutzer mit reinem Lesezugriff.
  • Was schiefgeht, geht leise schief: ein Connector im falschen Account, eine Erfolgsmeldung, die nichts geändert hat, ein Feld, das im anderen System etwas anderes bedeutet.
  • 3 Gewohnheiten fangen das ab: zuerst 3 Rohdatensätze ansehen; bei jeder Massenänderung Dry Run, Undo-Datei und Gegenprobe (Read-back); den Account prüfen, beim Lesezugriff bleiben und Keys aus dem Chat heraushalten.
  • In einem Mock-CRM mit eingebauten API-Fallen haben die Gewohnheiten 1 und 2 jede Falle erwischt, auch 15 „OK“-Antworten, die 0 Datensätze geändert hatten. Der Read-only-Key hat den versehentlichen Schreibversuch abgelehnt.
  • Kostenlos: 8 Prompts, eine Checkliste auf 1 Seite und das Mock-CRM zum Üben.

01MCP oder API: 2 Wege, Claude mit Ihrem CRM zu verbinden

MCP (Model Context Protocol) ist ein Stecker: Der CRM-Anbieter betreibt einen Server, Sie fügen ihn in Claude als Connector hinzu, und Claude ruft die Tools des CRM direkt aus dem Chat auf. Die API ist die Programmierschnittstelle des CRM: Ein Skript (Claude kann es schreiben) ruft sie mit einem Key auf. Die meisten großen CRMs betreiben inzwischen einen offiziellen MCP-Server:

CRMKann es schreiben?So bleibt es beim LesezugriffIm Connector-Verzeichnis von Claude
CloseJa: anlegen, mit einem 3. Scope auch ändern, löschen und zusammenführenScope mcp.readJa
HubSpotJa: Kontakte, Unternehmen, Deals, Tickets, Produkte, Aktivitäten. Angebote und Rechnungen nur lesendSchreib-Tools in Claude blockierenJa
monday.comJa. Jeder Aufruf wird auf Ihr tägliches API-Limit angerechnetSchreib-Tools in Claude blockierenJa
PipedriveAnlegen und ändern. Keine Lösch-ToolsSchreib-Tools in Claude blockierenJa
Salesforce*Getrennte Server für Lesen, Ändern und Löschen, alle standardmäßig ausNur den Lese-Server einschaltenNein: selbst hinzufügen
Zoho CRMJa, über den Data-Operations-Server. Aufrufe verbrauchen API-CreditsDen Data-Insights-Server nutzenJa
AttioJa: Datensätze, Notizen, Aufgaben, ListenSchreib-Tools in Claude blockierenJa
GoHighLevelJa, auch Nachrichten versenden. Key plus Location-IDDie Bearbeitungs-Scopes beim Key weglassenNicht gefunden

Anbieterdokumentation und Connector-Verzeichnis von Claude, geprüft am 13. Oktober 2026. *Die Salesforce-Dokumentation ließ sich nicht laden; diese Zeile stützt sich auf 2 unabhängige Reviews (ab Enterprise Edition, allgemein verfügbar seit April 2026). Funktionen ändern sich schnell: Prüfen Sie die Anbieterseite, bevor Sie sich auf eine Zeile verlassen.

In Claude legen Sie für jedes Tool eines Connectors fest, ob es immer erlaubt ist, eine Freigabe braucht oder blockiert ist. Blockieren Sie Schreib-Tools, bis Sie sie brauchen; die Hilfeseite von Claude warnt, dass der Research-Modus Tools ohne Rückfrage aufrufen kann.

Ihre Daten: Bei Free, Pro und Max entscheidet die Einstellung zur Modellverbesserung („Help improve Claude“), ob Chats für das Training genutzt werden dürfen; Team, Enterprise und die API fallen nicht darunter. Bei Team und Enterprise teilen sich alle Nutzer 1 festen Key in einem Connector: Geben Sie ihm so wenige Rechte wie möglich.

Wann der MCP-Connector die bessere Wahl ist: bei Fragen im Chat, etwa „Welche Deals über 10.000 hatten in den letzten 30 Tagen keine Aktivität?“

Wann die API die bessere Wahl ist: bei allem, was Sie 2-mal ausführen, bei allem mit mehr als ein paar Hundert Datensätzen, bei jeder Massenänderung. Ein Skript läuft jedes Mal exakt gleich, protokolliert, was es getan hat, und Sie können es lesen, bevor es läuft. Meine eigene Reihenfolge steht fest: zuerst die API mit einem Key, dann der MCP-Connector, ganz zuletzt das Klicken im Browser.

Welcher Key: ein Read-only-Key oder ein eng begrenzter Key für Analysen, ein Admin-Key nur während des Aufbaus. Nicht jedes CRM bietet einen Read-only-Key. Ein Close-API-Key und ein persönliches Token bei monday oder Pipedrive dürfen alles, was Ihr Nutzer darf. Bei Private Apps in HubSpot vergeben Sie Lese- und Schreibrechte einzeln. Wo sich der Key nicht einschränken lässt, nehmen Sie einen eigenen Nutzer mit reinem Lesezugriff (prüfen Sie, was ein zusätzlicher Nutzer in Ihrem Tarif kostet).

02Was schiefgeht: Die API meldet „OK“, und nichts ist passiert

Diese 3 Fallen laufen still durch oder führen Sie auf die falsche Fährte. Alle 3 sind mir in echten CRM-Projekten passiert:

Falle 1Der Connector hängt in einem anderen AccountEin Chat-Connector ist immer nur in 1 Account eingeloggt. Ich habe meinen in weniger als 2 Monaten in 6 verschiedenen Accounts vorgefunden. „Workspace not found“ hieß: Ich war im falschen Account.
Falle 2Ohne Meldung verworfenIn manchen CRMs wird ein Feldname mit Tippfehler oder ein nicht unterstützter Filter einfach ignoriert. In einem CRM lieferte die Kontaktsuche per E-Mail die erste Seite aller Kontakte, und ein Schreibzugriff mit falschem Feldnamen meldete „OK“ und änderte nichts.
Falle 3Gleiches Feld, andere BedeutungBei einer CRM-Migration zählte das alte System die Klingelzeit zur „Anrufdauer“, das neue nur die Gesprächszeit. In 1 Woche hatten 1.560 als „nicht erreicht“ markierte Anrufe trotzdem eine Dauer über 0. Im ersten Vergleich sah das neue System schlechter aus, als es war.

Fragen Sie Claude: „Hat es geklappt?“, dann liest Claude meist das „OK“ und antwortet mit Ja. Prüfen Sie stattdessen die Daten.

033 Gewohnheiten, die das abfangen, getestet an einem Mock-CRM

Ich habe ein Mock-CRM gebaut (60 fiktive Leads, 244 Anrufe) und ein Demo-Skript dazu. Die Fallen 2 und 3 sind darin eingebaut: ein ignorierter Filter, ein ignorierter Feldname und Klingelzeit in der Anrufdauer. Das Skript hat jedes Ergebnis gegen eine Referenzrechnung geprüft, und die Screenshots sind seine unbearbeiteten Logs. Das ist eine Simulation der Fallen, kein Test der API eines bestimmten Anbieters.

Gewohnheit 1: 3 Rohdatensätze ansehen, bevor Sie einem Filter oder Feld trauen

Die Suche per E-Mail antwortete mit 200 OK und 60 Kontakten für 1 Adresse; der erste war die falsche Person. Die Anzahl entsprach der ungefilterten Gesamtzahl, und keiner der 3 Rohdatensätze enthielt die Adresse. Die dokumentierte Abfrage fand den richtigen Kontakt.

Log: Der E-Mail-Filter liefert 60 von 60 Kontakten und die falsche Person; 3 Rohdatensätze und die ungefilterte Gesamtzahl zeigen, dass der Filter ignoriert wird; die dokumentierte Abfrage liefert genau 1 richtigen Kontakt.
Rot ist der Fehler, Grün die Prüfung, die ihn erwischt hat.

Bei den Anrufen: 60 von 60 nicht angenommenen Anrufen aus der alten Telefonsynchronisation hatten eine Dauer über 0, gegenüber 0 von 68 nativen. Selbst bei angenommenen Anrufen wirkte das alte System 15,3 s länger (336,4 s gegenüber 321,1 s). Diese Differenz ist Klingelzeit: Die echte Gesprächszeit lag bei 320,9 s und 321,1 s.

Log: Nicht angenommene Altanrufe haben alle eine Dauer über 0, die nativen keine; die naiven Durchschnitte weichen ab, die Referenz-Gesprächszeiten sind gleich.
Der Durchschnitt über alle Anrufe (181,2 s gegenüber 145,0 s) vermischt zusätzlich eine andere Annahmequote.

Gewohnheit 2: Dry Run, Undo-Datei und Gegenprobe bei jeder Massenänderung

Aufgabe: eine Übergabenotiz an 15 Leads anheften. Der Dry Run gab Payload und Diff aus, und die Undo-Datei speicherte 15 Vorher-Werte. Der Payload nutzte einen geratenen Feldnamen: 15 von 15 Aufrufen meldeten OK, und die Gegenprobe fand 0 angeheftete Notizen. Der Dry Run hatte es angedeutet („not in record“); die Gegenprobe hat es bewiesen. Mit dem richtigen Feldnamen: 15 von 15, 0 außerhalb der betroffenen Datensätze. Das Undo stellte 15 von 15 wieder her.

Log: Dry Run mit dem exakten Payload für 15 Notizen, Undo-Journal, 15 OK-Antworten bei 0 geänderten Notizen, Stopp, 1 Rohdatensatz, Korrektur, 15 von 15 angeheftet, Undo stellt 15 von 15 wieder her.
Ohne Gegenprobe endet der Lauf mit „15 von 15 OK“, und nichts ist passiert.

Gewohnheit 3: richtiger Account, Lesezugriff, Keys raus aus dem Chat

Fragen Sie zuerst, in welchem Account die Verbindung steckt (Prompt 1 im Prompt-Paket unten; nicht Teil des Mock-Tests). Die Keys kamen aus Umgebungsvariablen, deshalb zeigen die Logs nur die Namen und ein maskiertes Präfix. Als das Skript mit dem Read-only-Key schreiben wollte, antwortete das CRM mit 403. Ein Scan der Logs und der Undo-Datei (4 Dateien) fand 0 Kopien der beiden Keys. Ein Key, der in einen Chat eingefügt wurde, gilt als geleakt: Tauschen Sie ihn aus.

Log: Keys erscheinen nur als maskierte Variablennamen, ein Schreibzugriff mit dem Read-only-Key wird mit 403 abgelehnt, ein Scan findet 0 Kopien der beiden Keys.

04Prompts, Checkliste und das Mock-CRM zum Üben

8 Prompts übertragen die Gewohnheiten in einen Connector oder ein Skript. Fangen Sie mit diesen 2 an:

Prompt 2: Zuerst 3 Rohdatensätze ansehen
Rufen Sie 3 <Leads | Kontakte | Deals | Anrufe> als Rohdaten mit allen Feldern ab. Zeigen Sie sie genau so, wie die API sie zurückgibt, ohne Zusammenfassung.
Listen Sie danach die Feldnamen, ihre Typen und je 1 Beispielwert auf.
Filtern, zählen und schreiben Sie noch nichts.
Prompt 6: Massenänderung, zuerst ein Dry Run
Ich möchte <Feld> bei jedem <Objekt>, für das <Bedingung> gilt, auf <Wert> setzen.
Schritt 1, Dry Run: Nennen Sie die Zahl der betroffenen Datensätze und zeigen Sie für die ersten 10 eine Vorher-nachher-Tabelle. Schreiben Sie nichts.
Schritt 2: Speichern Sie eine Undo-Datei mit der ID und dem aktuellen Wert jedes betroffenen Datensatzes.
Schritt 3: Warten Sie auf mein „Go“.
Schritt 4: Führen Sie die Änderung aus, lesen Sie danach jeden Datensatz erneut aus und berichten Sie: geändert, unverändert, Fehler.
Ist ein Datensatz nach einer Erfolgsmeldung unverändert, stoppen Sie sofort und sagen Sie es mir.

Die anderen 6 stehen im Prompt-Paket.

Klein anfangen: Verbinden Sie Claude mit reinem Lesezugriff, fragen Sie „In welchem Account bin ich?“, rufen Sie 3 Rohdatensätze ab, und stellen Sie dann Ihre erste echte Frage.

Ahmed Essam
Unabhängiger Berater für CRM und Automatisierung mit 90+ CRM-Umsetzungen. Ich bilde ab, wie aus Leads Umsatz wird, und baue ein System darum herum. Die MCP-Tabelle in diesem Beitrag wurde am 13. Oktober 2026 geprüft; das Mock-CRM lief am 13. Oktober 2026. Passend dazu: ein Unternehmens-Dashboard, mit KI auf Dummy-Daten gebaut. Soll jemand einen zweiten Blick auf Ihr Setup werfen? Nehmen Sie Kontakt auf.