> Discover all available pages from the documentation index: https://mastra.zisheng.pro/fr/llms.txt # Développer avec l'IA Pour le développement quotidien assisté par l'IA avec les Skills Mastra et la CLI, consultez [Développer](https://mastra.zisheng.pro/fr/docs/getting-started/develop). Cette page présente d'autres moyens de donner aux Agents de programmation accès à la documentation de Mastra. ## Documentation intégrée aux packages Les packages Mastra incluent une documentation intégrée dans `dist/docs`. Lorsque vous installez un package Mastra, votre Agent IA peut lire ces fichiers directement depuis `node_modules` afin de comprendre les API et les modèles du package. Chaque répertoire `dist/docs` comprend : - `SKILL.md` : un fichier de Skill conforme au standard des Skills - `references/` : un dossier contenant les fichiers de documentation relatifs au package - `assets/SOURCE_MAP.json` : un fichier source map qui relie les exports publics à leur emplacement dans `node_modules` ## Fichiers de contexte Mastra fournit à la racine un fichier [`llms.txt`](https://mastra.ai/llms.txt) qui présente toutes les pages de documentation disponibles. Il ne fournit pas de fichier `llms-full.txt`, car regrouper toute la documentation dans un seul fichier n'est pas utile. À la place, chaque page de documentation possède son propre fichier `llms.txt`. Ces fichiers Markdown sont simplifiés. À la fin de chaque page de documentation, vous trouverez un lien vers le fichier `llms.txt` correspondant. Ajoutez `/llms.txt` à n'importe quelle URL de la documentation Mastra pour y accéder. Vous pouvez également le demander en ajoutant l'extension `.md` à la fin de l'URL. Exemples pour la [page d'introduction](https://mastra.zisheng.pro/fr/docs) : - [`/docs/llms.txt`](https://mastra.ai/docs/llms.txt) - [`/docs.md`](https://mastra.ai/docs.md) ## Serveur de documentation MCP > **Attention:** Le serveur de documentation MCP n'est pas recommandé pour le développement quotidien. Utilisez plutôt le [Skill Mastra](https://mastra.zisheng.pro/fr/docs/getting-started/develop), car il est plus à jour et plus performant. Le package `@mastra/mcp-docs-server` fournit un accès local direct à l'intégralité de la documentation Mastra au moyen du [Model Context Protocol (MCP)](https://modelcontextprotocol.io/docs/getting-started/intro). Il fonctionne avec Cursor, Windsurf, Cline, Claude Code, VS Code, Codex ou tout autre outil prenant en charge MCP. Ces Tools sont conçus pour aider les Agents à récupérer des informations précises et propres à une tâche, que vous ajoutiez une fonctionnalité à un Agent, créiez la structure d'un nouveau projet ou cherchiez à comprendre le fonctionnement d'un élément. Si vous ne pouvez pas utiliser de serveur MCP local et devez vous connecter à un serveur distant, utilisez cette URL : `https://mastra.mcp.kapa.ai`. Vous devez vous authentifier avec votre compte Google (seul un identifiant anonyme est transmis) afin de permettre la limitation du débit. Dans la mesure du possible, Mastra recommande d'utiliser un serveur MCP local pour bénéficier de meilleures performances et d'une plus grande fiabilité. ### Installation La commande [`create-mastra`](https://mastra.zisheng.pro/fr/reference/cli/create-mastra) ne configure pas le serveur de documentation MCP. Ajoutez le serveur manuellement lorsque vous avez besoin de Tools propres à MCP, tels que le Tool de migration. Si aucune instruction propre à votre outil ne figure ci-dessous, vous pouvez éventuellement ajouter le serveur MCP à l'aide de cette configuration JSON courante. ```json { "mcpServers": { "mastra": { "type": "stdio", "command": "npx", "args": ["-y", "@mastra/mcp-docs-server@latest"] } } } ``` #### Claude Code CLI Installez-le à l'aide de la commande de terminal suivante : ```bash claude mcp add --scope project mastra -- npx -y @mastra/mcp-docs-server@latest ``` Cette commande crée un fichier `.mcp.json` limité au projet s'il n'existe pas encore. Vous pouvez utiliser la même commande lorsque vous employez Claude Code comme [extension Visual Studio Code](https://code.claude.com/docs/en/vs-code#connect-to-external-tools-with-mcp). [En savoir plus sur l'utilisation de serveurs MCP avec Claude Code](https://docs.claude.com/en/docs/claude-code/mcp) #### OpenAI Codex CLI 1. Enregistrez-le depuis le terminal : ```bash codex mcp add mastra-docs -- npx -y @mastra/mcp-docs-server@latest ``` 2. Exécutez `codex mcp list` pour confirmer que le serveur apparaît avec l'état `enabled`. [En savoir plus sur l'utilisation de serveurs MCP avec OpenAI Codex](https://developers.openai.com/codex/mcp) #### Cursor Installez-le en sélectionnant le bouton ci-dessous : [![Installer le serveur MCP](https://cursor.com/deeplink/mcp-install-light.svg)](cursor://anysphere.cursor-deeplink/mcp/install?name=mastra\&config=eyJjb21tYW5kIjoibnB4IC15IEBtYXN0cmEvbWNwLWRvY3Mtc2VydmVyIn0%3D) Si vous avez suivi l'installation automatique, une fenêtre contextuelle s'affiche dans le coin inférieur gauche lorsque vous ouvrez Cursor et vous invite à activer Mastra Docs MCP Server. ![Fenêtre contextuelle dans Cursor affichant « New MCP server detected: mastra ». L\'utilisateur peut choisir l\'action « Skip » ou « Enable ».](/fr/assets/images/enable-mastra-docs-cursor-cd5872abdc36c0e10951a59a47f25e12.png) [En savoir plus sur l'utilisation de serveurs MCP avec Cursor](https://cursor.com/de/docs/context/mcp) #### Antigravity Google Antigravity est une plateforme de développement centrée sur les Agents qui prend en charge les serveurs MCP pour accéder à la documentation externe, aux API et au contexte du projet. 1. Ouvrez votre fichier de configuration MCP Antigravity : - Cliquez sur **Agent session**, puis sélectionnez le **menu déroulant « … »** en haut du panneau latéral de l'éditeur. Sélectionnez ensuite **MCP Servers** pour accéder au **MCP Store**. - Vous pouvez y accéder depuis l'interface MCP Store d'Antigravity ![MCP Store d\'Antigravity. Une barre de recherche apparaît en haut, suivie d\'une liste des serveurs MCP disponibles. Un menu déroulant se trouve tout en haut à droite.](/fr/assets/images/antigravity_mcp_server-689ea495d9c7139cc431f1f1b9827f9b.png) 2. Pour ajouter un serveur MCP personnalisé, sélectionnez **Manage MCP Servers** en haut du MCP Store, puis **View raw config** dans l'onglet principal. ![MCP Store d\'Antigravity affichant l\'option Manage MCP Servers et le bouton View raw config.](/fr/assets/images/antigravity_managed_mcp-b661e8c04b3219000f8d842e5eb26a1a.png) 3. Ajoutez la configuration du serveur MCP Mastra : ```json { "mcpServers": { "mastra-docs": { "command": "npx", "args": ["-y", "@mastra/mcp-docs-server"] } } } ``` 4. Enregistrez la configuration et redémarrez Antigravity ![L\'interface utilisateur indique que le serveur MCP est activé. Vous pouvez également activer ou désactiver chaque Tool séparément.](/fr/assets/images/antigravity_final_interface_mcp-7fa132dbe76cdee9f61136a26d6e6615.png) Une fois configuré, le serveur MCP Mastra met les éléments suivants à la disposition des Agents Antigravity : - Documentation indexée et schémas d'API de Mastra, permettant la récupération par programmation du contexte pertinent lors de la génération de code - Accès aux exemples de code et aux modèles d'utilisation stockés dans la documentation Mastra - Données structurées pour la gestion des erreurs et références de débogage dans l'éditeur - Métadonnées sur les modèles actuels des projets Mastra afin de faciliter la suggestion et la complétion de code Le serveur MCP apparaît dans le MCP Store d'Antigravity, où vous pouvez gérer son état de connexion et son authentification si nécessaire. [En savoir plus sur l'utilisation de serveurs MCP avec Antigravity](https://antigravity.google) #### Visual Studio Code 1. Créez un fichier `.vscode/mcp.json` dans votre Workspace 2. Insérez la configuration suivante : ```json { "servers": { "mastra": { "type": "stdio", "command": "npx", "args": ["-y", "@mastra/mcp-docs-server@latest"] } } } ``` Une fois le serveur MCP installé, vous pouvez l'utiliser comme suit : 1. Ouvrez les paramètres de VSCode. 2. Accédez aux paramètres MCP. 3. Cliquez sur « enable » pour l'option Chat > MCP. ![Entrée de la page des paramètres de VSCode. L\'option s\'intitule « Chat \> MCP: Enabled (Preview) ». Sa description indique : « Enables integration with Model Context Protocol servers to provide additional tools and functionality. »](/fr/assets/images/vscode-mcp-setting-8d1eb4f3df1e33606503f8c5e937e9e3.png) MCP fonctionne uniquement en mode Agent dans VSCode. Une fois dans ce mode, ouvrez le fichier `mcp.json` et sélectionnez le bouton « start ». Notez que ce bouton n'apparaît que si le dossier `.vscode` contenant `mcp.json` se trouve à la racine de votre Workspace, ou au niveau le plus élevé de l'explorateur de fichiers de l'éditeur. ![Capture d\'écran du fichier mcp.json affichant le bouton start dans l\'éditeur](/fr/assets/images/vscode-start-mcp-26480d86080c4907cb497a325de106a4.png) Après avoir démarré le serveur MCP, sélectionnez le bouton Tools dans le volet Copilot pour afficher les Tools disponibles. ![Page Tools de VSCode affichant les Tools disponibles](/fr/assets/images/vscode-mcp-running-d92d6ed234d1148093dc804b0ead3515.png) [En savoir plus sur l'utilisation de serveurs MCP avec Visual Studio Code](https://code.visualstudio.com/docs/copilot/customization/mcp-servers) #### Windsurf 1. Ouvrez `~/.codeium/windsurf/mcp_config.json` dans votre éditeur 2. Insérez la configuration suivante : ```json { "mcpServers": { "mastra": { "command": "npx", "args": ["-y", "@mastra/mcp-docs-server@latest"] } } } ``` 3. Enregistrez la configuration et redémarrez Windsurf [En savoir plus sur l'utilisation de serveurs MCP avec Windsurf](https://docs.windsurf.com/windsurf/cascade/mcp#mcp-config-json) #### OpenCode Vous pouvez définir des serveurs MCP dans votre [configuration OpenCode](https://opencode.ai/docs/config/) sous `mcp`. Créez un fichier `opencode.jsonc` à la racine de votre projet avec le contenu suivant : ```json { "$schema": "https://opencode.ai/config.json", "mcp": { "mastra": { "type": "local", "command": ["npx", "-y", "@mastra/mcp-docs-server@latest"], "enabled": true } } } ``` [En savoir plus sur l'utilisation de serveurs MCP avec OpenCode](https://opencode.ai/docs/mcp-servers) #### Zed 1. Ouvrez `~/.config/zed/settings.json` dans votre éditeur 2. Insérez la configuration suivante : ```json { "context_servers": { "Mastra": { "command": "npx", "args": ["-y", "@mastra/mcp-docs-server@latest"] } } } ``` ### Utilisation Une fois la configuration terminée, vous pouvez poser à votre Tool IA des questions sur Mastra ou lui demander d'effectuer des actions. Pour ces étapes, il utilise les informations à jour provenant du serveur MCP de Mastra. **Ajouter des fonctionnalités :** - « Ajoute des Evals à mon Agent et écris des tests » - « Écris-moi un Workflow qui effectue la tâche suivante : `[task]` » - « Crée un nouveau Tool permettant à mon Agent d'accéder à `[3rd party API]` » **Poser des questions sur les intégrations :** - « Mastra fonctionne-t-il avec AI SDK ? Comment puis-je l'utiliser dans mon projet `[React/Svelte/etc]` ? » - « Mastra prend-il en charge les API de parole et de voix de `[provider]` ? Montre-moi dans mon code un exemple de leur utilisation. » **Déboguer ou mettre à jour le code existant :** - « Je rencontre un bug avec la Memory de l'Agent. Des modifications ou des corrections de bugs associées ont-elles été apportées récemment ? » - « Comment la mémoire de travail se comporte-t-elle dans Mastra et comment puis-je l'utiliser pour effectuer `[task]` ? Elle ne semble pas fonctionner comme prévu. » - « J'ai vu qu'il existe de nouvelles fonctionnalités de Workflow. Explique-les-moi, puis mets à jour `[workflow]` pour les utiliser. » ### Résolution des problèmes 1. **Le serveur ne démarre pas** - Vérifiez que [npx](https://docs.npmjs.com/cli/v11/commands/npx) est installé et fonctionne. - Recherchez d'éventuels conflits avec d'autres serveurs MCP. - Vérifiez la syntaxe de votre fichier de configuration. 2. **Échec des appels de Tools** - Redémarrez le serveur MCP ou votre IDE, ou les deux. - Mettez votre IDE à jour vers la dernière version.