Warp kullanıcıları için

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

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.

Ücretsiz başlayın Warp kurulumunu okuyun

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

~/.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.

// yapılandırma dosyası

~/.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.

// taşıma

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.

// anahtar

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.

// proje dosyaları

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.

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

// workflow 01

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

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.

// workflow 02

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

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.

// step 01

maguyva.ai’de bir repo dizinleyin

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

// step 02

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

~/.warp/.mcp.json

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

// step 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.