Pro uživatele VS Code

Copilot vidí váš workspace. Maguyva mapuje repo.

Agent ve VS Code čte soubory, které přiložíte, a ty, které sám najde. Maguyva indexuje celé repo a servíruje ho přes MCP, takže se agent před úpravou zeptá, kde symbol leží a kdo ho volá.

Začít zdarma Přečtěte si nastavení pro VS Code

Free tarif: 3 repozitáře, Až 50K zaindexovaných řádků repa, bez kreditní karty.

Jedna položka servers v .vscode/mcp.json: URL a hlavička Authorization.

Co potřebujete vědět o VS Code

Čtyři fakta specifická pro VS Code.

// konfigurační soubor

.vscode/mcp.json

Servery patří pod servers, ne pod mcpServers. Pro všechny workspace spusťte MCP: Open User Configuration a přidejte stejnou položku do mcp.json svého profilu.

// transport

type: http

VS Code se k endpointu Maguyva připojuje přes Streamable HTTP a na SSE přejde jen tehdy, když ho server nepodporuje. Lokálně neběží nic.

// klíč

Odkaz na proměnnou prostředí

Hlavička zní Bearer ${env:MAGUYVA_API_KEY}; VS Code hodnotu vezme z prostředí, ve kterém bylo spuštěno, takže klíč nezůstane v souboru, který commitujete. Chcete se raději ptát? Vstupní proměnná se zeptá jednou a klíč si uloží.

// důvěra

Workspace Trust

Servery v .vscode/mcp.json se spustí bez zvláštního dotazu, jakmile workspace důvěřujete, a v omezeném režimu nikdy. Configure Tools ve vstupu chatu zapíná a vypíná jednotlivé nástroje.

Vlastní instrukce jsou dohoda o spolupráci. Používejte je.

# .github/copilot-instructions.md
- Než prohlásíš změnu za hotovou, spusť npm test.
- Nikdy neupravuj generované soubory v src/gen/.

VS Code čte pokyny pro celý projekt z .github/copilot-instructions.md nebo AGENTS.md a cílené pokyny ze souborů .github/instructions/*.instructions.md se vzorem applyTo. Používejte je pro:

Příkazy pro build, testy a lint.
Konvence, které agent pořád plete.
Složky, na které agent nemá sahat.

Pokyny říkají agentovi, jak pracovat. Neřeknou mu, které ze čtyř tisíc souborů importují typ, který se chystá přejmenovat.

Kde končí pohled na workspace

Tři věci, které se agent z otevřených souborů nedozví.

// přiložené není všechno

Agent pracuje s tím, co přiložíte, a s tím, co vrátí jeho hledání. Volající v jiném balíčku, který se po změně rozbije, nebyl na žádném z těch seznamů.

// shoda textu není reference

Hledání ve workspace najde řetězec. Neodliší skutečné volání od komentáře, mocku ani stejnojmenné metody jiné třídy.

// každé čtení stojí kontext

Každý soubor, který agent otevře kvůli orientaci, ukrojí kontext potřebný pro změnu. Jedna seřazená odpověď s file:line stojí méně než deset průzkumných čtení.

Maguyva jako MCP server ve VS Code

Jedna položka servers dá agentovi:

11 nástrojů nad vaším indexovaným repozitářem sémantické, strukturální (AST), grafové a textové vyhledávání, plus vyhledávání symbolů, závislé a načítání souborů.
Odpovědi s cestami k souborům a čísly řádků napříč 285+ jazyky, aby agent hned otevřel ten správný soubor.
Nástroje, které jen čtou Nástroje Maguyva jen dotazují index. Žádný neupravuje vaše soubory, takže každé schválení se týká čtení, ne zápisu.

VS Code dává agentovi váš workspace.
Maguyva dává agentovi mapu repa.

Dva pracovní postupy

Nejdřív se zeptejte mapy, pak upravujte.

// workflow 01

Najděte testy dřív, než změníte parser

vscode agent> které testy procházejí přes parseConfig?

dependency_search("parseConfig", dependents)
  tests/config/parse.test.ts:12
  tests/cli/flags.test.ts:88

→ Po úpravě agent spustí tyto dva soubory, ne celou sadu.
[exit 0]

Odpověď jmenuje dva testovací soubory, které se k parseru dostanou, takže agent ověří změnu tam, kde se může rozbít.

// workflow 02

Odhadněte přejmenování před první úpravou

vscode agent> přejmenuj OrderStatus.PENDING na OrderStatus.QUEUED

find_symbol("OrderStatus", references)
  23 referencí v 9 souborech

→ Agent naplánuje jeden průchod devíti soubory.
[exit 0]

Počet referencí dorazí před úpravou, ne až poté, co selže kontrola typů.

Nastavení ve VS Code

Tři kroky. Free tarif: 3 repozitáře, Až 50K zaindexovaných řádků repa, bez kreditní karty.

// step 01

Indexujte repozitář na maguyva.ai

Vyberte si takový, který už znáte, abyste mohli posoudit odpovědi.

// step 02

Přidejte Maguyva do .vscode/mcp.json

.vscode/mcp.json

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

// step 03

Nastavte klíč a spusťte server

Nastavte MAGUYVA_API_KEY v prostředí, ze kterého spouštíte VS Code, a server spusťte přes code lens nad jeho položkou. Položte agentovi otázku, na kterou už znáte odpověď.