Connectez Notiondesk Workspace MCP à Codex pour consulter les informations de l'espace de travail et effectuer les actions Notiondesk prises en charge à partir de l'extension Codex CLI ou IDE.
Notiondesk fonctionne comme un serveur MCP distant et utilise OAuth pour authentifier votre compte Notiondesk.
Avant de commencer
S'assurer:
- L'espace de travail MCP est activé pour au moins un centre d'aide Notiondesk
- Vous pouvez vous connecter à l'espace de travail Notiondesk auquel vous souhaitez vous connecter.
- Codex est installé et fonctionne sur votre ordinateur.
Si Workspace MCP n'est pas encore activé, consultez Activer Workspace MCP dans Notiondesk .
Ajouter Notiondesk MCP au Codex
Courir:
Cela ajoute le serveur MCP d'espace de travail Notiondesk à votre configuration Codex.
Authentifiez-vous avec Notiondesk
Après avoir ajouté le serveur, exécutez :
Votre navigateur ouvre la page d'autorisation OAuth Notiondesk.
Alors:
codex mcp add notiondesk --url https://mcp.notiondesk.so/mcpcodex mcp login notiondesk- Connectez-vous à Notiondesk si nécessaire.
- Vérifiez que l'espace de travail affiché est correct.
- Veuillez examiner les autorisations demandées.
- Approuver la connexion.
- Retour au Codex.
Vous n'avez pas besoin d'ajouter manuellement une clé API, un mot de passe ou un jeton Notiondesk.
L'authentification est gérée via OAuth.
Vérifiez la connexion
Vérifiez vos serveurs MCP configurés :
Vérifiez que notiondesk apparaît et est activé.
Vous pouvez ensuite commencer Codex :
Commencez par une requête en lecture seule :
Vérifiez que les centres d'aide attendus s'affichent.
Essayez alors :
Commencer par des requêtes en lecture seule permet de confirmer plus facilement que Codex est connecté à l'espace de travail Notiondesk correct avant d'effectuer des actions.
Utilisez Workspace MCP de Codex
Une fois connecté, Codex peut utiliser les outils Notiondesk disponibles lorsqu'ils sont pertinents pour votre tâche.
Par exemple:
Ou:
Si votre rôle Notiondesk autorise les modifications prises en charge, vous pouvez également demander à Codex d'effectuer des actions :
Les actions disponibles dépendent de votre rôle Notiondesk et des centres d'aide auxquels vous avez accès.
Utilisez Notiondesk MCP de l'extension Codex IDE
Codex partage sa configuration MCP entre l'interface de ligne de commande (CLI) et les intégrations IDE prises en charge.
Après avoir configuré Notiondesk avec :
Le même serveur MCP est accessible via l'extension Codex IDE.
codex mcp listcodexList 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/mcpSi l'extension était déjà ouverte lorsque vous avez ajouté le serveur, rechargez-la si Notiondesk n'apparaît pas.
Chaque connexion authentifiée Notiondesk continue de suivre les autorisations de votre propre espace de travail.
Configurer manuellement Notiondesk
Codex stocke sa configuration MCP dans :
Vous pouvez configurer manuellement Notiondesk avec :
Après avoir enregistré la configuration, authentifiez-vous avec :
L'utilisation de codex mcp add est généralement plus simple que la modification manuelle de la configuration.
Collaborer avec plusieurs centres d'assistance
Une seule connexion Codex permet d'accéder à plusieurs centres d'aide Notiondesk.
Un centre d'aide est disponible lorsque :
~/.codex/config.toml[mcp_servers.notiondesk]
url = "https://mcp.notiondesk.so/mcp"codex mcp login notiondesk- L'espace de travail MCP est activé pour cela
- Votre compte Notiondesk y a accès
Vous n'avez pas besoin de configurer un serveur MCP distinct pour chaque centre d'aide.
Lorsqu'il existe plusieurs centres d'aide, précisez avec lequel Codex doit collaborer :
Autorisations
Workspace MCP suit les permissions du compte Notiondesk utilisé lors de l'autorisation OAuth.
Par exemple:
Check the French translation status for the Developer Docs help center.- Les utilisateurs peuvent accéder aux informations en lecture seule prises en charge
- Les éditeurs peuvent effectuer des actions de gestion prises en charge
- Les administrateurs et les propriétaires d'espaces de travail peuvent accéder à des actions administratives supplémentaires.
La connexion de Notiondesk à Codex ne confère pas à votre compte des autorisations supplémentaires Notiondesk.
Dépannage
Notiondesk n'apparaît pas dans le Codex
Courir:
Vérifiez que notiondesk apparaît.
Si cela ne fonctionne pas, ajoutez à nouveau le serveur :
codex mcp listcodex mcp add notiondesk --url https://mcp.notiondesk.so/mcp Notiondesk est configuré mais non authentifié
Courir:
L'ajout du serveur MCP et la réalisation de l'authentification OAuth sont des étapes distinctes.
codex mcp login notiondesk L'authentification OAuth ne s'ouvre pas
Veuillez vérifier que l'URL MCP de l'espace de travail est :
Réessayez ensuite :
N’ajoutez pas /sse à l’URL MCP de l’espace de travail.
https://mcp.notiondesk.so/mcpcodex mcp login notiondesk Il manque un centre d'aide.
Confirmez que :
- L'espace de travail MCP est activé pour ce centre d'aide.
- Votre compte Notiondesk y a accès.
Codex ne peut pas accéder à un centre d'aide qui n'est pas disponible pour le compte Notiondesk utilisé lors de l'autorisation OAuth.
Certains outils Notiondesk sont indisponibles
L'espace de travail MCP suit votre rôle Notiondesk.
Si Codex peut lire les informations de l'espace de travail mais ne peut pas effectuer d'action, il se peut que votre compte ne dispose pas des autorisations requises.
Consultez la section « Rôles, autorisations et sécurité de Workspace MCP » pour plus de détails.
Le serveur apparaît dans codex mcp list mais n'est pas disponible dans une session
codex mcp list mais n'est pas disponible dans une sessionDémarrez une nouvelle session Codex après avoir configuré le serveur MCP.
Si vous utilisez l'extension IDE, rechargez-la après avoir modifié votre configuration MCP.
Supprimer Notiondesk MCP
Pour supprimer la connexion à Codex, utilisez les commandes de gestion MCP disponibles dans votre version de Codex installée.
Vous pouvez également supprimer l'entrée notiondesk de :
La suppression de la connexion Codex ne désactive pas Workspace MCP dans Notiondesk et n'affecte pas les autres clients IA ou coéquipiers.
~/.codex/config.toml