Pro uživatele Claude Desktop

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

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.

Začít zdarma Přečtěte si nastavení pro Claude Desktop

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

Checkout není potřeba. Zeptejte se indexu.

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

Čtyři fakta specifická pro Claude Desktop.

// konfigurační soubor

claude_desktop_config.json

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

// transport

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.

// klíč

Záznam env

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

// restart

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.

// workflow 01

Vysvětlete cestu kódem při review

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.

// workflow 02

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

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.

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

claude_desktop_config.json

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

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