> For the complete documentation index, see [llms.txt](https://docs.verge.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verge.io/overview/fr/travailler-avec-des-outils-dia/connect-via-mcp.md).

# Se connecter via MCP

VergeOS Docs publie un **serveur MCP (Model Context Protocol) hébergé**. Connectez-le à un assistant IA — Claude, Cursor, VS Code Copilot, Codex et autres — et cet assistant pourra rechercher et lire directement cette documentation tout en vous aidant, au lieu de deviner ou de s’appuyer sur des données d’entraînement obsolètes.

{% hint style="info" %}
Vous avez besoin d’un client qui prend en charge **les serveurs MCP distants via HTTP**. Le serveur est सार्वजनिक, donc aucune clé API ni connexion n’est requise.
{% endhint %}

## Le serveur

|                      |                                      |
| -------------------- | ------------------------------------ |
| **URL**              | `https://docs.verge.io/~gitbook/mcp` |
| **Transport**        | HTTP streamable                      |
| **Authentification** | Aucune (public)                      |

## Ajouter le serveur

{% tabs %}
{% tab title="Claude Code" %}
Exécutez la commande CLI pour l’ajouter à votre compte utilisateur :

```bash
claude mcp add vergeos-docs --scope user --transport http https://docs.verge.io/~gitbook/mcp
```

Puis confirmez qu’il est connecté :

```bash
claude mcp list
```

{% endtab %}

{% tab title="Claude Desktop" %}

1. Ouvrez **Paramètres → Connecteurs**.
2. Choisissez **Ajouter un connecteur personnalisé**.
3. Nommez-le `VergeOS Docs` et définissez l’URL sur :

   ```
   https://docs.verge.io/~gitbook/mcp
   ```
4. Enregistrez, puis activez le connecteur dans un nouveau chat.
   {% endtab %}

{% tab title="Cursor" %}
Ajoutez le serveur à `~/.cursor/mcp.json` (global) ou `.cursor/mcp.json` (par projet) :

```json
{
  "mcpServers": {
    "vergeos-docs": {
      "url": "https://docs.verge.io/~gitbook/mcp"
    }
  }
}
```

{% endtab %}

{% tab title="VS Code" %}
Utilisez le lien d’installation en un clic :

```
vscode:mcp/install?%7B%22name%22%3A%22VergeOS%20Docs%22%2C%22url%22%3A%22https%3A%2F%2Fdocs.verge.io%2F~gitbook%2Fmcp%22%7D
```

Ou ajoutez-le manuellement à `.vscode/mcp.json`:

```json
{
  "servers": {
    "VergeOS Docs": {
      "url": "https://docs.verge.io/~gitbook/mcp"
    }
  }
}
```

{% endtab %}

{% tab title="Codex" %}
Exécutez la commande CLI :

```bash
codex mcp add vergeos-docs --url https://docs.verge.io/~gitbook/mcp
```

{% endtab %}
{% endtabs %}

## Ce que vous obtenez

Une fois connecté, l’assistant dispose de deux outils :

* **`searchDocumentation`** — recherche dans toute la documentation VergeOS et renvoie le contenu correspondant avec des liens directs vers les pages.
* **`getPage`** — récupère le Markdown complet d’une page de documentation spécifique.

## Essayez-le

Demandez à votre assistant quelque chose qui devrait s’appuyer sur la documentation, par exemple :

{% hint style="success" %}

* "Recherchez dans la documentation VergeOS comment configurer une synchronisation de site."
* "En utilisant la documentation VergeOS, résumez les étapes pour migrer une VM depuis VMware."
* "Que dit la documentation VergeOS au sujet du dimensionnement des nœuds pour un déploiement en périphérie ?"
  {% endhint %}

Si les outils sont disponibles et que les réponses citent des pages de VergeOS Docs, la connexion fonctionne.

## Allez plus loin avec les compétences d’agent

Le serveur MCP donne à un assistant un accès en lecture à la documentation. Si vous utilisez **Claude Code** ou **Codex**, les [compétences d’agent VergeOS](/overview/fr/travailler-avec-des-outils-dia/agent-skills.md) package ajoute par-dessus des workflows centrés sur les tâches — dépannage, diagnostics, formation et gestion d’infrastructure via le `vrg` CLI — et regroupe pour vous ce même serveur MCP de documentation.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.verge.io/overview/fr/travailler-avec-des-outils-dia/connect-via-mcp.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.