# MCP de documentation **Ce serveur concerne uniquement la documentation.** Pour consulter ou modifier les données de votre espace de travail Insyder, utilisez le [MCP natif](/guides/native-mcp) avec une connexion OAuth ou une clé API personnelle Insyder. Vous pouvez connecter les deux serveurs sous des noms distincts : **Insyder API Docs** et **Insyder Native**. Le site de documentation Insyder expose un serveur Model Context Protocol (MCP). Un assistant IA compatible peut l’utiliser pour rechercher dans ces guides, découvrir les endpoints, examiner les schémas de requête et de réponse, et comprendre les exigences d’authentification du contrat OpenAPI actuel. ## Adresse du serveur ```text https://docs.insyder.io/mcp ``` Les boutons Claude et ChatGPT mènent aux instructions ci-dessous. Les autres clients MCP peuvent ajouter manuellement cette adresse HTTPS comme serveur distant utilisant le transport Streamable HTTP. Le serveur de documentation est public et ne nécessite aucune authentification ni clé API Insyder. ## Se connecter avec Claude 1. Ouvrez [Claude](https://claude.ai), puis **Customize > Connectors**. 2. Sélectionnez **+ > Add custom connector**. 3. Nommez le connecteur **Insyder API Docs** et saisissez `https://docs.insyder.io/mcp` comme URL du serveur MCP distant. Laissez les champs OAuth facultatifs vides. 4. Sélectionnez **Add**, puis activez le connecteur dans **+ > Connectors** dans votre conversation. Pour un espace Team ou Enterprise, un propriétaire doit d’abord ajouter le connecteur dans **Organization settings > Connectors**. Consultez les [instructions de Claude sur les connecteurs personnalisés](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp) pour plus de détails. ## Se connecter avec ChatGPT 1. Ouvrez [ChatGPT](https://chatgpt.com) et activez **Developer mode** dans **Settings > Security and login**. 2. Ouvrez **Plugins**, puis sélectionnez le bouton **+** pour ajouter un serveur MCP. 3. Nommez-le **Insyder API Docs** et décrivez-le ainsi : **Rechercher dans la documentation Insyder et examiner le contrat de l’API publique**. 4. Sous **Connection**, saisissez `https://docs.insyder.io/mcp`. Choisissez **No authentication** si cette option apparaît, puis créez la connexion et vérifiez les outils découverts. 5. Démarrez une conversation et sélectionnez la connexion dans le menu des outils. La disponibilité du mode développeur dépend de votre compte et des règles de votre espace de travail. Consultez les [instructions de connexion MCP d’OpenAI](https://developers.openai.com/plugins/deploy/connect-chatgpt#test-an-mcp-server-optional) si vos paramètres diffèrent. ## Outils de documentation disponibles Les outils publiés permettent de lister les API et leurs endpoints, d’obtenir le détail des endpoints et les schémas de sécurité, de rechercher dans la documentation et de récupérer la description complète de l’API. La documentation fournie aux agents MCP est en **anglais par défaut**, indépendamment de la langue du site. L’outil de recherche accepte `locale: "fr"` pour demander explicitement des résultats en français. Le contrat OpenAPI fourni par MCP reste en anglais. Ces outils sont en lecture seule. Connecter le serveur MCP n’ajoute aucune clé API, ne donne accès à aucun espace de travail et n’exécute aucune requête vers `api.insyder.io`. Le serveur MCP ne peut pas : - Contourner les autorisations d’une clé API ou accéder à un espace de travail non sélectionné. - Lire ou modifier les données d’un espace de travail Insyder. - Exposer des identifiants de connexion, des données brutes de fournisseurs ou des paramètres de connexion. - Exécuter des opérations absentes de l’API publique, notamment les commandes de connexion, de synchronisation et d’analyse. ## Protection des identifiants Ne collez jamais une clé `insyder_live_` dans un message ou dans la configuration du **MCP de documentation**. Ce serveur public n’en a pas besoin. Le [MCP natif](/guides/native-mcp) utilise le consentement OAuth pour les connexions hébergées de Claude et ChatGPT, ou une clé dans une configuration client privée ; suivez ses instructions pour autoriser l’accès à un espace de travail. Utilisez ce serveur pour explorer la documentation. Pour travailler avec vos données, connectez le [MCP natif](/guides/native-mcp) ou appelez `https://api.insyder.io/v1` depuis votre intégration.