# Hızlı Başlangıç

Canonical source: https://maguyva.ai/tr/docs/quickstart

License: text under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/); code samples under [MIT-0](https://opensource.org/license/mit-0); the Maguyva name, logos, brand assets and other code are not covered. Details: [maguyva.ai/license](https://maguyva.ai/license).

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](https://app.maguyva.ai) — kredi kartı gerekmez. API anahtarınız (`mgv_` ile başlar) [app.maguyva.ai](https://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:

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

```bash
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:

```bash
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ı:

```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](https://maguyva.ai/tr/docs/installation) 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](https://maguyva.ai/tr/docs/troubleshooting) 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

- Kurulum Kılavuzu: belgelenen tüm 23 istemci için istemci başına yapılandırma
- Nasıl Çalışır: sorunuz ile yanıt arasında neler olduğu
- MCP API Referansı: her araç, parametre parametre