# Przewodnik instalacji

Canonical source: https://maguyva.ai/pl/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).

Uruchom wszystko w mniej niż 5 minut. Ten przewodnik obejmuje konfigurację dla 23 klientów MCP, w tym 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 i Warp i innych.

**Wymagania wstępne**: Potrzebujesz klucza API z [app.maguyva.ai](https://app.maguyva.ai) oraz połączonego repozytorium GitHub.

## Konfiguracja środowiska

Najpierw ustaw klucz API w zmiennej środowiskowej. Pomiń `repository`, gdy Twój klient MCP dostarcza domyślne ustawienie dla żądania lub gdy klucz ma dostęp dokładnie do jednego repozytorium; w przeciwnym razie przekaż je jawnie.

### 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
```

Zastąp `mgv_xxxx` swoim rzeczywistym kluczem API z [app.maguyva.ai](https://app.maguyva.ai).

## Konfiguracja klienta

Wybierz poniżej swojego klienta MCP, aby zobaczyć szczegółowe instrukcje konfiguracji.

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

Maguyva korzysta ze standardowego MCP. Może się połączyć każdy klient obsługujący ten protokół — nawet jeśli powyżej nie ma dla niego oficjalnego przewodnika. Udokumentowano 23 klientów, a kolejne są regularnie dodawane.

## Zweryfikuj swoją konfigurację

Po połączeniu spróbuj zadać swojemu agentowi kilka pytań:

- "Jakie repozytoria mam połączone?" — sprawdza, czy połączenie działa
- "Jak obsługiwane jest uwierzytelnianie w tym kodzie?" — testuje wyszukiwanie semantyczne
- "Znajdź wszystkie funkcje, które wywołują bazę danych" — testuje wyszukiwanie zależności
- "Od czego zależy klasa UserService?" — testuje wyszukiwanie symboli

Powinieneś zobaczyć wyniki ze ścieżkami plików i numerami linii z połączonego repozytorium. Jeśli nie, sprawdź [troubleshooting](https://maguyva.ai/pl/docs/troubleshooting) poniżej.

## Format repozytorium

Przy określaniu repozytoriów:

- Z gałęzią: `"owner/repo:branch"` (e.g. `"owner/repository:develop"`)
- Domyślna gałąź: `"owner/repo"`

**Wskazówka**: sprawdź rozpoznawanie repozytorium za pomocą `repository_context(action="info", repository="...")`. Nadpisanie repozytorium dotyczy tylko bieżącego wywołania.

## Rozwiązywanie problemów

### Problemy z kluczem API

- Sprawdź, czy klucz zaczyna się od przedrostka mgv_
- Sprawdź, czy klucz jest poprawnie ustawiony w Twoim środowisku
- Upewnij się, że klucz nie wygasł

### Nie znaleziono repozytorium

- Sprawdź, czy repozytorium jest połączone w app.maguyva.ai
- Sprawdź, czy format owner/repo jest poprawny
- Upewnij się, że masz dostęp do repozytorium

### Problemy z połączeniem MCP

- Jeśli klient używa mostu @maguyva/mcp, sprawdź, czy npx jest dostępne w PATH
- Sprawdź, czy Twój token API jest ważny i nie wygasł
- Przetestuj połączenie z https://maguyva.tools/mcp
- Sprawdź składnię konfiguracji MCP Twojego klienta

## Kolejne kroki

- Dokumentacja API MCP: Pełna dokumentacja API
- Jak to działa: Zrozum optymalizację kontekstu
- Rozwiązywanie problemów: Napraw problemy z konfiguracją i połączeniem