Filesystem MCP nedir? Kurulum, izinli klasörler, üzerine yazma riski ve güvenlik geçmişi
Kendi dosya erişimi olmayan bir asistana Filesystem MCP'yi bağlarsın; asistan yalnız seçtiğin klasörlerde dosya okur, yazar, düzenler, taşır, klasör açar ve arar. Yerel bir MCP sunucusu (modelcontextprotocol/servers deposu, npm paketi @modelcontextprotocol/server-filesystem). README'deki 13 araç arasında silme aracı yok; ama write_file bir dosyanın üzerine yazar, edit_file içeriği değiştirir, move_file kaynağı kaldırır ve bunları geri alma ya da çöp kutusu yok. Depo bu sunucuları üretim için değil, eğitim amaçlı referans uygulama sayıyor. Geçmişte iki yüksek önemli yol aşma açığı kaydedildi (2025).
- Ne yapar
- Asistana seçtiğin klasörlerde dosya okutup yazdırır
- Tür
- MCP sunucusu (yerel, açık kaynak)
- Yapımcı
- MCP steering group (modelcontextprotocol)
- Erişim
- Yalnız izin verdiğin klasörler, ağa veri göndermez
- Risk
- Üzerine yazma ve taşıma geri alınamaz
- Durum
- Eğitim amaçlı referans uygulama
- Ücret
- Ücretsiz, hesap gerekmez
Filesystem MCP ne işe yarar?
MCP, yapay zekâ programlarının dış araçlara bağlanma standardıdır. Filesystem MCP ile asistan, senin seçtiğin klasörlerde dosyaları okur, yeni dosya oluşturur ya da var olanı değiştirir, klasör açar, dosya ya da klasör taşır, klasör ağacını çıkarır ve desen ile dosya arar.
Üzerine yazma ve taşıma geri alınamaz; ağa veri göndermez.
| Grup | Araçlar |
|---|---|
| Okur (9) | read_text_file, read_media_file, read_multiple_files, list_directory, list_directory_with_sizes, directory_tree, search_files, get_file_info, list_allowed_directories |
| Yazar (4) | create_directory, write_file, edit_file, move_file |
Kime yarar: Asistanın bir proje klasöründe dosyaları okuyup düzenlemesini isteyen ve bunun için güvenli bir sınır çizmek isteyenlere. Önemli klasörlerde dikkatli ol.
Filesystem MCP nasıl kurulur?
Gereken: Node.js (npx) ya da Docker. İzinli klasörleri sen yazarsın. Yapılandırmalar README'den aynen alındı; Claude Desktop için ayar dosyasını Settings sonra Developer sonra Edit Config ile açıp uygulamayı tamamen kapatıp yeniden aç.
› {"mcpServers":{"filesystem":{"command":"npx","args":["-y","@modelcontextprotocol/server-filesystem","/Users/username/Desktop","/path/to/other/allowed/dir"]}}}Windows'ta README npx'i cmd ile başlatmayı söylüyor ("command":"cmd", argümanlar ["/c","npx","-y",…]); MCP belgesinin Windows sekmesi ise doğrudan npx kullanıyor. Biri çalışmazsa diğerini dene.
› {"mcpServers":{"filesystem":{"command":"docker","args":["run","-i","--rm","--mount","type=bind,src=/Users/username/Desktop,dst=/projects/Desktop","--mount","type=bind,src=/path/to/other/allowed/dir,dst=/projects/other/allowed/dir,ro","mcp/filesystem","/projects"]}}}Sonuna ,ro eklenen bağlama yalnız okunur olur: README'nin tek koruması bu.
VS Code için README kullanıcı mcp.json ya da .vscode/mcp.json yapılandırmasını (npx ya da Docker) anlatıyor. Claude Code README'de yok: Claude Code'un kendi belgesi yerel (stdio) sunucuyu claude mcp add ile eklemeyi anlatıyor ve sunucunun roots isteğine oturumun açıldığı klasörü yanıtlıyor.
!Atlas kartındaki kurulum satırı sürümü 2026.8.31'e sabitlemiş; npm latest etiketi 11 Ekim 2026'da 1.0.0 oldu. Eski sürüm kurulabilir ama güncel değil. Geçmiş uyarılar için izinler bölümüne bak.
Filesystem MCP nasıl kullanılır?
Bağlandıktan sonra isteği normal yazarsın. Değişiklik yaptıracaksan önce ne yapacağını göstermesini ve dryRun (edit_file) kullanmasını iste.
Önemli klasörleri yedekle ya da Docker'da ro ile salt okunur ver. Dosya üzerine yazmanın geri alma yolu yok.
Filesystem MCP nerede çalışır?
| Claude DesktopVar | README'de yapılandırma var. |
|---|---|
| VS Code ve InsidersVar | README'de yapılandırma var. |
| Claude CodeKısmen | README'de yok; Claude Code'un kendi belgesi stdio sunucu eklemeyi anlatıyor. |
| Cursor, Codex, LM Studio ve diğerleriNet değil | Belgede yazmıyor; çalışmaz demek değildir. |
Filesystem MCP neye erişir, ne değiştirir?
Yalnız izin verdiğin klasörlerdeki dosyalar ve klasör bilgisi. Tüm araçlar ağa veri göndermez (openWorldHint false).
write_file (var olanın üzerine yazar), edit_file (içeriği değiştirir), create_directory ve move_file.
README'nin 13 araçlık listesinde silme aracı yok. Yine de move_file kaynağı kaldırır (README notu "Deletes source file"; hedef varsa reddeder), write_file üzerine yazar. Geri alma ve çöp kutusu yok. Özellik listesi "delete directories" diyor, yani README kendi içinde çelişiyor.
Okunan dosya içeriği kullandığın yapay zekâ hizmetine gider.
İzinli klasörler: komut satırı argümanı ya da istemcinin roots özelliği. İstemci roots gönderirse sunucudaki klasörlerin tümünün yerine geçer (README). Roots da klasör argümanı da yoksa sunucu çıkış koduyla kapanır.
| Kayıtlı uyarı | Özet |
|---|---|
| GHSA-hc55-p739-j48w (CVE-2025-53110) | Yüksek: çakışan klasör adı öneki izinli klasör sınırını aşabiliyordu (Temmuz 2025) |
| GHSA-q66q-fx2p-7w4m (CVE-2025-53109) | Yüksek: sembolik bağlantı yoluyla izinli klasör dışına erişim (Temmuz 2025) |
İkisi 2025.7.01 sürümünde düzeltildi (npm'de 2025.7.1); uyarı metni ile etkilenen sürüm alanı birbirini tutmuyor. Güncel sürüm için kayıtlı açık uyarı yok; bu "güvenli" demek değildir. README bu sunucuları eğitim amaçlı referans uygulama olarak tanımlıyor.
Filesystem MCP ücretsiz mi?
Evet; açık kaynak ve hesapsız kullanılır. Lisansta bir tutarsızlık var: README MIT yazıyor, depodaki LICENSE dosyası ise MIT'ten Apache-2.0'a geçiş sürecini anlatıyor; npm lisans alanı "SEE LICENSE IN LICENSE", GitHub NOASSERTION gösteriyor. Asistan aracının kendi planı ayrı. TL fiyatı yok.
Sık sorunlar ve çözümleri
| Ne oluyor | Ne yapmalı |
|---|---|
| Sunucu bağlanmıyor, araçlar görünmüyor | Claude Desktop'ı tamamen kapat-aç; yapılandırma sözdizimini ve yolların mutlak olduğunu kontrol et; günlüklere bak. |
| Sunucu hemen kapanıyor (çıkış kodu 1) | Klasör argümanı verilmemiş ve istemci roots desteklemiyor; komuta en az bir izinli klasör yaz. |
| "Access denied - no allowed directories" | İstemci geçerli root göndermiyor; istemcide bir klasör aç. 1.0.0 öncesi hızlı ilk çağrılar da bu hatayla reddedilebiliyordu. |
| Windows'ta npx başlamıyor (ENOENT) | cmd /c ile başlat; günlükte APPDATA geçen ENOENT görürsen yapılandırmaya APPDATA'nın açık değerini ekle. |
| Windows'ta dosya yazarken EPERM | 1.0.0'da write_file ve edit_file yerinde yazıyor; güncelle. |
Filesystem MCP nasıl kaldırılır?
- İstemcide: Yapılandırma dosyasından filesystem girdisini sil ve istemciyi yeniden başlat.
- Docker kullandıysan: Docker imajını silmek istersen
docker image rm mcp/filesystem.
Kalıcı hesap bağlantısı yok; kaldırma adımları genel yöntemdir.
Sık sorulan sorular
Filesystem MCP nedir, ne işe yarar?
Kendi dosya erişimi olmayan bir asistana yalnız seçtiğin klasörlerde dosya okuma, yazma, düzenleme, taşıma, klasör açma ve arama araçları veren yerel bir MCP sunucusudur.
Filesystem MCP güvenli mi, neye erişir?
Yalnız izin verdiğin klasörlere erişir ve ağa veri göndermez. Ama o klasörlerde dosyaların üzerine yazabilir ve taşıyabilir. Depo README'si bu sunucuları üretim için değil, eğitim amaçlı referans uygulama sayar; güvenli damgası yok, yalnız güncel sürüm için kayıtlı açık uyarı yok.
Claude dosyalarımı silebilir mi?
README'deki 13 araç arasında silme aracı yok. Ama write_file bir dosyanın üzerine yazar, edit_file içeriği değiştirir, move_file kaynağı kaldırır; bunlarla veri kaybı olabilir. Önemli klasörleri Docker'da ro bayrağıyla yalnız okunur bağlamak README'nin sunduğu korumadır.
Hangi klasörlere erişeceğini nasıl belirlerim?
Ya komuta klasör yollarını yazarsın ya da roots destekleyen bir istemciye bırakırsın; istemci roots gönderirse komut satırındakilerin yerine geçer.
Filesystem MCP ücretsiz mi, lisansı ne?
Açık kaynak ve hesapsız kullanılır. README MIT yazar; depodaki LICENSE ise MIT'ten Apache-2.0'a geçiş sürecini anlatır.
Hangi programlarda çalışır?
README Claude Desktop ve VS Code için yapılandırma verir; Claude Code'un kendi belgesi stdio sunucu eklemeyi anlatır. Diğer istemciler belgede geçmiyor; çalışmaz demek değildir.
İlgili rehberler
Kaynaklar
Resmî kaynaklarda net olmayanlar: Claude Desktop dışındaki istemcilerin roots desteği · en düşük Node sürümü (package.json'da yok) · hazırlık betiğinin npx kurulumunda çalışıp çalışmadığı · issue taraması (yapılmadı) · Windows komut biçimi (README ile MCP belgesi farklı) · Türkçe bilgi. Her biri ilgili bölümde yazılı.