> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify-mintlify-add-hello-world-quickstart-48843.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Protocole de Contexte de Modèle

> Permettez aux utilisateurs d’accéder à votre documentation et à vos API depuis leurs outils d’IA préférés

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 établit 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 et de vos spécifications OpenAPI, afin de préparer votre contenu pour l’écosystème d’IA plus large, où tout client MCP (comme Claude, Cursor, Goose et autres) peut se connecter à votre documentation et à vos API.

Votre serveur MCP expose des outils permettant aux applications d’IA de rechercher dans votre documentation et d’interagir avec vos API.

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

<Note>
  Les serveurs MCP ne peuvent être générés que pour une documentation publique. La documentation protégée par l’authentification des utilisateurs finaux n’est pas accessible pour la génération de serveur.
</Note>

Mintlify génère automatiquement un serveur MCP pour votre documentation et l’héberge à l’URL de votre documentation au 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 depuis votre [tableau de bord](https://dashboard.mintlify.com/products/mcp).

Le chemin `/mcp` est réservé aux serveurs MCP hébergés et ne peut pas être utilisé pour d’autres éléments de navigation.

<div id="configuring-your-mcp-server">
  ## Configuration de votre serveur MCP
</div>

Tous les serveurs MCP incluent l’outil `search` par défaut, qui permet aux utilisateurs d’interroger des informations issues de votre documentation depuis d’autres outils.

Si vous disposez d’un [forfait Pro ou Enterprise](https://mintlify.com/pricing?ref=mcp), vous pouvez exposer des endpoints de votre spécification OpenAPI en tant qu’outils MCP.

Pour exposer des endpoints en tant qu’outils MCP, utilisez l’objet `mcp` dans l’extension `x-mint`, au niveau du fichier ou de l’endpoint. Par exemple, le serveur MCP de Mintlify inclut des outils pour créer des conversations avec l’Assistant, obtenir des mises à jour d’état et déclencher des mises à jour.

Les serveurs MCP adoptent une approche « security-first » où les endpoints d’API ne sont pas exposés par défaut. Vous devez activer explicitement les endpoints pour les rendre disponibles en tant qu’outils MCP. N’exposez que les endpoints sûrs pour un accès public via des outils d’IA.

<ResponseField name="mcp" type="object">
  La configuration MCP de l’endpoint.

  <Expandable title="MCP">
    <ResponseField name="enabled" type="boolean">
      Indique s’il faut exposer l’endpoint en tant qu’outil MCP. Prend le pas sur la configuration au niveau du fichier.
    </ResponseField>

    <ResponseField name="name" type="string">
      Le nom de l’outil MCP.
    </ResponseField>

    <ResponseField name="description" type="string">
      La description de l’outil MCP.
    </ResponseField>
  </Expandable>
</ResponseField>

<div id="file-level-configuration">
  ### Configuration au niveau du fichier
</div>

Activez MCP par défaut pour tous les endpoints dans un fichier de spécification OpenAPI, puis excluez certains endpoints de manière sélective :

```json
{
  "openapi": "3.1.0",
  "x-mint": {
    "mcp": {
      "enabled": true
    }
  },
  // ...
  "paths": {
    "/api/v1/users": {
      "get": {
        "x-mint": {
          "mcp": {
            "enabled": false // Désactive MCP pour ce point de terminaison
          }
        },
        // ...
      }
    }
  }
}
```

<div id="endpoint-level-configuration">
  ### Configuration au niveau des endpoints
</div>

Activer MCP pour des endpoints spécifiques :

```json
{
  "paths": {
    "/api/v1/users": {
      "get": {
        "x-mint": {
          "mcp": {
            "enabled": true,
            "name": "get-users",
            "description": "Récupérer la liste des utilisateurs"
          },
          // ...
        }
      }
    },
    "/api/v1/delete": {
      "delete": {
        // Pas de `x-mint: mcp`, donc cet endpoint n’est pas exposé comme outil MCP
        // ...
      }
    }
  }
}
```

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

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

1. Rendre publique l’URL de votre serveur MCP.
2. Les utilisateurs copient l’URL de votre serveur MCP et l’ajoutent à leurs outils.
3. Les utilisateurs accèdent à votre documentation et à vos endpoints API via 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 [tableau de bord](https://dashboard.mintlify.com/products/mcp) et récupérez 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>

    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">
    <Steps>
      <Step title="Obtenez l’URL de votre serveur MCP.">
        Accédez à votre [tableau de bord](https://dashboard.mintlify.com/products/mcp) et récupérez 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
        claude mcp add --transport http <name> <url>
        ```
      </Step>
    </Steps>

    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">
    <Steps>
      <Step title="Obtenez l’URL de votre serveur MCP.">
        Accédez à votre [tableau de bord](https://dashboard.mintlify.com/products/mcp) et récupérez 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 ouvrira le fichier `mcp.json`.
        4. Dans `mcp.json`, configurez votre serveur :

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

    Consultez 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 [tableau de bord](https://dashboard.mintlify.com/products/mcp) et récupérez 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
        {
          "servers": {
            "<your-mcp-server-name>": {
              "type": "http",
              "url": "<your-mcp-server-url>"
            }
          }
        }
        ```
      </Step>
    </Steps>

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

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

Connectez-vous au serveur MCP de Mintlify pour interagir avec l’API Mintlify et rechercher dans notre documentation. Vous obtiendrez ainsi des réponses plus précises sur l’utilisation de Mintlify dans votre environnement local et 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 **Se connecter à Cursor** ou **Se connecter à 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, sélectionnez le bouton des pièces jointes (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 en savoir plus.
  </Tab>

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

    ```bash
    claude mcp add --transport http Mintlify https://mintlify.com/docs/mcp
    ```

    Testez la connexion en exécutant :

    ```bash
    claude mcp list
    ```

    Consultez la [documentation Claude Code](https://docs.anthropic.com/en/docs/claude-code/mcp#installing-mcp-servers) pour en savoir plus.
  </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**. Pour connecter manuellement le serveur MCP, 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**. Le fichier `mcp.json` s’ouvre.
      </Step>

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

        ```json
        {
          "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 devrait afficher le serveur MCP de Mintlify comme outil disponible.
      </Step>
    </Steps>

    Consultez [Installing MCP servers](https://docs.cursor.com/en/context/mcp#installing-mcp-servers) dans la documentation de Cursor pour en savoir plus.
  </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**. Pour connecter manuellement le serveur MCP, créez un fichier `.vscode/mcp.json` et ajoutez :

    ```json
    {
      "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 en savoir plus.
  </Tab>
</Tabs>

<div id="authentication">
  ## Authentification
</div>

Lorsque vous activez un point de terminaison d’API pour le MCP, le serveur inclut les exigences d’authentification définies dans vos `securitySchemes` et `securityRequirement` OpenAPI. Toutes les clés sont gérées directement par l’outil et ne sont ni stockées ni traitées par Mintlify.

Si un utilisateur demande à son outil d’IA d’appeler un point de terminaison protégé, l’outil lui demandera alors les informations d’identification nécessaires à l’authentification.

<div id="monitoring-your-mcp-server">
  ## Surveiller votre serveur MCP
</div>

Vous pouvez consulter tous les outils MCP disponibles dans la section **Available tools** de la [page MCP Server](https://dashboard.mintlify.com/products/mcp) de votre tableau de bord.

<Frame>
  <img src="https://mintcdn.com/mintlify-mintlify-add-hello-world-quickstart-48843/KAieJWDWb9msJsqT/images/mcp/mcp-server-page-light.png?fit=max&auto=format&n=KAieJWDWb9msJsqT&q=85&s=b2951db02e33abbb05c922faa7c9bcd3" alt="Tableau de bord MCP avec la section Available tools mise en évidence" class="block dark:hidden" width="3024" height="1548" data-path="images/mcp/mcp-server-page-light.png" />

  <img src="https://mintcdn.com/mintlify-mintlify-add-hello-world-quickstart-48843/KAieJWDWb9msJsqT/images/mcp/mcp-server-page-dark.png?fit=max&auto=format&n=KAieJWDWb9msJsqT&q=85&s=75b9018915e26dbf4ddee8595fa94b8c" alt="Tableau de bord MCP avec la section Available tools mise en évidence" class="hidden dark:block" width="3018" height="1540" data-path="images/mcp/mcp-server-page-dark.png" />
</Frame>

<div id="troubleshooting">
  ## Dépannage
</div>

<AccordionGroup>
  <Accordion title="Le serveur MCP n’affiche que l’outil de recherche">
    Si votre serveur MCP n’expose que l’outil de recherche malgré la présence d’une spécification OpenAPI :

    1. Vérifiez que votre spécification OpenAPI est valide et accessible.
    2. Assurez-vous d’avoir explicitement activé MCP pour des points de terminaison spécifiques à l’aide de `x-mint.mcp.enabled: true`.
    3. Consultez vos journaux de déploiement pour détecter d’éventuelles erreurs de traitement OpenAPI.

    Si le traitement OpenAPI échoue, le serveur continue avec uniquement l’outil de recherche afin de préserver la fonctionnalité.
  </Accordion>

  <Accordion title="Problèmes d’authentification">
    Si des utilisateurs signalent des problèmes d’authentification :

    1. Vérifiez que votre spécification OpenAPI inclut des définitions `securitySchemes` appropriées.
    2. Confirmez que les points de terminaison activés fonctionnent avec les méthodes d’authentification spécifiées.
  </Accordion>

  <Accordion title="Descriptions d’outils manquantes ou peu claires">
    Si les outils d’IA n’utilisent pas efficacement vos points de terminaison d’API :

    1. Ajoutez des champs `summary` et `description` détaillés à vos points de terminaison.
    2. Assurez-vous que les noms et descriptions des paramètres sont explicites.
    3. Utilisez le tableau de bord MCP pour vérifier comment vos points de terminaison apparaissent en tant qu’outils.
  </Accordion>
</AccordionGroup>