# Agent ve Warp bydlí v terminálu. Dejte mu mapu repa.

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

Agent ve Warp spouští příkazy a čte, co vypíšou. Maguyva indexuje celé repo a servíruje ho přes MCP, takže se agent zeptá, kde kód leží, místo aby pouštěl grep a cat, dokud se něco netrefí.

> Jedna položka mcpServers v ~/.warp/.mcp.json: URL a hlavička Authorization.

## Co potřebujete vědět o Warp

Čtyři fakta specifická pro Warp.

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

Warp spouští servery z tohoto globálního souboru sám. Stejný JSON můžete vložit i do Settings → Agents → MCP servers → + Add.

### Vzdáleně, přes URL

Položka `url` se připojí přes Streamable HTTP nebo SSE. Lokálně neběží nic a Node.js není potřeba.

### Hlavička natvrdo

Klíč jde rovnou do hlavičky `Authorization`. Držte ho v globálním souboru, ne v projektovém `.warp/.mcp.json`, který commitujete.

### Nikdy se nespustí samy

Warp najde `.warp/.mcp.json` v naklonovaném repu, ale počká, až každý server spustíte sami. Když to zapnete, umí číst servery i z konfigurací Claude Code a Codex.

## Projektová pravidla jsou dohoda o spolupráci. Používejte je.

```text
# AGENTS.md
- Než prohlásíš změnu za hotovou, spusť make test.
- Používej skripty z bin/, ne improvizované příkazy.
```

Warp čte projektová pravidla z `AGENTS.md` (nebo z `WARP.md`, který má přednost, pokud existují oba) a Global Rules uplatňuje všude. Používejte je pro:

- Příkazy pro build, testy a nasazení.
- Konvence, které agent pořád plete.
- Příkazy, které agent nesmí nikdy spustit.

Pravidla říkají agentovi, jak pracovat. Neřeknou mu, která služba ještě čte proměnnou prostředí, kterou se chystáte odstranit.

## Kde končí grep v terminálu

Tři věci, které se relace shellu levně nenaučí.

### // výstup proletí kolem

Každý grep a cat, který agent spustí, skončí v konverzaci. Hledání, které vypíše dvě stě řádků, spálí kontext dřív, než začne skutečná práce.

### // shoda není volající

grep neodliší skutečné volání od komentáře, fixture ani stejnojmenné metody jiné třídy.

### // shell startuje za studena

Nová relace o repu nic neví. Index Maguyva je už postavený, takže hned první otázka dostane seřazenou odpověď.

## Maguyva jako MCP server ve Warp

Jedna položka mcpServers dá agentovi ve Warp:

- **11 nástrojů nad vaším indexovaným repozitářem**: sémantické, strukturální (AST), grafové a textové vyhledávání, plus vyhledávání symbolů, závislé a načítání souborů.
- **Odpovědi s cestami k souborům a čísly řádků**: ve více než 285 jazycích, dost krátké na přečtení v panelu terminálu.
- **Nástroje, které jen čtou**: Nástroje Maguyva jen dotazují index. Žádný neupravuje soubory ani nespouští příkazy.

> Warp dává agentovi *terminál*.
> Maguyva dává agentovi *mapu kódu*.

## Dva pracovní postupy

Nejdřív se zeptejte mapy, pak spouštějte příkazy.

### 01. Vystopujte padající skript až ke zdroji

```text
warp agent> deploy.sh padá: BUILD_ID není nastavené. kde se nastavuje?

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

→ Agent načte ci/env.sh a nasazení zopakuje.
[exit 0]
```

Jedno indexované hledání nahradí rekurzivní grep přes celé repo i s jeho výstupem.

### 02. Zkontrolujte volající, než změníte krok při startu

```text
warp agent> můžeme přestat spouštět migrace při startu?

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

→ Agent přesune všechny tři do kroku vydání.
[exit 0]
```

Volající dorazí před změnou, takže worker nenastartuje proti starému schématu.

## Nastavení ve Warp

Tři kroky. Free tarif: 3 repozitáře, Až 50K zaindexovaných řádků repa, bez kreditní karty.

### 01. Indexujte repozitář na maguyva.ai

Vyberte si takový, který už znáte, abyste mohli posoudit odpovědi.

### 02. Přidejte Maguyva do ~/.warp/.mcp.json

`~/.warp/.mcp.json`

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

### 03. Nahraďte zástupný text a položte jednu otázku

Nahraďte `mgv_xxxx` svým API klíčem a uložte. V Settings → Agents → MCP servers ověřte, že server běží, a pak položte otázku, na kterou už znáte odpověď.

[Dokumentace MCP](https://docs.warp.dev/agents/capabilities/mcp/) pro Warp popisuje servery definované v souborech, sdílení a ověřování.

## Indexujte jeden repozitář, který už znáte.

Připojte Warp přes MCP a položte otázku, kterou si můžete ověřit.