İçeriğe atla

Hızlı Başlangıç

Sıfırdan doğrulanmış bir yanıta giden en hızlı yol: bir anahtar alın, zaten bildiğiniz bir depoyu indeksleyin, istemcinizi bağlayın ve zaten değerlendirebileceğiniz bir soru sorun.

1. Bir API anahtarı alın#

Ücretsiz başlayın — kredi kartı gerekmez. API anahtarınız (mgv_ ile başlar) app.maguyva.ai içinde bulunur.

2. Zaten bildiğiniz bir depoyu indeksleyin#

Portaldan bir GitHub deposu bağlayın ve indekslenmesine izin verin. Hızlıca doğrulayabileceğiniz küçük bir depo seçin — bu, ilk günden tüm şirketinizi indekslemeye çalışmak yerine, Maguyva'nın modeli gerçekten temellendirip temellendirmediğini net şekilde gösterir.

3. İstemcinizi bağlayın#

Claude Code için, Maguyva eklentisini mağazadan yükleyin — her komutu Claude Code içinde çalıştırın:

/plugin marketplace add maguyva/claude-code-plugin
/plugin install maguyva@maguyva

Eklenti, MAGUYVA_API_KEY ortam değişkenindeki anahtarınızla kimlik doğrular. Bunu kabuğunuzda ayarlayın (anahtarlar depo kapsamlı olduğundan proje başına direnv önerilir):

export MAGUYVA_API_KEY=mgv_xxxx

Bir ekiple mi çalışıyorsunuz? Eklentiyi deponun .claude/settings.json dosyasına işlemek için her iki /plugin komutuna da --scope project ekleyin, böylece takım arkadaşlarınız otomatik olarak alır.

Diğer istemcilerin çoğu (Cursor, VS Code, Windsurf, Zed ve benzerleri) doğrudan uzak sunucuya bağlanır — bir köprüye gerek kalmadan, Bearer başlığıyla uç noktayı gösterin. Örneğin, Cursor'ın .cursor/mcp.json dosyası:

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

Yapı, istemciye göre hafifçe değişir (VS Code, type: "http" ile servers altında iç içe yerleşir; Windsurf serverUrl kullanır; Zed context_servers kullanır). mgv_xxxx ifadesini API anahtarınızla değiştirin, ardından istemcinizi yeniden başlatın. Belgelenen tüm 24 istemci için tam yapılandırma Kurulum Kılavuzu içinde yer alır.

4. Zaten değerlendirebileceğiniz bir soru sorun#

Bağlantıyı doğrulamak için "Hangi depoları bağladım?" ile başlayın, ardından yanıtını zaten bildiğiniz depoyla ilgili gerçek bir soru sorun — "Bu kod tabanında kimlik doğrulama nasıl işleniyor?" gibi bir şey

Dosya yollarını ve satır numaralarını içeren yanıtlar almalısınız. Referans verilen dosyaları açın ve yanıtın gerçek depoyla karşılaştığında geçerli kalıp kalmadığını kontrol edin. Bu tek değerlendirilmiş yanıt, herhangi bir özellik listesinden daha fazlasını anlatır — aracın, varsayılan iş akışınıza katılmadan önce güveni kazanmasını sağlayın.

Sonuç yok mu, yoksa bağlantı hataları mı? Sorun Giderme sayfasına gidin — çoğu hata; ayarlanmamış bir API anahtarı, eksik bir npx veya indekslemesi henüz tamamlanmamış bir depodan kaynaklanır.

Sonraki adımlar#