CLI & Editoren

Customermates ist das Open-Source-KI-CRM. Einmal verbunden, liest und schreibt Ihr Coding-Agent Contacts, Deals und Notizen, ohne das Terminal zu verlassen. Alle Clients auf dieser Seite authentifizieren sich gleich: mit einem API-Key im x-api-key-Header gegen <BASE_URL>/api/v1/mcp, wobei <BASE_URL> die Adresse ist, unter der Sie Customermates öffnen, in der Cloud oder auf Ihrer eigenen Instanz. Die Snippets unten enthalten bereits die Adresse der Seite, auf der Sie diese Doku lesen; öffnen Sie Customermates unter einer anderen Adresse, etwa auf Ihrer eigenen Instanz, ersetzen Sie neben YOUR_KEY auch diese Adresse.

API-Key anlegen

Öffnen Sie in Customermates Mein Profil → API & Konnektoren, klicken Sie auf Hinzufügen und wählen Sie Standard-API-Key. Geben Sie ihm einen Namen, der den Client beschreibt (z.B. Claude Code); ohne Datum unter Läuft ab läuft er nie ab. Der 64-Zeichen-Key wird einmal angezeigt, also sofort kopieren. Die Schnellverbindungen im selben Dialog erledigen das automatisch: Dort wird der Key nach dem Client benannt, läuft nach 365 Tagen ab und steht bereits im angezeigten Setup-Snippet; darunter steht sein Ablaufdatum. Zum Anlegen eines Keys braucht Ihre Rolle Verwalten auf Ja in der Zeile API & Webhooks, und die Seite selbst braucht Lesen Alle in dieser Zeile; die eingebaute Rolle Admin hat beides. Siehe API-Keys. Ein Key erbt die Berechtigungen des Users, der ihn erstellt hat; einen Scope pro Key gibt es nicht. Legen Sie pro Client einen eigenen Key an, damit Sie einen Client einzeln widerrufen können, ohne die anderen zu treffen; das Audit-Log protokolliert den User, dem ein Key gehört, nicht den Key selbst. API-Keys und MCP funktionieren in jedem Tarif und auf selbst gehosteten Instanzen.

Link: die Seite API & Konnektoren, /profile/api-keys. Mate: navigate und highlight_element mit nav-profile-api-keys; highlight_element nimmt außerdem profile-api-keys-generate für Hinzufügen an (Rollen mit Verwalten auf API & Webhooks), danach api-key-option-standard für Standard-API-Key (Voraussetzung profile-api-keys-generate) sowie api-key-name, api-key-expires und api-key-save für Name, Läuft ab und Speichern (Voraussetzung api-key-option-standard). Die Kacheln der Schnellverbindungen sind keine Highlight-Ziele, deshalb nennt Mate sie beim Namen.

Claude Code

Claude Code fügt MCP-Server über sein CLI hinzu. Ein Befehl erledigt das Setup. In einem beliebigen Terminal ausführen, YOUR_KEY ersetzen:

claude mcp add --transport http customermates https://customermates.com/api/v1/mcp \
  --header "x-api-key: YOUR_KEY"

Kein Neustart, keine Konfigurationsdatei. Claude Code verbindet sich automatisch. Mit claude mcp list prüfen, dass customermates aufgeführt ist.

Scope: Der Befehl nutzt standardmäßig den lokalen Scope. Mit --scope user ist Customermates auf Ihrer Maschine überall verfügbar, mit --scope project landet die Konfiguration in der .mcp.json des Repos, sodass Teammitglieder sie übernehmen.

Codex

Das Codex CLI von OpenAI nutzt eine TOML-Konfigurationsdatei. Der codex mcp add-Befehl unterstützt nur stdio-Server. Für einen HTTP-MCP-Server wie Customermates fügen Sie den Block manuell ein. ~/.codex/config.toml öffnen (anlegen falls nötig) und anhängen, YOUR_KEY ersetzen:

[mcp_servers.customermates]
enabled = true
url = "https://customermates.com/api/v1/mcp"
http_headers = { "x-api-key" = "YOUR_KEY" }

Um den Key aus einer Umgebungsvariable zu lesen, statt ihn in der Datei zu speichern, ersetzen Sie die http_headers-Zeile im Block oben durch:

env_http_headers = { "x-api-key" = "CUSTOMERMATES_API_KEY" }

Dann CUSTOMERMATES_API_KEY im Shell-Profil exportieren. Neue Sessions erkennen den Server, also die aktuelle beenden und eine neue starten.

Cursor

Settings → Tools & MCP → Add new MCP server öffnen und Folgendes einfügen, YOUR_KEY ersetzen:

{
  "customermates": {
    "url": "https://customermates.com/api/v1/mcp",
    "headers": {
      "x-api-key": "YOUR_KEY"
    }
  }
}

Cursor lädt hot: kein Neustart nötig, die Tools erscheinen direkt im Composer. Um die Datei direkt zu bearbeiten, kommt derselbe Block in ~/.cursor/mcp.json (global) oder <project>/.cursor/mcp.json (pro Projekt), eingebettet unter mcpServers.

Gemini CLI

Die Gemini CLI lädt MCP-Server aus ~/.gemini/settings.json. Folgendes mergen, YOUR_KEY ersetzen:

{
  "mcpServers": {
    "customermates": {
      "httpUrl": "https://customermates.com/api/v1/mcp",
      "headers": {
        "x-api-key": "YOUR_KEY"
      }
    }
  }
}

Falls mcpServers bereits Einträge enthält, fügen Sie customermates daneben ein, statt das Objekt zu überschreiben.

Claude Desktop (config file)

Der empfohlene Weg für Claude Desktop ist der Connector-Weg: OAuth, kein Key, über Ihre Geräte synchronisiert. Im Free-Plan, oder wenn Sie lieber einen statischen Key nutzen, funktioniert die Konfigurationsdatei unten auch.

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"
      ]
    }
  }
}

mcp-remote ist ein Shim, der Claude Desktop über stdio mit einem Remote-HTTP-MCP-Server sprechen lässt. Er wird beim ersten Aufruf via npx heruntergeladen, Sie brauchen also Node 18+ im PATH.

Danach neu starten: vollständig beenden (⌘Q auf macOS, nicht nur das Fenster schließen) und neu öffnen. Customermates erscheint im Tools-Panel mit den CRM-Tools.

Probieren Sie Ihren ersten Prompt

Der Server stellt beim Verbinden Anweisungen zur Tool-Oberfläche, zu Sicherheitsregeln und zum Abruf relevanter Wissensdatenbank-Seiten bereit. Der jeweilige Client entscheidet, ob er diese Anweisungen an seinen Agent weitergibt. Tut er das nicht, ergänzen Sie die Wissensdatenbank-Abrufregel in den dauerhaften Anweisungen dieses Clients. In Clients, die MCP-Prompts unterstützen (etwa Claude Code), können Sie den eingebauten get-started-Prompt für einen geführten Start nutzen: Er liest zuerst Ihren Workspace und relevante Wissensdatenbank-Seiten und fragt nur nach fehlenden Informationen.

• "Setz die Status-Spalte des Acme-Deals auf '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-Organisation und starte einen Deal über 12 Stunden Beratung."

Die verfügbaren Record-Typen sind Contact, Organization, Deal, Service und Task. Deals und Tasks haben kein festes Pipeline-Feld. Attribute wie der Status eines Deals oder die Priorität eines Tasks sind konfigurierbare Custom Columns, die Werte in einem Prompt hängen also davon ab, wie Ihr Workspace eingerichtet ist. Rufen Sie get_record_schema auf, um die Spalten zu sehen, die ein Record-Typ aktuell hat.

Troubleshooting

Link: die Seite API & Konnektoren, /profile/api-keys, und die Seite Mitglieder, /company/members. Mate: navigate und highlight_element mit nav-profile-api-keys oder nav-company-members, und highlight_element mit profile-api-keys-generate für Hinzufügen (Rollen mit Verwalten auf API & Webhooks); die Key-Karten und die Zeilen der Mitglieder sind keine Highlight-Ziele, deshalb nennt Mate sie beim Namen; ist eine Mitgliedszeile geöffnet, heben member-modal-status Status und member-modal-save Speichern im Dialog Benutzer hervor (Rollen mit Verwalten auf Benutzer & Rollen).

Weiter

• Custom Connector: der OAuth-Weg für die Apps von Claude und ChatGPT.
• MCP-Tool-Katalog: jedes Tool, das der Agent aufrufen kann.
• Webhooks: andere Systeme über CRM-Änderungen informieren.