# L’agent de Warp vit dans le terminal. Donnez-lui une carte du dépôt. Canonical source: https://maguyva.ai/fr/for-warp License: text under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/); code samples under [MIT-0](https://opensource.org/license/mit-0); the Maguyva name, logos, brand assets and other code are not covered. Details: [maguyva.ai/license](https://maguyva.ai/license). L’agent de Warp lance des commandes et lit ce qu’elles affichent. Maguyva indexe tout le dépôt et le sert via MCP : l’agent demande où se trouve le code au lieu d’enchaîner grep et cat jusqu’à ce que quelque chose corresponde. > Une entrée mcpServers dans ~/.warp/.mcp.json : une URL et un en-tête Authorization. ## Ce que Warp doit savoir Quatre points propres à Warp. ### ~/.warp/.mcp.json Warp démarre de lui-même les serveurs de ce fichier global. Vous pouvez aussi coller le même JSON dans Settings → Agents → MCP servers → + Add. ### Distant, par URL Une entrée `url` se connecte en Streamable HTTP ou en SSE. Rien ne tourne en local et Node.js n’est pas nécessaire. ### Un en-tête en clair La clé va directement dans l’en-tête `Authorization`. Gardez-la dans le fichier global, pas dans le `.warp/.mcp.json` d’un projet que vous commitez. ### Jamais démarrés d’office Warp détecte `.warp/.mcp.json` dans un dépôt cloné, mais attend que vous démarriez chaque serveur. Il peut aussi lire les serveurs des configurations de Claude Code et de Codex une fois l’option activée. ## Les règles de projet sont un accord de travail. Servez-vous-en. ```text # AGENTS.md - Lancez make test avant de déclarer une modification terminée. - Utilisez les scripts de bin/, pas des commandes improvisées. ``` Warp lit les règles de projet dans `AGENTS.md` (ou `WARP.md`, prioritaire si les deux existent) et applique partout les Global Rules. Utilisez-les pour : - Les commandes de build, de test et de déploiement. - Les conventions sur lesquelles l’agent se trompe sans cesse. - Les commandes que l’agent ne doit jamais lancer. Les règles disent à l’agent comment travailler. Elles ne peuvent pas lui dire quel service lit encore la variable d’environnement que vous allez supprimer. ## Là où grep dans le terminal s’arrête Trois choses qu’une session shell n’apprend pas à bon compte. ### // la sortie défile Chaque grep et chaque cat lancés par l’agent atterrissent dans la conversation. Une recherche qui affiche deux cents lignes consomme du contexte avant que le vrai travail commence. ### // une correspondance n’est pas un appelant grep ne distingue pas un vrai appel d’un commentaire, d’une fixture ou d’une méthode homonyme d’une autre classe. ### // le shell démarre à froid Une nouvelle session ne sait rien du dépôt. L’index de Maguyva est déjà construit : la première question obtient une réponse classée. ## Maguyva comme serveur MCP dans Warp Une entrée mcpServers donne à l’agent de Warp : - **11 outils sur votre dépôt indexé**: recherche sémantique, structurelle (AST), par graphe et textuelle, plus recherche de symboles, dépendants et récupération de fichiers. - **Des réponses avec chemins de fichiers et numéros de ligne**: dans plus de 285 langages, assez courtes pour un volet de terminal. - **Des outils en lecture seule**: Les outils de Maguyva interrogent l’index. Aucun ne modifie de fichier ni ne lance de commande. > Warp donne à l’agent *un terminal*. > Maguyva donne à l’agent *une carte du code*. ## Deux flux de travail Interrogez d’abord la carte, lancez les commandes ensuite. ### 01. Remonter d’un script en échec jusqu’à sa cause ```text warp agent> deploy.sh échoue : BUILD_ID n’est pas défini. où est-il défini ? text_pattern_search("BUILD_ID=") ci/env.sh:9 export BUILD_ID=... docs/deploy.md:31 ← texte → L’agent charge ci/env.sh et relance le déploiement. [exit 0] ``` Une recherche indexée remplace un grep récursif sur tout le dépôt, et sa sortie. ### 02. Vérifier les appelants avant de changer une étape de démarrage ```text warp agent> peut-on arrêter de lancer les migrations au démarrage ? dependency_search("runMigrations", dependents) 3 appelants : server.ts, worker.ts, scripts/seed.ts → L’agent déplace les trois vers l’étape de release. [exit 0] ``` Les appelants arrivent avant la modification : le worker ne démarre pas sur un ancien schéma. ## Configuration dans Warp Trois étapes. Palier Free : 3 dépôts, Jusqu'à 50 000 lignes de dépôt indexées, sans carte bancaire. ### 01. Indexez un dépôt sur maguyva.ai Choisissez-en un que vous connaissez déjà, pour pouvoir évaluer les réponses. ### 02. Ajouter Maguyva à ~/.warp/.mcp.json `~/.warp/.mcp.json` ```json { "mcpServers": { "maguyva": { "url": "https://maguyva.tools/mcp", "headers": { "Authorization": "Bearer mgv_xxxx" } } } } ``` ### 03. Remplacez le placeholder et posez une question Remplacez `mgv_xxxx` par votre clé API et enregistrez. Vérifiez que le serveur tourne dans Settings → Agents → MCP servers, puis posez une question dont vous connaissez déjà la réponse. La [documentation MCP](https://docs.warp.dev/agents/capabilities/mcp/) de Warp couvre les serveurs déclarés dans des fichiers, le partage et l’authentification. ## Indexez un dépôt que vous connaissez déjà. Connectez Warp via MCP, puis posez une question que vous pouvez vérifier.