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/agent-plugins
/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? Zvolte rozsah project v panelu, který otevře /plugin install maguyva@maguyva. Plugin se tím zapíše do souboru .claude/settings.json v repozitáři, který commitnete; každý člen týmu přesto jednou spustí instalaci. Příkazy /plugin v relaci nemají příznak --scope, takže pro skriptování spusťte shellovou podobu z kořene repozitáře:

claude plugin marketplace add maguyva/agent-plugins --scope project
claude plugin install maguyva@maguyva --scope project

Většina ostatních klientů (Cursor, VS Code, Devin Desktop, 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 ${env:MAGUYVA_API_KEY}"
      }
    }
  }
}

Tvar konfigurace se u jednotlivých klientů mírně liší (VS Code ji vnořuje pod servers s type: "http", Antigravity používá serverUrl, Zed používá context_servers). Tento příklad pro Cursor čte klíč z proměnné prostředí MAGUYVA_API_KEY uvedené výše; pokud konfigurace klienta místo toho obsahuje zástupný text mgv_xxxx, nahraďte ho svým API klíčem. Pak restartujte klienta. Přesnou konfiguraci pro všech 23 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í? Zkontrolujte klíč API, konfiguraci klienta a stav indexování repozitáře v Řešení problémů. Pokud používáte můstek, ověřte také dostupnost npx.

Další kroky

#

Související

Čtěte dál