# Warp-terminaalin agentti asuu terminaalissa. Anna sille kartta reposta.

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

Warp-terminaalin agentti ajaa komentoja ja lukee niiden tulosteen. Maguyva indeksoi koko repon ja tarjoilee sen MCP:n kautta, joten agentti kysyy, missä koodi on, sen sijaan että ajaisi grepiä ja catia, kunnes jokin osuu.

> Yksi mcpServers-merkintä tiedostossa ~/.warp/.mcp.json: URL ja Authorization-otsake.

## Mitä Warp-terminaalin pitää tietää

Neljä Warp-terminaalia koskevaa faktaa.

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

Warp käynnistää tämän globaalin tiedoston palvelimet itse. Voit myös liittää saman JSON-määrityksen kohtaan Settings → Agents → MCP servers → + Add.

### Etänä, URL-osoitteella

`url`-merkintä yhdistää Streamable HTTP:llä tai SSE:llä. Paikallisesti ei ajeta mitään, eikä Node.js:ää tarvita.

### Otsake sellaisenaan

Avain menee suoraan `Authorization`-otsakkeeseen. Pidä se globaalissa tiedostossa, älä projektin committaamassasi `.warp/.mcp.json`-tiedostossa.

### Ei koskaan automaattisesti käynnissä

Warp tunnistaa kloonatun repon tiedoston `.warp/.mcp.json`, mutta odottaa, että käynnistät jokaisen palvelimen itse. Kun kytket sen päälle, Warp voi lukea palvelimia myös Claude Code- ja Codex-asetuksista.

## Projektisäännöt ovat työskentelysopimus. Käytä niitä.

```text
# AGENTS.md
- Aja make test ennen kuin julistat muutoksen valmiiksi.
- Käytä bin/-hakemiston skriptejä, älä hätäisiä komentoja.
```

Warp lukee projektisäännöt tiedostosta `AGENTS.md` (tai `WARP.md`, joka voittaa, jos molemmat ovat olemassa) ja soveltaa Global Rules -sääntöjä kaikkialla. Käytä niitä näihin:

- Build-, testi- ja julkaisukomennot.
- Käytännöt, jotka agentti tekee yhä uudelleen väärin.
- Komennot, joita agentti ei saa koskaan ajaa.

Säännöt kertovat agentille, miten työskennellä. Ne eivät voi kertoa, mikä palvelu lukee yhä ympäristömuuttujaa, jonka olet poistamassa.

## Missä grep terminaalissa loppuu

Kolme asiaa, joita shell-istunto ei opi halvalla.

### // tuloste vierii ohi

Jokainen agentin ajama grep ja cat päätyy keskusteluun. Kaksisataa riviä tulostava haku kuluttaa kontekstia ennen kuin varsinainen työ alkaa.

### // osuma ei ole kutsuja

grep ei erota oikeaa kutsua kommentista, fixturesta tai toisen luokan samannimisestä metodista.

### // shell aloittaa kylmiltään

Uusi istunto ei tiedä reposta mitään. Maguyva-indeksi on jo rakennettu, joten ensimmäinen kysymys saa järjestetyn vastauksen.

## Maguyva MCP-palvelimena Warp-terminaalissa

Yksi mcpServers-merkintä antaa Warp-terminaalin agentille:

- **11 työkalua indeksoituun repoosi**: semanttinen, rakenteellinen (AST-), graafi- ja tekstihaku sekä symbolihaku, riippuvaiset ja tiedostojen haku.
- **Vastaukset tiedostopoluilla ja rivinumeroilla**: yli 285 kielellä, tarpeeksi lyhyinä terminaalin paneelissa luettaviksi.
- **Työkalut, jotka vain lukevat**: Maguyva-työkalut kyselevät indeksiä. Mikään niistä ei muokkaa tiedostoja eikä aja komentoja.

> Warp antaa agentille *terminaalin*.
> Maguyva antaa agentille *kartan koodista*.

## Kaksi työnkulkua

Kysy ensin kartalta, aja komennot sitten.

### 01. Jäljitä epäonnistuva skripti lähteeseen

```text
warp agent> deploy.sh kaatuu: BUILD_ID puuttuu. missä se asetetaan?

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

→ Agentti lataa ci/env.sh:n ja ajaa julkaisun uudelleen.
[exit 0]
```

Yksi indeksoitu haku korvaa rekursiivisen grepin koko repon läpi ja sen tulosteen.

### 02. Tarkista kutsujat ennen käynnistysvaiheen muuttamista

```text
warp agent> voimmeko lopettaa migraatioiden ajamisen käynnistyksessä?

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

→ Agentti siirtää kaikki kolme julkaisuvaiheeseen.
[exit 0]
```

Kutsujat tulevat ennen muutosta, joten worker ei käynnisty vanhaa skeemaa vasten.

## Käyttöönotto Warp-terminaalissa

Kolme vaihetta. Free-taso: 3 repositoriota, Enintään 50 000 indeksoitua repo-riviä, ei luottokorttia.

### 01. Indeksoi repo osoitteessa maguyva.ai

Valitse jo tuntemasi repo, jotta voit arvioida vastauksia.

### 02. Lisää Maguyva tiedostoon ~/.warp/.mcp.json

`~/.warp/.mcp.json`

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

### 03. Korvaa paikkamerkki ja kysy yksi kysymys

Korvaa `mgv_xxxx` omalla API-avaimellasi ja tallenna. Tarkista kohdasta Settings → Agents → MCP servers, että palvelin on käynnissä, ja kysy sitten yksi kysymys, jonka vastauksen jo tiedät.

Warp-terminaalin [MCP-dokumentaatio](https://docs.warp.dev/agents/capabilities/mcp/) kattaa tiedostopohjaiset palvelimet, jakamisen ja tunnistautumisen.

## Indeksoi yksi repo, jonka jo tunnet.

Yhdistä Warp MCP:n kautta ja kysy yksi kysymys, jonka voit tarkistaa.