Model Context Protocol

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

​

À propos des serveurs MCP

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.

​

Fonctionnement des serveurs MCP

Lorsqu’un serveur MCP est connecté à un outil d’IA, le LLM peut décider d’utiliser votre outil de recherche dans la documentation pendant la génération de la réponse.

• 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.

​

Accéder à votre serveur MCP

Les serveurs MCP ne peuvent être générés que pour de la documentation publique. La documentation protégée par une authentification utilisateur final n’est pas accessible pour la génération de serveur.

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 dans votre Dashboard.

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.

​

Utiliser votre serveur MCP

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 :

Menu contextuel

Ajoutez des options dans le menu contextuel 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.

Claude

1. Obtenez l’URL de votre serveur MCP.

   Accédez à votre Dashboard et trouvez l’URL de votre serveur MCP.

2. 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 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.

Voir la documentation Model Context Protocol pour plus de détails.

Claude Code

1. Obtenez l’URL de votre serveur MCP.

   Accédez à votre Dashboard et trouvez l’URL de votre serveur MCP.

2. 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.

   claude mcp add --transport http <name> <url>
   

Voir la documentation Claude Code pour plus de détails.

Cursor

1. Obtenez l’URL de votre serveur MCP.

   Accédez à votre Dashboard et trouvez l’URL de votre serveur MCP.

2. 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 Command + Shift + P (Ctrl + Shift + P 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 :

   {
     "mcpServers": {
       "<your-mcp-server-name>": {
         "url": "<your-mcp-server-url>"
       }
     }
   }
   

Voir la documentation Cursor pour plus de détails.

VS Code

1. Obtenez l’URL de votre serveur MCP.

   Accédez à votre Dashboard et trouvez l’URL de votre serveur MCP.

2. 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 :

   {
     "servers": {
       "<your-mcp-server-name>": {
         "type": "http",
         "url": "<your-mcp-server-url>"
       }
     }
   }
   

Voir la documentation VS Code pour plus de détails.

​

Exemple : connexion au serveur MCP de Mintlify

Connectez-vous au serveur MCP de Mintlify pour rechercher dans notre documentation. 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.

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.

Claude

Pour utiliser le serveur MCP de Mintlify avec Claude :

1. Ajouter le serveur MCP de Mintlify à Claude

   1. Accédez à la page 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.
2. 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.

Consultez la documentation Model Context Protocol pour plus de détails.

Claude Code

Pour utiliser le serveur MCP de Mintlify avec Claude Code, exécutez la commande suivante :

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

Testez la connexion en exécutant :

claude mcp list

Consultez la documentation Claude Code pour plus de détails.

CursorInstaller dans Cursor

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

1. Ouvrir les paramètres MCP

   1. Utilisez Command + Shift + P (Ctrl + Shift + P 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.
2. Configurer le serveur MCP de Mintlify

   Dans mcp.json, ajoutez :

   {
     "mcpServers": {
       "Mintlify": {
         "url": "https://mintlify.com/docs/mcp"
       }
     }
   }
   

3. 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.

Voir Installing MCP servers dans la documentation de Cursor pour plus de détails.

VS CodeInstaller dans VS Code

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 :

{
  "servers": {
    "Mintlify": {
      "type": "http",
      "url": "https://mintlify.com/docs/mcp"
    }
  }
}

Consultez la documentation VS Code pour plus de détails.

​

Surveiller votre serveur MCP

Vous pouvez voir tous les outils MCP disponibles dans la section Outils disponibles de la page MCP Server de votre Dashboard.