Pour les utilisateurs de Warp

L’agent de Warp vit dans le terminal. Donnez-lui une carte du dépôt.

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.

Commencer gratuitement Lire la configuration Warp

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

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.

// fichier de config

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

// transport

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.

// clé

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.

// fichiers de projet

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.

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

// workflow 01

Remonter d’un script en échec jusqu’à sa cause

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.

// workflow 02

Vérifier les appelants avant de changer une étape de démarrage

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.

// 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 à ~/.warp/.mcp.json

~/.warp/.mcp.json

{
  "mcpServers": {
    "maguyva": {
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer mgv_xxxx"
      }
    }
  }
}

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