Voor Warp-gebruikers

De agent van Warp woont in de terminal. Geef hem een kaart van de repo.

De agent van Warp voert commando’s uit en leest wat ze afdrukken. Maguyva indexeert de hele repo en levert die via MCP, zodat de agent vraagt waar code staat in plaats van grep en cat te draaien tot er iets overeenkomt.

Start gratis Lees de Warp-setup

Free-abonnement: 3 repositories, Tot 50K geïndexeerde repo-regels, geen creditcard nodig.

Eén mcpServers-item in ~/.warp/.mcp.json: een URL en een Authorization-header.

Wat Warp moet weten

Vier feiten specifiek voor Warp.

// configbestand

~/.warp/.mcp.json

Warp start de servers uit dit globale bestand vanzelf. Je kunt dezelfde JSON ook plakken in Settings → Agents → MCP servers → + Add.

// transport

Remote, via URL

Een url-item maakt verbinding via Streamable HTTP of SSE. Lokaal draait niets en Node.js is niet nodig.

// sleutel

Een letterlijke header

De sleutel gaat direct in de Authorization-header. Houd hem in het globale bestand, niet in de .warp/.mcp.json van een project dat je commit.

// projectbestanden

Nooit automatisch gestart

Warp detecteert .warp/.mcp.json in een gekloonde repo, maar wacht tot jij elke server start. Als je het aanzet, leest het ook servers uit de configuraties van Claude Code en Codex.

Projectregels zijn een werkafspraak. Gebruik ze.

# AGENTS.md
- Draai make test voordat je een wijziging af noemt.
- Gebruik de scripts in bin/, geen losse commando’s.

Warp leest projectregels uit AGENTS.md (of WARP.md, dat voorgaat als beide bestaan) en past Global Rules overal toe. Gebruik ze voor:

Build-, test- en deploycommando’s.
Conventies die de agent steeds verkeerd doet.
Commando’s die de agent nooit mag uitvoeren.

Regels vertellen de agent hoe hij moet werken. Ze kunnen hem niet vertellen welke service de omgevingsvariabele nog leest die je zo gaat verwijderen.

Waar grep in de terminal ophoudt

Drie dingen die een shellsessie niet goedkoop leert.

// uitvoer scrolt voorbij

Elke grep en cat die de agent draait, belandt in het gesprek. Een zoekopdracht die tweehonderd regels afdrukt, kost context voordat het echte werk begint.

// een treffer is geen aanroeper

grep ziet geen verschil tussen een echte aanroep en een commentaar, een fixture of een methode met dezelfde naam in een andere klasse.

// de shell begint koud

Een nieuwe sessie weet niets van de repo. De index van Maguyva staat al klaar, dus de eerste vraag krijgt een gerangschikt antwoord.

Maguyva als MCP-server in Warp

Eén mcpServers-item geeft de agent van Warp:

11 tools voor je geïndexeerde repo semantisch, structureel (AST-), graaf- en tekstzoeken, plus symbolen opzoeken, afhankelijken en bestanden ophalen.
Antwoorden met bestandspaden en regelnummers in meer dan 285 talen, kort genoeg voor een terminalvenster.
Tools die alleen lezen De tools van Maguyva bevragen de index. Geen enkele bewerkt bestanden of voert commando’s uit.

Warp geeft de agent een terminal.
Maguyva geeft de agent een kaart van de code.

Twee workflows

Vraag eerst de kaart, voer daarna commando’s uit.

// workflow 01

Een falend script terugvolgen naar de bron

warp agent> deploy.sh faalt: BUILD_ID is niet ingesteld. waar wordt die gezet?

text_pattern_search("BUILD_ID=")
  ci/env.sh:9   export BUILD_ID=...
  docs/deploy.md:31   ← tekst

→ De agent laadt ci/env.sh en draait de deploy opnieuw.
[exit 0]

Eén geïndexeerde zoekopdracht vervangt een recursieve grep over de repo en al zijn uitvoer.

// workflow 02

Aanroepers controleren voordat een opstartstap verandert

warp agent> kunnen we stoppen met migraties draaien bij het opstarten?

dependency_search("runMigrations", dependents)
  3 aanroepers: server.ts, worker.ts, scripts/seed.ts

→ De agent verplaatst alle drie naar de releasestap.
[exit 0]

De aanroepers komen vóór de wijziging binnen, dus de worker start niet tegen een oud schema.

Instellen in Warp

Drie stappen. Free-abonnement: 3 repositories, Tot 50K geïndexeerde repo-regels, geen creditcard nodig.

// step 01

Indexeer een repo op maguyva.ai

Kies er een die je al kent, zodat je de antwoorden kunt beoordelen.

// step 02

Voeg Maguyva toe aan ~/.warp/.mcp.json

~/.warp/.mcp.json

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

// step 03

Vervang de placeholder en stel één vraag

Vervang mgv_xxxx door je API-sleutel en sla op. Controleer onder Settings → Agents → MCP servers dat de server draait en stel dan één vraag waarvan je het antwoord al weet.