Sıfır yıldızlı codeagent-mcp: ChatGPT'ye kendi Linux sunucunuzda çalışma alanı açıyor
GitHub'ın gözden kaçan depolarından codeagent-mcp; dosya düzenleme, komut, kalıcı terminal ve ekran görüntüsünü 42 MCP aracıyla sunuyor. Güvenli kullanım ise sıkı bir sunucu kurulumu gerektiriyor.
1 okunma4 dk okumacodeagent-mcp GitHub deposu ve araç yüzeyi
GitHub'da 1 Eylül 2026'da henüz yıldızı bulunmayan bir depo, ChatGPT ile kendi Linux sunucunuz arasında dikkat çekici bir köprü kuruyor. codeagent-mcp adlı açık kaynak proje; yapay zekâ istemcisinin önceden tanımlanmış kod depolarını okumasına, dosya düzenlemesine, komut çalıştırmasına, kalıcı terminal oturumlarını yönetmesine ve tarayıcı ekran görüntülerini karşılaştırmasına imkân veren, kendi sunucunuzda çalışan bir MCP sunucusu.
Projenin değeri “ChatGPT sunucuya bağlanıyor” cümlesinden çok sınırları nasıl çizdiğinde ortaya çıkıyor. İstemci doğrudan bir dosya yolu seçemiyor. Yönetici, erişilebilecek çalışma kopyalarını sunucudaki projects.yaml dosyasında tanımlıyor; sohbet tarafı yalnız proje kimliği gönderiyor. Yazma yetkisi proje başına kapalı geliyor ve hem bir ortam kapısı hem de systemd ReadWritePaths sınırıyla açılıyor. Değişiklik yapan her oturumun özel bir çalışma kilidi alması da iki ajanın aynı depoyu eşzamanlı bozmasını önlemeyi amaçlıyor.
42 araç ne yapıyor?
Depodaki güncel README, araç yüzeyini 42 başlıkta topluyor. Dosya okuma ve aramanın yanında yama uygulama, ikili dosya aktarma, Git durumunu ve farkını görme, tek seferlik komut çalıştırma, tmux üzerinde kalıcı terminal açma, tarayıcıyı yönetme ve değişiklik öncesi-sonrası görsel karşılaştırma bulunuyor.
İki kullanım özellikle kolay gözden kaçıyor. Birincisi, sohbete eklenen bir tasarım, PDF, CSV veya üretilmiş görselin istem metnine sıkıştırılmadan doğrudan çalışma kopyasına yazılabilmesi. README bu aktarımı dosya başına 2 MB ile sınırlandırıyor. İkincisi, bir arayüz değişikliğinden önce ve sonra ekran görüntüsü alıp piksel farkını karşılaştırabilmek. Böylece ajan yalnız kodu değiştirmekle kalmıyor, görünür sonucu da denetleyebiliyor.
Somut kullanım örnekleri şunlar:
- Uzak sunucudaki web uygulamasında küçük bir erişilebilirlik düzeltmesi yapmak, testleri çalıştırmak ve ekran görüntüsünü karşılaştırmak.
- Bir hata günlüğünü depoya taşımadan incelemek; ilgili kodu bulup yalnız önerilen yamayı hazırlamak.
- Uzun süren geliştirme sunucusunu tmux oturumunda açık tutarken başka bir sohbetten son çıktıyı okumak.
- Bir tasarım dosyasını sohbetten projeye aktarıp bileşeni bu dosyaya göre uygulamak.
Nasıl başlanır?
Bu, masaüstüne iki tıklamayla kurulacak bir araç değil. Sunucu tarafında Linux, Python 3.12, uv, git, tmux ve ripgrep gerekiyor. Yol sınırlandırması Linux openat2 sistem çağrısına dayandığı için çekirdek sürümü 5.6 veya daha yeni olmalı. Proje, stok 5.4 çekirdeğiyle gelen Ubuntu 20.04'ü yaygın bir tuzak olarak özellikle anıyor. Windows ve macOS sunucu olarak desteklenmiyor; ancak kullanıcı bilgisayarı Windows veya macOS olabilir, çünkü bağlantı tarayıcıdaki istemci üzerinden kuruluyor.
Uzaktan ChatGPT bağlantısı için sıralı kurulum; ayrı ve kısıtlı bir sistem kullanıcısı oluşturma, Python ortamını hazırlama, depoyu eşitleme, proje kaydını tanımlama, alan adı ve DNS ayarı, GitHub OAuth izin listesi, systemd servisi ve TLS ters vekili adımlarını kapsıyor. Yerel MCP istemcileri için stdio yolu daha kısa; fakat Cursor ve Claude Code gibi araçların zaten kendi dosya ve kabuk yetenekleri bulunduğundan asıl kullanım senaryosu uzaktaki sohbet istemcisi.
İlk güvenli deneme için şu görev yeterli:
“Yalnız demo projesini aç. Önce çalışma alanı durumunu ve Git farkını göster. README ile test komutlarını oku; hiçbir dosyayı değiştirmeden başarısız testin olası nedenlerini sırala. Değişiklik gerekiyorsa uygulanacak yamayı önizle ve benden açık onay gelmeden yazma aracını çağırma.”
Bu komut tek başına teknik yetkiyi kısıtlamaz; gerçek sınırı sunucu yapılandırması belirler. Ancak ilk denemede ajanın önce okuma, sonra öneri, en son kontrollü yazma sırasını izlemesini sağlar.
Ücretsiz mi, kimler için uygun?
Kod MIT lisansıyla yayımlanıyor ve depo kendi kendine barındırılabiliyor. Buna rağmen toplam kullanım ücretsiz sayılmaz: Linux sunucusu, alan adı, TLS hizmeti ve seçilen model veya ChatGPT planı ayrı maliyet çıkarabilir. Uzaktan kurulum ayrıca sistem yönetimi bilgisi gerektiriyor. Küçük bir ekip, kendi laboratuvar sunucusu veya hassas kodu üçüncü taraf geliştirme ortamına taşımak istemeyen teknik kullanıcılar için anlamlı olabilir; yalnızca ara sıra kod sorusu soran biri için fazla ağır.
Benzer masaüstü kodlama ajanlarından temel farkı, çalışma ortamının sohbeti açtığınız bilgisayarda değil, sizin yönettiğiniz Linux sunucusunda bulunması. Bunun karşılığında kurulum ve güvenlik sorumluluğu da size geçiyor.
Güvenlikte güçlü taraflar ve açık kalan risk
Referans mimari; süreci sudo ve Docker erişimi olmayan ayrı kullanıcıyla çalıştırıyor, yalnız geri döngü adresine bağlıyor, dış dünyaya TLS ters vekili üzerinden çıkıyor ve GitHub OAuth subject izin listesi kullanıyor. Yazma izninin iki ayrı kapıyla açılması ve istemcinin keyfî sunucu yolu verememesi olumlu.
Yine de bu araç dosya yazabiliyor ve komut çalıştırabiliyor; hatalı proje kaydı, geniş ReadWritePaths tanımı veya zayıf OAuth yapılandırması ciddi sonuç doğurabilir. Kurulum belgesini kopyalarken kullanıcı kimliklerini, servis yollarını ve izin listesini kendi sunucunuza göre doğrulayın. İlk bağlantıda üretim deposu yerine geçici bir depo kullanın, yedek alın ve yazmayı kapalı tutun. README'deki güvenlik modeli bağımsız sızma testi kanıtı değildir; projenin az kullanılmış olması da daha dikkatli inceleme gerektirir.
Okuyucu bugün, kullanmadığı bir Linux makinede yalnız okunabilir demo projesi tanımlayıp bağlantı zincirini sınayabilir. GitHub'ın az görünen köşelerindeki işe yarar yapay zekâ araçlarını yalnız duymak değil, güvenli biçimde uygulamak için Mülk Rehberi Gazetesi'ni takip edin.