Hilfe · KI und Schnittstellen · ab Stufe CRM

MCP-Zugang: das CRM aus Codex, Claude Code und anderen KI-Werkzeugen bedienen

Zugriffstoken anlegen, Werkzeug verbinden, los. Die KI sucht Kontakte, legt Deals und Aufgaben an und schreibt Notizen, immer mit den Rechten des Mitarbeiters, dem das Token gehört.

Was das ist

Klarkunde hat einen Endpunkt nach dem Model Context Protocol (MCP). Ein KI-Werkzeug, das MCP spricht, etwa Codex, Claude Code oder ein eigener Agent, kann damit Kontakte, Deals, Notizen und Aufgaben lesen und bearbeiten. Es arbeitet dabei immer als ein bestimmter Benutzer des CRM und darf genau das, was dieser Benutzer darf: dieselben Projekte, dieselben sichtbaren Pipelines, dieselbe Rolle.

1. Zugriffstoken anlegen

Einstellungen → Mein Konto → Zugriffstoken für KI-Werkzeuge → Token.

• Bezeichnung: Werkzeug und Gerät, zum Beispiel „Codex Laptop“.
• Rechte: „Lesen und schreiben“ oder „Nur lesen“.
• Nur Deals in diesen Phasen (optional): Die KI sieht dann nur Deals, die gerade in diesen Phasen stehen, nur deren Kunden und Verlauf, und verschiebt nur innerhalb dieser Phasen. Praktisch, wenn ein externer Partner nur einen Ausschnitt bearbeiten soll.
• Administratoren können ein Token für einen anderen Benutzer anlegen; es arbeitet dann mit dessen Rechten.

Das Token wird nur einmal angezeigt. Direkt in das Werkzeug übernehmen, nicht per Chat oder E-Mail weitergeben. Wird es nicht mehr gebraucht: in derselben Liste widerrufen, der Zugang endet sofort.

2. Verbindungsdaten

MCP-Adresse	https://ihrefirma.klarkunde.de/mcp
Transport	Streamable HTTP (POST und GET auf dieselbe Adresse)
Anmeldung	Kopfzeile Authorization: Bearer <token>

3. Einrichtung in Codex

Das Token kommt in eine Umgebungsvariable, nicht in die Konfigurationsdatei, zum Beispiel in ~/.zshrc:

export KLARKUNDE_CRM_TOKEN="<hier das Token>"

In ~/.codex/config.toml:

[mcp_servers.klarkunde_crm]
url = "https://ihrefirma.klarkunde.de/mcp"
bearer_token_env_var = "KLARKUNDE_CRM_TOKEN"

Prüfen mit codex mcp list, erster Aufruf in Codex: „Rufe whoami im CRM auf“.

4. Einrichtung in Claude Code

claude mcp add --transport http klarkunde-crm https://ihrefirma.klarkunde.de/mcp --header "Authorization: Bearer $KLARKUNDE_CRM_TOKEN"

5. Was die KI kann

• Lesen: wer bin ich (whoami), Pipelines mit Phasen, Kontakte suchen und ansehen, Deals suchen und ansehen, Verlauf, Aufgaben, Makler finden, die eine Region abdecken.
• Schreiben: Kontakt anlegen und ändern, Deal anlegen, ändern und verschieben, Notiz schreiben, Aufgabe anlegen, ändern und erledigen.
• Bewusst nicht: Löschen, Massenversand, Massenänderungen. Alles, was die KI schreibt, steht im Verlauf mit dem Benutzer des Tokens.

Sicherheit

• Gespeichert wird nur ein Hash des Tokens; ohne gültiges Token antwortet der Server mit 401.
• Ein Token kann jederzeit widerrufen werden. Die Liste zeigt, wann es zuletzt benutzt wurde.
• Setzen Sie externe Partner über ein Token mit Phasen-Beschränkung und „Nur lesen“ ein, wenn Schreiben nicht nötig ist.

Verwandte Anleitungen