• 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. Quickstart

Quickstart

Von der Registrierung bis zum ersten KI-aktualisierten Deal in fünf Minuten.

Account anlegen, API-Key erzeugen, Customermates mit deinem KI-Tool verbinden, Setup-Prompt einfügen. Fünf Minuten.

1. Account anlegen

customermates.com/auth/signup. Keine Kreditkarte. Erste sieben Tage kostenlos; danach wählst du einen Plan.

2. API-Key erzeugen

Profil → API Keys → Neuer Key. Die 64 Zeichen sofort kopieren — sie werden nur einmal angezeigt.

3. Customermates mit deinem KI-Tool verbinden

Die Seite für dein Tool öffnen:

  • Claude Code — ein Terminal-Befehl (am einfachsten)
  • Cursor — Settings-UI, zwei Klicks
  • Codex — ein TOML-Block in ~/.codex/config.toml
  • Claude Desktop — Konfigurationsdatei + Neustart
  • ChatGPT — Custom Connector UI (bezahlter Plan)

Jede Seite ist ein 3-Schritt-Vorgang, der mit demselben Setup-Prompt endet.

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

Nachdem du den Server registriert hast, das hier zuerst an deinen Agent 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.

Er erklärt dem Agent, wie er sicher mit deinem CRM arbeitet — keine Relationship-Wipes, richtiges Tool pro Custom-Column-Typ, etc.

5. Einen echten Prompt probieren

  • "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."

Der Agent sagt dir, welche Tools er genutzt hat und was sich geändert hat. Kein Copy-Paste, kein App-Wechsel.

6. Optional: einen Webhook abonnieren

Sollen andere Tools Bescheid wissen, wenn sich im CRM etwas ändert?

Unternehmen → Webhooks → Neu. URL: eine Einweg-webhook.site. Events: contact.created und deal.updated. Speichern.

Einen Contact bearbeiten. Innerhalb von Sekunden landet die Delivery auf webhook.site mit voller Payload. So erzählt dein CRM dem Rest deines Stacks, was sich geändert hat.

Volle Webhook-Docs: Webhooks.

Weiter

  • Kernkonzepte: Entitäten, Custom Columns, Beziehungen auf einen Blick.
  • Von Pipedrive: Migrations-Guide.
  • MCP-Tool-Katalog: jedes Tool, das deine KI aufrufen kann.
1. Account anlegen
2. API-Key erzeugen
3. Customermates mit deinem KI-Tool verbinden
4. Diesen Setup-Prompt als erste Nachricht einfügen
5. Einen echten Prompt probieren
6. Optional: einen Webhook abonnieren
Weiter