• Customermates Logo
    CustomermatesDocumentation
  • Einführung
  • Vergleich
Erste Schritte
  • Quickstart
  • Kernkonzepte
  • Von Pipedrive
KI verbinden
  • Claude Code verbinden
  • Claude Desktop verbinden
  • Codex verbinden
  • Cursor verbinden
  • Gemini 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. Gemini verbinden

Gemini CLI verbinden

Customermates über ~/.gemini/settings.json an die Gemini CLI anbinden.

Die Gemini CLI lädt MCP-Server aus ~/.gemini/settings.json. Eine Datei-Bearbeitung, dann Session starten und Setup-Prompt einfügen.

1. API-Key anlegen

In Customermates: Profil → API Keys → Neuer Key. Gib ihm einen Namen (z.B. Gemini CLI). Der 64-Zeichen-Key wird einmal angezeigt. Sofort kopieren.

2. Server in settings.json eintragen

~/.gemini/settings.json öffnen. Folgendes einfügen, YOUR_KEY ersetzen:

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

Bei Self-Host: URL durch deine Instanz ersetzen.

Falls mcpServers bereits Einträge enthält, customermates daneben einfügen, nicht überschreiben.

3. Setup-Prompt als erste Nachricht senden

gemini in einem Terminal starten und das hier als erste Nachricht senden:

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.

Warum Customermates in Gemini

Der Gemini-CLI-Agent läuft im selben Terminal, in dem du sowieso arbeitest. Das CRM wird zu einem weiteren Tool in derselben Session: einen Call loggen, ohne die App zu wechseln, eine Deal-Stage zwischen zwei Commits verschieben, prüfen, wer gerade blockiert ist, während du das Repo des Kunden liest.

Probier deinen ersten echten Prompt

  • "Verschieb den Acme-Deal in Stage 'Won' und füge eine Notiz hinzu, dass der Vertrag heute unterschrieben wurde."
  • "Find Contacts in der Org für das Repo, in dem ich gerade bin."
  • "Log einen Task, dem Bug-Report nachzugehen, den wir eben besprochen haben."

Troubleshooting

SymptomLösung
Server wird nicht erkanntgemini neu starten, JSON-Syntax prüfen
"Invalid API key"In Profil → API Keys neu erstellen
Tool-Calls laufen in TimeoutHTTPS_PROXY in der Shell setzen, in der gemini gestartet wurde

Weiter

  • MCP-Tool-Katalog
  • Claude Code verbinden
  • Cursor verbinden
1. API-Key anlegen
2. Server in settings.json eintragen
3. Setup-Prompt als erste Nachricht senden
Warum Customermates in Gemini
Probier deinen ersten echten Prompt
Troubleshooting
Weiter