# Nakikita ng Copilot ang workspace mo. Minamapa ng Maguyva ang repo. Canonical source: https://maguyva.ai/fil/for-vscode 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). Binabasa ng agent sa VS Code ang mga file na ina-attach mo at ang mga nahahanap nito. Ini-index ng Maguyva ang buong repo at ibinabalik ito sa MCP, kaya bago mag-edit, tinatanong muna ng agent kung nasaan ang isang symbol at sino ang tumatawag dito. > Isang servers entry sa .vscode/mcp.json: isang URL at isang Authorization header. ## Ang kailangang malaman sa VS Code Apat na fact na para lang sa VS Code. ### .vscode/mcp.json Ang mga server ay nasa ilalim ng `servers`, hindi `mcpServers`. Para sa lahat ng workspace, patakbuhin ang `MCP: Open User Configuration` at idagdag ang parehong entry sa `mcp.json` ng profile mo. ### type: http Kumokonekta ang VS Code sa endpoint ng Maguyva gamit ang Streamable HTTP at lilipat lang sa SSE kapag hindi ito suportado ng server. Walang tumatakbo nang lokal. ### Isang env reference Ang header ay `Bearer ${env:MAGUYVA_API_KEY}`, na kinukuha ng VS Code mula sa environment kung saan ito binuksan, kaya hindi napupunta ang key sa file na kino-commit mo. Mas gusto mong tanungin? Ang input variable ay nagtatanong nang isang beses at sine-save ang key. ### Workspace Trust Nagsisimula ang mga server sa `.vscode/mcp.json` nang walang hiwalay na prompt kapag pinagkatiwalaan mo ang workspace, at hindi kailanman sa Restricted Mode. Gamit ang Configure Tools sa chat input, puwedeng i-on o i-off ang bawat tool. ## Ang custom instructions ay isang working agreement. Gamitin ito. ```text # .github/copilot-instructions.md - Patakbuhin ang npm test bago sabihing tapos na ang pagbabago. - Huwag i-edit ang mga generated file sa src/gen/. ``` Binabasa ng VS Code ang instructions para sa buong project mula sa `.github/copilot-instructions.md` o `AGENTS.md`, at ang mas tiyak na instructions mula sa mga file na `.github/instructions/*.instructions.md` na may `applyTo` pattern. Gamitin ang mga ito para sa: - Mga command sa build, test, at lint. - Mga convention na paulit-ulit na mali ng agent. - Mga folder na hindi dapat galawin ng agent. Sinasabi ng instructions sa agent kung paano magtrabaho. Hindi nito masasabi kung alin sa apat na libong file ang nag-i-import ng type na ire-rename nito. ## Kung saan nauubos ang tanaw sa workspace Tatlong bagay na hindi matututunan ng agent sa mga file na bukas nito. ### // hindi sapat ang naka-attach Gumagana ang agent sa ina-attach mo at sa ibinabalik ng mga search nito. Ang caller sa ibang package na masisira pagkatapos ng pagbabago ay wala sa alinman sa dalawang listahan. ### // hindi reference ang text match Nahahanap ng workspace search ang string. Hindi nito natutukoy kung tunay na tawag ito o comment, mock, o method na kapangalan sa ibang class. ### // bawat basa ay gastos sa context Bawat file na binubuksan ng agent para mag-orient ay umuubos ng context na kailangan nito para sa pagbabago. Mas mura ang isang naka-rank na sagot na may file:line kaysa sampung exploratory read. ## Maguyva bilang MCP server sa VS Code Isang servers entry ang nagbibigay sa agent 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 wika, kaya tamang file agad ang binubuksan ng agent. - **Mga tool na nagbabasa lang**: Nagku-query lang sa index ang mga tool ng Maguyva. Walang nag-e-edit ng mga file mo, kaya bawat approval ay tungkol sa pagbasa, hindi sa pagsulat. > Binibigay ng VS Code sa agent ang *workspace mo*. > Binibigay ng Maguyva sa agent ang *mapa ng repo*. ## Dalawang workflow Tanungin muna ang mapa, saka mag-edit. ### 01. Hanapin ang mga test bago baguhin ang parser ```text vscode agent> aling mga test ang dumadaan sa parseConfig? dependency_search("parseConfig", dependents) tests/config/parse.test.ts:12 tests/cli/flags.test.ts:88 → Pagkatapos mag-edit, ang dalawang file na ito ang pinapatakbo ng agent, hindi ang buong suite. [exit 0] ``` Pinapangalanan ng sagot ang dalawang test file na umaabot sa parser, kaya sinusuri ng agent ang pagbabago kung saan ito puwedeng masira. ### 02. Sukatin ang rename bago ang unang edit ```text vscode agent> i-rename ang OrderStatus.PENDING sa OrderStatus.QUEUED find_symbol("OrderStatus", references) 23 reference sa 9 na file → Nagpaplano ang agent ng isang pasada sa siyam na file. [exit 0] ``` Dumarating ang bilang ng reference bago ang edit, hindi pagkatapos pumalya ang type checker. ## Setup sa VS Code 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 .vscode/mcp.json `.vscode/mcp.json` ```json { "servers": { "maguyva": { "type": "http", "url": "https://maguyva.tools/mcp", "headers": { "Authorization": "Bearer ${env:MAGUYVA_API_KEY}" } } } } ``` ### 03. I-set ang key mo at simulan ang server I-set ang `MAGUYVA_API_KEY` sa environment kung saan mo binubuksan ang VS Code, saka simulan ang server mula sa code lens sa itaas ng entry nito. Tanungin ang agent ng isang bagay na alam mo na ang sagot. Saklaw ng [MCP docs](https://code.visualstudio.com/docs/agent-customization/mcp-servers) ng VS Code ang input variables, ang portable na .mcp.json format, at ang server trust. ## I-index ang isang repo na kilala mo na. Ikonekta ang VS Code sa MCP, saka magtanong ng isang bagay na kaya mong i-check.