> ## Documentation Index
> Fetch the complete documentation index at: https://wiki.another-horizon.eu/llms.txt
> Use this file to discover all available pages before exploring further.

# Model Context Protocol

> Connectez votre documentation et vos endpoints d’API à des outils d’IA via un serveur MCP hébergé.

export const PreviewButton = ({children, href}) => {
  return <a href={href} className="text-sm font-medium text-white dark:!text-zinc-950 bg-zinc-900 hover:bg-zinc-700 dark:bg-zinc-100 hover:dark:bg-zinc-300 rounded-full px-3.5 py-1.5 not-prose">
        {children}
      </a>;
};

<div id="about-mcp-servers">
  ## À propos des serveurs MCP
</div>

Le Model Context Protocol (MCP) est un protocole ouvert qui crée des connexions standardisées entre les applications d’IA et des services externes, comme la documentation. Mintlify génère un serveur MCP à partir de votre documentation, en préparant votre contenu pour un écosystème d’IA plus vaste dans lequel n’importe quel client MCP (comme Claude, Cursor, Goose et d’autres) peut se connecter à votre documentation.

Votre serveur MCP expose un outil de recherche permettant aux applications d’IA d’interroger votre documentation.

<div id="how-mcp-servers-work">
  ### Fonctionnement des serveurs MCP
</div>

Lorsqu'un outil d'IA comme Claude, Cursor ou ChatGPT est connecté à votre serveur MCP de documentation, cet outil peut rechercher directement dans votre documentation pendant la génération de la réponse plutôt que d'effectuer une recherche générique sur le web.

* Le LLM peut rechercher de manière proactive dans votre documentation pendant qu'il génère une réponse, et pas seulement lorsqu'on le lui demande explicitement.
* Le LLM détermine quand utiliser l'outil de recherche en fonction du contexte de la conversation et de la pertinence de votre documentation.
* Chaque appel d'outil a lieu pendant le processus de génération, ce qui permet au LLM d'intégrer en temps réel des informations issues de votre documentation dans sa réponse.

Par exemple, si un utilisateur pose une question de programmation et que le LLM détermine que votre documentation est pertinente, il peut effectuer une recherche dans votre documentation et inclure ces informations dans la réponse sans que l'utilisateur ait à demander explicitement votre documentation.

<div id="access-your-mcp-server">
  ## Accéder à votre serveur MCP
</div>

<Note>
  Les serveurs MCP ne peuvent être générés que pour de la documentation publique. La documentation protégée par une authentification d’utilisateur final ne peut pas générer de serveur MCP.
</Note>

Mintlify génère automatiquement un serveur MCP pour votre documentation et l’héberge à l’URL de votre documentation avec le chemin `/mcp`. Par exemple, le serveur MCP de Mintlify est disponible à l’adresse `https://mintlify.com/docs/mcp`.

Vous pouvez afficher et copier l’URL de votre serveur MCP sur la [page du serveur MCP](https://dashboard.mintlify.com/products/mcp) dans votre Dashboard.

<Frame>
  <img src="https://mintcdn.com/anotherhorizon/nGGkQ8HPtMLIJ_OO/images/mcp/mcp-server-page-light.png?fit=max&auto=format&n=nGGkQ8HPtMLIJ_OO&q=85&s=a6871b23ff5895dfa6471749cfe8cd31" alt="Page du serveur MCP dans le Dashboard." className="block dark:hidden" width="2066" height="972" data-path="images/mcp/mcp-server-page-light.png" />

  <img src="https://mintcdn.com/anotherhorizon/nGGkQ8HPtMLIJ_OO/images/mcp/mcp-server-page-dark.png?fit=max&auto=format&n=nGGkQ8HPtMLIJ_OO&q=85&s=ef48d4693d3cad5d1a4ff3ccd92ed38b" alt="Page du serveur MCP dans le Dashboard." className="hidden dark:block" width="2068" height="974" data-path="images/mcp/mcp-server-page-dark.png" />
</Frame>

<Note>
  Les serveurs MCP hébergés utilisent le chemin `/mcp` dans leur URL. Les autres éléments de navigation ne peuvent pas utiliser le chemin `/mcp`.
</Note>

<div id="use-your-mcp-server">
  ## Utiliser votre serveur MCP
</div>

Vos utilisateurs doivent connecter votre serveur MCP à leurs outils d’IA préférés.

1. Rendez l’URL de votre serveur MCP publique.
2. Les utilisateurs copient l’URL de votre serveur MCP et l’ajoutent à leurs outils.
3. Les utilisateurs accèdent à votre documentation depuis leurs outils.

Voici quelques façons d’aider vos utilisateurs à se connecter à votre serveur MCP :

<Tabs>
  <Tab title="Menu contextuel">
    Ajoutez des options dans le [menu contextuel](/fr/ai/contextual-menu) pour permettre à vos utilisateurs de se connecter à votre serveur MCP depuis n’importe quelle page de votre documentation.

    | Option                          | Identifiant | Description                                                               |
    | :------------------------------ | :---------- | :------------------------------------------------------------------------ |
    | **Copier l’URL du serveur MCP** | `mcp`       | Copie l’URL de votre serveur MCP dans le presse‑papiers de l’utilisateur. |
    | **Se connecter à Cursor**       | `cursor`    | Installe votre serveur MCP dans Cursor.                                   |
    | **Se connecter à VS Code**      | `vscode`    | Installe votre serveur MCP dans VS Code.                                  |
  </Tab>

  <Tab title="Claude">
    <Steps>
      <Step title="Obtenez l’URL de votre serveur MCP.">
        Accédez à votre [Dashboard](https://dashboard.mintlify.com/products/mcp) et trouvez l’URL de votre serveur MCP.
      </Step>

      <Step title="Publiez l’URL de votre serveur MCP pour vos utilisateurs.">
        Créez un guide pour vos utilisateurs qui inclut l’URL de votre serveur MCP et les étapes pour le connecter à Claude.

        1. Accédez à la page [Connectors](https://claude.ai/settings/connectors) dans les paramètres de Claude.
        2. Sélectionnez **Add custom connector**.
        3. Ajoutez le nom et l’URL de votre serveur MCP.
        4. Sélectionnez **Add**.
        5. Lors de l’utilisation de Claude, sélectionnez le bouton des pièces jointes (l’icône « plus »).
        6. Sélectionnez votre serveur MCP.
      </Step>
    </Steps>

    Voir la [documentation Model Context Protocol](https://modelcontextprotocol.io/docs/tutorials/use-remote-mcp-server#connecting-to-a-remote-mcp-server) pour plus de détails.
  </Tab>

  <Tab title="Claude Code">
    <Steps>
      <Step title="Obtenez l’URL de votre serveur MCP.">
        Accédez à votre [Dashboard](https://dashboard.mintlify.com/products/mcp) et trouvez l’URL de votre serveur MCP.
      </Step>

      <Step title="Publiez l’URL de votre serveur MCP pour vos utilisateurs.">
        Créez un guide pour vos utilisateurs qui inclut l’URL de votre serveur MCP et la commande pour le connecter à Claude Code.

        ```bash theme={null}
        claude mcp add --transport http <name> <url>
        ```
      </Step>
    </Steps>

    Voir la [documentation Claude Code](https://docs.anthropic.com/en/docs/claude-code/mcp#installing-mcp-servers) pour plus de détails.
  </Tab>

  <Tab title="Cursor">
    <Steps>
      <Step title="Obtenez l’URL de votre serveur MCP.">
        Accédez à votre [Dashboard](https://dashboard.mintlify.com/products/mcp) et trouvez l’URL de votre serveur MCP.
      </Step>

      <Step title="Publiez l’URL de votre serveur MCP pour vos utilisateurs.">
        Créez un guide pour vos utilisateurs qui inclut l’URL de votre serveur MCP et les étapes pour le connecter à Cursor.

        1. Utilisez <kbd>Command</kbd> + <kbd>Shift</kbd> + <kbd>P</kbd> (<kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>P</kbd> sous Windows) pour ouvrir la palette de commandes.
        2. Recherchez « Open MCP settings ».
        3. Sélectionnez **Add custom MCP**. Cela ouvre le fichier `mcp.json`.
        4. Dans `mcp.json`, configurez votre serveur :

        ```json theme={null}
        {
          "mcpServers": {
            "<your-mcp-server-name>": {
              "url": "<your-mcp-server-url>"
            }
          }
        }
        ```
      </Step>
    </Steps>

    Voir la [documentation Cursor](https://docs.cursor.com/en/context/mcp#installing-mcp-servers) pour plus de détails.
  </Tab>

  <Tab title="VS Code">
    <Steps>
      <Step title="Obtenez l’URL de votre serveur MCP.">
        Accédez à votre [Dashboard](https://dashboard.mintlify.com/products/mcp) et trouvez l’URL de votre serveur MCP.
      </Step>

      <Step title="Publiez l’URL de votre serveur MCP pour vos utilisateurs.">
        Créez un guide pour vos utilisateurs qui inclut l’URL de votre serveur MCP et les étapes pour le connecter à VS Code.

        1. Créez un fichier `.vscode/mcp.json`.
        2. Dans `mcp.json`, configurez votre serveur :

        ```json theme={null}
        {
          "servers": {
            "<your-mcp-server-name>": {
              "type": "http",
              "url": "<your-mcp-server-url>"
            }
          }
        }
        ```
      </Step>
    </Steps>

    Voir la [documentation VS Code](https://code.visualstudio.com/docs/copilot/chat/mcp-servers) pour plus de détails.
  </Tab>
</Tabs>

<div id="example-connect-to-the-mintlify-mcp-server">
  ### Exemple : connexion au serveur MCP de Mintlify
</div>

Connectez-vous au serveur MCP de Mintlify pour rechercher sur ce site de documentation depuis votre outil d’IA préféré. Vous obtiendrez ainsi des réponses plus précises sur l’utilisation de Mintlify dans votre environnement local, et vous verrez comment aider vos utilisateurs à se connecter à votre serveur MCP.

<Tabs>
  <Tab title="Menu contextuel">
    En haut de cette page, ouvrez le menu contextuel et choisissez **Connect to Cursor** ou **Connect to VS Code** pour connecter le serveur MCP de Mintlify à l’IDE de votre choix.
  </Tab>

  <Tab title="Claude">
    Pour utiliser le serveur MCP de Mintlify avec Claude :

    <Steps>
      <Step title="Ajouter le serveur MCP de Mintlify à Claude">
        1. Accédez à la page [Connectors](https://claude.ai/settings/connectors) dans les paramètres de Claude.
        2. Sélectionnez **Add custom connector**.
        3. Ajoutez le serveur MCP de Mintlify :

        * Name: `Mintlify`
        * URL: `https://mintlify.com/docs/mcp`

        4. Sélectionnez **Add**.
      </Step>

      <Step title="Accéder au serveur MCP dans votre chat">
        1. Dans Claude, cliquez sur le bouton des pièces jointes (l’icône “plus”).
        2. Sélectionnez le serveur MCP de Mintlify.
        3. Posez à Claude une question sur Mintlify.
      </Step>
    </Steps>

    Consultez la [documentation Model Context Protocol](https://modelcontextprotocol.io/docs/tutorials/use-remote-mcp-server#connecting-to-a-remote-mcp-server) pour plus de détails.
  </Tab>

  <Tab title="Claude Code">
    Pour utiliser le serveur MCP de Mintlify avec Claude Code, exécutez la commande suivante :

    ```bash theme={null}
    claude mcp add --transport http Mintlify https://mintlify.com/docs/mcp
    ```

    Testez la connexion en exécutant :

    ```bash theme={null}
    claude mcp list
    ```

    Consultez la [documentation Claude Code](https://docs.anthropic.com/en/docs/claude-code/mcp#installing-mcp-servers) pour plus de détails.
  </Tab>

  <Tab title="Cursor">
    <PreviewButton href="cursor://anysphere.cursor-deeplink/mcp/install?name=mintlify&config=eyJ1cmwiOiJodHRwczovL21pbnRsaWZ5LmNvbS9kb2NzL21jcCJ9">Installer dans Cursor</PreviewButton>

    Pour connecter le serveur MCP de Mintlify à Cursor, cliquez sur le bouton **Installer dans Cursor**. Ou, pour le connecter manuellement, suivez ces étapes :

    <Steps>
      <Step title="Ouvrir les paramètres MCP">
        1. Utilisez <kbd>Command</kbd> + <kbd>Shift</kbd> + <kbd>P</kbd> (<kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>P</kbd> sous Windows) pour ouvrir la palette de commandes.
        2. Recherchez « Open MCP settings ».
        3. Sélectionnez **Add custom MCP**. Cela ouvre le fichier `mcp.json`.
      </Step>

      <Step title="Configurer le serveur MCP de Mintlify">
        Dans `mcp.json`, ajoutez :

        ```json theme={null}
        {
          "mcpServers": {
            "Mintlify": {
              "url": "https://mintlify.com/docs/mcp"
            }
          }
        }
        ```
      </Step>

      <Step title="Tester la connexion">
        Dans le chat de Cursor, demandez « What tools do you have available? ». Cursor doit afficher le serveur MCP de Mintlify comme outil disponible.
      </Step>
    </Steps>

    Voir [Installing MCP servers](https://docs.cursor.com/en/context/mcp#installing-mcp-servers) dans la documentation de Cursor pour plus de détails.
  </Tab>

  <Tab title="VS Code">
    <PreviewButton href="https://vscode.dev/redirect/mcp/install?name=mintlify&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmintlify.com%2Fdocs%2Fmcp%22%7D">Installer dans VS Code</PreviewButton>

    Pour connecter le serveur MCP de Mintlify à VS Code, cliquez sur le bouton **Installer dans VS Code**. Ou, pour le connecter manuellement, créez un fichier `.vscode/mcp.json` et ajoutez :

    ```json theme={null}
    {
      "servers": {
        "Mintlify": {
          "type": "http",
          "url": "https://mintlify.com/docs/mcp"
        }
      }
    }
    ```

    Consultez la [documentation VS Code](https://code.visualstudio.com/docs/copilot/chat/mcp-servers) pour plus de détails.
  </Tab>
</Tabs>