Verbinde den Workspace Notiondesk (MCP) mit VS Code

Verbinden Sie den Workspace MCP Notiondesk mit VS Code mithilfe der Ein-Klick-Installation oder der Datei mcp.json und authentifizieren Sie sich anschließend sicher mit OAuth.

5 Min. Lesezeit

Verbinden Sie den Notiondesk Workspace MCP mit Visual Studio Code, um über die KI-Tools von VS Code auf Ihren Notiondesk Workspace zuzugreifen.

Sie können die Verbindung direkt von Notiondesk aus installieren oder den Remote-MCP-Server manuell konfigurieren.

Workspace MCP verwendet OAuth und richtet sich nach den Berechtigungen des Teammitglieds Notiondesk, das die Verbindung autorisiert.

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.
  • Sie verwenden eine Version von VS Code mit MCP-Unterstützung.

Falls Workspace MCP noch nicht aktiviert ist, siehe Workspace MCP aktivieren in Notiondesk .

Verbinden Sie Notiondesk vom Dashboard aus

Die einfachste Einrichtung beginnt mit Notiondesk.

  1. Öffnen Sie Ihr Notiondesk Dashboard
  1. Wählen Sie ein Hilfecenter aus, in dem Workspace MCP aktiviert ist.
  1. Gehen Sie zu Einstellungen → Allgemein
  1. Suchen Sie den Workspace MCP- Abschnitt
  1. Öffnen Sie die Installation in Ihrem Client.
  1. VS Code auswählen
  1. Klicken Sie auf „Zu VS Code hinzufügen“ .

VS Code öffnet die Notiondesk MCP-Serverdetails.

  1. Überprüfen Sie den Servernamen und die URL.
  1. Klicken Sie auf Installieren.
  1. Starten Sie den Server, wenn VS Code Sie dazu auffordert.
  1. Schließen Sie die OAuth-Autorisierung Notiondesk in Ihrem Browser ab.

Sobald die Autorisierung abgeschlossen ist, stehen die Notiondesk-Tools in VS Code zur Verfügung.

Konfigurieren Sie Notiondesk MCP manuell

Sie können Workspace MCP auch mit der mcp.json-Datei von VS Code konfigurieren.

Für eine projektspezifische Verbindung erstellen oder öffnen Sie Folgendes:

Hinzufügen:

Speichern Sie die Datei.

VS Code sollte den neuen MCP-Server erkennen.

Stellen Sie sicher, dass Notiondesk in allen Projekten verfügbar ist.

Wenn Sie Notiondesk regelmäßig in verschiedenen Projekten verwenden, können Sie den Server Ihrem VS Code-Benutzerprofil anstatt eines einzelnen Arbeitsbereichs hinzufügen.

Öffnen Sie die Befehlspalette und führen Sie Folgendes aus:

Fügen Sie den Remote-HTTP-Server hinzu:

Wählen Sie Ihr Benutzerprofil als Konfigurationsziel aus.

Ein MCP-Server auf Benutzerebene ist in all Ihren VS Code-Arbeitsbereichen verfügbar.

Starten Sie den Notiondesk MCP-Server

Öffnen Sie die Befehlspalette und führen Sie Folgendes aus:

Wählen Sie notiondesk aus.

Von dort aus können Sie den Server starten, stoppen, neu starten oder überprüfen.

Beim erstmaligen Herstellen der Verbindung kann VS Code Sie auffordern, zu bestätigen, dass Sie dem MCP-Server vertrauen.

Überprüfen Sie die Konfiguration und genehmigen Sie sie, um fortzufahren.

Authentifizieren Sie sich mit Notiondesk

Wenn VS Code eine Verbindung zum Workspace MCP Notiondesk herstellt, startet es den OAuth-Autorisierungsablauf.

.vscode/mcp.json
{
  "servers": {
    "notiondesk": {
      "type": "http",
      "url": "https://mcp.notiondesk.so/mcp"
    }
  }
}
MCP: Add Server
https://mcp.notiondesk.so/mcp
MCP: List Servers

Notiondesk öffnet sich in Ihrem Browser.

Dann:

  1. Melden Sie sich bei Bedarf bei Notiondesk an.
  1. Vergewissern Sie sich, dass der richtige Arbeitsbereich angezeigt wird.
  1. Überprüfen Sie die angeforderten Berechtigungen.
  1. Verbindung genehmigen
  1. Zurück zu VS Code

Überprüfen Sie die Verbindung.

Beginnen Sie mit einer schreibgeschützten Anfrage in VS Code:

Bestätigen Sie, dass die erwarteten Hilfezentren wieder erreichbar sind.

Dann versuchen Sie Folgendes:

Sie können auch fragen:

Oder:

Beginnen Sie mit Leseanfragen, bevor Sie VS Code auffordern, Änderungen vorzunehmen.

Verwenden Sie Workspace MCP aus VS Code

Sobald die Verbindung hergestellt ist, kann VS Code die verfügbaren Tools nutzen, sofern diese für Ihre Anfrage relevant sind.

Zum Beispiel:

Wenn Ihre Notiondesk-Rolle unterstützte Aktionen zulässt, können Sie auch Folgendes fragen:

Die verfügbaren Tools hängen von Ihrer Notiondesk Rolle und den Ihnen zugänglichen Hilfezentren ab.

Arbeiten Sie mit mehreren Hilfezentren zusammen

Über dieselbe VS Code-Verbindung können mehrere Notiondesk-Hilfezentren aufgerufen werden.

Ein Hilfecenter ist verfügbar, wenn:

List the Notiondesk help centers I can access.
Show the sync status for my main help center.
Show me the latest negative article feedback.
Review recent chatbot conversations and identify repeated customer questions.
Review article feedback and help center analytics from the last 30 days. Show me which articles need attention first.
Trigger a sync for the onboarding collection.
  • Workspace MCP ist dafür aktiviert.
  • Ihr Notiondesk-Konto hat die Berechtigung, darauf zuzugreifen.

Sie benötigen keine separate MCP-Konfiguration für jedes Helpcenter.

Wenn Sie mit mehreren Hilfezentren arbeiten, geben Sie bitte an, welches Sie meinen:

Arbeitsbereichs- vs. Benutzerkonfiguration

Verwenden Sie eine Arbeitsbereichskonfiguration, wenn Notiondesk MCP nur für ein Projekt konfiguriert werden soll:

Verwenden Sie eine Benutzerkonfiguration, wenn Sie Notiondesk MCP in allen Ihren VS Code-Arbeitsbereichen verfügbar haben möchten.

Wenn eine Workspace-Konfiguration in die Quellcodeverwaltung übernommen wird, können andere Teammitglieder dieselbe MCP-Serverdefinition erhalten, aber jedes Teammitglied muss sich weiterhin mit seinem eigenen Notiondesk-Konto authentifizieren.

Geben Sie die OAuth-Zugangsdaten nicht an Teammitglieder weiter.

Fehlerbehebung

Check the translation status for the Developer Docs help center.
.vscode/mcp.json

Notiondesk wird in VS Code nicht angezeigt.

Öffnen Sie die Befehlspalette und führen Sie Folgendes aus:

Bestätigen Sie, dass der Server notiondesk angezeigt wird.

Wenn Sie die Konfiguration manuell vorgenommen haben, überprüfen Sie, ob Ihre Datei Folgendes enthält:

MCP: List Servers
{
  "servers": {
    "notiondesk": {
      "type": "http",
      "url": "https://mcp.notiondesk.so/mcp"
    }
  }
}

Der Server startet nicht.

Laufen:

Wählen Sie den Server Notiondesk aus und klicken Sie auf „Ausgabe anzeigen“ , um die MCP-Protokolle zu überprüfen.

Über dasselbe Menü können Sie den Server auch neu starten.

MCP: List Servers

Die OAuth-Authentifizierung startet nicht.

Bitte überprüfen Sie, ob die Server-URL exakt lautet:

Fügen Sie /sse nicht hinzu und ändern Sie die URL nicht.

Starten Sie den Server über MCP neu: Server auflisten und Authentifizierung erneut versuchen.

https://mcp.notiondesk.so/mcp

Ein Hilfezentrum fehlt.

Prüfen Sie das:

  • Workspace MCP ist für dieses Hilfezentrum aktiviert.
  • Ihr Notiondesk-Konto hat Zugriff darauf.

VS Code kann nicht auf Hilfezentren zugreifen, die dem Teammitglied Notiondesk, das die Autorisierung abgeschlossen hat, nicht zur Verfügung stehen.

Einige Notiondesk-Werkzeuge fehlen.

Workspace MCP folgt Ihrer Notiondesk Rolle.

Ein Betrachter erhält nicht die gleichen Aktionen wie ein Redakteur oder Administrator.

Weitere Informationen finden Sie unter Workspace MCP-Rollen, Berechtigungen und Sicherheit .

Trenne Notiondesk von VS Code

Sie können den Notiondesk MCP-Server aus VS Code deaktivieren oder entfernen, wenn Sie ihn nicht mehr benötigen.

Laufen:

Wählen Sie den Server Notiondesk aus und deaktivieren oder entfernen Sie ihn.

Wenn Sie es manuell konfiguriert haben, können Sie auch den Eintrag notiondesk aus Ihrem mcp.json entfernen.

Das Entfernen der Verbindung aus VS Code deaktiviert Workspace MCP in Notiondesk nicht und hat keine Auswirkungen auf andere KI-Clients oder Teammitglieder.

MCP: List Servers

Verwandte Artikel

War diese Seite hilfreich?