Pro uživatele Warp

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

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

Začít zdarma Přečtěte si nastavení pro Warp

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

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.

// konfigurační soubor

~/.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.

// transport

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.

// klíč

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.

// projektové soubory

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.

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

// workflow 01

Vystopujte padající skript až ke zdroji

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.

// workflow 02

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

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.

// step 01

Indexujte repozitář na maguyva.ai

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

// step 02

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

~/.warp/.mcp.json

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

// step 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ěď.