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

Canonical source: https://maguyva.ai/nl/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).

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.

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

## Wat Warp moet weten

Vier feiten specifiek voor Warp.

### ~/.warp/.mcp.json

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

### Remote, via URL

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

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

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

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

### 01. Een falend script terugvolgen naar de bron

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

### 02. Aanroepers controleren voordat een opstartstap verandert

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

### 01. Indexeer een repo op maguyva.ai

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

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

`~/.warp/.mcp.json`

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

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

De [MCP-documentatie](https://docs.warp.dev/agents/capabilities/mcp/) van Warp behandelt servers in bestanden, delen en authenticatie.

## Indexeer één repo die je al kent.

Verbind Warp via MCP en stel één vraag die je kunt controleren.