Einen KI-Assistenten per MCP mit Helpdash verbinden

Helpdash stellt einen Model-Context-Protocol-Server (MCP) bereit, sodass ein KI-Assistent direkt in Ihrem Workspace arbeiten kann, statt dass Sie Tickets in ein Chatfenster kopieren. Fragen Sie "welche Tickets verletzen heute das SLA?" oder "fasse diesen Verlauf für die Übergabe zusammen" — und der Assistent fragt Helpdash selbst ab.

Dieser Beitrag behandelt, was der Connector bereitstellt, wie man ihn verbindet und — der Teil, der zweimaliges Lesen verdient — was er nicht darf.

Was der Connector bereitstellt

Der Server liefert 46 Werkzeuge, vier fertige Prompts und eine Ressource, die alle Enum-Werte auflistet, die die Werkzeuge akzeptieren. Die Werkzeuge decken Tickets, Live-Chat, die Wissensdatenbank, vorgefertigte Antworten, Projekte und Teammitglieder, das Dashboard, CSAT, Automatisierungsregeln, Webhooks, Einstellungen, das Aktivitätsprotokoll und die Abrechnung ab.

Lesen und Schreiben sind immer getrennte Werkzeuge. Es gibt kein Sammelwerkzeug api_request mit einem method-Parameter — Tickets suchen und eines ändern sind verschiedene Werkzeuge mit verschiedenen Berechtigungen. Ein Assistent mit Lesezugriff kann also nichts verändern, indem er ein Argument variiert.

Die vier Prompts sind Arbeitsabläufe, die es lohnt, vorformuliert zu haben:

• Ticket triagieren — schlägt Priorität, Kategorie und zuständige Person vor. Ändert nichts.
• Kundenantwort entwerfen — entwirft den Text mit Ihrer Wissensdatenbank und Ihren vorgefertigten Antworten. Er kann nicht senden; die Antwort kommt zur Prüfung zurück.
• Verlauf zusammenfassen — verdichtet ein langes Ticket oder Chatprotokoll für die Schichtübergabe.
• Wöchentlicher Support-Bericht — Volumen, SLA, CSAT und was Aufmerksamkeit braucht.

Einen Client verbinden

Öffnen Sie Einstellungen → KI-Connectoren (MCP) und stellen Sie ein Token aus. Geben Sie ihm eine Bezeichnung, die Sie später wiedererkennen, lassen Sie beim ersten Token alle Schreibschalter aus und kopieren Sie den Schlüssel — er wird genau einmal angezeigt.

Dann registrieren Sie ihn. Für Claude Code:

claude mcp add --transport http helpdash https://your-workspace.helpdash.io/mcp \
  --header "Authorization: Bearer hd_mcp_..."

Für jeden Client, der eine .mcp.json liest:

{
  "mcpServers": {
    "helpdash": {
      "type": "http",
      "url": "https://your-workspace.helpdash.io/mcp",
      "headers": { "Authorization": "Bearer hd_mcp_..." }
    }
  }
}

Beide Schnipsel werden für Sie erzeugt, ausgefüllt mit Ihrer Workspace-Adresse, auf demselben Bildschirm, auf dem das Token erscheint.

Clients, die eine Anmeldung im Browser bevorzugen, können statt eines statischen Tokens OAuth 2.1 nutzen: Der Server veröffentlicht die üblichen Discovery-Dokumente, unterstützt PKCE und dynamische Client-Registrierung und zeigt einen Zustimmungsbildschirm, der genau die angefragten Scopes auflistet. Kein Token zum Kopieren und kein Schlüssel auf der Festplatte.

Was er nicht darf

Der Connector ist keine zweite, laxere API. Jeder Aufruf durchläuft dieselben vier Prüfungen wie eine Anfrage von Menschen.

Er handelt als Sie. Ein Token ist an die Person gebunden, die es ausgestellt hat. Es erbt deren Rollen und Berechtigungen exakt — wenn Sie ein Ticket in der Anwendung nicht öffnen können, kann es ein Assistent mit Ihrem Token auch nicht. Und es ist an einen Workspace gebunden: Es gibt kein Argument, das an die Daten eines anderen Mandanten reicht.

Nur Lesen, sofern Sie nichts anderes sagen. Ein neues Token mit allen Schaltern aus kann suchen, lesen und berichten — mehr nicht. Schreibzugriff wird je Bereich erteilt — Tickets ändern, im Live-Chat antworten, die Wissensdatenbank bearbeiten, Projekte verwalten, Teammitglieder einladen, Einstellungen ändern, Automatisierungsregeln ändern — und nur für die Bereiche, die Sie ankreuzen. Lesen ist immer enthalten, denn ein Assistent, der schreiben, aber nicht lesen kann, ist nutzlos.

Schreibwerkzeuge fragen vorher. Jedes Werkzeug, das Daten ändert, ist als destruktiv gekennzeichnet, sodass ein gut gebauter Client vor jedem Aufruf nachfragt, statt still zu handeln. Werkzeuge, die Kundinnen erreichen, sagen das in ihrer eigenen Beschreibung: Eine Live-Chat-Nachricht wird sofort zugestellt und kann nicht zurückgeholt werden, und ein Ticket-Kommentar ist standardmäßig eine interne Notiz, damit nichts versehentlich bei Kundinnen landet.

Geheimnisse bleiben serverseitig. Wer Ihre Einstellungen über einen Connector liest, bekommt Integrations-Zugangsdaten maskiert zurück. Es gibt kein Argument, das sie sichtbar macht.

Kundentext wird eingezäunt. Ticketbeschreibungen, Kommentare und Chatprotokolle stammen von anderen Menschen, und ein Support-Postfach ist genau der Ort, an dem jemand versuchen würde, Anweisungen für eine mitlesende KI unterzubringen. Helpdash umschließt diesen Text mit einem ausdrücklichen Block für nicht vertrauenswürdige Inhalte und teilt dem Modell in den eigenen Server-Anweisungen mit, dass nichts darin ein Befehl ist.

Alles wird protokolliert. Jeder Aufruf wird mit Person, Werkzeug und Ergebnis festgehalten, im selben Prüfprotokoll wie der Rest des Workspace. Falls Sie je beantworten müssen "was hat der Assistent am Dienstag eigentlich gemacht?", steht es dort.

Widerruf wirkt sofort. Ein Token in den Einstellungen zu löschen stoppt schon die nächste Anfrage des Assistenten. Wir speichern nur einen SHA-256-Hash des Schlüssels, können ihn also nicht für Sie wiederherstellen — verloren heißt neu ausstellen.

Ein Token weiter einschränken

Zwei optionale Kontrollen sind es wert, bekannt zu sein. Ein Token kann ein Ablaufdatum tragen — der einfachste Weg, ein kurzlebiges Experiment sich selbst aufräumen zu lassen. Und es kann eine IP-Freigabeliste tragen, sodass ein Token, das für einen Server gedacht ist, nicht von anderswo genutzt werden kann. Beides steht im selben Erstellungsformular.

Ein vernünftiges erstes Token

Stellen Sie eines ohne Schreib-Scopes aus und geben Sie dem Assistenten eine Woche nur mit Lesezugriff. Lassen Sie ihn SLA-Risiken finden, unübersichtliche Verläufe zusammenfassen und Antworten entwerfen, die Sie selbst senden. Das deckt den meisten Nutzen ab, ohne Risiko. Wenn Sie wissen, welchen Schreib-Scope Sie tatsächlich wollen, stellen Sie ein zweites Token nur damit aus — ein bestehendes Token zu erweitern ist bewusst nicht möglich.

Jede Aussage oben beschreibt Verhalten, das heute ausgeliefert wird; der Connector ist in jedem Helpdash-Workspace verfügbar.