# Copilot voit votre espace de travail. Maguyva cartographie le dépôt. Canonical source: https://maguyva.ai/fr/for-vscode 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 VS Code lit les fichiers que vous joignez et ceux qu’il trouve lui-même. Maguyva indexe tout le dépôt et le sert via MCP : avant de modifier, l’agent demande où se trouve un symbole et qui l’appelle. > Une entrée servers dans .vscode/mcp.json : une URL et un en-tête Authorization. ## Ce que VS Code doit savoir Quatre points propres à VS Code. ### .vscode/mcp.json Les serveurs vont sous `servers`, pas sous `mcpServers`. Pour tous vos espaces de travail, lancez `MCP: Open User Configuration` et ajoutez la même entrée au `mcp.json` de votre profil. ### type: http VS Code se connecte au point de terminaison de Maguyva en Streamable HTTP et ne bascule en SSE que si un serveur ne le prend pas en charge. Rien ne tourne en local. ### Une référence à une variable d’environnement L’en-tête vaut `Bearer ${env:MAGUYVA_API_KEY}`, que VS Code résout depuis l’environnement dans lequel il a été lancé : la clé reste hors du fichier que vous commitez. Vous préférez une invite ? Une variable d’entrée la demande une fois et la conserve. ### Workspace Trust Les serveurs de `.vscode/mcp.json` démarrent sans invite séparée dès que vous faites confiance à l’espace de travail, et jamais en mode restreint. Configure Tools, dans la zone de saisie du chat, active ou désactive chaque outil. ## Les instructions personnalisées sont un accord de travail. Utilisez-les. ```text # .github/copilot-instructions.md - Lancez npm test avant de déclarer une modification terminée. - Ne modifiez jamais les fichiers générés sous src/gen/. ``` VS Code lit les instructions de projet dans `.github/copilot-instructions.md` ou `AGENTS.md`, et les instructions ciblées dans des fichiers `.github/instructions/*.instructions.md` dotés d’un motif `applyTo`. Utilisez-les pour : - Les commandes de build, de test et de lint. - Les conventions sur lesquelles l’agent se trompe sans cesse. - Les dossiers auxquels l’agent ne doit pas toucher. Les instructions disent à l’agent comment travailler. Elles ne peuvent pas lui dire lesquels de quatre mille fichiers importent le type qu’il s’apprête à renommer. ## Là où la vue de l’espace de travail s’arrête Trois choses que l’agent ne peut pas apprendre des fichiers ouverts. ### // joint ne veut pas dire complet L’agent travaille avec ce que vous joignez et ce que ses recherches renvoient. L’appelant d’un autre paquet qui casse après la modification ne figurait dans aucune des deux listes. ### // une correspondance n’est pas une référence La recherche de l’espace de travail trouve la chaîne. Elle ne distingue pas un vrai appel d’un commentaire, d’un mock ou d’une méthode homonyme d’une autre classe. ### // chaque lecture coûte du contexte Chaque fichier que l’agent ouvre pour s’orienter consomme le contexte dont il a besoin pour la modification. Une réponse classée avec file:line coûte moins que dix lectures exploratoires. ## Maguyva comme serveur MCP dans VS Code Une entrée servers donne à l’agent : - **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**: sur plus de 285 langages, pour que l’agent ouvre le bon fichier du premier coup. - **Des outils en lecture seule**: Les outils de Maguyva interrogent l’index. Aucun ne modifie vos fichiers : chaque approbation porte sur une lecture, pas sur une écriture. > VS Code donne à l’agent *votre espace de travail*. > Maguyva donne à l’agent *une carte du dépôt*. ## Deux flux de travail Interrogez d’abord la carte, puis modifiez. ### 01. Trouver les tests avant de modifier un parseur ```text vscode agent> quels tests passent par parseConfig ? dependency_search("parseConfig", dependents) tests/config/parse.test.ts:12 tests/cli/flags.test.ts:88 → Après la modification, l’agent lance ces deux fichiers, pas toute la suite. [exit 0] ``` La réponse nomme les deux fichiers de test qui atteignent le parseur : l’agent vérifie la modification là où elle peut casser. ### 02. Mesurer un renommage avant la première modification ```text vscode agent> renomme OrderStatus.PENDING en OrderStatus.QUEUED find_symbol("OrderStatus", references) 23 références dans 9 fichiers → L’agent prévoit un seul passage sur neuf fichiers. [exit 0] ``` Le nombre de références arrive avant la modification, pas après l’échec du vérificateur de types. ## Configuration dans VS Code 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 à .vscode/mcp.json `.vscode/mcp.json` ```json { "servers": { "maguyva": { "type": "http", "url": "https://maguyva.tools/mcp", "headers": { "Authorization": "Bearer ${env:MAGUYVA_API_KEY}" } } } } ``` ### 03. Définir votre clé et démarrer le serveur Définissez `MAGUYVA_API_KEY` dans l’environnement depuis lequel vous lancez VS Code, puis démarrez le serveur avec le code lens au-dessus de son entrée. Posez à l’agent une question dont vous connaissez déjà la réponse. La [documentation MCP](https://code.visualstudio.com/docs/agent-customization/mcp-servers) de VS Code couvre les variables d’entrée, le format portable .mcp.json et la confiance accordée aux serveurs. ## Indexez un dépôt que vous connaissez déjà. Connectez VS Code via MCP, puis posez une question que vous pouvez vérifier.