# Claude Desktop váš repozitář nevidí. Ukažte mu ho.

Canonical source: https://maguyva.ai/cs/for-claude-desktop

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

V Claude Desktop se spousta lidí ptá na kód, který zrovna neupravuje: při review, onboardingu nebo callech k incidentům. Maguyva indexuje repozitář a poskytuje ho přes MCP, takže odpovědi citují soubory a řádky místo vzpomínek.

> Checkout není potřeba. Zeptejte se indexu.

## Co potřebujete vědět o Claude Desktop

Čtyři fakta specifická pro Claude Desktop.

### claude_desktop_config.json

Otevře ho Settings → Developer → Edit Config. V macOS leží v `~/Library/Application Support/Claude/`, ve Windows v `%APPDATA%\Claude\`.

### Lokální most

Tento soubor spouští lokální procesy, takže návod spouští `@maguyva/mcp` přes `npx`. Potřebujete nainstalovaný Node.js.

### Záznam env

Most čte `MAGUYVA_API_KEY` z bloku `env` serveru ve stejném souboru.

### Ukončete a znovu otevřete

Claude Desktop čte soubor při spuštění. Po úpravě aplikaci úplně ukončete; server se spustí při dalším startu.

## Pokyny projektu určují zadání. Používejte je.

Projects v Claude uchovávají pokyny a soubory, se kterými začíná každý chat v projektu. Jsou to správné místo pro:

- Pro koho jsou odpovědi: reviewer, nový člen týmu, inženýr na pohotovosti.
- Firemní styl vysvětlení a shrnutí.
- Pár dokumentů, které chcete citovat, třeba přehled architektury.

Nahrané soubory jsou snímek. Den po nahrání je repozitář už jinde.

## Kde vložený kód přestává stačit

Tři způsoby, jak se rozhovor o kódu bez kódu pokazí.

### // vložené úryvky stárnou

Soubor vložený do chatu minulý týden popisuje kód z minulého týdne. Claude sebejistě odpovídá podle verze, kterou dostal.

### // úryvek není systém

Jeden soubor jen zřídka odpoví na “co se stane, když tohle selže?” Handler, retry a alert obvykle žijí ve třech různých balíčcích.

### // bez checkoutu není grep

Claude Desktop nemá pracovní kopii vašeho repozitáře. Bez nástroje závisí každá odpověď o struktuře na tom, co jste si vzpomněli vložit.

## Maguyva jako MCP server v Claude Desktop

Jeden záznam v mcpServers dá Claude:

- **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, abyste mohli ověřit každé tvrzení.
- **Výsledky, které zohledňují větev**: aby Claude odpovídal o větvi, kterou určíte, a ne o souboru, který někdo nahrál minulý měsíc.

> Pokyny projektu říkají Claude, *jak odpovídat*.
> Maguyva dává Claude *kód, o který se může opřít*.

## Dva pracovní postupy

Otázky, kvůli kterým byste jinak otevírali IDE.

### 01. Vysvětlete cestu kódem při review

```text
claude> co se stane, když platební webhook neprojde kontrolou podpisu?

semantic_search("webhook signature verification failure")
  src/payments/webhooks.ts:64   verifySignature()
  src/payments/webhooks.ts:91   rejectAndAlert()

→ Claude odpoví a ocituje oba řádky.
[exit 0]
```

Každý krok odpovědi ukazuje na soubor a řádek, které můžete otevřít.

### 02. Odhadněte rozsah změny dřív, než ji naplánujete

```text
claude> kolik míst čte staré pole plan_code?

text_pattern_search("plan_code")
  14 shod v 9 souborech
dependency_search("getPlanCode", dependents)
  6 volajících

→ Odhad začíná u čísla, ne u dohadu.
[exit 0]
```

Hodí se na plánovací schůzce, když nikdo nemá repozitář otevřený.

## Nastavení v Claude Desktop

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

`claude_desktop_config.json`

```json
{
  "mcpServers": {
    "maguyva": {
      "command": "npx",
      "args": [
        "-y",
        "@maguyva/mcp"
      ],
      "env": {
        "MAGUYVA_API_KEY": "mgv_xxxx"
      }
    }
  }
}
```

### 03. Nahraďte zástupný text, restartujte a položte jednu otázku

Nahraďte `mgv_xxxx` svým API klíčem, Claude Desktop úplně ukončete a znovu otevřete. Pokud se server neobjeví, podívejte se do `mcp-server-maguyva.log` ve složce s logy Claude (`~/Library/Logs/Claude` v macOS).

[Průvodce MCP k lokálním serverům](https://modelcontextprotocol.io/docs/develop/connect-local-servers) podrobněji popisuje konfigurační soubor a jeho logy.

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

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