Verbind de MCP-werkruimte Notiondesk met VS Code

Verbind de MCP-werkruimte Notiondesk met VS Code via installatie met één klik of via mcp.json, en authenticeer vervolgens veilig met OAuth.

4 min lezen

Verbind de Notiondesk Workspace MCP met Visual Studio Code om toegang te krijgen tot uw Notiondesk workspace vanuit de AI-tools van VS Code.

U kunt de verbinding rechtstreeks vanaf Notiondesk installeren of de externe MCP-server handmatig configureren.

Workspace MCP maakt gebruik van OAuth en volgt de machtigingen van de teamgenoot Notiondesk die de verbinding autoriseert.

Voordat je begint

Zorg ervoor dat:

  • Workspace MCP is ingeschakeld voor ten minste één Notiondesk helpcentrum
  • Je kunt je aanmelden bij de Notiondesk werkruimte waarmee je verbinding wilt maken.
  • Je gebruikt een versie van VS Code met MCP-ondersteuning.

Als Workspace MCP nog niet is ingeschakeld, raadpleeg dan Workspace MCP inschakelen in Notiondesk .

Verbind Notiondesk vanuit het dashboard

De eenvoudigste configuratie begint bij Notiondesk.

  1. Open je Notiondesk dashboard
  1. Selecteer een helpcentrum waar Workspace MCP is ingeschakeld.
  1. Ga naar Instellingen → Algemeen
  1. Zoek het Workspace MCP- gedeelte
  1. Open Installeren in uw client
  1. Selecteer VS Code
  1. Klik op 'Toevoegen aan VS Code'.

VS Code opent de details van de Notiondesk MCP-server.

  1. Controleer de servernaam en URL.
  1. Klik op Installeren
  1. Start de server als VS Code daarom vraagt.
  1. Voltooi de Notiondesk OAuth-autorisatie in uw browser.

Zodra de autorisatie is voltooid, worden de Notiondesk tools beschikbaar in VS Code.

Configureer Notiondesk MCP handmatig

Je kunt Workspace MCP ook configureren met het mcp.json-bestand van VS Code.

Voor een projectspecifieke verbinding kunt u het volgende aanmaken of openen:

Toevoegen:

Sla het bestand op.

VS Code zou de nieuwe MCP-server moeten detecteren.

Zorg ervoor dat Notiondesk beschikbaar is voor alle projecten.

Als je Notiondesk regelmatig in verschillende projecten gebruikt, kun je de server toevoegen aan je VS Code-gebruikersprofiel in plaats van aan een aparte werkruimte.

Open het opdrachtpalet en voer het volgende commando uit:

Voeg de externe HTTP-server toe:

Kies uw gebruikersprofiel als configuratiedoel.

Een MCP-server op gebruikersniveau is beschikbaar voor al uw VS Code-werkruimtes.

Start de Notiondesk MCP-server

Open het opdrachtpalet en voer het volgende commando uit:

Selecteer notiondesk .

Van daaruit kunt u de server starten, stoppen, herstarten of inspecteren.

Wanneer u voor het eerst verbinding maakt, kan VS Code u vragen te bevestigen dat u de MCP-server vertrouwt.

Controleer de configuratie en geef uw goedkeuring om verder te gaan.

Authenticeer met Notiondesk

Wanneer VS Code verbinding maakt met de MCP-werkruimte Notiondesk, start het de OAuth-autorisatiestroom.

.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 wordt geopend in uw browser.

Dan:

  1. Meld u aan bij Notiondesk indien nodig
  1. Controleer of de juiste werkruimte wordt weergegeven.
  1. Controleer de aangevraagde machtigingen.
  1. De verbinding goedkeuren
  1. Terug naar VS Code

Controleer de verbinding

Begin met een alleen-lezen verzoek in VS Code:

Controleer of de verwachte helpcentra zijn geretourneerd.

Probeer dan eens:

Je kunt ook vragen:

Of:

Begin met alleen-lezen-verzoeken voordat u VS Code vraagt ​​om wijzigingen uit te voeren.

Gebruik Workspace MCP vanuit VS Code

Zodra de verbinding tot stand is gebracht, kan VS Code de beschikbare Notiondesk-tools gebruiken wanneer deze relevant zijn voor uw verzoek.

Bijvoorbeeld:

Als uw rol Notiondesk ondersteunde acties toestaat, kunt u ook het volgende aanvragen:

De beschikbare tools zijn afhankelijk van uw Notiondesk-rol en de helpcentra waartoe u toegang hebt.

Werk samen met meerdere helpdesks.

Dezelfde VS Code-verbinding kan toegang bieden tot meerdere Notiondesk helpcentra.

Een helpdesk is beschikbaar wanneer:

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 is hiervoor ingeschakeld.
  • Uw Notiondesk-account heeft toestemming om er toegang toe te krijgen.

U hoeft niet voor elk helpcentrum een ​​aparte MCP-configuratie aan te maken.

Wanneer u met meerdere helpcentra werkt, geef dan aan met welk helpcentrum u het hebt:

Werkruimte versus gebruikersconfiguratie

Gebruik een werkruimteconfiguratie wanneer Notiondesk MCP slechts voor één project geconfigureerd moet worden:

Gebruik een gebruikersconfiguratie als u wilt dat Notiondesk MCP beschikbaar is in al uw VS Code-werkruimtes.

Als een werkruimteconfiguratie wordt opgenomen in versiebeheer, kunnen andere teamleden dezelfde MCP-serverdefinitie ontvangen, maar elk teamlid moet zich nog steeds authenticeren met zijn of haar eigen Notiondesk-account.

Deel OAuth-gegevens niet met teamgenoten.

Probleemoplossing

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

Notiondesk verschijnt niet in VS Code

Open het opdrachtpalet en voer het volgende commando uit:

Controleer of de server notiondesk verschijnt.

Als je het handmatig hebt geconfigureerd, controleer dan of je bestand het volgende bevat:

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

De server start niet op.

Loop:

Selecteer de server Notiondesk en kies 'Uitvoer weergeven' om de MCP-logboeken te bekijken.

Je kunt de server ook vanuit hetzelfde menu opnieuw opstarten.

MCP: List Servers

OAuth-authenticatie start niet.

Controleer of de server-URL exact hetzelfde is:

Voeg geen /sse toe en wijzig de URL niet.

Start de server opnieuw op via MCP: Servers weergeven en probeer de authenticatie opnieuw.

https://mcp.notiondesk.so/mcp

Er is geen helpdesk aanwezig.

Controleer dat:

  • Workspace MCP is ingeschakeld voor dat helpcentrum.
  • Uw Notiondesk account heeft er toegang toe.

VS Code heeft geen toegang tot helpcentra die niet beschikbaar zijn voor de teamgenoot met gebruikersnaam Notiondesk die de autorisatie heeft voltooid.

Sommige Notiondesk-tools ontbreken

Workspace MCP volgt uw Notiondesk rol.

Een kijker heeft niet dezelfde mogelijkheden als een redacteur of beheerder.

Zie Workspace MCP-rollen, -machtigingen en -beveiliging voor meer informatie.

Ontkoppel Notiondesk van VS Code

Je kunt de Notiondesk MCP-server uitschakelen of verwijderen uit VS Code wanneer je deze niet langer nodig hebt.

Loop:

Selecteer de server Notiondesk en schakel deze uit of verwijder deze.

Als u dit handmatig hebt geconfigureerd, kunt u ook de vermelding notiondesk uit uw mcp.json verwijderen.

Het verbreken van de verbinding met VS Code schakelt Workspace MCP in Notiondesk niet uit en heeft geen invloed op andere AI-clients of teamgenoten.

MCP: List Servers

Gerelateerde artikelen

Was deze pagina nuttig?