Verbinden Sie den Workspace MCP mit Claude Code, um Workspace-Informationen einzusehen und unterstützte Aktionen direkt von Ihrem Terminal aus durchzuführen.
Claude Code verbindet sich mit Notiondesk als Remote-HTTP-MCP-Server und authentifiziert sich über OAuth.
Bevor Sie beginnen
Stellen Sie sicher:
- Workspace MCP ist für mindestens ein Notiondesk Hilfezentrum aktiviert
- Sie können sich bei dem Notiondesk-Arbeitsbereich anmelden, mit dem Sie sich verbinden möchten.
- Claude Code ist auf Ihrem Computer installiert und funktioniert.
Falls Workspace MCP noch nicht aktiviert ist, siehe Workspace MCP aktivieren in Notiondesk .
Füge Notiondesk MCP zum Claude-Code hinzu.
Laufen:
Dies fügt den Notiondesk Workspace MCP-Server zu Claude Code hinzu.
Stellen Sie sicher, dass Notiondesk in allen Projekten verfügbar ist.
Wenn Sie Notiondesk MCP in jedem Claude Code-Projekt verwenden möchten, fügen Sie es mit Benutzerbereich hinzu:
Verwenden Sie stattdessen den Projekt- oder lokalen Gültigkeitsbereich, wenn die Verbindung nur in einer bestimmten Entwicklungsumgebung verfügbar sein soll.
Authentifizieren Sie sich mit Notiondesk
Nach dem Hinzufügen des Servers starten Sie Claude Code:
Geben Sie dann Folgendes ein:
Wählen Sie den Server notiondesk aus und starten Sie den Authentifizierungsablauf.
Claude Code öffnet Notiondesk in Ihrem Browser.
Dann:
claude mcp add --transport http notiondesk https://mcp.notiondesk.so/mcpclaude mcp add --transport http --scope user notiondesk https://mcp.notiondesk.so/mcpclaude/mcp- Melden Sie sich bei Bedarf bei Notiondesk an.
- Vergewissern Sie sich, dass der richtige Arbeitsbereich angezeigt wird.
- Überprüfen Sie die angeforderten Berechtigungen.
- Verbindung genehmigen.
- Zurück zum Claude-Code.
Claude Code speichert die OAuth-Authentifizierung für die Verbindung und kann sie bei Bedarf aktualisieren.
Überprüfen Sie den MCP-Server
Sie können die konfigurierten MCP-Server von Ihrem Terminal aus überprüfen:
Sie können auch den Server Notiondesk untersuchen:
Starten Sie anschließend Claude Code und testen Sie die Verbindung mit:
Prüfen Sie, ob die erwarteten Hilfezentren angezeigt werden.
Versuchen Sie als Nächstes Folgendes:
Das Starten mit reinen Leseanfragen hilft zu bestätigen, dass Claude Code mit dem richtigen Notiondesk-Arbeitsbereich verbunden ist.
Verwenden Sie Notiondesk aus dem Claude-Code.
Sobald die Verbindung hergestellt ist, kann Claude Code die verfügbaren Notiondesk-Tools nutzen, sofern diese für Ihre Anfrage relevant sind.
Zum Beispiel:
Oder:
Wenn Ihre Notiondesk-Rolle Änderungen zulässt, können Sie Claude Code auch anweisen, unterstützte Aktionen durchzuführen:
Die für Claude Code verfügbaren Aktionen hängen von Ihren Berechtigungen im Arbeitsbereich Notiondesk ab.
Arbeiten Sie mit mehreren Hilfezentren zusammen
Über dieselbe Claude-Code-Verbindung können mehrere Notiondesk-Hilfezentren aufgerufen werden.
Ein Hilfecenter ist verfügbar, wenn:
claude mcp listclaude mcp get notiondeskList the Notiondesk help centers I can access.Show the sync status for my main help center.Review recent article feedback and search analytics. Show me which documentation needs attention first.Review recent chatbot conversations and identify repeated questions that are not covered well by our help center.Trigger a sync for the onboarding collection.- Workspace MCP ist dafür aktiviert.
- Ihr Notiondesk-Konto hat Zugriff darauf.
Sie müssen nicht für jedes Hilfezentrum einen separaten MCP-Server konfigurieren.
Wenn mehrere Hilfezentren verfügbar sind, geben Sie dasjenige an, das Claude Code verwenden soll.
Zum Beispiel:
Wählen Sie den richtigen Claude-Code-Bereich aus.
Claude Code unterstützt verschiedene Gültigkeitsbereiche für MCP-Server.
Lokaler Gültigkeitsbereich
Der lokale Gültigkeitsbereich ist die Standardeinstellung.
Verwenden Sie es, wenn Sie im aktuellen Projekt nur Notiondesk MCP benötigen.
Projektumfang
Verwenden Sie den Projektbereich, wenn die MCP-Konfiguration über die .mcp.json-Konfiguration des Projekts mit Teammitgliedern geteilt werden soll.
Jeder Teamkollege authentifiziert sich weiterhin mit seinem eigenen Notiondesk-Konto.
Geben Sie die OAuth-Zugangsdaten nicht an Teammitglieder weiter.
Benutzerbereich
Verwenden Sie den Benutzerbereich, wenn Sie Notiondesk in allen Claude Code-Projekten auf Ihrem Computer verfügbar haben möchten:
Für die meisten Personen, die regelmäßig Notiondesk aus Claude Code verwalten, ist der Benutzerbereich die bequemste Option.
Berechtigungen
Workspace MCP richtet sich nach den Berechtigungen des Teammitglieds Notiondesk, das die OAuth-Autorisierung durchführt.
Zum Beispiel:
Check the French translation status for the Developer Docs help center.claude mcp add --transport http notiondesk https://mcp.notiondesk.so/mcpclaude mcp add --transport http --scope project notiondesk https://mcp.notiondesk.so/mcpclaude mcp add --transport http --scope user notiondesk https://mcp.notiondesk.so/mcp- Ein Betrachter kann unterstützte schreibgeschützte Werkzeuge verwenden.
- Ein Redakteur kann auf unterstützte Verwaltungsaktionen zugreifen.
- Ein Administrator oder Workspace-Inhaber kann auf zusätzliche administrative Aktionen zugreifen.
Das Hinzufügen von Notiondesk MCP zu einem gemeinsamen Projekt teilt die Notiondesk Berechtigungen eines Teammitglieds nicht mit allen anderen.
Jeder Teamkollege authentifiziert sich separat.
Fehlerbehebung
Claude Code kann den MCP-Server Notiondesk nicht finden.
Laufen:
Bestätigen Sie, dass notiondesk angezeigt wird.
Falls dies nicht der Fall ist, fügen Sie es erneut hinzu:
claude mcp listclaude mcp add --transport http notiondesk https://mcp.notiondesk.so/mcp Die OAuth-Authentifizierung startet nicht.
Öffne den Claude-Code und gib Folgendes ein:
Wählen Sie den Server Notiondesk aus und starten Sie die Authentifizierung.
Falls sich Ihr Browser nicht automatisch öffnet, stellt Ihnen Claude Code möglicherweise eine URL zur Verfügung, die Sie manuell öffnen können.
/mcp Der Server Notiondesk wurde hinzugefügt, aber nicht authentifiziert.
Verwenden:
Wählen Sie anschließend den Server Notiondesk aus und schließen Sie den OAuth-Ablauf ab.
Das Hinzufügen des MCP-Servers und die Authentifizierung Ihres Notiondesk-Kontos sind separate Schritte.
/mcp Ein Hilfezentrum fehlt.
Bestätigen Sie Folgendes:
- Workspace MCP ist für dieses Hilfezentrum aktiviert.
- Ihr Notiondesk-Konto hat Zugriff darauf.
Claude Code kann nicht auf ein Hilfecenter zugreifen, das für das während der OAuth-Autorisierung verwendete Konto nicht verfügbar ist.
Einige Aktionen sind nicht verfügbar.
Workspace MCP folgt Ihrer Notiondesk Rolle.
Wenn Claude Code zwar Informationen lesen, aber eine bestimmte Aktion nicht ausführen kann, verfügt Ihr Konto möglicherweise nicht über die erforderliche Berechtigung.
Weitere Informationen finden Sie unter Workspace MCP-Rollen, Berechtigungen und Sicherheit .
Die Authentifizierung funktioniert nicht mehr.
Offen:
Wählen Sie den Server Notiondesk aus und authentifizieren Sie sich erneut.
Sie können die bestehende Authentifizierung auch über das MCP-Menü löschen, bevor Sie die Verbindung wiederherstellen.
/mcpEntfernen Sie Notiondesk MCP
So entfernen Sie den Server aus Claude Code:
Das Entfernen des Servers aus Claude Code deaktiviert Workspace MCP in Notiondesk nicht und hat keine Auswirkungen auf Verbindungen von anderen KI-Clients.
claude mcp remove notiondesk