Vous pouvez connecter Notiondesk Workspace MCP à n'importe quel client AI compatible qui prend en charge les serveurs MCP distants et l'authentification OAuth .
Utilisez ce guide lorsque votre client MCP ne dispose pas d'un guide d'installation dédié 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.
- Votre client MCP prend en charge les serveurs MCP HTTP distants
- Votre client MCP prend en charge l'authentification OAuth.
Si Workspace MCP n'est pas encore activé, consultez Activer Workspace MCP dans Notiondesk .
Détails de connexion
Utilisez ces informations lors de l'ajout de Notiondesk à votre client MCP :
N’ajoutez pas /sse à l’URL.
Le point de terminaison MCP de l'espace de travail est :
Ajouter le serveur MCP
Ouvrez les paramètres MCP ou de connecteur de votre client IA.
L'interface exacte dépend du client, mais vous devrez généralement :
Name: Notiondesk MCP
URL: https://mcp.notiondesk.so/mcp
Authentication: OAuthhttps://mcp.notiondesk.so/mcp- Ajouter un nouveau serveur MCP distant
- Saisissez Notiondesk MCP comme nom
- Saisissez
https://mcp.notiondesk.so/mcpcomme URL du serveur
- Sélectionnez l'authentification OAuth si votre client demande une méthode d'authentification.
- Sauvegarder ou se connecter au serveur
Si votre client MCP utilise un fichier de configuration au lieu d'une interface de paramètres, ajoutez Notiondesk comme serveur MCP HTTP distant utilisant la même URL.
Consultez la documentation MCP de votre client pour connaître son format de configuration exact.
Authentifiez-vous avec Notiondesk
Après avoir ajouté le serveur, lancez le processus de connexion ou d'authentification.
Votre client doit ouvrir Notiondesk dans votre navigateur.
Alors:
- Connectez-vous à Notiondesk si nécessaire
- Vérifiez que l'espace de travail correct est affiché.
- Examiner les autorisations demandées
- Approuver la connexion
- Retournez à votre client MCP
Workspace MCP utilise OAuth, vous ne devriez donc pas avoir besoin de copier manuellement un mot de passe ou une clé API Notiondesk dans votre client MCP.
Vérifiez la connexion
Commencez par une requête en lecture seule :
Vérifiez que les centres d'aide attendus s'affichent.
Essayez alors :
Vous pouvez également demander :
Commencer par des requêtes en lecture seule permet de confirmer que le client est connecté à l'espace de travail Notiondesk correct avant d'effectuer des actions.
Utiliser Workspace MCP
Une fois connecté, votre client MCP peut utiliser les outils Notiondesk disponibles sur votre compte.
Par exemple:
Ou:
Si votre rôle Notiondesk autorise les modifications prises en charge, vous pouvez également demander des actions telles que :
La manière exacte dont votre client découvre ou invoque les outils MCP dépend du client.
Autorisations
L'espace de travail MCP suit les permissions du coéquipier Notiondesk qui effectue l'autorisation OAuth.
Se connecter via un autre client MCP ne modifie pas vos autorisations Notiondesk.
Par exemple:
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 our article feedback and analytics from the last 30 days. Show me which articles need attention first.Check the translation status for my main help center.Trigger a sync for the onboarding collection.- Un utilisateur visionneur bénéficie d'un accès en lecture seule.
- Un éditeur peut effectuer des actions de gestion prises en charge.
- Un administrateur ou un propriétaire d'espace de travail peut accéder à des actions administratives supplémentaires.
Le client MCP ne peut pas obtenir plus d'accès que celui dont dispose déjà votre compte Notiondesk.
Collaborer avec plusieurs centres d'assistance
Une seule connexion Workspace MCP permet d'accéder à plusieurs centres d'aide.
Un centre d'aide est disponible lorsque :
- L'espace de travail MCP est activé pour cela
- Votre compte Notiondesk y a accès
Vous n'avez pas besoin d'une URL Workspace MCP différente pour chaque centre d'aide.
Le même point de terminaison est utilisé :
Lorsqu'il existe plusieurs centres d'aide, indiquez celui que vous souhaitez que votre assistant utilise.
Par exemple:
Dépannage
https://mcp.notiondesk.so/mcpReview article feedback for the Developer Docs help center. Mon client ne parvient pas à se connecter au serveur
Vérifiez que l'URL du serveur est exactement :
Ne pas utiliser :
ou ajoutez /sse au point de terminaison.
Votre client doit prendre en charge les serveurs MCP distants.
https://mcp.notiondesk.so/mcphttps://mcp.notiondesk.so/mcp/sse L'authentification OAuth ne démarre pas
Votre client MCP doit prendre en charge l'authentification OAuth pour les serveurs MCP distants.
Si le client ne prend en charge que les serveurs MCP locaux, les clés API ou les en-têtes statiques, il se peut qu'il ne soit pas compatible avec Workspace MCP.
Consultez la documentation MCP de votre client.
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.
Workspace MCP ne peut pas afficher un centre d'aide auquel votre compte n'a pas accès.
Certains outils sont indisponibles.
Les outils MCP de l'espace de travail disponibles dépendent de votre rôle Notiondesk.
Votre client MCP peut également appliquer ses propres restrictions quant aux outils utilisables.
Consultez la section « Rôles, autorisations et sécurité de Workspace MCP » pour plus de détails.
La connexion fonctionne, mais les outils ne sont pas utilisés automatiquement.
Le choix des outils MCP dépend du client IA.
Certains clients exigent que vous :
- Activez le serveur MCP pour une conversation.
- Sélectionnez le connecteur manuellement
- Activer l'utilisation de l'outil
- Approuver les actions individuelles
Vérifiez les paramètres MCP de votre client si la connexion Notiondesk est active mais que ses outils ne sont pas disponibles dans les conversations.