Pour les utilisateurs de VS Code

Copilot voit votre espace de travail. Maguyva cartographie le dépôt.

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.

Commencer gratuitement Lire la configuration VS Code

Palier Free : 3 dépôts, Jusqu'à 50 000 lignes de dépôt indexées, sans carte bancaire.

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.

// fichier de config

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

// transport

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.

// clé

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.

// confiance

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.

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

// workflow 01

Trouver les tests avant de modifier un parseur

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.

// workflow 02

Mesurer un renommage avant la première modification

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.

// step 01

Indexez un dépôt sur maguyva.ai

Choisissez-en un que vous connaissez déjà, pour pouvoir évaluer les réponses.

// step 02

Ajouter Maguyva à .vscode/mcp.json

.vscode/mcp.json

{
  "servers": {
    "maguyva": {
      "type": "http",
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer ${env:MAGUYVA_API_KEY}"
      }
    }
  }
}

// step 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.