Para sa mga user ng Warp

Sa terminal nakatira ang agent ng Warp. Bigyan ito ng mapa ng repo.

Nagpapatakbo ng mga command ang agent ng Warp at binabasa ang output ng mga ito. Ini-index ng Maguyva ang buong repo at ibinabalik ito sa MCP, kaya tinatanong ng agent kung nasaan ang code sa halip na paulit-ulit na mag-grep at mag-cat hanggang may tumugma.

Magsimula nang libre Basahin ang setup sa Warp

May Free tier: 3 repository, Hanggang 50K na naka-index na linya ng repo, walang card.

Isang mcpServers entry sa ~/.warp/.mcp.json: isang URL at isang Authorization header.

Ang kailangang malaman sa Warp

Apat na fact na para lang sa Warp.

// config file nito

~/.warp/.mcp.json

Kusang sinisimulan ng Warp ang mga server sa global file na ito. Puwede mo ring i-paste ang parehong JSON sa Settings → Agents → MCP servers → + Add.

// ang transport

Remote, gamit ang URL

Kumokonekta ang isang url entry gamit ang Streamable HTTP o SSE. Walang tumatakbo nang lokal at hindi kailangan ang Node.js.

// ang key

Literal na header

Direktang inilalagay ang key sa Authorization header. Itago ito sa global file, hindi sa .warp/.mcp.json ng project na kino-commit mo.

// mga project file

Hindi kusang sinisimulan

Natutukoy ng Warp ang .warp/.mcp.json sa na-clone na repo pero hinihintay ka nitong simulan ang bawat server. Kapag in-on mo ito, kaya rin nitong basahin ang mga server mula sa config ng Claude Code at Codex.

Ang project rules ay kasunduan sa trabaho. Gamitin ang mga ito.

# AGENTS.md
- Patakbuhin ang make test bago sabihing tapos na ang pagbabago.
- Gamitin ang mga script sa bin/, hindi mga command na basta-basta.

Binabasa ng Warp ang project rules mula sa AGENTS.md (o WARP.md, na mananaig kapag parehong naroon) at ina-apply ang Global Rules kahit saan. Gamitin ang mga ito para sa:

Mga command sa build, test, at deploy.
Mga convention na paulit-ulit na mali ng agent.
Mga command na hindi kailanman dapat patakbuhin ng agent.

Sinasabi ng rules sa agent kung paano magtrabaho. Hindi nito masasabi kung aling service ang nagbabasa pa ng environment variable na tatanggalin mo na.

Kung saan nauubos ang grep sa terminal

Tatlong bagay na hindi mura ang pag-aaral para sa isang shell session.

// lumalampas ang output

Bawat grep at cat na pinapatakbo ng agent ay napupunta sa usapan. Ang search na naglalabas ng dalawandaang linya ay umuubos ng context bago pa magsimula ang tunay na trabaho.

// hindi caller ang isang match

Hindi natutukoy ng grep kung tunay na tawag ito o comment, fixture, o method na kapangalan sa ibang class.

// malamig ang simula ng shell

Walang alam ang bagong session tungkol sa repo. Nakahanda na ang index ng Maguyva, kaya naka-rank na sagot agad ang makukuha ng unang tanong.

Maguyva bilang MCP server sa Warp

Isang mcpServers entry ang nagbibigay sa agent ng Warp ng:

11 na tool sa naka-index mong repo semantic, structural (AST), graph, at text search, kasama ang symbol lookup, mga dependent, at pagkuha ng file.
Mga sagot na may file path at line number sa 285+ na language, sapat ang ikli para mabasa sa isang terminal pane.
Mga tool na nagbabasa lang Nagku-query lang sa index ang mga tool ng Maguyva. Walang nag-e-edit ng file o nagpapatakbo ng command.

Binibigay ng Warp sa agent ang isang terminal.
Binibigyan ng Maguyva ang agent ng mapa ng code.

Dalawang workflow

Tanungin muna ang mapa, saka magpatakbo ng mga command.

// workflow 01

Sundan ang pumapalyang script hanggang sa pinagmulan

warp agent> pumapalya ang deploy.sh: walang BUILD_ID. saan ito sine-set?

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

→ Sino-source ng agent ang ci/env.sh at inuulit ang deploy.
[exit 0]

Isang naka-index na search ang pumapalit sa recursive na grep sa buong repo at sa output nito.

// workflow 02

Suriin ang mga caller bago baguhin ang isang boot step

warp agent> puwede na bang itigil ang pagpapatakbo ng migrations sa startup?

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

→ Inililipat ng agent ang tatlo sa release step.
[exit 0]

Dumarating ang mga caller bago ang pagbabago, kaya hindi magbo-boot ang worker sa lumang schema.

Setup sa Warp

Tatlong hakbang. Free tier: 3 repository, Hanggang 50K na naka-index na linya ng repo, walang card.

// step 01

I-index ang isang repo sa maguyva.ai

Pumili ng isang alam mo na, para masuri mo ang mga sagot.

// step 02

Idagdag ang Maguyva sa ~/.warp/.mcp.json

~/.warp/.mcp.json

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

// step 03

Palitan ang placeholder at magtanong ng isa

Palitan ang mgv_xxxx ng API key mo at i-save. Tingnan sa Settings → Agents → MCP servers kung tumatakbo ang server, saka magtanong ng isang bagay na alam mo na ang sagot.