# Agenten i Warp bor i terminalen. Gi den et kart over repoet.

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

Agenten i Warp kjører kommandoer og leser det de skriver ut. Maguyva indekserer hele repoet og leverer det via MCP, så agenten spør hvor koden ligger i stedet for å kjøre grep og cat til noe passer.

> Én mcpServers-oppføring i ~/.warp/.mcp.json: en URL og en Authorization-header.

## Hva Warp må vite

Fire fakta som gjelder akkurat Warp.

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

Warp starter serverne i denne globale filen på egen hånd. Du kan også lime inn samme JSON under Settings → Agents → MCP servers → + Add.

### Eksternt, via URL

En `url`-oppføring kobler til via Streamable HTTP eller SSE. Ingenting kjører lokalt, og Node.js trengs ikke.

### En header i klartekst

Nøkkelen går rett i `Authorization`-headeren. Hold den i den globale filen, ikke i et prosjekts `.warp/.mcp.json` som du committer.

### Startes aldri automatisk

Warp oppdager `.warp/.mcp.json` i et klonet repo, men venter på at du starter hver server. Slår du det på, kan Warp også lese servere fra konfigurasjonene til Claude Code og Codex.

## Prosjektregler er en samarbeidsavtale. Bruk dem.

```text
# AGENTS.md
- Kjør make test før du kaller en endring ferdig.
- Bruk skriptene i bin/, ikke tilfeldige kommandoer.
```

Warp leser prosjektregler fra `AGENTS.md` (eller `WARP.md`, som går foran hvis begge finnes) og bruker Global Rules overalt. Bruk dem til:

- Kommandoer for bygg, test og utrulling.
- Konvensjoner agenten stadig gjør feil.
- Kommandoer agenten aldri skal kjøre.

Regler forteller agenten hvordan den skal jobbe. De kan ikke fortelle hvilken tjeneste som fortsatt leser miljøvariabelen du snart fjerner.

## Der grep i terminalen tar slutt

Tre ting en skalløkt ikke lærer billig.

### // utdata ruller forbi

Hver grep og cat agenten kjører, havner i samtalen. Et søk som skriver ut to hundre linjer, bruker kontekst før det egentlige arbeidet begynner.

### // et treff er ikke en kaller

grep kan ikke skille et ekte kall fra en kommentar, en fixture eller en metode med samme navn i en annen klasse.

### // skallet starter kaldt

En ny økt vet ingenting om repoet. Indeksen til Maguyva er allerede bygd, så det første spørsmålet får et rangert svar.

## Maguyva som MCP-server i Warp

Én mcpServers-oppføring gir agenten i Warp:

- **11 verktøy for det indekserte repoet ditt**: semantisk, strukturelt (AST-), graf- og tekstsøk, pluss symboloppslag, avhengige og filhenting.
- **Svar med filstier og linjenumre**: på over 285 språk, korte nok til å lese i et terminalpanel.
- **Verktøy som bare leser**: Verktøyene til Maguyva spør indeksen. Ingen av dem redigerer filer eller kjører kommandoer.

> Warp gir agenten *en terminal*.
> Maguyva gir agenten *et kart over koden*.

## To arbeidsflyter

Spør kartet først, kjør kommandoer etterpå.

### 01. Spor et feilende skript tilbake til kilden

```text
warp agent> deploy.sh feiler: BUILD_ID er ikke satt. hvor blir den satt?

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

→ Agenten laster inn ci/env.sh og kjører utrullingen på nytt.
[exit 0]
```

Ett indeksert søk erstatter en rekursiv grep gjennom repoet og all utdataen.

### 02. Sjekk kallere før et oppstartssteg endres

```text
warp agent> kan vi slutte å kjøre migreringer ved oppstart?

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

→ Agenten flytter alle tre til release-steget.
[exit 0]
```

Kallerne kommer før endringen, så workeren starter ikke mot et gammelt skjema.

## Oppsett i Warp

Tre steg. Free-planen: 3 repoer, Opptil 50K indekserte kodelinjer, uten kredittkort.

### 01. Indekser et repo på maguyva.ai

Velg ett du allerede kjenner, så du kan vurdere svarene.

### 02. Legg Maguyva til i ~/.warp/.mcp.json

`~/.warp/.mcp.json`

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

### 03. Bytt ut plassholderen og still ett spørsmål

Bytt ut `mgv_xxxx` med API-nøkkelen din og lagre. Sjekk under Settings → Agents → MCP servers at serveren kjører, og still så ett spørsmål du allerede vet svaret på.

[MCP-dokumentasjonen](https://docs.warp.dev/agents/capabilities/mcp/) til Warp dekker filbaserte servere, deling og autentisering.

## Indekser ett repo du allerede kjenner.

Koble Warp til via MCP, og still ett spørsmål du kan sjekke.