Augment Context Engine MCP Nasıl Yüklenir ve Kullanılır

Yaklaşık 3 dakika

Augment Context Engine MCP Nasıl Yüklenir ve Kullanılır

Augment'ın Context Engine MCP'si, kurumsal düzeyde kod aramayı modern AI ajanlarına entegre eder. Model Context Protocol (MCP) sunucusu yerel olarak çalışmaya başladıktan sonra, Cursor, Claude Code, Zed veya GitHub Copilot gibi araçlar, asistanınızı gerçek proje ile bağlı tutmak için Augment'tan hassas kod alma isteğinde bulunabilir. Bu rehber, kurulum, yapılandırma ve günlük kullanımı adım adım anlatır, böylece özellikleri daha hızlı teslim etmeye başlayabilirsiniz.

Neden Augment Context Engine MCP Tercih Edilmeli?

Derin proje farkındalığı – Augment, çoklu depo arama dizini oluşturur, böylece "Stripe'ı nerede başlatıyoruz?" gibi sorgular doğru dosyaları anında döndürür.
MCP uyumluluğu – Herhangi bir MCP destekli istemci (Cursor, Claude Desktop, Gemini CLI vb.) aynı sunucuyu çağırabilir. Yeni eklentilere gerek yok.
Güvenli kimlik doğrulama akışı – Auggie CLI giriş oturumuna güvenebilir ya da AUGMENT_SESSION_AUTH aracılığıyla kapsamlı bir erişim token’ı enjekte edebilirsiniz.
Platformlar arası araçlar – macOS, Windows ve Linux üzerinde çalışır. Sunucu stdio üzerinden iletişim kurar, böylece editör bağımsızdır.

Gereksinimler

Node.js 18+ Auggie CLI’i (npm veya npx) yüklemek için.
Augment hesabı Context Engine erişimi ile. Augment adresinden kaydolun ve çalışma alanınızı doğrulayın.
Desteklenen MCP istemcisi örneğin Cursor, Claude Code/Desktop, Zed veya GitHub Copilot.

Adım 1: Auggie CLI Kurulumu

Augment, MCP sunucusunu Auggie CLI’nın bir parçası olarak sağlıyor. Ön sürüm paketini global olarak yükleyin:

npm install -g @augmentcode/auggie@prerelease

Kurulumu doğrulayın:

auggie --version

CLI’yi güncel tutmak, protokol iyileştirmeleri ve yeni alma araçlarını almanızı sağlar.

Adım 2: Augment ile Kimlik Doğrulama

CLI'nın imzalı istekler yapabilmesi için tarayıcıyla giriş yapın:

auggie login

Bu komut bir Augment OAuth penceresi açar. Kimlik doğrulandıktan sonra, CLI yerel bir oturum saklar ve MCP sunucusu bunu kullanır. CI dostu bir kurulum gerekiyorsa, token dışa aktarın:

auggie token print
export AUGMENT_SESSION_AUTH='{"accessToken":"...","tenantURL":"https://tenant.augmentcode.com","scopes":["read","write"]}'

İpucu: Token’ları asla git deposuna göndermeyin. Terminal dışa aktarmalarını, .gitignore içindeki .env dosyalarını veya gizli yöneticileri tercih edin.

Adım 3: MCP Sunucusunu Çalıştırma

Auggie CLI bir context engine modunu açığa çıkarır:

auggie --mcp -m default -w "${WORKSPACE_FOLDER_PATHS%%,*}"

-m default Augment model profilinizi seçer.
-w sunucunun proje ağacınızı yansıtabilmesi için ilk çalışma alanı klasörünü belirtir.

Bir istemci MCP üzerinden bağlandığında, Auggie dosyaları kademeli olarak indeksler ve codebase-retrieval veya query_codebase gibi araçlar sunar.

Adım 4: MCP İstemcinizi Yapılandırma

Cursor IDE

Settings › Tools & MCP → New MCP Server menüsünü açın.
İşletim sisteminize uygun JSON parçacığını yapıştırın:

macOS / Linux (bash):

{
  "mcpServers": {
    "augment-context-engine": {
      "type": "local",
      "command": "bash",
      "args": ["-c", "auggie --mcp -m default -w \"${WORKSPACE_FOLDER_PATHS%%,*}\""] ,
      "enabled": true
    }
  }
}

Windows (PowerShell):

{
  "mcpServers": {
    "augment-context-engine": {
      "type": "local",
      "command": "powershell",
      "args": ["-Command", "auggie --mcp -m default -w \"($env:WORKSPACE_FOLDER_PATHS -split ',')[0]\""],
      "enabled": true
    }
  }
}

Cursor’u yeniden başlatın. MCP araç paletinde artık codebase-retrieval görünmelidir.

Claude Code / Claude Desktop

Claude yapılandırmasını düzenleyin (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json, Windows: %APPDATA%/Claude/claude_desktop_config.json).
Augment sunucu kaydını ekleyin:

{
  "mcpServers": {
    "augment-context-engine": {
      "command": "npx",
      "args": ["-y", "auggie-context-mcp@latest"],
      "env": {
        "AUGMENT_SESSION_AUTH": "{\"accessToken\":\"your-token\",\"tenantURL\":\"https://...\"}"
      }
    }
  }
}

Yeni MCP araç setini yüklemek için Claude Desktop’u yeniden başlatın.

Çalışma alanı kökü: Claude Code, doğru dosyaların indekslenmesi için depo kök yolu gerektirir. IDE içindeki Claude Code Settings › Workspace Root altında yapılandırabilirsiniz.

Adım 5: Entegrasyonu Test Edin

MCP destekli IDE’nizde basit bir alma sorgusu çalıştırın:

"Bu proje ne yapıyor? Lütfen kod tabanı alma aracını kullan."

Ajanın codebase-retrieval çağırdığını, bağlam açısından zengin snippet’ler aktardığını ve atıflarla yanıt verdiğini görmelisiniz. Araç eksikse, CLI çıktısında şu hataları kontrol edin:

Auggie CLI not found → bina dosyasının PATH içinde olduğundan emin olun.
Authentication required → auggie login komutunu tekrar çalıştırın veya token’ınızı yenileyin.
Query timed out → İlk indeksleme büyük monorepolarda daha uzun sürebilir; indeks tamamlandıktan sonra tekrar deneyin.

Günlük Kullanım İpuçları

Kesin sorular sorun. "Auth nerede?" demek yerine "JWT doğrulayan middleware’i göster" diye sorun, böylece gürültüyü azaltırsınız.
Araçları zincirleyin. Cursor ve Claude, codebase-retrieval, codebase-search ve diğer MCP araçlarını sırasıyla çalıştırarak yinelemeli yanıtlar sunabilir.
Çoklu depo projeleri. Mikroservisler geliştirirken birden fazla -w bayrağı veya çalışma alanı klasörü kullanarak Augment'ın servisler arası referansları haritalamasını sağlayın.
Çevrimdışı yedek. Bağlantınız kesilirse CLI önbellekteki indeksleri sunmaya devam eder ancak yanıtlar uzak değişiklikleri içermeyebilir. Çevrimiçi olduğunuzda git pull yapıp sunucuyu yeniden başlatın.

Augment Context Engine MCP Ne Kadar İyi?

Doğruluk: Augment geliştirici iş akışlarına odaklanır; sıralama, çağrı grafikleri, testler ve sorgunuzla alakalı dokümantasyon önceliklidir.
Hız: MCP sunucu tokenları hemen istemciye aktarır ve sonraki sorgular önceden ısınmış önbelleği kullanır.
Güvenlik: Kimlik doğrulama token’ları yereldir ve stdio taşıması çalışma ortamınızı kontrol etmenize olanak tanır. Takımlar için Augment Enterprise organizasyon genelinde politika ve denetim kayıtlarını destekler.
Zayıflıklar: Motor Augment’ın yönetilen arka ucuna bağlıdır, bu nedenle aktif abonelik ve ağ erişimi gereklidir. Ayrıca, yerel indeksleme yaptığından, devasa monorepolarda ilk çalıştırma birkaç dakika sürebilir.

Kendi embeddinglerinizi veya açık kaynaklı alma araçlarınızı kıyasladığınızda, Augment kurulum süresini kısaltır ve büyük IDE ajanlarıyla kutudan çıkar çıkmaz entegre olur. Zaten Cursor veya Claude kullanıyorsanız MCP yolu doğal gelir.

Sorun Giderme Kontrol Listesi

Belirti	Muhtemel Sebep	Çözüm
MCP sunucusu görünmüyor	JSON yanlış yapılandırılmış	Virgül/tırnakları kontrol edin, istemciyi yeniden başlatın
`Auggie CLI not found`	PATH sorunu	CLI’yı yeniden yükleyin veya npm global bin dizinini PATH’e ekleyin
Kimlik doğrulama hatası	Oturum süresi dolmuş	`auggie login` yapın veya `AUGMENT_SESSION_AUTH`’ı yenileyin
IDE içinde araç eksik	Çalışma alanı uyumsuzluğu	`-w` parametresinin aktif depoya işaret ettiğini doğrulayın
Yavaş sorgular	İlk indeksleme	İndeksleme tamamlanana kadar CLI’i açık bırakın

Sonuç

Augment’ın Context Engine MCP’si AI kodlama ajanlarına gerçek kod tabanınıza güvenilir erişim sağlar. Birkaç terminal komutuyla — Auggie yükleyip giriş yaparak ve MCP yapılandırmasını yapıştırarak — hassas kod alma, daha hızlı incelemeler ve daha az hayali kod elde edersiniz. Sunucuyu IDE’nizle birlikte çalışır tutun ve diğer geliştirme hizmetleri gibi düzenli güncelleyin, günlükleri izleyin ve token’larınızı koruyun.

MCP deneylerinizi, ek hizmetlerinizi veya demo ortamlarınızı barındırmak için güvenilir altyapıya mı ihtiyacınız var? LightNode’un uygun küresel düğümlerini bu bağlantıdan keşfedin ve dakikalar içinde VPS kurun.