Verbind de MCP-werkruimte Notiondesk met Codex

Verbind de Notiondesk Workspace MCP met Codex, authenticeer met OAuth en krijg toegang tot de Notiondesk tools vanuit de Codex CLI of IDE-extensie.

4 min lezen

Verbind de Notiondesk Workspace MCP met Codex om werkruimte-informatie te bekijken en ondersteunde Notiondesk acties uit te voeren vanuit de Codex CLI of IDE-extensie.

Notiondesk functioneert als een externe MCP-server en gebruikt OAuth om uw Notiondesk-account te authenticeren.

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.
  • Codex is geïnstalleerd en werkt op uw computer.

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

Voeg Notiondesk MCP toe aan Codex

Loop:

Hiermee wordt de Notiondesk Workspace MCP-server aan uw Codex-configuratie toegevoegd.

Authenticeer met Notiondesk

Nadat je de server hebt toegevoegd, voer je het volgende commando uit:

Uw browser opent de Notiondesk OAuth-autorisatiepagina.

Dan:

codex mcp add notiondesk --url https://mcp.notiondesk.so/mcp
codex mcp login notiondesk
  1. Meld u indien nodig aan bij Notiondesk.
  1. Controleer of de juiste werkruimte wordt weergegeven.
  1. Controleer de aangevraagde machtigingen.
  1. De verbinding goedkeuren.
  1. Terug naar de Codex.

U hoeft geen Notiondesk API-sleutel, wachtwoord of token handmatig toe te voegen.

Authenticatie verloopt via OAuth.

Controleer de verbinding

Controleer uw geconfigureerde MCP-servers:

Controleer of notiondesk wordt weergegeven en is ingeschakeld.

Je kunt Codex dan starten:

Begin met een alleen-lezen verzoek:

Controleer of de verwachte helpcentra worden weergegeven.

Probeer dan eens:

Door te beginnen met alleen-lezen-verzoeken is het gemakkelijker om te bevestigen dat Codex is verbonden met de juiste Notiondesk-werkruimte voordat acties worden uitgevoerd.

Gebruik Workspace MCP van Codex

Zodra de verbinding tot stand is gebracht, kan Codex de beschikbare Notiondesk tools gebruiken wanneer deze relevant zijn voor uw taak.

Bijvoorbeeld:

Of:

Als uw Notiondesk-rol ondersteunde wijzigingen toestaat, kunt u Codex ook vragen om acties uit te voeren:

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

Gebruik Notiondesk MCP uit de Codex IDE-extensie.

Codex deelt zijn MCP-configuratie tussen de CLI en ondersteunde IDE-integraties.

Na het configureren van Notiondesk met:

Dezelfde MCP-server is ook beschikbaar via de Codex IDE-extensie.

codex mcp list
codex
List the Notiondesk help centers I can access.
Show the sync status for my main help center.
Review the last 30 days of article feedback and analytics. Show me which documentation needs attention first.
Review recent chatbot conversations and identify repeated customer questions that are not covered well by our documentation.
Trigger a sync for the onboarding collection.
codex mcp add notiondesk --url https://mcp.notiondesk.so/mcp

Als de extensie al open was toen je de server toevoegde, herlaad deze dan als Notiondesk niet verschijnt.

Elke geauthenticeerde Notiondesk-verbinding blijft de machtigingen van uw eigen werkruimte volgen.

Configureer Notiondesk handmatig

Codex slaat zijn MCP-configuratie op in:

Je kunt Notiondesk handmatig configureren met:

Na het opslaan van de configuratie kunt u zich aanmelden met:

Het gebruik van codex mcp add is meestal eenvoudiger dan het handmatig bewerken van de configuratie.

Werk samen met meerdere helpdesks.

Met één Codex-verbinding heb je toegang tot meerdere Notiondesk helpcentra.

Een helpdesk is beschikbaar wanneer:

~/.codex/config.toml
[mcp_servers.notiondesk]
url = "https://mcp.notiondesk.so/mcp"
codex mcp login notiondesk
  • Workspace MCP is hiervoor ingeschakeld.
  • Uw Notiondesk account heeft er toegang toe.

U hoeft niet voor elk helpcentrum een ​​aparte MCP-server te configureren.

Als er meerdere helpcentra beschikbaar zijn, geef dan aan met welk helpcentrum Codex moet samenwerken:

Toestemmingen

Workspace MCP volgt de machtigingen van het Notiondesk-account dat tijdens de OAuth-autorisatie is gebruikt.

Bijvoorbeeld:

Check the French translation status for the Developer Docs help center.
  • Kijkers hebben toegang tot ondersteunde, alleen-lezen informatie.
  • Editors kunnen ondersteunde beheertaken uitvoeren.
  • Beheerders en eigenaren van werkruimtes hebben toegang tot aanvullende beheermogelijkheden.

Door Notiondesk te verbinden met Codex krijgt uw account geen extra Notiondesk machtigingen.

Probleemoplossing

Notiondesk komt niet voor in Codex

Loop:

Controleer of notiondesk wordt weergegeven.

Voeg de server dan opnieuw toe:

codex mcp list
codex mcp add notiondesk --url https://mcp.notiondesk.so/mcp

Notiondesk is geconfigureerd maar niet geverifieerd

Loop:

Het toevoegen van de MCP-server en het voltooien van de OAuth-authenticatie zijn afzonderlijke stappen.

codex mcp login notiondesk

OAuth-authenticatie wordt niet geopend

Controleer of de Workspace MCP-URL correct is:

Probeer het dan opnieuw:

Voeg /sse niet toe aan de Workspace MCP-URL.

https://mcp.notiondesk.so/mcp
codex mcp login notiondesk

Er is geen helpdesk aanwezig.

Bevestig dat:

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

Codex heeft geen toegang tot een helpcentrum dat niet beschikbaar is voor het Notiondesk-account dat tijdens de OAuth-autorisatie is gebruikt.

Sommige Notiondesk tools zijn niet beschikbaar

Workspace MCP volgt uw Notiondesk rol.

Als Codex werkruimte-informatie kan lezen maar geen actie kan uitvoeren, beschikt uw account mogelijk niet over de vereiste machtigingen.

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

De server verschijnt in codex mcp list maar is niet beschikbaar in een sessie.

Start een nieuwe Codex-sessie nadat u de MCP-server hebt geconfigureerd.

Als je de IDE-extensie gebruikt, moet je deze opnieuw laden nadat je je MCP-configuratie hebt gewijzigd.

Verwijder Notiondesk MCP

Om de verbinding met Codex te verbreken, gebruikt u de MCP-beheeropdrachten die beschikbaar zijn in uw geïnstalleerde Codex-versie.

Je kunt ook de vermelding notiondesk verwijderen uit:

Het verwijderen van de Codex-verbinding schakelt Workspace MCP in Notiondesk niet uit en heeft geen invloed op andere AI-clients of teamgenoten.

~/.codex/config.toml

Gerelateerde artikelen

Was deze pagina nuttig?