Przejdź do treści

Szybki start

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 — bez karty kredytowej. Twój klucz API (zaczyna się od mgv_) znajdziesz w 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:

/plugin marketplace add maguyva/claude-code-plugin
/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):

export MAGUYVA_API_KEY=mgv_xxxx

Pracujesz w zespole? Dodaj --scope project do obu poleceń /plugin, aby zapisać wtyczkę w .claude/settings.json repozytorium — wtedy zespół otrzyma ją automatycznie.

Większość pozostałych klientów (Cursor, VS Code, Windsurf, 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:

.cursor/mcp.json
{
  "mcpServers": {
    "maguyva": {
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer mgv_xxxx"
      }
    }
  }
}

Struktura różni się nieznacznie w zależności od klienta (VS Code zagnieżdża pod servers z type: "http", Windsurf używa serverUrl, Zed używa context_servers). Zastąp mgv_xxxx swoim kluczem API, a następnie zrestartuj klienta. Dokładna konfiguracja dla wszystkich 24 udokumentowanych klientów znajduje się w Przewodnik instalacji.

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 albo błędy połączenia? Zajrzyj do Rozwiązywanie problemów — większość awarii to nieustawiony klucz API, brakujące npx albo repozytorium, które jeszcze nie skończyło się indeksować.

Kolejne kroki#