Přeskočit na obsah

Rychlý start

Nejrychlejší cesta od nuly k ověřené odpovědi: získejte klíč, indexujte jeden repozitář, který už znáte, připojte svého klienta a položte jednu otázku, kterou už dokážete sami ohodnotit.

1. Získejte API klíč#

Začít zdarma — bez nutnosti kreditní karty. Váš API klíč (začíná na mgv_) najdete v app.maguyva.ai.

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

Připojte repozitář GitHub z portálu a nechte ho zaindexovat. Vyberte malý repozitář, který dokážete rychle ověřit — hned uvidíte, jestli Maguyva model skutečně podkládá reálným kódem, místo abyste se hned první den snažili indexovat celou firmu.

3. Připojte svého klienta#

Pro Claude Code nainstalujte plugin Maguyva z marketplace — každý příkaz spusťte uvnitř Claude Code:

/plugin marketplace add maguyva/claude-code-plugin
/plugin install maguyva@maguyva

Plugin se autentizuje pomocí vašeho klíče z proměnné prostředí MAGUYVA_API_KEY. Nastavte ji ve svém shellu (doporučujeme direnv pro jednotlivé projekty, protože klíče jsou vázané na repozitář):

export MAGUYVA_API_KEY=mgv_xxxx

Pracujete v týmu? Přidejte --scope project k oběma příkazům /plugin, aby se plugin zapsal do .claude/settings.json repozitáře a týmoví kolegové ho dostali automaticky.

Většina ostatních klientů (Cursor, VS Code, Windsurf, Zed a další) se připojuje přímo ke vzdálenému serveru — nasměrujte je na endpoint s hlavičkou Bearer, bez nutnosti mostu (bridge). Například u Cursoru soubor .cursor/mcp.json:

.cursor/mcp.json
{
  "mcpServers": {
    "maguyva": {
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer mgv_xxxx"
      }
    }
  }
}

Tvar konfigurace se u jednotlivých klientů mírně liší (VS Code ji vnořuje pod servers s type: "http", Windsurf používá serverUrl, Zed používá context_servers). Nahraďte mgv_xxxx svým API klíčem a restartujte klienta. Přesnou konfiguraci pro všech 24 zdokumentovaných klientů najdete v Instalační příručka.

4. Položte jednu otázku, kterou už dokážete ohodnotit#

Začněte otázkou "Jaké repozitáře mám připojené?", abyste potvrdili připojení, a pak položte jednu skutečnou otázku o svém repozitáři, jejíž odpověď už znáte — třeba "Jak je v tomhle kódu řešená autentizace?"

Měli byste dostat odpovědi s cestami k souborům a čísly řádků. Otevřete citované soubory a ověřte, že odpověď obstojí ve srovnání se skutečným repozitářem. Tahle jedna ohodnocená odpověď vám řekne víc než jakýkoli seznam funkcí — ať si nástroj důvěru zaslouží, než se stane součástí vašeho běžného postupu.

Žádné výsledky nebo chyby připojení? Přejděte na Řešení problémů — většina selhání je způsobena nenastaveným API klíčem, chybějícím npx nebo repozitářem, který ještě nedokončil indexaci.

Další kroky#