Einen KI-Agenten mit dem MCP-Server verbinden (Enterprise)
Der MCP-Server lässt einen externen KI-Agenten deinen Helpdesk über ein begrenztes Bot-Token bedienen. Es ist ein Endpunkt nach dem Model Context Protocol, sodass jeder MCP-fähige Agent (zum Beispiel ein OpenClaw-Bot) Unterhaltungen lesen, beantworten, private Notizen hinterlassen, Antwortentwürfe zur Freigabe durch einen Menschen erstellen, Kontakte verwalten, neue ausgehende Unterhaltungen starten und einen Ereignis-Feed abfragen kann. Du aktivierst ihn in den Einstellungen, erzeugst ein Token und richtest deinen Agenten auf die Verbindungs-URL. Der MCP-Server ist im Enterprise-Tarif verfügbar und während der 7-tägigen Enterprise-Testphase, mit der jedes neue Konto startet.
Wofür ist der MCP-Server da?
Er ist die Brücke zwischen einem externen KI-Agenten und Deskwoot. Statt deine eigene Integration gegen die REST API zu schreiben, verbindest du einen MCP-Client, und der Agent erhält einen definierten Satz von Werkzeugen, die er aufrufen kann. Stell es dir so vor, als gäbst du einem Bot einen begrenzten, widerrufbaren Schlüssel zu einem bestimmten Teil deines Posteingangs, statt ein Login auszuhändigen. Der Agent handelt über eine Bot-Identität, sodass seine Nachrichten und Notizen diesem Bot zugeschrieben werden, nicht einem menschlichen Teammitglied.
Wie aktiviere ich den MCP-Server?
- Geh zu Einstellungen > MCP Server.
- Schalte den MCP-Server für deinen Workspace ein.
- Erzeuge ein Bot-Token. Gib ihm einen klaren Namen (zum Beispiel OpenClaw Triage-Bot), damit du es später wiedererkennst.
- Wähle die Scopes, die das Token haben soll, und beschränke es auf bestimmte Posteingänge, falls der Agent nur in einigen davon arbeiten muss.
- Kopiere das Token sofort. Aus Sicherheitsgründen wird es nach dem Verlassen der Seite möglicherweise nicht erneut vollständig angezeigt.
Was ist die Verbindungs-URL?
Richte deinen MCP-Client auf:
https://<your-host>/api/mcp
Ersetze <your-host> durch deinen eigenen Deskwoot-Host. Übergib das Bot-Token so, wie dein MCP-Client es erwartet (in der Regel ein Bearer-Token im Authorization-Header). Sobald der Client verbunden ist, sieht der Agent die Werkzeuge, die er auf Basis der Scopes des Tokens verwenden darf.
Was kann ein externer Agent über MCP tun?
Ein verbundener Agent kann innerhalb der Scopes, die du gewährst:
- Unterhaltungen und ihre Nachrichten lesen.
- Auf Unterhaltungen antworten.
- Private Notizen hinzufügen, die nur dein Team sieht.
- Antwortentwürfe erstellen, die ein menschliches Teammitglied prüft und sendet.
- Kontakte lesen, erstellen und aktualisieren.
- Ausgehende Unterhaltungen starten.
- Einen Ereignis-Feed abfragen, um auf neue Aktivität zu reagieren.
Was kann er nicht tun?
Der MCP-Server ist bewusst eng gefasst. Er legt deine Workspace-Einstellungen, die Abrechnung oder destruktive Aktionen nicht offen. Konkret kann ein Bot-Token keine Einstellungen oder Konfigurationen ändern, die Abrechnung anrühren, Datensätze löschen, Broadcasts senden oder Webhooks verwalten. Wenn dein Agent etwas außerhalb dieser Grenze tun muss, wird der MCP-Server es nicht ausführen, und das ist Absicht.
Wie funktionieren Scopes und Posteingangsgrenzen?
Jedes Token trägt einen Satz von Scopes, die entscheiden, welche Werkzeuge der Agent aufrufen kann. Gewähre nur das, was der Agent wirklich braucht. Ein Bot, der Antworten zur Freigabe durch Menschen entwirft, braucht zum Beispiel keine Berechtigung, eigenständig Nachrichten zu senden. Zusätzlich zu den Scopes kannst du ein Token auf bestimmte Posteingänge beschränken, sodass ein Agent, der deinen Abrechnungs-Posteingang betreut, niemals Unterhaltungen in einem anderen sieht. Falls ein Token jemals durchsickert oder du einen Agenten nicht mehr nutzt, widerrufe es unter Einstellungen > MCP Server, und der Zugriff ist sofort weg.
Welche Tarife enthalten den MCP-Server?
Der MCP-Server ist eine Enterprise-Funktion. Er ist auch während der 7-tägigen Enterprise-Testphase verfügbar, sodass du einen Agenten anbinden und testen kannst, bevor du dich auf einen bezahlten Tarif festlegst. Wenn du programmatischen Zugriff ohne MCP brauchst, deckt die REST API dieselben Daten ab und ist ebenfalls eine Enterprise-Funktion, wobei Tokens unter Einstellungen > API-Tokens verwaltet werden.