Araç İsim Alanları

Bu sayfa, Chainabit'e bağlanan harici bir MCP server'ı değil, NEXUS yerel MCP server'ın araçlarını anlatır. nexus-mcp tek bir server, tek bir bağlantı ve tek bir tools/list çağrısıdır. Araç ailelerini ayrı sunuculara veya ayrı bağlantılara bölmez: bir kez bağlanıp tools/list çağıran (ya da güncel dönemde server/discover yeteneklerini okuyan) bir istemci, çalışan çalışma alanının sunabildiği her isim alanını tek bir yanıtta, birlikte görür.

Aileler

İsim alanı	Ne işe yarar	Kapsam	Neyle yönetilir
canvas_*	Excalidraw uyumlu ortak tuvali okuma ve yazma	çalışma alanı	hedef tuval üzerinde açık bir rol ataması
agent_*	Mesh eşlerini listeleme, onlara mesaj gönderme ve ajan kimliği	çalışma alanı	çağıran ajanın mesh yetkisi
window_*	Salt okunur pencere durumu ve pencereye bağlı olanlar	çalışma alanı	çağıran ajanın mesh yetkisi
memory_*	Ortak bilgi belleği	oturum / ajan / proje / çalışma alanı / genel	görünürlük ve bilgi çalışma zamanı anahtarı
provider_*	Yapay zekâ sağlayıcı kaydı ve köprü çalışma zamanı bilgileri	uygulama geneli	çağıran ajanın mesh yetkisi
team_*	Takım üyeliği	uygulama geneli	çağıran ajanın mesh yetkisi
neural_*	Neural Map üzerinde sınırlı gezinme	uygulama geneli	çağıran ajanın mesh yetkisi
browser_*	Bir NEXUS tarayıcı Penceresini izleme ve otomatikleştirme	çalışma alanı içinde, Pencere başına	mesh yetkisi, denetim kirası ve eylem başına onay
workspace_*	Çalışma alanı kimliği, kapsam çözümü ve yaşam döngüsü	çalışma alanı	mesh yetkisi; oluşturma ve silme ayrıca kullanıcının onayını gerektirir
session_*	Terminal oturumları: listeleme, açma ve kapatma, bölmeleri düzenleme, birine odaklanma	çalışma alanı	özerklik kipi ve açma için ajan başına oluşturma sınırı
insight_*	Salt okunur katkı, kullanım ve maliyet değerleri	ajan / çalışma alanı	çağıran ajanın mesh yetkisi
repo_* / worktree_*	Salt okunur depo ve worktree yerleşimi; git'in kendi kayıt dosyalarından okunur	çalışma alanı	çağıran ajanın mesh yetkisi
room_*	Yerel 2-B Oda için salt okunur varlık, düşünce akışı, bölgeler ve kip	çalışma alanı	çağıran ajanın mesh yetkisi
settings_*	Kalıcı uygulama yapılandırması, katmanlı — çoğu alan okunabilir, azı yazılabilir, bir kısmı hiçbiri	uygulama geneli	kapalı bir izin listesi, ardından özerklik kipi
bit_*	Metniyle birlikte bir Bit — markdown not bölmesi — oluşturma	çalışma alanı	özerklik kipi ve oluşturma sınırı
plan_*	Çok adımlı bir işlemi duyurma; böylece izleyebilir, durdurabilir ve geri alabilirsiniz	çalışma alanı	özerklik kipi
tool_*	Bu katalogu çağıranın kendi canlı izinleriyle işaretlenmiş olarak okumak ve bu izinlerden birini bırakmak — yalnızca daraltma, asla yetki verme	çağıran ajan	çağıran ajanın mesh yetkisi

Bellek kapsamları

Bir memory_* yazma işlemi ait olduğu kapsamı belirtir ve o kapsam, kaydı kimin geri okuyabileceğini belirler:

Kapsam	Kimler okuyabilir	Yaşam süresi
oturum	yalnızca kaydı yazan canlı oturum	oturumla birlikte sona erer
ajan	yalnızca kaydı yazan ajan	kalıcı
proje	aynı projede çalışan her ajan	kalıcı
çalışma alanı	o çalışma alanındaki her ajan	kalıcı
genel	her ajan	kalıcı

Bir proje, çözümlenmiş dizini ile tanımlanır; bu nedenle sembolik bağ veya göreli yol üzerinden erişilen aynı klasör birden çok değil, tek bir projedir.

Okuma kapsama göre belirlenir, çağırana göre değil: göremediğiniz bir kayda yapılan istek reddedilmek yerine bulunamadı olarak yanıtlanır; böylece var olmayan bir kayıt ile gizlenmiş bir kayıt dışarıdan ayırt edilemez.

Çalışma alanı kapsamlı her aile, başka bir çalışma alanını adlandıran veya ima eden bir çağrıyı reddeder. provider_*, team_*, neural_* ve settings_* ise uygulama genelidir: sağlayıcı ve uygulama yapılandırması NEXUS geneline ait ayarlardır, takımlar bugün çalışma alanına göre bölünmez ve Neural Map tek bir ortak graftır.

Bazı araç adları, başka bir aileye ait bir ön ek taşır: agent_launch, session_arrange, session_focus, browser_focus, browser_open_window, browser_close_window, canvas_create, canvas_delete, session_create, session_close. Bunlar ön eke göre değil, tam ada göre yönlendirilir; dolayısıyla bir aracın ön ekinin ima ettiği aile, o çağrıyı yanıtlayan kod olmayabilir. Bu yalnızca istemci tarafında araçları ön eke göre süzüyorsanız önemlidir: ada göre süzün.

Araç bazındaki tam tablo için MCP Araçları sayfasına bakın.

Her açıklama hangi düzlemde çalıştığını bildirir

Bu sunucunun sunduğu her araç açıklaması aynı işaretle başlar:

[Local NEXUS app] List the canvases the calling agent may read in its workspace.

Bu ön ek süs değildir. Chainabit bulut MCP sunucusu da bağlıysa elinizde iki agent_create aracı, iki bellek sistemi, iki ajan listesi ve "workspace" adı verilen birbiriyle ilgisiz iki şey olur. Bir modelin iki benzer araç arasında seçim yaparken en güvenilir okuduğu sinyal aracın açıklamasıdır; bu yüzden bu sunucu düzlemini her açıklamada, en başta bildirir.

Aldığınız bir araç açıklamasında bu işaret yoksa, o araç bu sunucudan gelmemiştir. Tüm sınır için bkz. NEXUS yerel MCP ile Chainabit bulut MCP.

Gerçekte ne olduğunu keşfetmek

tools/list çalışan çalışma alanı tarafından canlı olarak sunulur; önbelleğe alınmış ya da eskimiş bir katalogdan değil. Bu aynı zamanda çalışan bir çalışma alanı yokken boş veya hatırlanmış bir liste döndürmek yerine kapalı biçimde başarısız olduğu anlamına gelir. Araç adlarını dokümantasyondan sabitlemek yerine bağlandıktan sonra bu çağrıyı yapın (ya da 2026-07-28 döneminde server/discover içindeki capabilities alanını okuyun): kesin girdi şemaları tools/list yanıtına aittir; bu sayfa ve araç referansı ise sürümler arasında kararlı kalan amaç ve sonuç sözleşmelerini anlatır.

tools/list ayrıca yalnızca ilgili bağlantının gerçekten sunabildiklerini bildirir. Altındaki yüzey kullanılamıyorsa bir isim alanı hiç duyurulmaz; duyurulup ardından hatayla yanıtlanmaz.

Daha önce kullanmadığınız bir şeyi çağırmadan önce iki kaynak okumaya değer:

• nexus://capabilities — her aracın gerektirdiği yetki, onay düzeyi, yan etkileri ve belirtilmişse geri alınabilirliği.
• nexus://planes — bu sunucunun ne olduğu ve ne olmadığı.

İkisi de MCP Protokolü referansında ele alınır.

Bu iki kaynak köprünün biçimini anlatır ve her çağıran için aynı okunur. Sizin ne yapabileceğinizi — yetki kümenizin ve özerklik modunuzun şu anda hangi araçlara izin vereceğini — öğrenmek istediğinizde bunun yerine tool_list çağırın; bkz. MCP Araçları.

Her ailede okuma ile yazma

Okuma ve yazma çağrıları, tasarımınızı etkileyecek kadar farklı davranır ve bu fark tüm yüzeyde tutarlıdır:

• Bir okuma (canvas_list, agent_list_peers, window_read, memory_query, provider_list, team_list, neural_neighbors, browser_read_page, workspace_current, tool_list) yalnızca güncel durumu döndürür. Okumalar ajanın özerklik moduna hiçbir zaman takılmaz.
• Tuvale yazma yalın bir başarı/başarısızlık döndürmez; dört sonuçtan birini döndürür.
• Mesh üzerine yazma (agent_trigger, agent_invite_to_channel, agent_create) eylem sıraya alındığında veya talep edildiğinde döner, sonrasında bir şey gerçekleştiğinde değil.
• Ortak belleğe yazma eşzamanlıdır: girdi, bir sonraki memory_query veya memory_list çağrısında hemen görünür.
• Tarayıcıda yazma ayrıca bir denetim kirasına ve hassas eylemlerde bir insanın onayına tabidir.

Hiçbir ailenin yazma çağrısı, "etki her yerde tamamen yerleştiğinde döner" anlamında eşzamanlı bir uzak yordam çağrısı gibi davranmaz.

Özerklik her isim alanı için geçerlidir

Çağıran ajanın özerklik modu izin vermeden hiçbir yazma çağrısı iletilmez. Bu denetim tüm araç yüzeyinde tek biçimlidir ve isim alanı yönlendirmesinin üstünde uygulanır; böylece yeni eklenen bir isim alanı denetimsiz bir yazma yüzeyi açamaz. Okumalar her zaman geçer; geri alınamaz eylemler her modda mutlaka bir insana ulaşır. Dört mod ve her birinin ne döndürdüğü MCP Araçları sayfasında belgelenmiştir.

Bir aile bir diğerinin yerine geçemez

agent_* içinde tuvali okuyan veya yazan hiçbir şey yoktur; canvas_* içinde de başka bir ajana seslenen hiçbir şey yoktur. window_* bir pencereyi asla değiştirmez; workspace_* yalnızca çalışma alanları üzerinde işlem yapar, bir çalışma alanının içindekiler üzerinde asla. Hem tuvale çizen hem de başka bir ajana devreden bir akış kuruyorsanız bu, tek bir birleşik çağrı değil, iki isim alanından iki ayrı çağrıdır.

Bir çalışma alanını döşemek ve bir tane oluşturmak

Bir ajan, sizin zaten açtığınız bir çalışma alanını döşeyebilir: terminal açabilir (session_create), birinde bir ajanı çalıştırmaya başlayabilir (agent_launch), tarayıcı penceresi açıp motorunu başlatabilir (browser_open_window), tuval oluşturabilir (canvas_create) ve Bit ekleyebilir (bit_create). Her biri tersiyle birlikte gelir ve her biri ajan başına bir hız sınırı ile ömür boyu üst sınıra işlenir; bir ret, hangi sınırın aşıldığını ve ne zaman sıfırlanacağını söyler.

Çalışma alanının kendisini oluşturmak veya silmek her zaman önce size sorar.workspace_create ve workspace_delete vardır, ancak hiçbiri gözetimsiz çalışmaz: her biri NEXUS'ta çalışma alanını adıyla anan bir onay kartı yükseltir ve siz yanıtlayana kadar hiçbir şey olmaz. Oluşturma, bir hız sınırıyla değil bu onayla ölçülür.

Oluşturma ayrıca bilinçli olarak rahatsız etmez: bir ajanın oluşturduğu çalışma alanı arka planda açılır, böylece kendi pencereniz olduğu yerde kalır ve oluşturan ajan oraya yeniden kapsamlanmaz — bir ajan, gidecek yeni bir yer oluşturarak kendi kapsamını taşıyamaz. Silmenin tersi yoktur ve çalışma alanının oturumlarını, düzenini ve tuvallerini yok eder; bu yüzden Auto dahil her özerklik modunda onay gerektirir.

Bir ajanın oluşturduğu her şey NEXUS arayüzünde ona atfedilir — bölme başlığında, kenar çubuğu satırında ve tuval satırında bir rozetle — ve uygulama yeniden başlatıldıktan sonra da kalır; böylece kendi açmadığınız bir yüzey her zaman kimin açtığını söyler.

Düzenleme, odaklanma ve başsız bir çağrının dokunabileceği pencere

session_arrange, çalışma alanının kendi bölme yerleşimi üzerinde çalışır; bu yüzden kaç pencere açık olursa olsun belirsizlik yoktur ve o çalışma alanını gösteren her pencere değişikliği yansıtır.

session_focus ve browser_focus farklıdır: seçim bir pencereye aittir. Bu nedenle şu anda baktığınız pencere üzerinde ve yalnızca o pencere çağıran ajanın çalışma alanını gösterirken çalışırlar. Başka bir çalışma alanına geçtiyseniz çağrı reddedilir ve size ne gösterildiğini söyleyen bir mesaj döner. Bir ajan arka plandaki bir pencereye uzanamaz — göremediğiniz bir şeyi kımıldatmak, görebildiğiniz bir şeyi kımıldatmaktan daha kötüdür.

Çok adımlı bir işlemi izlemek, durdurmak ve geri almak

Yalnızca birlikte anlam taşıyan birden çok değişiklik yapmadan önce bir ajan plan_begin çağırıp bunları duyurabilir. Plan, çalışırken NEXUS'ta görünür ve duyurulanı gerçekte olanın yanında gösterir.

Plan, ajana hiçbir yetki vermez. Hiçbir şey yürütemez — plan_execute diye bir araç yoktur; adımlar ajanın olağan araç çağrılarıdır ve her biri tıpkı plansız olduğu gibi denetlenir. Kayıt, ajanın kendini anlatmasıyla değil, sunucunun çağrıları gönderirken tuttuğu kayıtla oluşur; bu yüzden bir ajan kendi planından bir adımı gizleyemez.

Çalışan bir planı durdurabilirsiniz. O andan sonra kalan yazma işlemleri reddedilir; okumaları çalışmaya devam eder, böylece ajan neyin olup neyin olmadığını öğrenip size tahmin yürütmeden anlatabilir. Ardından geri alabilirsiniz: bu, planın oluşturduğu yüzeyleri en yenisinden başlayarak kapatır. Geri alma sınırları konusunda dürüsttür — neyi eski hâline getiremeyeceğini (bir bölme düzeninin önceki geometrisi kayıtlı değildir) siz onaylamadan önce bildirir.

Neler sunulmuyor

Tuval rolü veren veya değiştiren bir araç, NEXUS uygulama penceresi açan ya da kapatan bir araç (bir pencerenin içindeki tarayıcı pencereleri farklı bir şeydir ve oluşturulabilir) ve çalışma alanı oluşturan, değiştiren veya silen bir araç yoktur. Boşlukların tam listesi ve her birinin gerekçesi için MCP Araçları sayfasındaki "Neler burada yok" bölümüne bakın; bir yeteneğin var olmasından yola çıkıp onu denetleyen bir aracın da var olduğunu varsaymayın.

Sırada ne var

• MCP Araçları — araç bazındaki tam tablo.
• NEXUS yerel MCP ile Chainabit bulut MCP — iki sunucuyu birbirinden ayırmak.
• İstemci Bağlama — tools/list çağrısının bir şey döndürmesini sağlamak.
• Sorun Giderme — keşfin kendisi başarısız olduğunda.