# Rychlý start

Canonical source: https://maguyva.ai/cs/docs/quickstart

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

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](https://app.maguyva.ai) — bez nutnosti kreditní karty. Váš API klíč (začíná na `mgv_`) najdete v [app.maguyva.ai](https://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:

```text
/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ář):

```bash
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:

```bash
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`:

```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](https://maguyva.ai/cs/docs/installation).

## 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ů](https://maguyva.ai/cs/docs/troubleshooting). Pokud používáte můstek, ověřte také dostupnost `npx`.

## Další kroky

- Instalační příručka: konfigurace pro každého klienta ze všech 23 zdokumentovaných klientů
- Jak to funguje: co se stane mezi vaší otázkou a odpovědí
- Referenční příručka MCP API: každý nástroj, parametr po parametru