Jede Verbindung gilt für einen Arbeitsbereich, und es gibt kein Tool zum Wechseln. Stelle erneut eine Verbindung her und wähle auf dem Zustimmungsbildschirm den anderen Arbeitsbereich aus.
MCP
Mit dem Ferndesk-MCP-Server können KI-Tools wie Claude, ChatGPT, Cursor und Codex in deinem Arbeitsbereich in deinem Namen agieren. Sie können Artikel durchsuchen und bearbeiten, Änderungen zur Überprüfung einreichen, Support-Unterhaltungen bearbeiten und Berichte lesen. Die Adresse lautet https://mcp.ferndesk.com. Du meldest dich per OAuth an, daher ist kein API-Schlüssel erforderlich.
Inhaber und Admins finden die Schritte für die einzelnen Clients unter Integrationen > KI-Clients. Auch Mitwirkende können eine Verbindung herstellen – mit derselben URL. Dein Help Center verfügt außerdem über einen separaten, schreibgeschützten MCP-Server für Leser. Siehe Suche, SEO und KI-Tools.
Client verbinden
Füge die URL in deinem Client hinzu und melde dich dann im Browserfenster, das sich öffnet, bei Ferndesk an. Auf dem Zustimmungsbildschirm wählst du den Arbeitsbereich aus und genehmigst den Zugriff.
claude mcp add --transport http ferndesk https://mcp.ferndesk.comClaude (claude.ai und Desktop): Füge einen benutzerdefinierten Connector mit der URL hinzu. Bei Team und Enterprise muss ein Organisationsinhaber ihn zuerst hinzufügen. Die Anleitung zu benutzerdefinierten Connectors von Anthropic beschreibt die einzelnen Schritte.
Claude Code: Führe den Befehl aus, starte eine Sitzung, führe
/mcpaus, wähleferndeskund dann Authentifizieren.ChatGPT: Aktiviere den Entwicklermodus unter Einstellungen > Apps > Erweiterte Einstellungen und erstelle dann eine App mit der URL. Der Entwicklermodus hängt von deinem ChatGPT-Tarif ab.
Cursor: Verwende auf der Seite „KI-Clients“ die Option Zu Cursor hinzufügen oder füge das obige JSON zu
~/.cursor/mcp.jsonoder zur Datei.cursor/mcp.jsoneines Projekts hinzu.Codex CLI: Remote-Server gehören in
config.toml, dacodex mcp addnur lokale Server hinzufügt. Führe anschließendcodex mcp login ferndeskaus.Andere Clients: Jeder Client, der Streamable HTTP und OAuth 2.1 mit dynamischer Clientregistrierung und PKCE (S256) unterstützt. Es muss sich um einen öffentlichen Client handeln: Ein Client, der ein festes Client-Secret benötigt, funktioniert nicht.
Was eine Verbindung ermöglicht
Eine Verbindung agiert als ein Mitglied in einem Arbeitsbereich. Sie kann alles tun, was deine Rolle und die von dir genehmigten Berechtigungen zulassen. Deine Rolle wird bei jeder Anfrage überprüft, sodass eine Rollenänderung sofort wirksam wird.
Berechtigung | Mögliche Aktionen |
|---|---|
| Artikel, Entwürfe, Überarbeitungen, Überprüfungsanfragen und Aufgaben von Fern lesen und durchsuchen. |
| Entwürfe erstellen und bearbeiten, Artikel verschieben und löschen, Sammlungen und ihre Reihenfolge verwalten, Änderungen in einer Überprüfungsanfrage zur Prüfung einreichen und Nutzer des Help Centers verwalten. |
| Entwürfe und Überprüfungsanfragen veröffentlichen, die Veröffentlichung aufheben und Überarbeitungen wiederherstellen. Nur für Inhaber und Admins. |
| Unterhaltungen mit dem KI-Assistenten in deinem Help Center lesen. |
| Support-Unterhaltungen, Kunden, Teammitglieder, Labels und gespeicherte Antworten lesen. |
| Interne Notizen hinzufügen. Inhaber und Admins können außerdem Unterhaltungen zuweisen, mit Labels versehen, schließen, wieder öffnen, zurückstellen und priorisieren. |
| Kunden in deinem Namen antworten. Standardmäßig deaktiviert; du kannst die Funktion bei der Zustimmung aktivieren. |
| Support- und Help-Center-Berichte lesen. |
| Einstellungen für Help Center, Widget, KI-Agent, Playbook, Posteingang, Labels, gespeicherte Antworten und Team lesen. Geheimnisse werden niemals zurückgegeben. |
| Diese Einstellungen ändern, E-Mail-Posteingänge hinzufügen und Support aktivieren. Nur für Inhaber und Admins. |
| Teammitglieder einladen. Standardmäßig deaktiviert und nur für Inhaber und Admins. |
Clients, die nicht nach bestimmten Berechtigungen fragen, erhalten alle Berechtigungen außer den beiden, die standardmäßig deaktiviert sind. Um später eine Berechtigung hinzuzufügen, stelle die Verbindung erneut her und genehmige sie.
Änderungen werden überprüft
In einem Help Center, in dem bereits Artikel veröffentlicht wurden, werden Bearbeitungen in einer Überprüfungsanfrage gesammelt. Nichts wird veröffentlicht, bevor es jemand freigibt – entweder in Ferndesk oder über den Client, nachdem du dies bestätigt hast. Beim Einreichen einer Anfrage werden deine Inhaber und Admins per E-Mail benachrichtigt. Eine Überprüfungsanfrage mit Änderungen an API-Referenzen kann nur in Ferndesk veröffentlicht werden.
URL eines Artikels beibehalten
Die URL eines Artikels besteht aus seinem Slug und seiner Kurz-ID, zum Beispiel /connect-intercom-a1b2c. Ohne benutzerdefinierten Slug richtet sich der Slug bei jeder Veröffentlichung nach dem Titel. Die alte URL leitet dann mit einem 301-Statuscode zur neuen URL weiter.
Um den Slug festzulegen, übergib slug an save_article, wenn du die Änderung in einer Überprüfungsanfrage einreichst. Im Direktmodus speicherst du den Entwurf ohne den Slug und übergibst slug an publish_article. Der Slug wird zum benutzerdefinierten Slug des Artikels und bleibt daher auch bei einer Umbenennung erhalten. Soll die aktuelle URL bei einer Umbenennung beibehalten werden, übergib den aktuellen Slug. get_article gibt customSlug zurück. Der Wert ist true, sobald ein benutzerdefinierter Slug festgelegt wurde.
Ein Slug muss mindestens 2 Zeichen lang sein und darf nur Kleinbuchstaben, Zahlen und einzelne Bindestriche enthalten. Am Anfang und Ende darf kein Bindestrich stehen. Ein ungültiger Slug wird abgelehnt und ein Korrekturvorschlag angezeigt.
MCP erfordert keine eindeutigen Slugs, da jede URL mit der Kurz-ID endet.
Für eine Übersetzung kannst du keinen Slug übergeben (ändere ihn in Ferndesk). Das gilt auch für Löschungen und Help Center, die über eine externe Plattform veröffentlicht werden.
MCP kann einen benutzerdefinierten Slug nicht deaktivieren. Damit sich die URL wieder nach dem Titel richtet, deaktiviere Benutzerdefinierter Slug unter Artikeleinstellungen > SEO.
Die öffentliche API akzeptiert dasselbe Feld slug im gleichen Format für POST /v1/review_requests/:id/changes, POST /v1/articles und PATCH /v1/articles/:id.
Auf Sammlungen verlinken und ihre URLs ändern
Textlinks können auch auf eine Sammlung, einen Abschnitt oder eine veröffentlichte API-Referenz im selben Help Center verweisen. Verwende internal://coll_..., internal://sect_... oder internal://apiref_... mit IDs aus get_helpdesk_overview (IDs von API-Referenzen stammen aus get_order für den jeweiligen Abschnitt).
Um die URL einer Sammlung zu ändern, übergib slug zusammen mit der collection_id an save_collection. Die Kurz-ID bleibt unverändert, sodass die alte URL mit einem 301-Statuscode zur neuen weiterleitet.
Einschränkungen
MCP kann keine Aufgabe von Fern starten. Es kann Aufgaben von Fern auflisten und verwerfen.
Es gibt kein Tool zum Hochladen von Bildern. Füge Bilder in den HTML- oder Markdown-Inhalt des Artikels ein: Inline-
data:-Bilder werden beim Speichern des Artikels hochgeladen. Bilder, die an anderer Stelle gehostet werden, werden bei der Veröffentlichung in dein Help Center kopiert.MCP kann keine Abschnitte erstellen oder löschen und weder Abrechnung noch API-Schlüssel oder Webhooks verwalten.
Ein Artikeltext darf bis zu 500.000 Zeichen umfassen.
Schreibvorgänge nutzen das API-Kontingent gemeinsam: 1.000 pro Minute und Verbindung sowie 3.000 pro Minute und Arbeitsbereich. Lesevorgänge werden nicht mitgezählt.
Ohne aktives Abonnement sind Änderungen deaktiviert.
Verbindungen verwalten
Inhaber und Admins sehen auf der Seite „KI-Clients“ alle Verbindungen – eine Zeile pro Arbeitsbereich – und können jede davon widerrufen. Möchte ein Mitwirkender eine Verbindung entfernen lassen, muss er einen Inhaber oder Admin darum bitten. Zugriffstoken sind eine Stunde gültig und können sieben Tage lang erneuert werden. Daher muss man sich bei einem Client, der eine Woche lang nicht genutzt wurde, erneut anmelden.
Kann ein Client mehrere Arbeitsbereiche nutzen?
Warum wurde mein Speichervorgang abgelehnt?
Bei den meisten Ablehnungen wird angegeben, was geändert werden muss: eine fehlende Berechtigung (stelle die Verbindung erneut her und genehmige sie), eine Rolle, mit der nur Entwürfe gespeichert werden können, ein Artikel mit einem offenen Entwurf eines anderen Autors oder eine Bearbeitung, durch die versehentlich die Titelüberschrift, Bilder oder Blöcke entfernt würden.
Kann ein Mitwirkender veröffentlichen?
Nein. Der Client eines Mitwirkenden speichert Entwürfe und reicht Überprüfungsanfragen ein. Ein Inhaber oder Admin veröffentlicht sie.