Erste Schritte
Integrationen
Füge diesen Prompt als erste Nachricht ein, nachdem du MCP verbunden hast. Er erklärt der KI, was Customermates ist, wie sie sicher agiert, und fragt nach deinem API-Key.
TL;DR — Kopier den Block unten in einen neuen Claude / ChatGPT / Cursor-Chat, sobald MCP verbunden ist. Die KI fragt nach deinem API-Key, prüft, was bereits in deinem CRM liegt, und folgt den Sicherheitsregeln, die versehentlichen Datenverlust verhindern.
Schwächere KI-Assistenten erfinden Toolnamen, löschen Beziehungen durch null-Werte und rufen beim falschen Spaltentyp das falsche Update-Tool auf. Der Prompt unten gibt dem Modell Kontext über:
get_current_user, count_entity, list_custom_columns), damit sich das Modell orientiert, bevor es handelt.Kopier alles im Block, paste ihn in deine erste Nachricht, und folge dem Assistenten.
Du bist jetzt per MCP mit meinem Customermates CRM verbunden.
## Über Customermates
Customermates 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 zugewiesen
Entitä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 nach
1. Meinem Customermates-API-Key — ich paste ihn; nutz ihn im Header `x-api-key` bei jedem MCP-Call.
2. Meinem Namen und meiner Rolle, damit du deine Antworten anpasst.
3. 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 Links zu behalten, `[]` um alle zu löschen, oder `link_entities` / `unlink_entities` für einzelne IDs.
- **Bevorzug `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 Create oder Update**: `get_entity_configuration` aufrufen, um Custom-Column-IDs und Filter-Syntax zu kennen.
- **Destruktive Aktionen bestätigen lassen.** Bei `delete_*` oder allem, was als IRREVERSIBLE markiert ist, frag nach, es sei denn ich habe "mach einfach" gesagt.
## Vorgeschlagene erste Schritte
1. Ruf `get_current_user` und `get_company` auf und sag mir, wer und wo ich arbeite.
2. Ruf `count_entity` für contact, organization, deal, service und task.
3. Ruf `list_custom_columns`, damit wir keine Felder neu anlegen, die bereits existieren.
4. Frag, 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 Tool und Argumente.
- Wenn ich frage "was ist mit X?", nutz erst `search_all_entities`, bevor du den Entity-Typ rätst.
Bereit. Bitte frag nach meinem API-Key.Ein guter Assistent:
get_current_user und get_company auf, bestätigt die Verbindung.count_entity alle fünf Typen und fasst zusammen, was vorhanden ist.Wenn er anfängt zu erstellen, bevor er fragt: Prompt erneut einfügen mit dem Zusatz "du hast die Setup-Routine übersprungen".