Einen KI-Agenten mit dem MCP-Server verbinden (Enterprise)

Mit dem MCP-Server bedient ein externer KI-Agent deinen Helpdesk über einen Bot-Token mit begrenzten Berechtigungen. Der Server ist ein Endpunkt nach dem Model Context Protocol. Jeder MCP-fähige Agent (zum Beispiel ein OpenClaw-Bot) kann darüber Konversationen lesen und beantworten, private Notizen hinterlassen, Antwortentwürfe zur Freigabe durch einen Menschen anlegen, Kontakte verwalten, neue ausgehende Konversationen starten und einen Ereignis-Feed abfragen. Du schaltest ihn in den Einstellungen ein, erzeugst einen Token und gibst deinem Agenten die Verbindungs-URL. Der MCP-Server ist im Enterprise-Tarif verfügbar und auch 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 selbst eine Integration für die REST API zu schreiben, verbindest du einen MCP-Client, und der Agent bekommt einen festen Satz an Werkzeugen, die er aufrufen kann. Stell es dir so vor: Du gibst einem Bot einen begrenzten Schlüssel, den du jederzeit widerrufen kannst, für einen bestimmten Teil deiner Inboxen, statt ihm ein Login zu geben. Der Agent handelt unter einer eigenen Bot-Identität. Seine Nachrichten und Notizen erscheinen also unter diesem Bot und nicht unter einem Teammitglied.

Wie schalte ich den MCP-Server ein?

1. Gehe zu Einstellungen > MCP-Server.
2. Schalte den MCP-Server für deinen Workspace ein.
3. Erzeuge einen Bot-Token. Gib ihm einen eindeutigen Namen (zum Beispiel OpenClaw Triage-Bot), damit du ihn später wiedererkennst.
4. Wähle die Berechtigungen (Scopes) des Tokens und beschränke ihn auf bestimmte Inboxen, falls der Agent nur in einigen davon arbeiten soll.
5. Kopiere den Token sofort. Aus Sicherheitsgründen wird er nach dem Verlassen der Seite nicht mehr vollständig angezeigt.

Wie lautet die Verbindungs-URL?

Trage in deinem MCP-Client diese Adresse ein:

https://<your-host>/api/mcp

Ersetze <your-host> durch deine eigene Deskwoot-Adresse. Übergib den Bot-Token so, wie dein MCP-Client es erwartet (meist als Bearer-Token im Authorization-Header). Sobald der Client verbunden ist, sieht der Agent die Werkzeuge, die er mit den Scopes des Tokens nutzen darf.

Was kann ein externer Agent über MCP tun?

Ein verbundener Agent kann im Rahmen der Scopes, die du vergibst:

• Konversationen und ihre Nachrichten lesen.
• Auf Konversationen antworten.
• Private Notizen hinzufügen, die nur dein Team sieht.
• Antwortentwürfe anlegen, die ein Teammitglied prüft und abschickt.
• Kontakte lesen, anlegen und ändern.
• Ausgehende Konversationen 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 gibt keinen Zugriff auf die Einstellungen deines Workspaces, die Abrechnung oder Aktionen, die etwas zerstören. Ein Bot-Token kann also keine Einstellungen oder Konfigurationen ändern, nicht an die Abrechnung, nichts löschen, keine Massennachrichten senden und keine Webhooks verwalten. Braucht dein Agent etwas außerhalb dieser Grenze, macht der MCP-Server es nicht, und das ist so gewollt.

Wie funktionieren Scopes und die Beschränkung auf Inboxen?

Jeder Token hat eine Reihe von Scopes, die festlegen, welche Werkzeuge der Agent aufrufen darf. Vergib nur, was der Agent wirklich braucht. Ein Bot, der Antworten nur zur Freigabe entwirft, braucht zum Beispiel keine Berechtigung, selbst Nachrichten zu senden. Zusätzlich kannst du einen Token auf bestimmte Inboxen beschränken. Ein Agent, der deine Abrechnungs-Inbox betreut, sieht dann nie Konversationen aus einer anderen. Ist ein Token einmal in falsche Hände geraten oder nutzt du einen Agenten nicht mehr, widerrufe den Token unter Einstellungen > MCP-Server, und der Zugriff endet sofort.

Welche Tarife enthalten den MCP-Server?

Der MCP-Server ist eine Enterprise-Funktion. Er funktioniert auch während der 7-tägigen Enterprise-Testphase, sodass du einen Agenten anbinden und testen kannst, bevor du dich für einen bezahlten Tarif entscheidest. Wenn du programmatischen Zugriff ohne MCP brauchst, deckt die REST API dieselben Daten ab. Sie ist ebenfalls eine Enterprise-Funktion (API-Token gibt es nur im bezahlten Enterprise-Tarif, nicht in der Testphase), und die Tokens verwaltest du unter Einstellungen > API-Token.

Häufige Fragen