# Utilisez la documentation avec l’IA

{% columns %}
{% column width="41.66666666666667%" %}
Chaque page de la documentation Navixy comprend 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 directement la documentation à vos outils d’IA via MCP.
{% endcolumn %}

{% column width="58.33333333333333%" %}

<figure><img src="/files/6aaae0128c80c6ab5ae099641af8d5a056b66c31" alt="" width="269"><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

## Raccourcis de page intégrés

| Raccourci                          | Ce qu’il fait                                        | Quand l’utiliser                                                                                                                      |
| ---------------------------------- | ---------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| **Copier la page**                 | Copie la page complète au format Markdown            | Collez le contexte complet dans n’importe quel assistant IA                                                                           |
| **Voir en Markdown**               | Ouvre la page en texte brut dans un nouvel onglet    | Inspectez la source brute ou copiez manuellement des sections spécifiques                                                             |
| **Copier** (sur les blocs de code) | Copie directement un bloc de code                    | À utiliser pour `curl` les commandes, les charges utiles JSON et les extraits de configuration afin d’éviter les erreurs de sélection |
| **Ouvrir dans ChatGPT**            | Ouvre la page dans ChatGPT avec le contenu préchargé | Posez des questions ou résumez sans rien copier-coller                                                                                |
| **Ouvrir dans Claude**             | Ouvre la page dans Claude avec le contenu préchargé  | Posez des questions ou résumez sans rien copier-coller                                                                                |
| **Exporter en PDF**                | Télécharge la page au format PDF                     | Enregistrez un instantané pour une utilisation hors ligne ou partagez-le en dehors de la documentation                                |

### Utilisation de Ouvrir dans ChatGPT et Ouvrir dans Claude

Les deux raccourcis envoient automatiquement la page actuelle comme contexte. Vous pouvez commencer à formuler des requêtes immédiatement sans copier ni coller. Cela est utile lorsque vous voulez une réponse rapide à propos d’une page spécifique sans changer d’outil manuellement.

{% columns %}
{% column %}
**Bonnes requêtes pour commencer :**

* Résume cette page avant que je la lise en entier.
* Transforme ceci en une liste de contrôle des prérequis.
* Génère des cas limites et des idées de tests à partir de cette référence.
* Explique ce que fait \[parameter] et quand je devrais le modifier.
  {% endcolumn %}

{% column %}
**Obtenir de meilleures réponses :**

Ajoutez une contrainte pour orienter la réponse. Demandez « étapes uniquement », « retourner du JSON » ou « hypothèses d’abord ». Si la page est longue, précisez sur quelle section vous voulez que l’assistant se concentre.
{% endcolumn %}
{% endcolumns %}

## Connexion du serveur MCP à vos outils d’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 d’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 d’abord. Cela 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 d’IA récupère les réponses directement à partir de la documentation publiée et peut créer des liens vers 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://navixy.com/docs/~gitbook/mcp
```

Vous pouvez aussi copier cette URL directement depuis l’option **Se connecter avec MCP** dans le menu des raccourcis de page.

### Connecter le serveur MCP

Utilisez la configuration ci-dessous pour les outils les plus courants. MCP fonctionne avec tout client qui prend en charge la configuration `mcpServers` .

{% tabs %}
{% tab title="Claude Desktop" %}
{% hint style="info" %}
Consultez la [documentation officielle de Claude](https://code.claude.com/docs/en/mcp) pour les informations les plus récentes sur l’utilisation des MCP avec Claude.
{% endhint %}

1. Dans Claude, accédez à **Paramètres** et sélectionnez **Développeur**.&#x20;
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://navixy.com/docs/~gitbook/mcp"
      ]
    }
  }
}
```

3. Quittez complètement Claude puis redémarrez-le. Recharger une fenêtre ne suffit pas.
   {% endtab %}

{% tab title="Cursor" %}
{% hint style="info" %}
Consultez la [documentation officielle de Cursor](https://cursor.com/docs/mcp) pour les informations les plus récentes sur l’utilisation des MCP avec Cursor.
{% endhint %}

1\. Accédez à **Paramètres**, ouvrez l’onglet **MCP** et sélectionnez **Ajouter un nouveau serveur MCP global**. Cela ouvre `~/.cursor/mcp.json`. Pour une configuration à l’échelle du 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://navixy.com/docs/~gitbook/mcp"
      ]
    }
  }
}
```

3. Quittez complètement Cursor puis redémarrez-le. Recharger une fenêtre ne suffit pas.
   {% endtab %}

{% tab title="VS Code" %}
{% hint style="info" %}
Consultez la [documentation officielle de VS Code](https://code.visualstudio.com/docs/copilot/customization/mcp-servers) pour les informations les plus récentes sur l’utilisation des MCP avec VS Code.
{% endhint %}

Si vous utilisez VS Code, c’est le chemin de configuration le plus rapide. Sélectionnez **Se connecter à VSCode** dans le menu des raccourcis de page. Cela ouvre une invite pour installer directement le serveur MCP dans votre environnement VS Code sans configuration manuelle.

1. Ouvrez VS Code et accédez aux paramètres de l’extension de votre assistant IA.

* Si l’extension prend en charge la configuration `mcpServers` , collez :

```json
{
  "mcpServers": {
    "navixy-docs": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://navixy.com/docs/~gitbook/mcp"
      ]
    }
  }
}
```

* Si l’extension prend en charge directement les points de terminaison HTTP MCP, 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 puis redémarrez-le.
   {% endtab %}

{% tab title="Autres IDE" %}
Si votre outil prend en charge MCP avec une commande locale, collez la configuration suivante :

```json
{
  "mcpServers": {
    "navixy-docs": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://navixy.com/docs/~gitbook/mcp"
      ]
    }
  }
}
```

S’il prend en charge MCP directement via HTTP, utilisez plutôt l’URL du point de terminaison :

```
https://www.navixy.com/docs/~gitbook/mcp
```

Dans les deux cas, redémarrez complètement l’outil après avoir ajouté le serveur.
{% endtab %}
{% endtabs %}

### Valider la connexion MCP

Après la configuration, exécutez cette requête pour confirmer que le serveur répond :

```
Utilise le serveur MCP de documentation navixy-docs.
Quelles pages couvrent les flux IoT Logic ?
Liste les pages que tu as trouvées et ajoute un lien vers chacune.
```

Si la réponse inclut des liens vers des pages spécifiques de la documentation Navixy, la connexion fonctionne. Une fois cela confirmé, vous pouvez demander à l’assistant de récupérer n’importe quelle page, de trouver des points de terminaison ou de suivre un flux de travail 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. Quittez l’application et rouvrez-la. Recharger une fenêtre ne suffit pas.

**L’assistant répond mais ne cite pas les sources.** Demandez explicitement des liens. Vous pouvez aussi lui demander de citer une courte phrase de la section à laquelle il s’est référé afin de confirmer qu’il a bien récupéré le bon contenu.

**Le contenu collé semble cassé.** Vérifiez s’il y a des retours à la ligne automatiques. C’est le plus fréquent avec les `curl` commandes et les longs chemins d’API copiés depuis la documentation.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://navixy.com/docs/home/fr/documentation-navixy/utilisez-la-documentation-avec-lia.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
