• Customermates Logo
    CustomermatesDocumentation
  • Einführung
  • Vergleich
Erste Schritte
  • Quickstart
  • Kernkonzepte
  • Von Pipedrive
KI verbinden
  • Claude Code verbinden
  • Claude Desktop verbinden
  • Codex verbinden
  • Cursor verbinden
  • ChatGPT verbinden
Integrationen
  • MCP
  • Webhooks
  • OpenAPI 3.1.0
  • N8N
Self-Hosting
  • Get Started
  • Architektur & Sicherheit
Reference
  • MCP-Tool-Katalog
  • Filter-Syntax
  • API-Keys
  • Zurück
  1. Einführung
  2. Claude Desktop verbinden

Claude Desktop verbinden

Customermates als MCP-Server in Claude Desktop. Eine Konfigurationsdatei bearbeiten, neu starten, Setup-Prompt einfügen.

Die "Custom Connectors"-UI in Claude Desktop unterstützt nur OAuth — keine statischen API-Header. Daher gehen wir über die Konfigurationsdatei mit dem mcp-remote-Shim. Ein JSON-Block, ein Neustart.

Wenn du Claude Code (das CLI) nutzt, siehe die Claude Code-Seite — dort reicht ein einziger Terminal-Befehl.

1. API-Key anlegen

In Customermates: Profil → API Keys → Neuer Key. Gib ihm einen Namen, der den Client beschreibt (z.B. Claude Desktop). Der 64-Zeichen-Key wird einmal angezeigt — sofort kopieren.

2. Konfigurationsdatei bearbeiten

Claude → Settings → Developer → Edit Config öffnen, oder die Datei direkt:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Diesen Block mergen, YOUR_KEY ersetzen:

{  "mcpServers": {    "customermates": {      "command": "npx",      "args": [        "-y",        "mcp-remote",        "https://customermates.com/api/v1/mcp",        "--header",        "x-api-key:YOUR_KEY"      ]    }  }}

Bei Self-Host: URL durch deine Instanz ersetzen.

mcp-remote ist ein kleiner Shim, der Claude Desktop per stdio mit einem Remote-HTTP-MCP-Server sprechen lässt. Er wird beim ersten Aufruf via npx heruntergeladen; du brauchst Node 18+ im PATH.

3. Claude Desktop neu starten

Vollständig beenden (⌘Q auf macOS, nicht nur Fenster schließen) und neu öffnen. Customermates erscheint im Tools-Panel mit allen CRM-Tools.

4. Diesen Setup-Prompt als erste Nachricht einfügen

Du bist jetzt per MCP mit meinem Customermates CRM verbunden.## Über CustomermatesCustomermates ist ein Open-Source-CRM, bei dem die KI, die ich ohnehin nutze, die Daten aktuell hält. Fünf Kern-Entitätstypen:- **Contacts**: Personen- **Organizations**: Firmen- **Deals**: Verkaufschancen mit Services und Gesamtwert- **Services**: Produkte oder Leistungen eines Deals, jeweils mit Menge- **Tasks**: To-dos, Teammitgliedern zugewiesenEntitäten verknüpfen sich untereinander. Ein Contact gehört zu einer oder mehreren Organizations und Deals. Ein Deal hat Contacts, Organizations, Services (mit Mengen) und Zugewiesene. Ein Task hat nur Zugewiesene. Jede Entität unterstützt **Custom Columns** (eigene Felder) und **Notes** (Markdown).## Bevor du etwas tust, frag mich nach1. Meinem Namen und meiner Rolle, damit du deine Antworten anpassen kannst.2. Wofür ich mein CRM typischerweise nutze, in einem Satz.## Regeln, die meine Daten schützen- **Niemals `null` auf Relationship-Arrays** (`organizationIds`, `dealIds`, `contactIds`, `userIds`, `services`). Null löscht die Beziehung. Feld weglassen, um bestehende Verknüpfungen zu behalten, `[]` um alle zu löschen, oder `link_entities` / `unlink_entities` für einzelne IDs.- **Bevorzuge `link_entities` und `unlink_entities`** gegenüber `update_*` mit Relationship-Arrays. Sie mergen statt zu ersetzen.- **Custom Fields sind per-Column-Merge**. Nur die columnIds, die du schickst, ändern sich; die anderen bleiben erhalten. Um ein Feld zu leeren: `{ columnId, value: null }`.- **Nutze das richtige per-Type-Custom-Column-Tool**. `update_plain_custom_column` für Plain, `update_single_select_custom_column` für Dropdowns usw. Der Server sagt dir, wenn du das falsche gewählt hast.- **Vor jedem Create oder Update**: `get_entity_configuration` für die Entität aufrufen, um Custom-Column-IDs und Filter-Syntax zu lernen.- **Destruktive Aktionen bestätigen lassen.** Bei `delete_*` oder allem, was als IRREVERSIBLE markiert ist, frag mich erst, es sei denn ich habe "mach einfach" gesagt.## Vorgeschlagene erste Schritte1. Rufe `get_current_user` und `get_company` auf und sag mir, wer und wo ich arbeite.2. Rufe `count_entity` für contact, organization, deal, service und task auf.3. Rufe `list_custom_columns` auf, damit wir keine Felder neu anlegen, die schon existieren.4. Frag mich, woran ich zuerst arbeiten will.## Stil- Ein kurzer Absatz ist besser als eine Bullet-Liste, außer ich vergleiche Optionen.- Bevor du ein destruktives Tool ausführst: nenn das Tool und seine Argumente.- Wenn ich frage "was ist mit X?", nutze erst `search_all_entities`, bevor du den Entity-Typ rätst.Bereit. Bitte frag mich, womit ich anfangen will.

Der Agent orientiert sich und wartet auf Anweisungen.

Probier deinen ersten echten Prompt

  • "Verschieb den Acme-Deal in Stage 'Won' und füge eine Notiz hinzu, dass der Vertrag heute unterschrieben wurde."
  • "Hol die letzten zehn Contacts, die ich angelegt habe. Welche haben keine E-Mail-Adresse?"
  • "Leg einen Contact für Jane Doe bei Initech an, verknüpf ihn mit der Initech-Org und starte einen Deal über 12 Stunden Beratung."

Troubleshooting

SymptomUrsacheLösung
Tools-Panel ist leerClaude wurde nicht neu geladenVollständig beenden und neu öffnen
npx: command not foundKein Node im PATHNode 18+ von nodejs.org installieren
"Invalid API key"Falsche Key-LängeIn Profil → API Keys neu erstellen
Server lehnt Relationship-Update abNull-Wipe-Schutz hat ausgelöst (gewollt)Claude bitten, link_entities / unlink_entities zu nutzen

Tipps

  • Claude Desktop lädt MCP-Configs nicht hot. Nach jeder Änderung beenden und neu öffnen.
  • Pro Client einen eigenen API-Key, wenn du Audit-Log-Granularität willst.
  • Für mehrere Customermates-Konten einen zweiten customermates-<tenant>-Block mit dem jeweiligen Key anlegen.

Weiter

  • MCP-Tool-Katalog: jedes Tool, das Claude aufrufen kann.
  • Webhooks: andere Systeme über CRM-Änderungen informieren.
  • Cursor verbinden: gleicher Server, anderer Client.
1. API-Key anlegen
2. Konfigurationsdatei bearbeiten
3. Claude Desktop neu starten
4. Diesen Setup-Prompt als erste Nachricht einfügen
Probier deinen ersten echten Prompt
Troubleshooting
Tipps
Weiter