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, ChatGPT 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. Vos utilisateurs doivent connecter votre serveur MCP à leurs outils.

​

Fonctionnement des serveurs MCP

Lorsqu’une application d’IA se connecte à votre serveur MCP de documentation, elle peut rechercher directement dans votre documentation en réponse à la requête d’un utilisateur, au lieu de s’appuyer sur des informations issues de ses données d’entraînement ou d’effectuer une recherche générique sur le web. Votre serveur MCP donne accès à tout le contenu indexé de votre site de documentation.

• Les applications d’IA peuvent rechercher de manière proactive dans votre documentation pendant qu’elles génèrent une réponse, même s’il ne leur a pas été explicitement demandé d’y rechercher une réponse.
• Les applications d’IA déterminent quand utiliser l’outil de recherche en fonction du contexte de la conversation et de la pertinence de votre documentation.
• Chaque recherche, aussi appelée appel d’outil, a lieu pendant le processus de génération, de sorte que l’application d’IA recherche des informations à jour dans votre documentation pour générer sa réponse.

Certains outils d’IA comme Claude prennent en charge à la fois MCP et Skills. MCP donne à l’IA accès au contenu de votre documentation, tandis que les Skills indiquent à l’IA comment utiliser ce contenu efficacement. Ils sont complémentaires. MCP fournit les données et les Skills fournissent les instructions.

​

Paramètres de filtrage de la recherche

L’outil de recherche MCP prend en charge des paramètres de filtrage facultatifs que les applications d’IA utilisent pour affiner les résultats de recherche.

• version : Filtre les résultats pour une version spécifique de la documentation. Par exemple, 'v0.7'. Ne renvoie que le contenu balisé avec la version spécifiée ou le contenu disponible dans toutes les versions.
• language : Filtre les résultats pour un code de langue spécifique. Par exemple, 'en', 'zh' ou 'es'. Ne renvoie que le contenu dans la langue spécifiée ou le contenu disponible dans toutes les langues.

Les applications d’IA déterminent quand appliquer ces filtres en fonction du contexte de la requête de l’utilisateur. Par exemple, si un utilisateur pose une question sur une version spécifique d’une API, l’application d’IA peut appliquer automatiquement le filtre approprié pour fournir des résultats plus pertinents.

​

MCP par rapport à la recherche sur le web

Les outils d’IA peuvent rechercher sur le web, mais MCP offre des avantages spécifiques pour la documentation.

• Accès direct à la source : La recherche sur le web dépend de ce que les moteurs de recherche ont indexé, ce qui peut être obsolète ou incomplet. MCP interroge directement votre documentation indexée la plus à jour.
• Flux de travail intégré : MCP permet à l’IA de rechercher pendant la génération de la réponse plutôt que d’effectuer une recherche web séparée.
• Aucun bruit de recherche : Les algorithmes de référencement (SEO) et de classement influencent les résultats de la recherche sur le web. MCP accède directement au contenu de votre documentation.

​

Accéder à votre serveur MCP

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

• Pour la documentation publique, votre serveur MCP est accessible à tous. Il recherche dans toutes les pages publiques indexées.
• Pour la documentation avec authentification partielle, où certaines pages sont publiques et d’autres sont protégées, vous devez activer votre serveur MCP avant qu’il soit accessible aux utilisateurs. Les utilisateurs non authentifiés peuvent rechercher dans le contenu public. Les utilisateurs qui s’authentifient peuvent rechercher dans tout le contenu auquel ils ont l’autorisation d’accéder en fonction de leurs groupes d’utilisateurs.
• Pour la documentation où toutes les pages requièrent une authentification, vous devez activer votre serveur MCP avant qu’il soit accessible aux utilisateurs. Les utilisateurs doivent s’authentifier avant de se connecter à votre serveur MCP. Votre serveur MCP recherche uniquement dans le contenu auquel chaque utilisateur a accès en fonction de ses groupes d’utilisateurs.

Vous pouvez afficher et copier l’URL de votre serveur MCP sur la page du serveur MCP dans votre Dashboard.

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.

​

Activer le MCP avec authentification

Si votre documentation nécessite une authentification, votre serveur MCP demande aux utilisateurs de s’authentifier avant de se connecter. Lorsqu’un utilisateur ajoute l’URL de votre serveur MCP à son outil d’IA, il doit se connecter avec ses identifiants existants. Après l’authentification, une redirection le renvoie vers son outil. Le serveur MCP ne renvoie que le contenu auquel chaque utilisateur est autorisé à accéder en fonction de ses groupes d’utilisateurs.

Si votre documentation utilise une authentification partielle avec des pages publiques et des pages protégées, les utilisateurs peuvent se connecter à votre serveur MCP sans s’authentifier pour accéder au contenu public. Les utilisateurs qui s’authentifient ont accès au contenu protégé auquel ils sont autorisés à accéder.

Par défaut, votre serveur MCP est uniquement disponible pour les outils localhost. Pour autoriser les outils web à se connecter, ajoutez les domaines de redirection des outils d’IA. Un domaine de redirection est le nom d’hôte qu’un outil d’IA utilise une fois l’authentification terminée, comme claude.ai ou app.cursor.ai. Les outils d’IA de vos utilisateurs ne peuvent pas finaliser l’authentification si leur domaine de redirection ne figure pas dans cette liste.

1. Activer le MCP avec authentification dans votre Dashboard

   1. Accédez à la page du serveur MCP dans votre Dashboard.
   2. Cliquez sur le bouton bascule Enable MCP Server.
2. Ajouter des domaines de redirection

   Ajoutez les domaines de redirection des outils d’IA auxquels vous souhaitez donner accès à vos utilisateurs. Les outils d’IA de vos utilisateurs ne peuvent pas finaliser l’authentification si leur domaine de redirection ne figure pas dans cette liste. Les domaines de redirection courants incluent claude.ai et vscode.dev/redirect.

   Les adresses loopback (localhost, 127.0.0.1) sont toujours approuvées et n’ont pas besoin d’être ajoutées.

​

Limites de débit

Pour protéger la disponibilité, Mintlify applique des limites de débit aux serveurs MCP.

Portée	Limite	Description
Par utilisateur (adresse IP)	5 000 requêtes par heure	Limite la fréquence à laquelle un même utilisateur peut effectuer des recherches dans votre documentation.
Par site de documentation (domain)	1 000 requêtes par heure	Limite le nombre total de recherches effectuées par tous les utilisateurs de votre serveur MCP.

​

Filtrage du contenu et indexation

Votre serveur MCP recherche le contenu que Mintlify indexe à partir de votre référentiel de documentation. Le traitement des fichiers et l’indexation pour la recherche déterminent quel contenu est disponible via votre serveur MCP.

Pour la documentation nécessitant une authentification, votre serveur MCP indexe uniquement les pages des groupes d’utilisateurs publics. Pour la documentation avec authentification partielle, votre serveur MCP indexe les pages publiques pour les utilisateurs non authentifiés ainsi que toutes les pages des groupes d’utilisateurs publics.

​

Traitement des fichiers avec .mintignore

Si des fichiers correspondent aux modèles définis dans .mintignore, Mintlify ne les traite pas et ne les indexe pas. Ces fichiers ne sont pas disponibles via votre serveur MCP.

​

Indexation pour la recherche avec docs.json

Par défaut, Mintlify n’indexe, pour la recherche via votre serveur MCP, que les pages incluses dans la navigation de votre docs.json.

Mintlify exclut les pages masquées (pages qui ne figurent pas dans votre navigation) de l’index de recherche, sauf si vous choisissez d’indexer toutes les pages. Pour inclure les pages masquées dans les résultats de recherche de votre serveur MCP, ajoutez la propriété seo.indexing à votre docs.json.

"seo": {
    "indexation": "all"
}

Pour exclure une page donnée de l’indexation par les moteurs de recherche, ajoutez noindex: true à son frontmatter.

---
title: "Page cachée"
description: "Cette page ne figure pas dans la navigation et n'est pas accessible via la recherche."
noindex: true
---

​

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.
Copier la commande d’installation MCP	add-mcp	Copie la commande npx add-mcp pour installer le serveur MCP.
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 ouvre 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 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.

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.

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

​

Utiliser plusieurs serveurs MCP

Les utilisateurs peuvent connecter plusieurs serveurs MCP à leurs outils d’IA. Les serveurs MCP connectés ne consomment pas de contexte tant que l’IA n’appelle pas un outil de recherche. L’IA décide quand effectuer une recherche en fonction de la pertinence de la requête ; elle ne recherche donc pas sur chaque serveur connecté pour chaque question.

Lorsque l’IA effectue une recherche, chaque requête renvoie plusieurs résultats qui s’ajoutent au contexte de la conversation. Si l’IA interroge plusieurs serveurs pour une seule question, cela peut consommer une quantité importante de contexte.

Bonnes pratiques pour utiliser plusieurs serveurs MCP :

• Connectez uniquement les serveurs MCP pertinents pour votre travail actuel.
• Soyez précis dans vos prompts afin que l’IA interroge le serveur le plus pertinent.
• Déconnectez les serveurs que vous n’utilisez pas activement pour réduire l’utilisation potentielle du contexte.