Dla użytkowników Warp

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

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.

Zacznij za darmo Przeczytaj konfigurację dla Warp

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

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

Co warto wiedzieć o Warp

Cztery fakty dotyczące tylko Warp.

// plik konfiguracji

~/.warp/.mcp.json

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

// transport

Zdalnie, przez URL

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

// klucz

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.

// pliki projektu

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.

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

// workflow 01

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

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.

// workflow 02

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

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.

// step 01

Zaindeksuj repo na maguyva.ai

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

// step 02

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

~/.warp/.mcp.json

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

// step 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ź.