Custom Connector

Customermates ist ein Open-Source-CRM, nativ für KI gebaut, und Ihre KI bedient es direkt über MCP. Der Custom Connector ist der einfachste Weg zu verbinden: eine URL einfügen, bei Customermates anmelden, Zugriff freigeben. Es gibt keinen API-Key zum Kopieren, keine Konfigurationsdatei zum Bearbeiten und kein Shim zum Installieren. Sie autorisieren einmal, und die Verbindung bleibt bestehen.

Das ist der empfohlene Weg für Claude (Web, Desktop und Mobile) und ChatGPT. Auf einem CLI oder Editor (Claude Code, Codex, Cursor, Gemini CLI) nutzen Sie stattdessen die API-Key-Methode.

Welche URL füge ich ein?

<BASE_URL>/api/v1/mcp

<BASE_URL> ist die Adresse, unter der Sie Customermates öffnen, in der Cloud oder auf Ihrer eigenen Instanz. Der Connector funktioniert in jedem Customermates-Tarif und auf selbst gehosteten Instanzen; nur die Messaging-, Kalender- und Social-Tools brauchen einen Tarif mit Messaging, ab Pro in der Cloud.

Wie verbinde ich Claude mit dem Customermates-CRM?

Um Claude mit Ihrem CRM zu verbinden, fügen Sie Customermates in Claude als Custom Connector hinzu:

1. Connector-Formular öffnen

   Claude → Settings → Connectors → Add custom connector.

2. URL einfügen

   Authentifizierung auf der Voreinstellung (OAuth) lassen. Kein Header, kein Key.

3. Anmelden und zulassen

   Ein Customermates-Fenster öffnet sich. Anmelden, dann auf dem Screen Zugriff autorisieren auf Zulassen klicken.

4. Tools prüfen

   Zurück in Claude erscheint Customermates mit seinen Tools.

Einmal hinzufügen, und es synchronisiert zu Claude auf Web, Desktop und Mobile. Die Verbindung hängt an Ihrem Claude-Konto, nicht an einem Gerät, und erneuert sich im Hintergrund.

Noch schneller: Öffnen Sie in Customermates Mein Profil → API & Konnektoren, klicken Sie auf Hinzufügen, wählen Sie unter Schnellverbindungen Claude und dann Claude-Konto, und klicken Sie auf Zu Claude hinzufügen. Das öffnet den Add-Connector-Dialog von Claude, vorausgefüllt mit Ihrer <BASE_URL>/api/v1/mcp (nur Claude Web und Teams). Der Onboarding-Schritt KI verbinden bietet dieselbe Schaltfläche. Hinzufügen braucht Verwalten auf API & Webhooks; ohne diese Berechtigung fügen Sie die URL wie oben ein.

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). Die Kacheln der Schnellverbindungen und Zu Claude hinzufügen sind keine Highlight-Ziele, deshalb nennt Mate sie beim Namen.

Wie verbinde ich ChatGPT?

Um ChatGPT zu verbinden, öffnen Sie in ChatGPT: Settings → Connectors → Add connector → Custom connector (MCP).

• Name: Customermates
• URL: <BASE_URL>/api/v1/mcp
• Authentication: OAuth

Speichern. ChatGPT öffnet ein Customermates-Fenster. Anmelden, dann auf dem Screen Zugriff autorisieren auf Zulassen klicken. Jedes Customermates-Tool wird gelistet, und es gibt keinen Key zu speichern oder zu rotieren.

Kann ChatGPT statt OAuth einen API-Key nutzen?

Ja. Fügen Sie den Connector genauso hinzu, aber authentifizieren Sie sich per Header:

1. Key anlegen

   Öffnen Sie in Customermates Mein Profil → API & Konnektoren, klicken Sie auf Hinzufügen und wählen Sie Standard-API-Key. Der 64-Zeichen-Key wird einmal angezeigt, also sofort kopieren. 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.

2. Per Header authentifizieren

   Im Connector-Formular Authentication: Header, Header name: x-api-key, Header value: Ihr Key.

Speichern. ChatGPT erreicht den Server und listet jedes Tool. Das geschieht auch mit einem falschen Key, weil Customermates den Key erst prüft, wenn ein Tool Workspace-Daten liest oder ändert; meldet danach jeder solche Aufruf „Sign in to use this action.“ (die Meldung kommt auf Englisch), ist der Key falsch, abgeschnitten, abgelaufen oder gelöscht, und Sie legen einen neuen an. Eine Doku-Abfrage wie search_docs antwortet auch mit einem falschen Key und beweist deshalb nicht, dass der Key funktioniert.

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.

Was zeigt der Screen Zugriff autorisieren?

Der Connector öffnet ein Customermates-Fenster:

1. Anmelden

   Oder Sie sind schon angemeldet.

2. Lesen, was autorisiert wird

   Der Screen Zugriff autorisieren nennt die App, die sich verbindet, listet, was sie anfordert (etwa Deine Identität bestätigen, Dein Basisprofil lesen, Deine E-Mail-Adresse lesen und Verbunden bleiben, während du abwesend bist), und zeigt unter Verbindungsziel den Host, an den der Zugriff geht.

3. Zulassen

   Klicken Sie auf Zulassen, oder auf Ablehnen, um abzulehnen.

Sie landen zurück in Ihrer KI, verbunden, mit allen 50 Tools in der Liste.

Der Connector akzeptiert jeden Client, daher ist der Screen Zugriff autorisieren die Kontrolle. Geben Sie nur eine Verbindung frei, die Sie selbst gestartet haben, und klicken Sie bei allem, was Sie nicht gestartet haben, auf Ablehnen. Die Verbindung per OAuth braucht keinen API-Key und keine zusätzliche Rollenberechtigung.

Wie lange bleibt die Verbindung gültig?

• Einmal in Claude Web hinzufügen, und es erscheint auch auf Desktop und Mobile. Die Verbindung hängt an Ihrem Claude-Konto, nicht an einem Gerät.
• Sie erneuert sich im Hintergrund. Nutzen Sie sie innerhalb von 30 Tagen, und Sie autorisieren nie neu; bleiben Sie länger untätig, und Sie geben einmal mehr frei.
• Jeder Aufruf läuft als der Customermates-User, der freigegeben hat, innerhalb der Daten dieses Kontos und mit den Rechten seiner Rolle. API-Keys funktionieren genauso: Sie erben die Berechtigungen des besitzenden Users, und es gibt kein Scoping pro Key.
• Wird dieser User auf Inaktiv gesetzt, scheitert jeder Aufruf, der Workspace-Daten liest oder ändert, mit „Your user account is inactive. Contact a workspace administrator.“, bis ein Mitglied mit Verwalten auf Benutzer & Rollen ihn wieder auf Aktiv setzt.

Was probiere ich zuerst?

Der Server sendet seine Instructions an Ihre KI, sobald sie sich verbindet, sodass der Client Workflow und Sicherheitsregeln bereits kennt. In Clients, die MCP-Prompts unterstützen (etwa Claude), können Sie zusätzlich den eingebauten get-started-Prompt starten, der den Start personalisiert: Ihr Name, Ihre Rolle und eine erste Zusammenfassung Ihres Workspace.

• "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."
• "Setz die Spalte Status beim Acme-Deal auf Won und füge eine Notiz hinzu, dass der Vertrag heute unterschrieben wurde."

Die Datensatztypen sind Contact, Organization, Deal, Service und Task. Felder wie der Status eines Deals oder die Priorität eines Tasks sind pro Workspace konfigurierbare Custom Columns, keine festen Produktfelder. Bitten Sie Ihre KI, get_record_schema aufzurufen, um die Spalten und ihre erlaubten Werte zu sehen, bevor sie schreibt.

Tool-Aufrufe bestätigen: Welche kann ich immer erlauben?

Customermates hält einen Tool-Aufruf nie an, um nachzufragen; das tut Ihr Client, und Sie steuern es dort. In Claude: Settings → Connectors → Customermates, dann setzen Sie jedes Tool (oder die read-only-Gruppe) auf Always allow oder Ask.

• Lesende Tools (get_*, list_*, search_*) tragen das Read-only-Flag und lassen sich ohne Risiko erlauben.
• Tools, die löschen können, tragen das destruktive Flag und nennen IRREVERSIBLE.
• Tools, die nur anlegen, ändern oder versenden, tragen keines der beiden Flags; zusammengeführte Tools mit einer Delete-Action, etwa manage_webhooks, tragen das destruktive Flag. Zu den Tools ohne Flag gehören send_email, send_chat_message, request_support, die Einladungen von manage_team und das Tool manage_social_relations, die echte Menschen erreichen, sowie move_email_thread, das E-Mails im echten Postfach verschiebt.

Lassen Sie jedes Tool, das nicht read-only ist, auf Ask. Die vollständige Liste steht im MCP-Tool-Katalog.

Was tun, wenn die Verbindung scheitert?

Link: die Seite API & Konnektoren, /profile/api-keys, die Seite Mitglieder, /company/members, und die Seite Abonnement, /company/subscription (nur Cloud). Mate: navigate und highlight_element mit nav-profile-api-keys, nav-company-members oder nav-company-subscription. profile-api-keys-generate hebt Hinzufügen auf der API-Seite hervor (Rollen mit Verwalten auf API & Webhooks); 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), und company-subscription-plan-picker umrahmt die Tarifkarten, solange die Tarifauswahl angezeigt wird.

Im Free-Plan oder in einem CLI?

Custom Connectors brauchen einen bezahlten Plan, und CLI- und Editor-Clients nutzen den Connector-Flow gar nicht. Beide authentifizieren sich stattdessen mit einem API-Key: siehe CLI & Editoren. Claude Desktop im Free-Plan kann den Konfigurationsdatei-Fallback nutzen.

Weiter

• MCP-Tool-Katalog: jedes Tool, das Ihre KI aufrufen kann.
• Webhooks: die andere Hälfte der agentischen Schleife.
• CLI & Editoren: API-Key-Setup für Claude Code, Codex, Cursor und Gemini CLI.

Grok Bot

Grok Bot kann Customermates über seinen Browser bedienen. Bitten Sie ihn, Ihre Customermates-URL zu öffnen, übernehmen Sie bei Aufforderung die Anmeldung und beschreiben Sie anschließend die Aufgabe. Prüfen Sie Entwürfe vor dem Versand. Dieser Browser-Ablauf benötigt keinen neuen Customermates-API-Schlüssel.

Grok Bot und die Konnektoren im Grok-Chat werden unterschiedlich eingerichtet. Fügen Sie im Grok-Chat einen eigenen MCP-Konnektor mit <BASE_URL>/api/v1/mcp hinzu und schließen Sie die Authentifizierung ab. Siehe die offizielle Grok-Bot-Anleitung und Grok-Konnektor-Anleitung.