# Průvodce instalací

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

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

Rozjeďte se za méně než 5 minut. Tento průvodce obsahuje nastavení pro 23 MCP klientů, včetně Claude Code, Claude Desktop, Cursor, VS Code, Devin Desktop, Codex CLI, GitHub Copilot CLI, Gemini CLI, Cline, Goose, Continue, LM Studio, Kiro CLI, JetBrains, Zed, Trae, OpenCode, BoltAI, LibreChat, Antigravity, Claude Cowork, ChatGPT, a Warp a dalších.

**Požadavky**: Budete potřebovat API klíč z [app.maguyva.ai](https://app.maguyva.ai) a připojený GitHub repozitář.

## Nastavení prostředí

Nejprve nastavte klíč API v proměnné prostředí. `repository` vynechte, pokud klient MCP poskytuje výchozí hodnotu pro daný požadavek nebo pokud má klíč přístup právě k jednomu repozitáři; jinak jej zadejte explicitně.

### macOS/Linux (Bash/Zsh)

```bash
export MAGUYVA_API_KEY="mgv_xxxx"
```

### Windows (PowerShell)

```powershell
'$Env:MAGUYVA_API_KEY="mgv_xxxx"' | Out-File -Append $PROFILE
. $PROFILE
```

Nahraďte `mgv_xxxx` svým skutečným API klíčem z [app.maguyva.ai](https://app.maguyva.ai).

## Konfigurace klienta

Níže vyberte svého MCP klienta pro konkrétní pokyny k nastavení.

```json
{
  "mcpServers": {
    "maguyva": {
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer ${env:MAGUYVA_API_KEY}"
      }
    }
  }
}
```

Maguyva používá standardní MCP. Připojit se může jakýkoliv klient podporující tento protokol — i když výše není žádný oficiální návod. 23 klientů zdokumentováno, další pravidelně přibývají.

## Ověřte své nastavení

Po připojení zkuste agentovi položit pár otázek:

- "Jaké repozitáře mám připojené?" — ověří, že připojení funguje
- "Jak je v této kódové základně řešená autentizace?" — otestuje sémantické vyhledávání
- "Najdi všechny funkce, které volají databázi" — otestuje vyhledávání závislostí
- "Na čem závisí třída UserService?" — otestuje vyhledávání symbolů

Měli byste vidět výsledky s cestami k souborům a čísly řádků z vašeho připojeného repozitáře. Pokud ne, podívejte se níže na [troubleshooting](https://maguyva.ai/cs/docs/troubleshooting).

## Formát repozitáře

Při zadávání repozitářů:

- S větví: `"owner/repo:branch"` (e.g. `"owner/repository:develop"`)
- Výchozí větev: `"owner/repo"`

**Tip**: pomocí `repository_context(action="info", repository="...")` zkontrolujte rozpoznání repozitáře. Přepsání výchozího repozitáře platí jen pro aktuální volání.

## Řešení problémů

### Problémy s API klíčem

- Ověřte, že váš klíč začíná prefixem mgv_
- Zkontrolujte, že je klíč správně nastaven ve vašem prostředí
- Ujistěte se, že klíči nevypršela platnost

### Repozitář nenalezen

- Ověřte, že je repozitář připojený v app.maguyva.ai
- Zkontrolujte, že formát owner/repo je správný
- Ujistěte se, že máte k repozitáři přístup

### Problémy s MCP připojením

- Pokud váš klient používá můstek @maguyva/mcp, ověřte, že je npx dostupné v PATH
- Zkontrolujte, že je váš API token platný a nevypršel
- Otestujte konektivitu na https://maguyva.tools/mcp
- Zkontrolujte syntaxi MCP konfigurace vašeho klienta

## Další kroky

- Referenční příručka MCP API: Kompletní dokumentace API
- Jak to funguje: Pochopte optimalizaci kontextu
- Řešení problémů: Vyřešte problémy s nastavením a připojením