# Sa terminal nakatira ang agent ng Warp. Bigyan ito ng mapa ng repo. Canonical source: https://maguyva.ai/fil/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). 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. > 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. ### ~/.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. ### 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. ### 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. ### 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. ```text # 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. ### 01. Sundan ang pumapalyang script hanggang sa pinagmulan ```text 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. ### 02. Suriin ang mga caller bago baguhin ang isang boot step ```text 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. ### 01. I-index ang isang repo sa maguyva.ai Pumili ng isang alam mo na, para masuri mo ang mga sagot. ### 02. Idagdag ang Maguyva sa ~/.warp/.mcp.json `~/.warp/.mcp.json` ```json { "mcpServers": { "maguyva": { "url": "https://maguyva.tools/mcp", "headers": { "Authorization": "Bearer mgv_xxxx" } } } } ``` ### 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. Saklaw ng [MCP docs](https://docs.warp.dev/agents/capabilities/mcp/) ng Warp ang file-based servers, sharing, at authentication. ## I-index ang isang repo na kilala mo na. Ikonekta ang Warp sa MCP, saka magtanong ng isang bagay na kaya mong i-check.