# Utiliser la documentation avec l'IA {% columns %} {% column width="41.66666666666667%" %} Chaque page de la documentation Navixy inclut des raccourcis intégrés pour travailler avec des assistants IA. Utilisez-les pour copier du contenu, ouvrir des pages directement dans ChatGPT ou Claude, ou connecter la documentation directement à vos outils IA via MCP. {% endcolumn %} {% column width="58.33333333333333%" %}
{% endcolumn %} {% endcolumns %} ## Raccourcis de page intégrés | Raccourci | Ce que ça fait | Quand l'utiliser | | ---------------------------------- | ---------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- | | **Copier la page** | Copie la page complète en Markdown | Coller le contexte complet dans n’importe quel assistant IA | | **Afficher en Markdown** | Ouvre la page en texte brut dans un nouvel onglet | Inspecter la source brute ou copier manuellement des sections spécifiques | | **Copier** (sur les blocs de code) | Copie directement un bloc de code | Utiliser pour `curl` commandes, charges JSON et extraits de configuration pour éviter les erreurs de sélection | | **Ouvrir dans ChatGPT** | Ouvre la page dans ChatGPT avec le contenu préchargé | Poser des questions ou résumer sans rien coller | | **Ouvrir dans Claude** | Ouvre la page dans Claude avec le contenu préchargé | Poser des questions ou résumer sans rien coller | | **Exporter en PDF** | Télécharge la page en PDF | Enregistrer une capture pour une utilisation hors ligne ou partager en dehors de la documentation | ### Utilisation de Ouvrir dans ChatGPT et Ouvrir dans Claude Les deux raccourcis envoient automatiquement la page courante en tant que contexte. Vous pouvez commencer à interroger immédiatement sans copier ni coller. Ceci est utile lorsque vous voulez une réponse rapide sur une page spécifique sans changer d’outil manuellement. {% columns %} {% column %} **Bons prompts pour commencer :** * Résumez cette page avant que je la lise en entier. * Transformez ceci en liste de contrôle de prérequis. * Générez des cas limites et des idées de tests à partir de cette référence. * Expliquez ce que fait \[parameter] et quand je devrais le modifier. {% endcolumn %} {% column %} **Obtenir de meilleurs résultats :** Ajoutez une contrainte pour orienter la réponse. Demandez « uniquement les étapes », « retourner du JSON » ou « hypothèses d’abord ». Si la page est longue, spécifiez la section sur laquelle vous voulez que l’assistant se concentre. {% endcolumn %} {% endcolumns %} ## Connexion du serveur MCP à vos outils IA Les raccourcis de page ci‑dessus fonctionnent bien lorsque vous avez déjà la bonne page ouverte. MCP (Model Context Protocol) va plus loin : il permet à votre outil IA de rechercher et de récupérer n’importe quelle page de la documentation Navixy à la demande, sans que vous ayez besoin de trouver et d’ouvrir la page au préalable. C’est particulièrement utile pendant le développement actif, lorsque vous naviguez entre plusieurs références d’API, configurations d’appareils et guides d’intégration au cours d’une seule session. Une fois connecté, votre outil IA récupère les réponses directement depuis la documentation publiée et peut lier les sections spécifiques qu’il a utilisées. ### Point de terminaison MCP Le serveur MCP est public et ne nécessite aucune authentification : ``` https://www.navixy.com/docs/~gitbook/mcp ``` Vous pouvez également copier cette URL directement depuis le **Connect with MCP** option du menu des raccourcis de page. ### Connecter le serveur MCP Utilisez la configuration Ci‑dessous vous trouverez les étapes de configuration pour les outils les plus courants. MCP fonctionne avec tout client qui prend en charge `mcpServers` de configuration. {% tabs %} {% tab title="Claude Desktop" %} 1. Dans Claude, allez dans **Paramètres** et sélectionnez **Développeur**. 2. Sélectionnez **Modifier la configuration** pour ouvrir `claude_desktop_config.json`, puis ajoutez ce qui suit : ```json { "mcpServers": { "navixy-docs": { "command": "npx", "args": [ "mcp-remote", "https://www.navixy.com/docs/~gitbook/mcp" ] } } } ``` 3. Quittez complètement Claude et redémarrez-le. Un simple rechargement de fenêtre ne suffit pas. {% endtab %} {% tab title="Cursor" %} 1\. Allez à **Paramètres**, ouvrez l’onglet **MCP** et sélectionnez **Ajouter un nouveau serveur MCP global**. Cela ouvre `~/.cursor/mcp.json`. Pour une configuration limitée au projet, créez ou modifiez `.cursor/mcp.json` à la racine de votre projet à la place. 2. Collez ce qui suit dans le fichier : ```json { "mcpServers": { "navixy-docs": { "command": "npx", "args": [ "mcp-remote", "https://www.navixy.com/docs/~gitbook/mcp" ] } } } ``` 3. Quittez complètement Cursor et redémarrez-le. Un simple rechargement de fenêtre ne suffit pas. {% endtab %} {% tab title="VS Code" %} Si vous utilisez VS Code, c’est la voie d’installation la plus rapide. Sélectionnez **Connect to VSCode** dans le menu des raccourcis de page. Cela ouvre une invite pour installer le serveur MCP directement dans votre environnement VS Code sans configuration manuelle. 1. Ouvrez VS Code et allez dans les paramètres de l’extension de votre assistant IA. * Si l’extension prend en charge `mcpServers` la configuration, collez : ```json { "mcpServers": { "navixy-docs": { "command": "npx", "args": [ "mcp-remote", "https://www.navixy.com/docs/~gitbook/mcp" ] } } } ``` * Si l’extension prend en charge des points de terminaison MCP HTTP directs, utilisez plutôt l’URL : ``` https://www.navixy.com/docs/~gitbook/mcp ``` Utilisez la méthode documentée par votre extension. 2. Quittez complètement VS Code et redémarrez-le. {% endtab %} {% tab title="Autres IDE" %} Si votre outil prend en charge MCP via une commande locale, collez la configuration suivante : ```json { "mcpServers": { "navixy-docs": { "command": "npx", "args": [ "mcp-remote", "https://www.navixy.com/docs/~gitbook/mcp" ] } } } ``` S’il prend en charge MCP via HTTP directement, utilisez plutôt l’URL du point de terminaison : ``` https://www.navixy.com/docs/~gitbook/mcp ``` Dans les deux cas, redémarrez entièrement l’outil après avoir ajouté le serveur. {% endtab %} {% endtabs %} ### Valider la connexion MCP Après l’installation, exécutez ce prompt pour confirmer que le serveur répond : ``` Utilisez le serveur MCP de la documentation navixy-docs. Quelles pages couvrent les flux IoT Logic ? Listez les pages que vous avez trouvées et liez chacune d’elles. ``` Si la réponse inclut des liens vers des pages spécifiques de la documentation Navixy, la connexion fonctionne. Une fois confirmée, vous pouvez demander à l’assistant de récupérer n’importe quelle page, trouver des points de terminaison ou retracer un flux complet à travers plusieurs sections de la documentation. ## Dépannage **Rien n’a changé après l’ajout du serveur.** Redémarrez complètement l’outil. Fermez l’application et ouvrez‑la à nouveau. Un simple rechargement de fenêtre ne suffit pas. **L’assistant répond mais ne cite pas ses sources.** Demandez explicitement des liens. Vous pouvez aussi lui demander de citer une courte phrase de la section qu’il a référencée pour confirmer qu’il a récupéré le bon contenu. **Le contenu collé semble corrompu.** Vérifiez les retours à la ligne. Cela se produit le plus souvent avec `curl` commandes et chemins d’API longs copiés depuis la documentation.