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@maguyvaWtyczka 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_xxxxPracujesz 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 projectWię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:
{
"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
#- 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