MCP: HelpStack einrichten, indem Sie fragen

HelpStack spricht MCP (Model Context Protocol), sodass ein KI-Assistent wie Claude Ihren Arbeitsbereich für Sie einrichten kann. Sie beschreiben in eigenen Worten, was Sie möchten; er legt die Wissensdatenbank-Artikel, die FAQ-Chips und die Agent-Tools an.

„Crawle unser Hilfecenter und füge dann ein Tool hinzu, das eine Bestellung anhand von Nummer und E-Mail über https://api.mystore.si/orders nachschlägt."

Das ist eine Einrichtungs-Verbindung, keine Support-Verbindung. Sie konfiguriert den Arbeitsbereich. Sie kann Ihre Konversationen nicht lesen und niemandem antworten — siehe Was sie nicht kann.

Kurz gefasst#

1. Token erstellen#

Einstellungen → API-Tokens → Token erstellen. Geben Sie ihm einen Namen, den Sie später wiedererkennen, etwa „Claude auf meinem Laptop" — an diesem Namen erkennen Sie, welches Token Sie widerrufen müssen.

Das Token wird nur einmal angezeigt. Wir speichern nur seinen Hash, es gibt also keinen Bildschirm, der es erneut zeigen kann, und keine Supportanfrage, die es wiederherstellt. Wenn Sie es verlieren, widerrufen Sie es und erstellen ein neues. Das dauert zehn Sekunden und ist der vorgesehene Weg, kein Fehlerfall.

Ein Token ist an eine Organisation gebunden — die, in der Sie beim Erstellen waren. Wenn Sie mehreren angehören, erstellen Sie je ein Token pro Organisation, die Sie einrichten möchten. Ein Token lässt sich nicht zwischen ihnen verschieben, und einer weiteren Organisation später beizutreten erweitert ein bereits vorhandenes Token nicht.

1b. Wählen Sie, was das Token darf#

Beim Erstellen eines Tokens haken Sie an, worauf es zugreifen darf. Ein Token kann nie mehr als Sie — Ihre Rolle gilt weiterhin — und die Scopes schränken es nur weiter ein.

Die beiden settings:-Scopes sind standardmäßig angehakt — das ist die Einrichtungsfläche, die diese Seite beschreibt. Die beiden conversations:-Scopes sind nie vorangehakt — einem Assistenten den Posteingang zu zeigen sollte eine Entscheidung sein, die jemand trifft, keine, die er erbt — und sie erscheinen überhaupt erst ab dem Growth-Tarif. Nehmen Sie settings:write heraus, erhalten Sie ein Token, das Ihre Konfiguration ansehen und nichts ändern kann: nützlich, wenn ein Assistent ein Setup prüfen oder „was haben wir eigentlich konfiguriert?" beantworten soll, ohne jedes Risiko einer Bearbeitung.

tools/list zeigt nur Tools, die das Token aufrufen kann, sodass ein Assistent nie eine Tür sieht, die er nicht öffnen kann.

2. Assistenten verbinden#

Claude Code:

claude mcp add helpstack --transport http https://helpstack.eu/api/mcp \
  --header "Authorization: Bearer hs_your_token_here"

Claude Desktop und ChatGPT — fügen Sie einen eigenen Connector mit der URL https://helpstack.eu/api/mcp hinzu und melden Sie sich an, wenn er danach fragt. Diese Clients können kein eingefügtes Token senden und nutzen deshalb eine Anmeldung: Sie wählen die Organisation und geben auf einer HelpStack-Seite frei, was die App darf. Nichts wird gewährt, bevor Sie zustimmen, und Sie können die App später unter Einstellungen → API-Tokens trennen.

Für diesen Weg müssen Sie kein Token anlegen. Tokens sind für Clients wie Claude Code, die den Header selbst setzen können.

Codex — es liest das Token aus einer Umgebungsvariablen, sodass es nie in Ihrer Konfigurationsdatei landet:

export HELPSTACK_MCP_TOKEN="hs_ihr_token"
codex mcp add helpstack --url https://helpstack.eu/api/mcp \
  --bearer-token-env-var HELPSTACK_MCP_TOKEN

Alles andere, das MCP über HTTP spricht — richten Sie es auf dieselbe URL mit demselben Header. Am Transport ist nichts HelpStack-spezifisch.

Bitten Sie ihn dann, whoami auszuführen. Er sollte mit dem Namen Ihrer Organisation und Ihrer Rolle antworten. Tut er das, funktioniert alles Weitere.

Zwei Wege zu verbinden#

Beides endet gleich: eine Identität mit Rolle, Organisation und einem Satz von Berechtigungen, die bei jedem Aufruf erneut geprüft werden.

Was sie kann#

Lesen steht jedem Mitglied offen. Schreiben erfordert Inhaber oder Administrator, genau wie im Dashboard: Das Token eines Agenten darf schauen, aber nichts ändern. Das wird vor Ihren Argumenten geprüft, sodass ein Token ohne Berechtigung durch den Aufruf nichts über ein Tool erfährt.

Das Bindeglied

attach_knowledge_base_groups_to_channel ist der Schritt, den man übersieht. Artikel hinzuzufügen richtet sie nirgendwohin aus: Ein Kanal ohne zugeordnete Gruppen durchsucht Ihre gesamte Wissensdatenbank, was bei einem Thema richtig und bei vielen schlecht ist. Gruppieren Sie die Artikel, ordnen Sie die Gruppe zu, und die KI antwortet auf diesem Kanal aus diesem Ausschnitt.

Die schwierigen Fälle beantworten#

Mit conversations:read und conversations:draft kann ein Assistent einen schwierigen Verlauf lesen und Ihnen eine durchdachte Antwort schreiben:

Sie: Lies Konversation 4821 und entwirf eine Antwort. Der Kunde hat recht, dass wir zu spät geliefert haben, aber die geforderte Erstattung ist höher als der Bestellwert.

Er ruft get_conversation auf, liest den ganzen Verlauf und ruft draft_reply auf. Der Entwurf landet in Ihrem Posteingang wie ein KI-Entwurf, und Sie senden ihn.

Ein Entwurf erreicht keinen Kunden. draft_reply reiht nie einen Versand ein: Der Entwurf bleibt inaktiv, bis eine Person ihn in HelpStack freigibt, wo die Freigabe unter ihrem Namen festgehalten wird.

Senden ist ein eigener Scope, conversations:send, und genau diese Trennung ist der Punkt. conversations:draft impliziert ihn nicht, nichts anderes gewährt ihn, und er ist nie vorangehakt. „Schreib mir eine Antwort" und „antworte für mich" sind verschiedene Entscheidungen, also verschiedene Berechtigungen.

Wenn Sie ihn gewähren, antwortet send_reply sofort und ungeprüft — genau das, was Ihre Kanäle mit aktivierter Auto-Antwort ohnehin tun. Es führt dieselbe Spracherkennung und Übersetzung aus wie der Freigabe-Button, damit keine englische Antwort bei einem Kunden landet, der auf Slowenisch geschrieben hat, und die Nachricht wird der Person zugeordnet, der das Token gehört, statt einem anonymen Assistenten. Eine gesendete Nachricht kann nicht zurückgeholt werden.

Nicht gesendete Entwürfe sind gekennzeichnet, wenn der Assistent den Verlauf erneut liest, damit er seinen eigenen Entwurf nie für etwas hält, das der Kunde gesehen hat.

Was sie nicht kann#

Absichtlich, und das ist die nützlichere Hälfte der Liste:

• Sie kann nicht senden, sofern Sie nicht conversations:send gewährt haben, der standardmäßig aus ist, vom Entwerfen getrennt und nur ab Growth verfügbar.
• Sie sieht keine andere Organisation. Die Organisation stammt aus dem Token und wird nie vom Aufrufer übergeben.
• Sie liest Ihren Posteingang nur, wenn Sie das gewährt haben. Die Konversations-Scopes sind aus, bis Sie sie anhaken, und unterhalb von Growth nicht verfügbar.
• Sie kann Ihre eigenen Rechte nicht überschreiten. Ein Token handelt als die Person, die es erstellt hat, mit deren Rolle wie sie jetzt ist.
• Sie überlebt Ihre Mitgliedschaft nicht. Entfernen Sie jemanden aus der Organisation, hören dessen Tokens beim nächsten Aufruf auf zu funktionieren.
• Sie behält keinen Scope, den Ihr Tarif verloren hat. Nach einem Downgrade von Growth funktionieren die Konversations-Scopes am selben Tag nicht mehr, auch auf bereits ausgestellten Tokens.

Beispiel#

Den Support eines Shops von null aufsetzen, in einem Gespräch:

Sie: Hier ist unser Hilfecenter: https://mystore.si/pomoc. Crawle es, füge dann einen FAQ-Chip zu Lieferzeiten hinzu und ein Tool, das den Bestellstatus über unsere API prüft.

Der Assistent ruft add_knowledge_base_url auf, dann create_faq, dann create_agent_tool — und meist zuerst list_agent_tools, um kein Tool zu doppeln, das Sie schon haben.

Zweierlei ist zu erwarten:

• Der Crawl ist nicht sofort fertig. Jeder Durchlauf indexiert ungefähr 50 Seiten und ein erneuter Durchlauf reicht weiter, eine große Website wird also über mehrere Crawls abgedeckt. Fragen Sie nach list_knowledge_base_sources, um den Stand zu sehen.
• Die Beschreibung eines Tools ist der wichtige Teil. Sie ist das, was das Modell liest, um zu entscheiden, wann es Ihr Tool aufruft. Sagen Sie es einfach — „nur verwenden, wenn der Kunde sowohl eine Bestellnummer als auch die E-Mail der Bestellung nennt" — und es landet in der Beschreibung, wo es hingehört.

Wenn etwas abgelehnt wird#

Die Fehler, die Sie am ehesten sehen, und was sie bedeuten:

Ein Token sicher halten#

Ein Token ist ein Passwort, das sich selbst eintippt. Behandeln Sie es so:

• Ein Token pro Einsatzort, damit ein Widerruf nicht die anderen bricht.
• Widerrufen Sie es, wenn Sie es nicht mehr nutzen. Einstellungen → API-Tokens zeigt, wann jedes zuletzt verwendet wurde; das reicht meist, um das ungenutzte zu erkennen.
• Fügen Sie es nicht in ein geteiltes Dokument oder einen Chat ein. Falls doch, widerrufen Sie es — der Preis eines Fehlers ist, dass jemand Ihren Assistenten umkonfiguriert.
• Es ist nicht für Ihre Kunden oder Ihre Website. Es gehört auf Maschinen, die Sie kontrollieren.

Verwandt#

• Agententools — was Tools sind und wie man eine gute Beschreibung schreibt.
• Benutzerdefinierte Agententools — die Integrator-Referenz für die Endpunkte, die Ihre Tools aufrufen.
• Wissensdatenbank — wie Crawling und Artikel sich verhalten.
• Feature-Flags — welche Funktionen Ihr Tarif enthält.