mirror of
https://github.com/mintlify/docs.git
synced 2026-09-14 13:35:46 +08:00
locadex-agent[bot]
644b17660f
Co-authored-by: locadex-agent[bot] <217277504+locadex-agent[bot]@users.noreply.github.com>
350 lines
17 KiB
Plaintext
350 lines
17 KiB
Plaintext
---
|
||
title: "Model Context Protocol"
|
||
description: "Connectez votre documentation et vos endpoints d’API à des outils d’IA via un serveur MCP hébergé."
|
||
keywords: ["MCP", "AI tools", "Claude", "Cursor"]
|
||
---
|
||
|
||
import { PreviewButton } from "/snippets/previewbutton.jsx"
|
||
|
||
<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, 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.
|
||
|
||
<div id="how-mcp-servers-work">
|
||
### Fonctionnement des serveurs MCP
|
||
</div>
|
||
|
||
Lorsqu'une application d'IA est connectée à votre serveur MCP de documentation, elle peut rechercher directement dans votre documentation au lieu d'effectuer une recherche générique sur le web en réponse à la requête d'un utilisateur. Votre serveur MCP donne accès à tout le contenu indexé de votre site de documentation.
|
||
|
||
* L'application d'IA peut rechercher de manière proactive dans votre documentation pendant qu'elle génère une réponse, et pas seulement lorsqu'on le lui demande explicitement.
|
||
* L'application d'IA détermine quand utiliser l'outil de recherche en fonction du contexte de la conversation et de la pertinence de votre documentation.
|
||
* Chaque recherche (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.
|
||
|
||
<Tip>
|
||
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.
|
||
</Tip>
|
||
|
||
<div id="search-filtering-parameters">
|
||
### Paramètres de filtrage de la recherche
|
||
</div>
|
||
|
||
L'outil de recherche MCP prend en charge des paramètres de filtrage optionnels que les applications d'IA peuvent utiliser 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 marqué avec la version spécifiée ou le contenu disponible pour 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.
|
||
* **`apiReferenceOnly`** : Lorsqu'il est défini sur `true`, ne renvoie que les pages de documentation de référence de l'API.
|
||
* **`codeOnly`** : Lorsqu'il est défini sur `true`, ne renvoie que des extraits de code et des exemples.
|
||
|
||
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 ou demande des exemples de code, l'application d'IA peut appliquer automatiquement les filtres appropriés pour fournir des résultats plus pertinents.
|
||
|
||
<div id="mcp-compared-to-web-search">
|
||
### MCP par rapport à la recherche sur le web
|
||
</div>
|
||
|
||
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.
|
||
|
||
<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="/images/mcp/mcp-server-page-light.png" alt="Page du serveur MCP dans le Dashboard." className="block dark:hidden" />
|
||
|
||
<img src="/images/mcp/mcp-server-page-dark.png" alt="Page du serveur MCP dans le Dashboard." className="hidden dark:block" />
|
||
</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="content-filtering-and-indexing">
|
||
## Filtrage du contenu et indexation
|
||
</div>
|
||
|
||
Votre serveur MCP effectue des recherches dans 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 le contenu disponible via votre serveur MCP.
|
||
|
||
<div id="file-processing-with-mintignore">
|
||
### Traitement des fichiers avec `.mintignore`
|
||
</div>
|
||
|
||
Si des fichiers correspondent aux modèles définis dans [.mintignore](/fr/organize/mintignore), Mintlify ne les traite pas et ne les indexe pas. Ces fichiers ne sont pas disponibles via votre serveur MCP.
|
||
|
||
<div id="search-indexing-with-docsjson">
|
||
### Indexation pour la recherche avec `docs.json`
|
||
</div>
|
||
|
||
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](/fr/organize/hidden-pages) (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`.
|
||
|
||
```json
|
||
"seo": {
|
||
"indexation": "all"
|
||
}
|
||
```
|
||
|
||
Pour exclure une page donnée de l’indexation par les moteurs de recherche, ajoutez `noindex: true` à son frontmatter.
|
||
|
||
```mdx
|
||
---
|
||
title: "Page cachée"
|
||
description: "Cette page ne figure pas dans la navigation et n'est pas accessible via la recherche."
|
||
noindex: true
|
||
---
|
||
```
|
||
|
||
<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
|
||
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
|
||
{
|
||
"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
|
||
{
|
||
"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
|
||
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 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
|
||
{
|
||
"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
|
||
{
|
||
"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>
|
||
|
||
<div id="using-multiple-mcp-servers">
|
||
### Utiliser plusieurs serveurs MCP
|
||
</div>
|
||
|
||
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 lancer une recherche en fonction de la pertinence de la requête, elle ne cherche 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 en cours.
|
||
* Formulez des prompts précis afin que l'IA interroge le serveur le plus pertinent.
|
||
* Déconnectez les serveurs que vous n'utilisez pas activement pour réduire la consommation potentielle de contexte. |