KI-Apps verbinden (MCP)

Der MonoChat MCP Server lässt eine KI-App, die das Model Context Protocol (MCP) unterstützt, etwa Claude Code oder Cursor, mit Ihrem MonoChat-Konto arbeiten. Die KI-App fragt MonoChat über einen festen Satz an Tools nach Daten; sie sieht nur, was Sie selbst sehen können.

Der MonoChat MCP Server ist in jedem Tarif verfügbar, ohne tarifabhängige Limits.

Eine Verbindung handelt in Ihrem Namen

Eine KI-App, die mit Ihrem Zugriffsschlüssel verbunden ist, handelt als Ihr Nutzer. Sie erreicht die Tenants, auf die Sie Zugriff haben, und nichts darüber hinaus. Widerrufen Sie Verbindungen, die Sie nicht mehr nutzen.

Was die KI-App tun kann

Diese Tools stehen jeder Verbindung zur Verfügung:

Tool	Was es tut
list_tenants	Listet die Tenants auf, auf die die Verbindung zugreifen kann.
list_sessions	Listet die Unterhaltungssitzungen eines Tenants auf, neueste zuerst, optional nur opened, assigned oder closed.
get_session	Gibt eine Unterhaltungssitzung zurück.
list_messages	Listet die Nachrichten einer Sitzung auf, neueste zuerst.
search_customers	Durchsucht die Kunden eines Tenants nach einem Stichwort.
list_message_templates	Listet die Nachrichtenvorlagen eines Kanals eines Tenants auf.

Nachrichtentexte stammen von Kunden und Mitarbeitenden. Sie sind Daten, die die KI-App liest, keine Anweisungen.

Eine Verbindung hat einen Umfang, Nur lesen oder Lesen und schreiben. Eine Verbindung mit Nur lesen sieht nie Tools, die Daten ändern. Alle oben aufgeführten Tools lesen nur.

Verbindung erstellen

Eine Verbindung gehört zu Ihrem Konto, nicht zu einem Tenant. Sie müssen zuvor die Zwei-Faktor-Verifizierung (per E-Mail oder Authenticator-App) eingerichtet haben.

1. Öffnen Sie Ihre Profileinstellungen, wählen Sie den Tab MCP-Verbindungen und klicken Sie auf Erstellen.
2. Geben Sie einen Namen ein, wählen Sie den Umfang (standardmäßig Nur lesen) und die Gültigkeit in Tagen (standardmäßig 90, höchstens 365).
3. Geben Sie den 6-stelligen Bestätigungscode Ihrer Zwei-Faktor-Methode ein. Bei E-Mail-Verifizierung klicken Sie zuerst auf Bestätigungscode senden.
4. Kopieren Sie den Zugriffsschlüssel. Er wird nur einmal angezeigt und beginnt mit mcp_sk_.

Sie können bis zu 10 aktive Verbindungen haben.

KI-App verbinden

Der Server befindet sich unter https://app.monochat.ai/api/mcp-server (verwenden Sie Ihre eigene MonoChat-Adresse, wenn Sie MonoChat auf eigenen Servern betreiben) und erwartet den Zugriffsschlüssel als Bearer-Token im Header Authorization.

Claude Code

claude mcp add --transport http monochat https://app.monochat.ai/api/mcp-server \
  --header "Authorization: Bearer <access key>"

Cursor

Fügen Sie den Server in ~/.cursor/mcp.json hinzu:

{
  "mcpServers": {
    "monochat": {
      "url": "https://app.monochat.ai/api/mcp-server",
      "headers": { "Authorization": "Bearer <access key>" }
    }
  }
}

Jeder andere MCP-Client, der den Streamable-HTTP-Transport und eigene Header unterstützt, verbindet sich auf dieselbe Weise.

Limits

Aufrufe werden pro Minute gezählt: 60 pro Verbindung, 300 pro Konto und 600 pro Tenant, und höchstens 4 gleichzeitige Aufrufe pro Verbindung. Einige Tools zählen als mehr als ein Aufruf. Wird ein Limit erreicht, antwortet der Server mit dem Status 429 und einem Retry-After-Header; die KI-App sollte so viele Sekunden warten.

Verbindung widerrufen

Jede Verbindung im Tab MCP-Verbindungen zeigt Status, Umfang, Ablauf und letzte Nutzung. Klicken Sie auf Widerrufen, um die KI-App sofort zu sperren. Eine widerrufene oder abgelaufene Verbindung kann nicht erneut verwendet werden; erstellen Sie stattdessen eine neue.

MCP-Zugriff für eine Organisation verwalten

Benutzer, die die Einstellungen einer Organisation ändern dürfen, verwalten ihren MCP-Zugriff unter Einstellungen › Organisation › MCP-Server.

• MCP-Zugriff für diese Organisation deaktivieren: Schalten Sie es ein und klicken Sie auf Speichern, um jeden MCP-Aufruf an diese Organisation abzulehnen, von jeder Verbindung jedes Benutzers. Die Organisation erscheint dann nicht mehr in list_tenants. Schalten Sie es aus und speichern Sie, um den MCP-Zugriff wieder zu erlauben.
• MCP-Aufrufe: jeder Aufruf eines Tools, das diese Organisation nennt, die neuesten zuerst, abgelehnte Aufrufe eingeschlossen. Jede Zeile zeigt den Benutzer, die Verbindung, das Tool, den Status (Erfolgreich oder Fehlgeschlagen), die IP-Adresse und die Zeit. Aufrufe von Benutzern, die nicht Mitglied dieser Organisation sind, werden nicht angezeigt.