Araç İsim Alanları
nexus-mcp tek bir sunucu, 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, kalıcı bilgi belleği | ajan / ç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_* | Salt okunur çalışma alanı kimliği ve kapsam çözümü | çalışma alanı | çağıran ajanın mesh yetkisi |
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_* | Salt okunur: bu katalog, çağıranın kendi canlı izinleriyle işaretlenmiş | çağıran ajan | çağıran ajanın mesh yetkisi |
Ç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_queryveyamemory_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_* bir çalışma alanını asla değiştirmez. 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 asla oluşturulamayan tek şey
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ı oluşturamaz. Ne bu sunucuda ne de başka bir yerde workspace_create vardır; bu tasarım gereğidir: bir ajan yerleştirildiği bir kapsamda çalışabilir, kendisi için asla kapsam üretemez.
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.