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/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):

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:

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:

.cursor/mcp.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”.

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”. Jeśli konfiguracja używa mostu, sprawdź też dostępność npx.

Kolejne kroki

#