# Kurulum Kılavuzu

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

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).

5 dakikadan kısa sürede kurulumu tamamlayın. Bu kılavuz, Claude Code, Claude Desktop, Cursor, VS Code, Devin Desktop, Codex CLI, GitHub Copilot CLI, Gemini CLI, Cline, Goose, Continue, LM Studio, Kiro CLI, JetBrains, Zed, Trae, OpenCode, BoltAI, LibreChat, Antigravity, Claude Cowork, ChatGPT ve Warp dahil 23 MCP istemcisi ve daha fazlası için kurulum içerir.

**Ön koşullar**: [app.maguyva.ai](https://app.maguyva.ai) üzerinden bir API anahtarına ve bağlı bir GitHub reposuna ihtiyacınız olacak.

## Ortam Kurulumu

Önce API anahtarınızı bir ortam değişkenine ayarlayın. MCP istemciniz bir istek varsayılanı sağladığında veya anahtar tam olarak bir repoya erişebildiğinde `repository` öğesini atlayın; aksi halde açıkça iletin.

### macOS/Linux (Bash/Zsh)

```bash
export MAGUYVA_API_KEY="mgv_xxxx"
```

### Windows (PowerShell)

```powershell
'$Env:MAGUYVA_API_KEY="mgv_xxxx"' | Out-File -Append $PROFILE
. $PROFILE
```

`mgv_xxxx` ifadesini [app.maguyva.ai](https://app.maguyva.ai) üzerinden aldığınız gerçek API anahtarınızla değiştirin.

## İstemci Yapılandırması

Belirli kurulum talimatları için aşağıdan MCP istemcinizi seçin.

```json
{
  "mcpServers": {
    "maguyva": {
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer ${env:MAGUYVA_API_KEY}"
      }
    }
  }
}
```

Maguyva standart MCP kullanır. Protokolü destekleyen herhangi bir istemci bağlanabilir — yukarıda birinci taraf bir kılavuz olmasa bile. 23 istemci belgelenmiştir, düzenli olarak yenileri eklenir.

## Kurulumunuzu Doğrulayın

Bağlandıktan sonra, ajanınıza birkaç soru sormayı deneyin:

- "Hangi repoları bağladım?" — bağlantının çalıştığını doğrular
- "Bu kod tabanında kimlik doğrulama nasıl işleniyor?" — semantik aramayı test eder
- "Veritabanını çağıran tüm işlevleri bul" — bağımlılık aramasını test eder
- "UserService sınıfı neye bağımlı?" — sembol bulmayı test eder

Bağlı reponuzdan dosya yolları ve satır numaraları içeren sonuçlar görmelisiniz. Görmüyorsanız, aşağıdaki [troubleshooting](https://maguyva.ai/tr/docs/troubleshooting) bölümünü kontrol edin.

## Repo Biçimi

Repoları belirtirken:

- Dal ile: `"owner/repo:branch"` (e.g. `"owner/repository:develop"`)
- Varsayılan dal: `"owner/repo"`

**İpucu**: Repo çözümlemesini kontrol etmek için `repository_context(action="info", repository="...")` kullanın. Repoyu geçersiz kılan açık seçim yalnızca mevcut çağrı için geçerlidir.

## Sorun Giderme

### API Anahtarı Sorunları

- Anahtarınızın mgv_ öneki ile başladığını doğrulayın
- Anahtarın ortamınızda doğru şekilde ayarlandığını kontrol edin
- Anahtarın süresinin dolmadığından emin olun

### Repo Bulunamadı

- Reponun app.maguyva.ai üzerinde bağlı olduğunu doğrulayın
- owner/repo biçiminin doğru olduğunu kontrol edin
- Repoya erişiminiz olduğundan emin olun

### MCP Bağlantı Sorunları

- İstemciniz @maguyva/mcp köprüsünü kullanıyorsa npx komutunun PATH içinde kullanılabilir olduğunu doğrulayın
- API tokeninizin geçerli ve süresi dolmamış olduğunu kontrol edin
- https://maguyva.tools/mcp adresine bağlantıyı test edin
- İstemcinizin MCP yapılandırma sözdizimini kontrol edin

## Sonraki Adımlar

- MCP API Referansı: Eksiksiz API belgeleri
- Nasıl Çalışır: Bağlam optimizasyonunu anlayın
- Sorun Giderme: Kurulum ve bağlantı sorunlarını giderin