Custom Connector

Customermates als Custom MCP Connector in Claude (Web, Desktop, Mobile) oder ChatGPT einrichten: URL einfügen, per OAuth anmelden, freigeben. Ohne API-Key.

Customermates ist ein CRM mit einsehbarem Quellcode, 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?

Jeder Workspace hat eine eigene MCP-URL:

<BASE_URL>/api/v1/mcp/w/<WORKSPACE_ID>

<BASE_URL> ist die Adresse, unter der Sie Customermates öffnen, in der Cloud oder auf Ihrer eigenen Instanz, und <WORKSPACE_ID> benennt den Workspace. Zusammensetzen müssen Sie sie nicht: Customermates zeigt die URL Ihres aktuellen Workspace mit einer Kopierschaltfläche unter API-Schlüssel & Konnektoren, wenn Sie auf Hinzufügen klicken und Claude und dann Claude-Konto wählen (oder ChatGPT & Codex und dann ChatGPT-App), sowie im Onboarding-Schritt Verbinde die KI, die du schon nutzt. Wechseln Sie den Workspace, um die URL eines anderen zu kopieren.

Weil jeder Workspace seine eigene URL hat, können Sie mehrere Workspaces gleichzeitig zu Claude hinzufügen, einen Connector pro Workspace. Claude lehnt einen zweiten Connector mit einer URL ab, die es schon kennt ("A connector with this URL already exists in your organization"), daher braucht ein zweiter Workspace seine eigene URL.

<BASE_URL>/api/v1/mcp funktioniert weiterhin: Die Adresse bietet dieselben Tools, und der Zustimmungsbildschirm fragt, welchen Workspace die Verbindung erhält. Verbindungen, die Sie damit früher hinzugefügt haben, bleiben, wie sie sind.

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 Zustimmungsbildschirm 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 API-Schlüssel & 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 der URL des aktuellen Workspace und einem Connector-Namen, der den Workspace-Namen enthält (nur Claude Web und Teams). Der Onboarding-Schritt Verbinde die KI, die du schon nutzt bietet dieselbe Schaltfläche. Hinzufügen braucht Erstellen auf API & Webhooks; ohne diese Berechtigung fügen Sie die URL wie oben ein.

Wie verbinde ich ChatGPT?

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

  • Name: Customermates
  • URL: die URL Ihres Workspace, <BASE_URL>/api/v1/mcp/w/<WORKSPACE_ID> (welche URL)
  • Authentication: OAuth

Speichern. ChatGPT öffnet ein Customermates-Fenster. Anmelden, dann auf dem Zustimmungsbildschirm 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 API-Schlüssel & 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 Erstellen 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. Customermates prüft den Key bei jeder Anfrage: Mit einem falschen, abgeschnittenen, abgelaufenen oder gelöschten Key antwortet der Server mit HTTP 401 und einem WWW-Authenticate-Header, und nichts wird gelistet; legen Sie dann einen neuen Key an.

Was zeigt der Zustimmungsbildschirm?

Der Connector öffnet ein Customermates-Fenster:

  1. Anmelden

    Oder Sie sind schon angemeldet.

  2. Lesen, was autorisiert wird

    Der Zustimmungsbildschirm mit dem Titel … mit … verbinden 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. Mit der URL eines Workspace zeigt er diesen Workspace mit seinem Avatar, und die Verbindung erhält genau diesen Workspace. Mit <BASE_URL>/api/v1/mcp und mehreren Workspaces fragt er, welchen Workspace die Verbindung erhält; Ihr aktueller Workspace ist vorausgewählt.

  3. Zulassen

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

Sie landen zurück in Ihrer KI, verbunden, mit den Customermates-Tools in der Liste.

Können Sie den Workspace der URL nicht verbinden, nennt der Bildschirm den Grund und bietet nur Ablehnen: Sie sind kein Mitglied (melden Sie sich mit dem Konto an, das Sie dort nutzen), Ihre Anfrage wartet noch auf Genehmigung, Ihr Zugriff ist deaktiviert, Ihre Rolle hat kein Lesen Alle auf API & Webhooks, der Workspace hat kein aktives Abonnement, oder neue Bedingungen müssen akzeptiert werden.

Der Connector akzeptiert jeden Client, daher ist der Zustimmungsbildschirm 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, Ihre Rolle braucht aber wie für jede MCP-Verbindung Lesen Alle auf API & Webhooks; ohne sie lehnt der Screen die Verbindung ab.

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 des auf dem Zustimmungsbildschirm gewählten Workspace und mit den Rechten seiner Rolle dort. API-Keys funktionieren genauso: Sie erben die Berechtigungen des besitzenden Users in dem Workspace, in dem sie erstellt wurden, und es gibt kein Scoping pro Key.
  • Eine Verbindung bleibt samt erneuerter Tokens in ihrem Workspace. Um in mehreren Workspaces zu arbeiten, fügen Sie pro Workspace einen Connector mit der URL dieses Workspace hinzu; sie arbeiten nebeneinander im selben Claude-Konto. Siehe Workspaces.
  • 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 Bearbeiten 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 das Feld Status beim Acme-Deal auf Won und füge eine Notiz hinzu, dass der Vertrag heute unterschrieben wurde."
  • „Welche Kundengespräche warten auf meine Antwort? Entwirf eine Antwort auf das älteste und speichere sie als Entwurf.“

Der Antwort-Prompt braucht einen verbundenen Kanal in Customermates Cloud ab Pro; der Entwurf wartet in der Konversation, bis Sie ihn prüfen und senden.

Jeder Workspace legt seine eigenen Datensatztypen fest, etwa Contacts, Deals oder Tasks, und auch Felder wie die Phase eines Deals oder die Priorität einer Task sind pro Workspace konfigurierbar. Bitten Sie Ihre KI, vor dem Schreiben discover_record_types und get_record_model für die relevanten Felder und erlaubten Werte aufzurufen.

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, ebenso manage_team, dessen remove_member einem Mitglied den Zugriff entzieht. Zu den Tools ohne Flag gehören send_email, send_chat_message, request_support, manage_social_relations, publish_social_post und comment_on_social_post, 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?

SymptomUrsacheLösung
"Couldn't register with the sign-in service" (Claude) oder "Connector verification failed" (ChatGPT)URL falsch oder nicht erreichbarKopieren Sie die URL erneut aus Customermates (welche URL), oder nutzen Sie exakt <BASE_URL>/api/v1/mcp, mit der Adresse, unter der Sie Customermates öffnen, als <BASE_URL>
"A connector with this URL already exists in your organization" (Claude)Diese URL ist schon verbunden, eventuell für einen anderen WorkspaceFügen Sie den anderen Workspace mit seiner eigenen URL hinzu, kopiert, während dieser Workspace geöffnet ist
Die URL eines Workspace antwortet mit HTTP 401 und error="invalid_token"Die Verbindung wurde für einen anderen Workspace freigegebenNeu verbinden; der Client meldet sich erneut für den Workspace der URL an
Die URL eines Workspace antwortet mit HTTP 403 und error: workspace_mismatch (Key im Header)Der API-Key gehört zu einem anderen WorkspaceNutzen Sie die URL des Workspace, zu dem der Key gehört, oder legen Sie in diesem Workspace einen Key an
Der Connector listet keine Tools, und der Server antwortet mit HTTP 401 (ChatGPT mit Header)Der Wert von x-api-key ist falsch, abgeschnitten, abgelaufen oder gelöschtUnter API-Schlüssel & Konnektoren einen neuen Key anlegen und die vollständigen 64 Zeichen einfügen
Jeder Aufruf, der Workspace-Daten liest oder ändert, meldet „Your user account is inactive. Contact a workspace administrator.“Ihr Customermates-User steht auf InaktivEin Mitglied mit Bearbeiten auf Benutzer & Rollen setzt Sie unter Mitglieder wieder auf Aktiv
Kein "Add custom connector"-EintragFree-PlanChatGPT braucht einen bezahlten Plan; Claude Free erlaubt einen Custom Connector, entfernen Sie also zuerst einen anderen. Siehe die CLI-Methode
Freigegeben, aber nichts verbindetSie haben aus einem anderen Konto freigegebenIns richtige Customermates-Konto anmelden, dann erneut versuchen
"Tool not found"Connector-Cache veraltetConnector entfernen und neu hinzufügen
Server lehnt Verknüpfung abDie Beziehungs-ID oder ein Endpunkt fehlt oder ist nicht zugänglichDen Agenten bitten, get_record_model zu lesen und dann mutate_crm_record mit link oder unlink zu verwenden
Auswahlfeld abgelehntWert nicht in der Optionsliste des FeldsDen Agenten bitten, vorher get_record_model aufzurufen
Ein Messaging-, Kalender- oder Social-Tool wird mit einer Tarif-Meldung abgelehntDer Workspace hat keinen Tarif mit Messaging (Starter, selbst gehostet, oder kein aktives Abonnement und keine laufende Testphase)In der Cloud wählt ein Mitglied mit Bearbeiten bei Unternehmen unter Abrechnung Pro oder höher. Selbst gehostete Instanzen haben kein Messaging; für diese Tools nutzen Sie Customermates Cloud

Im Free-Plan oder in einem CLI?

ChatGPT braucht für Custom Connectors einen bezahlten Plan (Claude Free erlaubt einen), 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.