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

Canonical source: https://maguyva.ai/cs/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).

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

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

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

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

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

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

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

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

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

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

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

### 01. Indexujte repozitář na maguyva.ai

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

### 02. Přidejte Maguyva do .vscode/mcp.json

`.vscode/mcp.json`

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

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

[Dokumentace MCP](https://code.visualstudio.com/docs/agent-customization/mcp-servers) pro VS Code popisuje vstupní proměnné, přenositelný formát .mcp.json a důvěru k serverům.

## Indexujte jeden repozitář, který už znáte.

Připojte VS Code přes MCP a položte otázku, kterou si můžete ověřit.