İç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 repoyu dizinleyin, 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 repoyu dizinleyin

#

Portaldan bir GitHub reposu bağlayın ve dizinlenmesine izin verin. Hızlıca doğrulayabileceğiniz küçük bir repo seçin — bu, ilk günden tüm şirketinizi dizinlemeye ç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/agent-plugins
/plugin install maguyva@maguyva

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

export MAGUYVA_API_KEY=mgv_xxxx

Takım halinde mi çalışıyorsunuz? /plugin install maguyva@maguyva komutunun açtığı panelde project kapsamını seçin. Bu, eklentiyi reponun .claude/settings.json dosyasına kaydeder ve bu dosyayı siz commit'lersiniz; her takım arkadaşı yine de kurulumu bir kez çalıştırır. Oturum içindeki /plugin komutlarının --scope bayrağı yoktur; bunu bir betikle yapmak için reponun kök dizininden shell biçimini çalıştırın:

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

Diğer istemcilerin çoğu (Cursor, VS Code, Devin Desktop, 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 ${env:MAGUYVA_API_KEY}"
      }
    }
  }
}

Yapı, istemciye göre hafifçe değişir (VS Code, type: "http" ile servers altında iç içe yerleşir; Antigravity serverUrl kullanır; Zed context_servers kullanır). Bu Cursor örneği anahtarınızı yukarıda gösterilen MAGUYVA_API_KEY ortam değişkeninden okur; bir istemcinin yapılandırmasında bunun yerine mgv_xxxx yer tutucusu görünüyorsa, onu API anahtarınızla değiştirin. Ardından istemcinizi yeniden başlatın. Belgelenen tüm 23 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 repoları bağladım?" ile başlayın, ardından yanıtını zaten bildiğiniz repoyla 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 repoyla 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 veya bağlantı hatası mı var? Sorun Giderme içinde API anahtarını, istemci yapılandırmasını ve repo dizinleme durumunu kontrol edin. Kurulum köprü kullanıyorsa npx komutunun da kullanılabilir olduğunu doğrulayın.

Sonraki adımlar

#

İlgili

Sıradaki okuma