# Agent w Warp mieszka w terminalu. Daj mu mapę repo.

Canonical source: https://maguyva.ai/pl/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 w Warp uruchamia komendy i czyta to, co wypisują. Maguyva indeksuje całe repo i udostępnia je przez MCP, więc agent pyta, gdzie jest kod, zamiast puszczać grep i cat, aż coś się dopasuje.

> Jeden wpis mcpServers w ~/.warp/.mcp.json: URL i nagłówek Authorization.

## Co warto wiedzieć o Warp

Cztery fakty dotyczące tylko Warp.

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

Warp sam uruchamia serwery z tego globalnego pliku. Ten sam JSON możesz też wkleić w Settings → Agents → MCP servers → + Add.

### Zdalnie, przez URL

Wpis `url` łączy się przez Streamable HTTP lub SSE. Lokalnie nic nie działa, a Node.js nie jest potrzebny.

### Nagłówek wprost

Klucz trafia prosto do nagłówka `Authorization`. Trzymaj go w pliku globalnym, a nie w projektowym `.warp/.mcp.json`, który commitujesz.

### Nigdy nie startują same

Warp wykrywa `.warp/.mcp.json` w sklonowanym repo, ale czeka, aż sam uruchomisz każdy serwer. Po włączeniu opcji potrafi też czytać serwery z konfiguracji Claude Code i Codex.

## Reguły projektu to umowa robocza. Korzystaj z nich.

```text
# AGENTS.md
- Uruchom make test, zanim uznasz zmianę za gotową.
- Używaj skryptów z bin/, a nie doraźnych komend.
```

Warp czyta reguły projektu z `AGENTS.md` (lub z `WARP.md`, który wygrywa, gdy istnieją oba) i stosuje Global Rules wszędzie. Używaj ich do:

- Komend build, testów i wdrożeń.
- Konwencji, które agent wciąż myli.
- Komend, których agentowi nie wolno uruchamiać.

Reguły mówią agentowi, jak pracować. Nie powiedzą mu, która usługa wciąż czyta zmienną środowiskową, którą zaraz usuniesz.

## Gdzie kończy się grep w terminalu

Trzy rzeczy, których sesja shella nie nauczy się tanio.

### // wynik przewija się dalej

Każdy grep i cat uruchomiony przez agenta ląduje w rozmowie. Wyszukiwanie, które wypisuje dwieście linii, zużywa kontekst, zanim zacznie się właściwa praca.

### // dopasowanie to nie wywołujący

grep nie odróżni prawdziwego wywołania od komentarza, fixture’a ani metody o tej samej nazwie w innej klasie.

### // shell startuje na zimno

Nowa sesja nic nie wie o repo. Indeks Maguyva jest już zbudowany, więc pierwsze pytanie od razu dostaje uszeregowaną odpowiedź.

## Maguyva jako serwer MCP w Warp

Jeden wpis mcpServers daje agentowi w Warp:

- **11 narzędzi dla zaindeksowanego repo**: wyszukiwanie semantyczne, strukturalne (AST), grafowe i tekstowe, a do tego wyszukiwanie symboli, zależności i pobieranie plików.
- **Odpowiedzi ze ścieżkami plików i numerami linii**: w ponad 285 językach, na tyle krótkie, by przeczytać je w panelu terminala.
- **Narzędzia tylko do odczytu**: Narzędzia Maguyva tylko odpytują indeks. Żadne nie edytuje plików ani nie uruchamia komend.

> Warp daje agentowi *terminal*.
> Maguyva daje agentowi *mapę kodu*.

## Dwa przepływy pracy

Najpierw zapytaj mapę, potem uruchamiaj komendy.

### 01. Prześledź padający skrypt aż do źródła

```text
warp agent> deploy.sh pada: BUILD_ID nie jest ustawione. gdzie się je ustawia?

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

→ Agent wczytuje ci/env.sh i ponawia wdrożenie.
[exit 0]
```

Jedno zaindeksowane wyszukiwanie zastępuje rekurencyjny grep po całym repo i jego wynik.

### 02. Sprawdź wywołujących, zanim zmienisz krok startowy

```text
warp agent> czy możemy przestać uruchamiać migracje przy starcie?

dependency_search("runMigrations", dependents)
  3 wywołujące: server.ts, worker.ts, scripts/seed.ts

→ Agent przenosi wszystkie trzy do kroku wydania.
[exit 0]
```

Wywołujący są znani przed zmianą, więc worker nie wystartuje na starym schemacie.

## Konfiguracja w Warp

Trzy kroki. Plan Free: 3 repozytoria, Do 50 tys. zindeksowanych linii repo, bez karty kredytowej.

### 01. Zaindeksuj repo na maguyva.ai

Wybierz takie, które już znasz, żeby móc ocenić odpowiedzi.

### 02. Dodaj Maguyva do ~/.warp/.mcp.json

`~/.warp/.mcp.json`

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

### 03. Podmień placeholder i zadaj jedno pytanie

Zamień `mgv_xxxx` na swój klucz API i zapisz. Sprawdź w Settings → Agents → MCP servers, że serwer działa, a potem zadaj pytanie, na które znasz już odpowiedź.

[Dokumentacja MCP](https://docs.warp.dev/agents/capabilities/mcp/) dla Warp opisuje serwery definiowane w plikach, udostępnianie i uwierzytelnianie.

## Zaindeksuj jedno repo, które już znasz.

Połącz Warp przez MCP i zadaj pytanie, które możesz sprawdzić.