# Szybki start

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

Najszybsza droga od zera do zweryfikowanej odpowiedzi: zdobądź klucz, zaindeksuj jedno repozytorium, które już znasz, połącz swojego klienta i zadaj jedno pytanie, które już potrafisz ocenić.

## 1. Zdobądź klucz API

[Zacznij za darmo](https://app.maguyva.ai) — bez karty kredytowej. Twój klucz API (zaczyna się od `mgv_`) znajdziesz w [app.maguyva.ai](https://app.maguyva.ai).

## 2. Zaindeksuj repozytorium, które już znasz

Połącz repozytorium GitHub z poziomu portalu i pozwól mu się zaindeksować. Wybierz małe repozytorium, które możesz szybko zweryfikować — dzięki temu od razu widać, czy Maguyva rzeczywiście ugruntowuje model, zamiast próbować zaindeksować całą firmę pierwszego dnia.

## 3. Połącz swojego klienta

Dla Claude Code zainstaluj wtyczkę Maguyva z rynku wtyczek — uruchom każde polecenie wewnątrz Claude Code:

```text
/plugin marketplace add maguyva/agent-plugins
/plugin install maguyva@maguyva
```

Wtyczka uwierzytelnia się kluczem ze zmiennej środowiskowej `MAGUYVA_API_KEY`. Ustaw ją w swojej powłoce (zalecane jest `direnv` per projekt, ponieważ klucze są przypisane do repozytorium):

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

Pracujesz w zespole? Wybierz zakres project w panelu, który otwiera `/plugin install maguyva@maguyva`. Plugin zostanie zapisany w pliku `.claude/settings.json` repozytorium, który zatwierdzasz; każdy współpracownik i tak uruchamia instalację raz. Komendy `/plugin` w sesji nie mają flagi `--scope`, więc aby to zautomatyzować, uruchom wersję powłoki z katalogu głównego repozytorium:

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

Większość pozostałych klientów (Cursor, VS Code, Devin Desktop, Zed i inne) łączy się bezpośrednio ze zdalnym serwerem — wystarczy wskazać im endpoint z nagłówkiem `Bearer`, bez żadnego mostka. Na przykład plik `.cursor/mcp.json` dla Cursor:

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

Struktura różni się nieznacznie w zależności od klienta (VS Code zagnieżdża pod `servers` z `type: "http"`, Antigravity używa `serverUrl`, Zed używa `context_servers`). Ten przykład dla Cursor odczytuje klucz ze zmiennej środowiskowej `MAGUYVA_API_KEY` pokazanej wyżej; jeśli konfiguracja klienta zawiera zamiast tego placeholder `mgv_xxxx`, zastąp go swoim kluczem API. Następnie zrestartuj klienta. Dokładną konfigurację dla wszystkich 23 udokumentowanych klientów znajdziesz w sekcji „[Przewodnik instalacji](https://maguyva.ai/pl/docs/installation)”.

## 4. Zadaj jedno pytanie, które już potrafisz ocenić

Zacznij od **"Jakie repozytoria mam połączone?"**, aby potwierdzić połączenie, a następnie zadaj jedno prawdziwe pytanie o swoje repozytorium, na które już znasz odpowiedź — na przykład **"Jak obsługiwane jest uwierzytelnianie w tym kodzie?"**

Powinieneś otrzymać odpowiedzi ze ścieżkami plików i numerami linii. Otwórz cytowane pliki i sprawdź, czy odpowiedź wytrzymuje konfrontację z rzeczywistym repozytorium. Ta jedna oceniona odpowiedź mówi więcej niż jakakolwiek lista funkcji — niech narzędzie zapracuje na zaufanie, zanim dołączy do Twojego domyślnego przepływu pracy.

Brak wyników lub błędy połączenia? Sprawdź klucz API, konfigurację klienta i stan indeksowania repozytorium, korzystając z sekcji „[Rozwiązywanie problemów](https://maguyva.ai/pl/docs/troubleshooting)”. Jeśli konfiguracja używa mostu, sprawdź też dostępność `npx`.

## Kolejne kroki

- Przewodnik instalacji: konfiguracja dla każdego z 23 udokumentowanych klientów
- Jak to działa: co dzieje się między Twoim pytaniem a odpowiedzią
- Dokumentacja API MCP: każde narzędzie, parametr po parametrze