Skip to content

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 yararKapsamNeyle 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ğiajan / çalışma alanı / genelgörünürlük ve bilgi çalışma zamanı anahtarı
provider_*Yapay zekâ sağlayıcı kaydı ve köprü çalışma zamanı bilgileriuygulama geneliçağıran ajanın mesh yetkisi
team_*Takım üyeliğiuygulama geneliçağıran ajanın mesh yetkisi
neural_*Neural Map üzerinde sınırlı gezinmeuygulama geneliçağıran ajanın mesh yetkisi
browser_*Bir NEXUS tarayıcı Penceresini izleme ve otomatikleştirmeçalışma alanı içinde, Pencere başınamesh 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ğerleriajan / ç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çbiriuygulama genelikapalı 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_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_* 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

Built with purpose.