# Warp ajanı terminalde yaşar. Ona reponun haritasını verin.

Canonical source: https://maguyva.ai/tr/for-warp

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

Warp ajanı komutlar çalıştırır ve çıktılarını okur. Maguyva tüm repoyu dizinler ve MCP üzerinden sunar; böylece ajan bir şey eşleşene kadar grep ve cat çalıştırmak yerine kodun nerede olduğunu sorar.

> ~/.warp/.mcp.json içinde tek bir mcpServers girdisi: bir URL ve bir Authorization başlığı.

## Warp hakkında bilmeniz gerekenler

Warp’a özgü dört bilgi.

### ~/.warp/.mcp.json

Warp bu global dosyadaki sunucuları kendisi başlatır. Aynı JSON’u Settings → Agents → MCP servers → + Add alanına da yapıştırabilirsiniz.

### URL ile uzak bağlantı

Bir `url` girdisi Streamable HTTP veya SSE ile bağlanır. Yerelde hiçbir şey çalışmaz ve Node.js gerekmez.

### Olduğu gibi bir başlık

Anahtar doğrudan `Authorization` başlığına girer. Onu commit ettiğiniz proje `.warp/.mcp.json` dosyasında değil, global dosyada tutun.

### Asla kendiliğinden başlamaz

Warp klonlanmış bir repoda `.warp/.mcp.json` dosyasını algılar, ancak her sunucuyu sizin başlatmanızı bekler. Bu özelliği açtığınızda Claude Code ve Codex yapılandırmalarındaki sunucuları da okuyabilir.

## Proje kuralları bir çalışma sözleşmesidir. Kullanın.

```text
# AGENTS.md
- Bir değişikliği bitti saymadan önce make test çalıştır.
- Geçici komutlar değil, bin/ içindeki betikleri kullan.
```

Warp proje kurallarını `AGENTS.md` dosyasından (ya da ikisi de varsa öncelikli olan `WARP.md` dosyasından) okur ve Global Rules’u her yerde uygular. Şunlar için kullanın:

- Derleme, test ve dağıtım komutları.
- Ajanın sürekli yanlış yaptığı kurallar.
- Ajanın asla çalıştırmaması gereken komutlar.

Kurallar ajana nasıl çalışacağını söyler. Kaldırmak üzere olduğunuz ortam değişkenini hangi servisin hâlâ okuduğunu söyleyemez.

## Terminalde grep’in yetmediği yer

Bir kabuk oturumunun ucuza öğrenemeyeceği üç şey.

### // çıktı akıp gider

Ajanın çalıştırdığı her grep ve cat konuşmaya düşer. İki yüz satır basan bir arama, asıl iş başlamadan bağlamı harcar.

### // eşleşme çağıran değildir

grep gerçek bir çağrıyı bir yorumdan, bir fixture’dan ya da başka bir sınıftaki aynı adlı metottan ayıramaz.

### // kabuk soğuk başlar

Yeni bir oturum repo hakkında hiçbir şey bilmez. Maguyva dizini zaten hazırdır; böylece ilk soru sıralı bir yanıt alır.

## Warp MCP sunucusu olarak Maguyva

Tek bir mcpServers girdisi Warp ajanına şunları verir:

- **Dizinlenmiş reponuz üzerinde 11 araç**: anlamsal, yapısal (AST), graf ve metin araması; ayrıca sembol arama, bağımlılar ve dosya alma.
- **Dosya yolları ve satır numaralarıyla yanıtlar**: 285+ dilde; bir terminal bölmesinde okunacak kadar kısa.
- **Yalnızca okuyan araçlar**: Maguyva araçları dizini sorgular. Hiçbiri dosya düzenlemez veya komut çalıştırmaz.

> Warp ajana *bir terminal* verir.
> Maguyva ajana *kodun haritasını* verir.

## İki iş akışı

Önce haritaya sorun, sonra komut çalıştırın.

### 01. Başarısız bir betiği kaynağına kadar izleyin

```text
warp agent> deploy.sh hata veriyor: BUILD_ID ayarlı değil. nerede ayarlanıyor?

text_pattern_search("BUILD_ID=")
  ci/env.sh:9   export BUILD_ID=...
  docs/deploy.md:31   ← metin

→ Ajan ci/env.sh dosyasını yükler ve dağıtımı yeniden çalıştırır.
[exit 0]
```

Tek bir dizinlenmiş arama, repo genelindeki özyinelemeli bir grep’in ve çıktısının yerini alır.

### 02. Bir başlatma adımını değiştirmeden önce çağıranları kontrol edin

```text
warp agent> migration’ları açılışta çalıştırmayı bırakabilir miyiz?

dependency_search("runMigrations", dependents)
  3 çağıran: server.ts, worker.ts, scripts/seed.ts

→ Ajan üçünü de sürüm adımına taşır.
[exit 0]
```

Çağıranlar değişiklikten önce gelir; böylece worker eski bir şemaya karşı açılmaz.

## Warp’ta kurulum

Üç adım. Free katmanı: 3 repo, 50K'ya kadar indekslenmiş repo satırı, kart gerektirmez.

### 01. maguyva.ai’de bir repo dizinleyin

Yanıtları değerlendirebilmek için zaten bildiğiniz birini seçin.

### 02. Maguyva’yı ~/.warp/.mcp.json dosyasına ekleyin

`~/.warp/.mcp.json`

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

### 03. Yer tutucuyu değiştirin ve bir soru sorun

`mgv_xxxx` değerini API anahtarınızla değiştirip kaydedin. Settings → Agents → MCP servers altında sunucunun çalıştığını kontrol edin, ardından yanıtını zaten bildiğiniz bir soru sorun.

Warp’ın [MCP belgeleri](https://docs.warp.dev/agents/capabilities/mcp/) dosya tabanlı sunucuları, paylaşımı ve kimlik doğrulamayı anlatır.

## Zaten bildiğiniz bir reponuzu dizinleyin.

Warp’ı MCP üzerinden bağlayın, ardından doğrulayabileceğiniz bir soru sorun.