Para sa mga user ng VS Code

Nakikita ng Copilot ang workspace mo. Minamapa ng Maguyva ang repo.

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.

Magsimula nang libre Basahin ang setup sa VS Code

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

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.

// config file nito

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

// ang transport

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.

// ang key

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.

// trust

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.

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

// workflow 01

Hanapin ang mga test bago baguhin ang parser

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.

// workflow 02

Sukatin ang rename bago ang unang edit

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.

// 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 .vscode/mcp.json

.vscode/mcp.json

{
  "servers": {
    "maguyva": {
      "type": "http",
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer ${env:MAGUYVA_API_KEY}"
      }
    }
  }
}

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