Claude per MCP mit Ihrem CRM verbinden - Relaticle         

Claude per MCP mit Ihrem CRM verbinden
======================================

Verbinden Sie Claude per OAuth oder über ein Token mit festgelegten Berechtigungen mit Relaticle. Verstehen Sie benutzerdefinierte Felder, Tool-Erkennung und direkte Schreibzugriffe, bevor Sie Einträge bearbeiten.

 Manuk Minasyan · 28. August 2026 · 13 Min. Lesezeit

 ![Claude per MCP mit Ihrem CRM verbinden](https://relaticle.com/storage/ink/01M7T45GX7QC4Z2KDCBTESD1N8.png) 

Mit Claude Code richten Sie in etwa zwei Minuten Claudes Lese- und Schreibzugriff auf Ihr Relaticle-CRM ein. Bei Claude.ai oder Claude Desktop über OAuth dauert es ein paar Minuten länger. Nach der Verbindung kann Claude Ihre Unternehmen, Personen, Verkaufschancen, Aufgaben und Notizen durchsuchen und alle Details eines Eintrags lesen. Claude kann Einträge direkt erstellen, aktualisieren oder löschen und nutzt dabei die benutzerdefinierten Attribute, die Ihr Team bereits eingerichtet hat. Dies ist die Einrichtungsanleitung. Sie zeigt, was die Verbindung tatsächlich leistet, wie Sie sie in jedem Client einrichten und was die verfügbaren Tools können. Außerdem erklärt sie, was die meisten Anleitungen auslassen: wie genau sich Schreibzugriffe verhalten, sobald Claude Zugriff hat.

Die maßgebliche Referenz für alle folgenden Details finden Sie unter [relaticle.com/developers/mcp](https://relaticle.com/de/developers/mcp). Dieser Beitrag führt Sie durch die Einrichtung. Speichern Sie die verlinkte Referenzseite als Lesezeichen für die genauen Tool-Schemas und Hinweise zur Fehlerbehebung.

[](#was-die-verbindung-leistet "Permalink")Was die Verbindung leistet
---------------------------------------------------------------------

[MCP (Model Context Protocol)](https://modelcontextprotocol.io/) ist der offene Standard, mit dem ein KI-Assistent echte Tools in einem echten System aufrufen kann. Sie müssen Daten dann nicht mehr zwischen einem Chatfenster und Ihrem CRM hin und her kopieren. Relaticle betreibt einen MCP-Server unter `mcp.relaticle.com`, der Ihren Arbeitsbereich jedem MCP-fähigen Client zur Verfügung stellt.

Nach der Verbindung kann Claude Folgendes tun:

- Unternehmen, Personen, Verkaufschancen, Aufgaben und Notizen durchsuchen und auflisten, mit Filtern, Sortierung und Paginierung
- Einen einzelnen Eintrag mit allen Details und seinen Beziehungen abrufen (die Personen eines Unternehmens, die verknüpften Aufgaben einer Verkaufschance und so weiter)
- Einträge in jedem dieser fünf Entitätstypen erstellen, aktualisieren und per Soft-Delete löschen
- Die benutzerdefinierten Attribute Ihres Arbeitsbereichs lesen und schreiben, nicht nur die eingebauten
- Aufgaben und Notizen mit Unternehmen, Personen und Verkaufschancen verknüpfen oder die Verknüpfung lösen und Aufgaben Mitgliedern des Arbeitsbereichs zuweisen
- Pro Entität eine Schema-Ressource lesen, damit es vor jedem Schreibzugriff Ihre genauen Feldcodes und Optionswerte kennt

Jeder dieser Vorgänge gilt für genau einen Arbeitsbereich: den, den Sie bei der Autorisierung der Verbindung gewählt haben. Mit demselben Token kann Claude weder die Daten eines anderen Arbeitsbereichs sehen noch ändern.

[](#verbindung-von-claude-web-und-desktop "Permalink")Verbindung von Claude (Web und Desktop)
---------------------------------------------------------------------------------------------

Der MCP-Server von Relaticle unterstützt zwei Authentifizierungsmethoden. Welche Sie verwenden, hängt vom Client ab.

**OAuth (empfohlen für Claude.ai, Claude Desktop und Claude Code).** Fügen Sie Relaticle als benutzerdefinierten Konnektor hinzu, mit der URL des MCP-Endpunkts `https://mcp.relaticle.com`, oder mit Ihrer eigenen Domain, wenn Sie selbst hosten. Der Server unterstützt OAuth 2.1 mit Dynamic Client Registration. Deshalb registriert sich Claude automatisch und führt Sie durch einen Zustimmungsbildschirm mit einem Klick: Sie wählen den Arbeitsbereich, den dieser Konnektor nutzen soll, bestätigen den Zugriff, und die Verbindung steht. Sie müssen kein Token kopieren oder einfügen.

Diese Wahl des Arbeitsbereichs gilt dauerhaft für den Konnektor. Soll er auf einen anderen Arbeitsbereich zeigen, widerrufen Sie den Konnektor und verbinden ihn neu. Ein Umschalten an Ort und Stelle ist nicht möglich. Auf diesem Weg ausgestellte Zugriffstoken gelten 30 Tage, Refresh-Token 90 Tage. Claude erneuert sie im Hintergrund, sodass Sie nach der Einrichtung vom Ablauf nichts bemerken sollten.

**Persönliches Zugriffstoken.** Erstellen Sie eines auf der Seite „Zugriffstoken“ in Relaticle, wählen Sie Arbeitsbereich und Berechtigungen und kopieren Sie dann das Token. Für Claude Desktop fügen Sie diesen Remote-Server unter **Customize → Connectors** (Anpassen, Konnektoren) per OAuth hinzu. Die Datei `claude_desktop_config.json` von Claude Desktop ist für lokale Server gedacht. Siehe [die Anleitung von Anthropic zum Hinzufügen eines Konnektors per URL](https://claude.com/docs/connectors/custom/add-unlisted).

![Die Seite „Zugriffstoken“ in den Relaticle-Einstellungen mit dem Formular zum Erstellen und der Liste der KI-Konnektoren](https://relaticle.com/storage/ink/01M09FZ68X5A12WNH2DFGVRMKC.png)

OAuth-Verbindungen erscheinen unter **Zugriffstoken → KI-Konnektoren**, wo Sie sie widerrufen können. Persönliche Zugriffstoken erscheinen in der Token-Liste auf dieser Seite.

**ChatGPT** kurz gesagt: Die benutzerdefinierten Konnektoren unterstützen ebenfalls OAuth Dynamic Client Registration, die Einrichtung läuft also genauso ab wie bei Claude.ai. Die Tools `search` und `fetch` von Relaticle sind gezielt für die Funktion Company Knowledge von ChatGPT gebaut. `search` liefert kanonische URLs, und `fetch` löst eine dieser URLs wieder in einen vollständigen Eintrag auf. Genau diese Schnittstellenvorgabe erwartet die Funktion.

[](#verbindung-von-claude-code "Permalink")Verbindung von Claude Code
---------------------------------------------------------------------

Claude Code verbindet sich per OAuth, genau wie Claude.ai. Fügen Sie den Server hinzu und melden Sie sich dann an:

```
claude mcp add relaticle --transport http https://mcp.relaticle.com
claude mcp login relaticle

```

`claude mcp login` öffnet den Zustimmungsbildschirm von Relaticle in Ihrem Browser, wo Sie den Arbeitsbereich wählen. Sie können auch `/mcp` in einer Sitzung ausführen. Claude Code verwaltet die OAuth-Token selbst, Ihre MCP-Konfiguration enthält also nur die Server-URL. Danach listet Claude Code `relaticle` unter seinen MCP-Servern auf, mit denselben Tools wie Claude.ai und Desktop.

Ein persönliches Zugriffstoken funktioniert weiterhin, zum Beispiel ein schreibgeschütztes Token für Berichte. Verweisen Sie über eine Umgebungsvariable darauf, damit das Token nicht in der Konfiguration steht:

```
claude mcp add relaticle \
  --transport http \
  https://mcp.relaticle.com \
  --header 'Authorization: Bearer ${RELATICLE_TOKEN}'

```

Ein direkt im Header eingetragenes Token wird im Klartext in `~/.claude.json` gespeichert, oder mit `--scope project` in `.mcp.json` in Ihrem Repository. [Wir haben getestet, wo es landet](https://relaticle.com/de/blog/claude-code-berechtigungen-wo-ihr-crm-token-landet).

*Aktualisiert am 9. November 2026: Dieser Abschnitt beginnt jetzt mit OAuth. Zuvor stand hier der Befehl für das persönliche Zugriffstoken.*

| Client | Verbindungsmethode | Typische Einrichtungsdauer |
|---|---|---|
| Claude.ai (Web) | Benutzerdefinierter OAuth-Konnektor, Dynamic Client Registration | ~2 Minuten |
| Claude Desktop | Benutzerdefinierter OAuth-Konnektor über Customize → Connectors | ~2-5 Minuten |
| Claude Code | `claude mcp add` plus OAuth-Anmeldung (`claude mcp login`) | ~2 Minuten |
| ChatGPT | Benutzerdefinierter OAuth-Konnektor, Dynamic Client Registration | ~2 Minuten |

[](#was-claude-kann-die-tools "Permalink")Was Claude kann (die Tools)
---------------------------------------------------------------------

Jede Verbindung erhält 39 Tools, geprüft am 8. November 2026. Bis zu 11 E-Mail-Tools kommen hinzu, wenn das Token E-Mail-Zugriff hat. Sie sind am Ende dieses Abschnitts aufgeführt. Eines dient der Identität (`who-ami-tool`). Es liefert den authentifizierten Benutzer, den aktuellen Arbeitsbereich, die Mitglieder des Arbeitsbereichs und die Berechtigungen des Tokens und eignet sich als erster Aufruf, um eine neue Verbindung zu prüfen. Zwei dienen der entitätsübergreifenden Suche (`search` und `fetch`, oben beschrieben). Fünf arbeiten auf Ebene des Arbeitsbereichs statt an einem einzelnen Eintrag. `get-crm-schema-tool` und `list-custom-fields-tool` dienen der Felderkennung. `get-crm-summary-tool` liefert Eintragszahlen und Pipeline-Summen. `aggregate-opportunities-tool` gruppiert Pipeline-Beträge nach Phase oder Unternehmen. `list-activity-tool` zeigt, wer welchen Eintrag geändert hat und welche Änderungen an einzelnen Feldern vorgenommen wurden. Die Upload-Tools speichern Dateien. `upload-file` liefert Markdown für Rich-Editor-Felder, `create-upload-url` bereitet einen signierten Upload vor. Die übrigen 29 Tools decken CRUD und Beziehungen für fünf Entitäten ab:

- **Unternehmen**: auflisten/suchen, abrufen, erstellen (erfordert `name`), aktualisieren, löschen
- **Personen (Kontakte)**: auflisten/suchen, abrufen, erstellen (erfordert `name`, optional `company_id`), aktualisieren, löschen
- **Verkaufschancen (Deals)**: auflisten/suchen, abrufen, erstellen (erfordert `name`, optional `company_id`/`contact_id`), aktualisieren, löschen
- **Aufgaben**: die üblichen fünf, dazu `attach-task-to-entities-tool` und `detach-task-from-entities-tool`. Damit verknüpfen Sie eine Aufgabe mit Unternehmen, Personen und Verkaufschancen oder ändern die Zuweisung an Mitglieder des Arbeitsbereichs, ohne bestehende Verknüpfungen zu löschen
- **Notizen**: die üblichen fünf, dazu Verknüpfen und Lösen mit Unternehmen, Personen und Verkaufschancen
- **E-Mail** (nur mit E-Mail-Zugriff): E-Mails und verbundene Postfächer auflisten und lesen, Entwürfe erstellen, aktualisieren und löschen, einen Entwurf oder eine neue E-Mail senden sowie einen eingeplanten Versand abbrechen, neu terminieren oder wiederholen. Jedes Tool braucht die passende Berechtigung am Token (`email:read`, `email:draft` oder `email:send`). Zum Senden ist außerdem eine Rolle im Arbeitsbereich nötig, die das Senden durch Agenten erlaubt.

Listen-Tools akzeptieren `search`, `filter` (auch für Ihre benutzerdefinierten Attribute, mit Operatoren wie `eq`, `gt`, `contains` und `in`), `sort`, `per_page` und `page`. Erstellen- und Aktualisieren-Tools akzeptieren ein `custom_fields`-Objekt für alles jenseits der eingebauten Felder. Die Verkaufschancen von Relaticle bringen zum Beispiel `stage`, `amount` und `close_date` ab Werk als benutzerdefinierte Attribute mit. Genau darauf muss ein Prompt wie „Prüfe meine Pipeline“ filtern und sortieren können.

Bei den benutzerdefinierten Attributen kommen die fünf Schema-Ressourcen ins Spiel. Bevor Claude in eine Entität schreibt, liest es `relaticle://schema/company` (oder `/people`, `/opportunity`, `/task`, `/note`), um die genauen Feldcodes und Optionswerte zu erfahren, die Ihr Team eingerichtet hat. Stimmen sie nicht, wird der Schreibzugriff komplett abgelehnt: Unbekannte Feldcodes werden nicht stillschweigend verworfen, sondern scheitern an der Validierung. Außerdem gibt es einen eingebauten Prompt **CRM Overview**, der Eintragszahlen sowie die zuletzt erstellten Unternehmen und Personen liefert. Er ist ein guter Einstieg in eine Sitzung, bevor Sie etwas Spezifischeres anfragen.

![Frühere who-ami-Antwort mit Kontoinformationen und Token-Berechtigungen](https://relaticle.com/storage/ink/01M09E1XESK0RRWGZ0034YFEFJ.png)

[](#schreibzugriffe-und-sicherheit "Permalink")Schreibzugriffe und Sicherheit
-----------------------------------------------------------------------------

Diesen Teil sollten Sie klären, bevor Sie etwas mit Schreibzugriff verbinden.

Relaticle hat zwei verschiedene Stellen, an denen eine KI in Ihr CRM schreiben kann, und sie verhalten sich unterschiedlich. In der App schlägt Rela, der integrierte KI-Assistent, Schreibzugriffe nur vor: Bitten Sie ihn, einen Eintrag zu erstellen oder zu aktualisieren, baut er eine Vorschlagskarte und wartet auf Ihre Freigabe, bevor etwas in der Datenbank gespeichert wird. Das ist eine `PendingAction`, eine echte Zeile, die im Status „ausstehend“ bleibt, bis ein Mensch handelt.

MCP funktioniert anders. Wenn Claude ein Schreib-Tool des CRM aufruft, validiert Relaticle die Anfrage und führt die zugehörige Aktion aus. Erfolgreiche Schreibzugriffe werden direkt gespeichert. Es gibt keinen Vorschlag, keine Karte und keinen separaten Freigabeschritt dazwischen. Das Sicherheitsnetz für MCP-Schreibzugriffe ist dasselbe wie bei jeder API, die Sie einem Agenten übergeben: Validierung, Berechtigungsprüfungen nach den normalen Richtlinien von Relaticle und der Umfang des Tokens, das Sie vergeben haben. Eine Freigabe durch einen Menschen ist im Protokoll nicht eingebaut.

Das ist wichtig dafür, wie Sie die Anbindung von Claude überhaupt bewerten. Einiges entschärft es in der Praxis:

- **Löschen ist nicht endgültig.** Jedes Lösch-Tool führt ein Soft-Delete aus. Nichts ist endgültig weg, und Einträge lassen sich wiederherstellen. Lösch-Tools sind in ihren MCP-Metadaten außerdem als destruktiv markiert, was ein gut funktionierender Client nutzen kann, um selbst eine Bestätigung abzufragen. Prüfen Sie die Einstellungen Ihres Clients, wenn Sie diese zusätzliche Abfrage wünschen.
- **Über MCP erstellte Einträge tragen eine Quelle.** Einträge, die über MCP entstehen, erhalten die Erstellungsquelle „MCP-Agent“. Das Aktualisieren eines bestehenden Eintrags ersetzt seine Erstellungsquelle nicht.
- **Über die Token-Berechtigungen steuern Sie diese Zugriffe tatsächlich.** OAuth-Konnektoren (Claude.ai, der Ein-Klick-Ablauf von Claude Desktop, Claude Code, ChatGPT) erhalten einen einzigen Scope, der das ganze Toolset freigibt. Feiner steuern Sie dort, welchen Arbeitsbereich der Konnektor erreichen darf. Das wählen Sie einmal bei der Zustimmung, und es bleibt fest, bis Sie widerrufen. Persönliche Zugriffstoken sind granularer: Beim Erstellen legen Sie fest, welche Berechtigungen sie erhalten (Lesen, Erstellen, Aktualisieren, Löschen, `email:read`, `email:draft` und `email:send`). Für einen Berichtsworkflow mit reinem Lesezugriff können Sie also ein eigenes Token ohne Schreibrechte erstellen, getrennt von einem Token mit vollständigen CRUD-Berechtigungen.

Wenn Claude für echte Workflows vollen Lese- und Schreibzugriff haben soll, ist genau das der vorgesehene Zweck. Soll es nur ansehen und nie etwas ändern, erstellen Sie ein Token mit dem Umfang `read` und verwenden dieses. Dieselben Tools funktionieren, nur die schreibenden werden abgelehnt.

[](#einrichtung-bei-self-hosting "Permalink")Einrichtung bei Self-Hosting
-------------------------------------------------------------------------

Nichts davon gilt nur für die Cloud. Eine selbst gehostete Relaticle-Installation betreibt denselben MCP-Server mit denselben Tools, ohne separaten Deploy-Schritt und ohne eine Funktion, die Sie einschalten müssen. Haben Sie `MCP_DOMAIN` nicht gesetzt, ist der Server direkt aus dem Docker-Image unter `{APP_URL}/mcp` erreichbar. Setzen Sie diese Variable, wenn Sie ihn lieber unter einer eigenen Subdomain bereitstellen. Persönliche Zugriffstoken funktionieren genau wie oben beschrieben, und OAuth läuft über denselben Passport-basierten Ablauf gegen Ihre eigene Domain, sobald Sie ihn konfiguriert haben.

Auf einer selbst gehosteten Instanz ändert sich nur die URL, auf die Sie Ihren Client richten. Ersetzen Sie `https://mcp.relaticle.com` in den obigen Konfigurationsbeispielen durch Ihr eigenes `{APP_URL}/mcp` oder durch Ihre `MCP_DOMAIN`, falls Sie eine gesetzt haben. Alles Übrige ist identisch mit dem gehosteten Tarif von Relaticle, auch das oben beschriebene Verhalten bei direkten Schreibzugriffen. Die vollständige Anleitung zum Deployment finden Sie im [Self-Hosting-Leitfaden](https://relaticle.com/de/developers/self-hosting), oder in unserer Blog-Anleitung zum [Self-Hosting eines KI-nativen CRM](https://relaticle.com/de/blog/ki-crm-selbst-hosten-2026) mit Docker, Coolify und Dokploy.

[](#beispiel-workflows "Permalink")Beispiel-Workflows
-----------------------------------------------------

Nach der Verbindung können Sie folgende Workflows ausprobieren. Alle nutzen Tools, die der Server tatsächlich bereitstellt:

1. **Pipeline-Review.** „Zeige mir jede Verkaufschance in der Phase Verhandlung/Prüfung, sortiert nach Betrag, und markiere alle ohne Abschlussdatum.“ Verwenden Sie `list-opportunities-tool` mit dem Phasenfilter und der Betragssortierung. Folgen Sie der Paginierung, bis `has_more` false ist, und prüfen Sie dann das Abschlussdatum jedes zurückgegebenen Eintrags.
2. **Dateneingabe nach einem Anruf.** „Ich habe gerade mit Acme Corp telefoniert. Lege das Unternehmen an, füge Jane Doe als Kontakt mit der Position VP Sales hinzu und erfasse eine Notiz, die zusammenfasst, was wir besprochen haben.“ Drei Tool-Aufrufe: `create-company-tool`, dann `create-people-tool` mit `company_id` und dem benutzerdefinierten Attribut `job_title`, dann `create-note-tool` mit direkt gesetzten `company_ids` und `people_ids`. Das Erstellen einer Notiz nimmt diese Verknüpfungen gleich entgegen, ein separater Attach-Aufruf ist nicht nötig.
3. **Einen festgefahrenen Deal wieder voranbringen.** „Sieh dir die Notizen zur Acme-Verkaufschance an und sag mir, was sie aufhält. Aktualisiere dann das Abschlussdatum, falls wir im Gespräch eines vereinbart haben.“ Gelesen wird über `list-notes-tool`/`get-note-tool`, geschrieben über `update-opportunity-tool`.
4. **Wöchentliche Zusammenfassung.** „Gib mir einen Überblick über das CRM und liste dann die Unternehmen auf, die diese Woche erstellt wurden, und die überfälligen Aufgaben.“ Beginnt mit dem eingebauten Prompt CRM Overview und fragt dann mit gefilterten Aufrufen von `list-companies-tool` und `list-tasks-tool` nach.
5. **Folgeaufgaben.** „Erstelle eine Aufgabe, nächste Woche bei John nachzufassen, weise sie mir zu und verknüpfe sie mit dem Unternehmen Acme und der Verkaufschance.“ Ein Aufruf von `create-task-tool`, dann `attach-task-to-entities-tool` mit `assignee_ids`, `company_ids` und `opportunity_ids` in derselben Anfrage.
6. **Überfällige Arbeit neu zuweisen.** „Finde Aufgaben, die mehr als eine Woche überfällig sind, und übertrage sie von Sarah auf mich.“ Ein gefilterter Aufruf von `list-tasks-tool`, dann `detach-task-from-entities-tool`, um die bisherige zuständige Person zu entfernen, und `attach-task-to-entities-tool`, um die neue hinzuzufügen.

![Eine Claude-Unterhaltung, die über list-opportunities-tool ein Pipeline-Review durchführt](https://relaticle.com/storage/ink/01M09FZ7TGV628QD22MTKZER4N.png)

Für nichts davon müssen Sie zuerst Ihr Schema erklären. Claude liest es aus den Schema-Ressourcen, sobald es zum ersten Mal einen Feldcode braucht. Wenn etwas nicht wie erwartet funktioniert oder Sie die vollständige Tool-Referenz wünschen, finden Sie sie unter [relaticle.com/developers/mcp](https://relaticle.com/de/developers/mcp). Allgemeine Fragen zu Konto und Arbeitsbereich, die nichts mit MCP zu tun haben, beantwortet [relaticle.com/help](https://relaticle.com/de/help).

 Mit Tag [ #mcp ](https://relaticle.com/de/blog/tag/mcp) [ #claude ](https://relaticle.com/de/blog/tag/claude) 

 Auf dieser Seite

 Weiterlesen

 Ähnliche Beiträge. 
--------------------

- [  17. Nov 2026  Leitfäden 

    ###  KI-Agent hat CRM-Einträge gelöscht: Lassen sie sich wiederherstellen? 

    Hat ein KI-Agent CRM-Einträge gelöscht, hängt die Wiederherstellung vom CRM ab. Wir vergleichen HubSpot, Salesforce, Attio und Relaticle und testen die Wiederherstellung in Relaticle.

     ![](https://relaticle.com/storage/ink/01M7T5H0MED6751B8CARR1SM8Y.png) 

     ](https://relaticle.com/de/blog/ki-agent-hat-crm-eintraege-geloescht-wiederherstellen)
- [  13. Nov 2026  Leitfäden 

    ###  ChatGPT-Konnektoren für Ihr CRM: sicher einrichten 

    ChatGPT-Konnektoren sind jetzt Apps innerhalb von Plugins. Verbinden Sie jeden CRM-Arbeitsbereich einmal. Prüfen Sie die Rechte Ihrer Rolle und klären Sie, wie Sie die Verbindung widerrufen können.

     ![](https://relaticle.com/storage/ink/01M7T5CR8RTJXTFZXK8XK02WK9.png) 

     ](https://relaticle.com/de/blog/chatgpt-connectors-fuer-ihr-crm-sicher-einrichten)
- [  9. Nov 2026  Leitfäden 

    ###  Claude-Code-Berechtigungen: Wo Ihr CRM-Token landet 

    Claude-Code-Berechtigungen können ein Geheimnis im Klartext speichern. Wir haben getestet, wo ein CRM-Token landet und warum OAuth ihn aus Ihren Konfigurationsdateien heraushält.

     ![](https://relaticle.com/storage/ink/01M7T1E5A4AXJRCD927SS2AS8W.png) 

     ](https://relaticle.com/de/blog/claude-code-berechtigungen-wo-ihr-crm-token-landet)
