Araç Referansı
Chainabit bulut MCP sunucusu, tools/list ile 41 araç sunar. Bunların her biri Chainabit hesabınıza etki eder — makinenizde çalışan NEXUS masaüstü uygulamasına asla dokunmaz. İki MCP sunucusu da bağlıysa, bir araç seçmeden önce NEXUS yerel MCP ile Chainabit bulut MCP sayfasını okuyun.
Kapsam nasıl çalışır
Her çağrı, OAuth erişim anahtarınızın taşıdığı kimliğe bağlanır. Bir tanımlayıcı göndererek başka bir hesabın verisine erişemezsiniz; tanımlayıcılar modelden geldiği gibi kabul edilmez, üyeliğinize karşı doğrulanır:
- Hesap — anahtarın düzenlendiği Chainabit hesabı.
- Çalışma alanı — o hesabın o an içinde çalıştığı çalışma alanı. Çalışma alanı kapsamlı araçlar yalnızca onun içinde okur ve yazar.
get_workspace_infoaçık birworkspaceIdkabul eder, ancak bunu kendi üyeliğinize karşı çözümler. - Kullanıcı — görevler, hedefler, bellek kayıtları ve takvim girdileri, o çalışma alanı içindeki oturum açmış kullanıcıya aittir.
Araçları koruyan yetkiler:
| Yetki | Kapsadıkları |
|---|---|
mcp.tools.read | Aşağıda aksi belirtilmeyen tüm araçlar. Görev, hedef, bellek ve kum havuzu araçlarının hem okuma hem yazma işlemleri bu bütçeyi tüketir. |
mcp.tools.write | Yalnızca update_agent. |
nexus.room | nexus_room_join, nexus_room_say, nexus_room_history, trigger_agent, trigger_team. |
nexus.desktop | get_nexus_entitlements. |
Bunların planlara ve hız kovalarına nasıl karşılık geldiği için Planlar ve Hız Sınırları sayfasına bakın.
MCP üzerinden yazma işlemleri anında uygulanır
Bazı araçlar, bir Chainabit yapay zekâ konuşmasının içinde çalışırken onay ister; orada ürün bir onay kartı gösterir. Bir MCP isteğinde böyle bir yüzey yoktur; dolayısıyla MCP üzerinden çağrılan bir yazma aracı çağrıldığı anda etkili olur. Veri oluşturan veya değiştiren her aracı anında etkili kabul edin ve önce yardım ettiğiniz kişiye doğrulatın.
Tek istisna, iki adımlı korumayı aracın kendi sözleşmesinde uygulayan bits_delete aracıdır — aşağıya bakın.
Yönelme
Neye bağlı olduğunuzu öğrenmek için önce bunları çağırın.
get_bot_info
Sunucunun adını, açıklamasını ve sunduğu yetenek ailelerinin özetini döndürür. Argüman almaz. Chainabit bulut sunucusuyla konuştuğunuzu doğrulamanın en ucuz yolu.
get_workspace_context
Çağıranın hesap tanımlayıcısını, geçerli çalışma alanı tanımlayıcısını ve planının verdiği MCP kapsamlarını döndürür. Argüman almaz. İlk çağrı olarak kullanışlıdır; sonraki çağrıların etkin çalışma alanını keşfetmek için ek gidiş-dönüşe ihtiyacı kalmaz.
get_workspace_info
Bir çalışma alanının üst verisini getirir — ad, plan, üye sayısı ve yapılandırma.
Argümanlar: workspaceId (isteğe bağlı; varsayılan olarak etkin çalışma alanı). Açıkça verilen bir tanımlayıcı kendi üyeliğinize karşı çözümlenir, dolayısıyla üyesi olmadığınız bir çalışma alanının adını vermek sonuç döndürmez.
get_nexus_entitlements
Hesabın NEXUS Desktop özellik yetkilerini döndürür: hangi özelliklerin açık olduğunu ve oturum, ajan ve çalışma alanı üzerindeki katı sınırları. Argüman almaz. Bağlandıktan sonra bir kez çağırın ve sonucu önbelleğe alın.
Bu araç, hesabın neye yetkili olduğunu bildirir. Makinenizde çalışan bir NEXUS uygulamasını incelemez ve inceleyemez.
nexus.desktop gerektirir.
Görevler — bits_*
Bit, tek bir yapılabilir görevdir. Bir hedef, proje veya çok adımlı girişim için bunun yerine chainies_* kullanın.
bits_query
En esnek görev araması. Tarih aralığı, durum, öncelik, hedef, zincir, üst görev, gecikme bayrağı ve metin aramasını imleç sayfalamasıyla birleştirir.
Argümanlar: dateFrom, dateTo (YYYY-MM-DD), status (pending | completed | skipped | failed | archived), priority (low | medium | high | critical), chainyId, chainId, parentId (bir görev tanımlayıcısı ya da yalnızca üst düzey görevler için root dizesi), overdue, query, limit (1–50, varsayılan 20), cursor.
Sayfalama sıralıdır: önceki yanıttaki nextCursor değerini olduğu gibi geçirin. İmleç değerleri opaktır ve yalnızca önceki bir yanıttan gelir.
bits_get
Tek bir görevi tanımlayıcısıyla getirir; liste yanıtlarında kırpılan tam not gövdesini de içerir.
Argümanlar: bitId (zorunlu).
bits_search
Görev başlıkları ve notları üzerinde anahtar kelime araması; isteğe bağlı durum, öncelik, hedef ve tarih aralığı süzgeçleriyle. Metin sorgusu yoksa veya sayfalama gerekiyorsa bits_query kullanın.
Argümanlar: query (zorunlu), limit (1–50, varsayılan 20), chainyId, status, priority, dateFrom, dateTo.
bits_create
Bir veya daha fazla görev oluşturur. Tek görev için title ve isteğe bağlı alanları geçirin; birden fazlası için aracı tekrar tekrar çağırmak yerine bir items dizisi geçirin. scheduledDate varsayılan olarak bugündür, priority varsayılan olarak medium. Görevi bir hedefe veya zincire bağlamak için chainyId ya da chainId verin.
bits_update
Bir veya daha fazla görevi günceller. Tek görev için bitId ile yalnızca değişecek alanları geçirin; birden fazlası için bir items dizisi geçirin. status alanını completed yapmak görevi tamamlanmış işaretler ve isteğe bağlı bir completionNote kabul eder. chainyId görevi başka bir hedefe taşır; chainId başka bir zincire atar.
bits_move
Bir görevi farklı bir hedefe veya zincire taşır. Genel düzenlemeler için bits_update tercih edin; bu araç açık yeniden atama içindir.
Argümanlar: bitId (zorunlu) ve chainyId ile chainId alanlarından en az biri.
bits_reprioritize
Çok sayıda görevin önceliğini tek bir işlemde değiştirir; bir öncelik analizinin devamı olarak tasarlanmıştır. Her girdi bir görev tanımlayıcısı, yeni bir öncelik ve isteğe bağlı kısa bir gerekçe taşır.
Argümanlar: chainyId (zorunlu), updates (zorunlu; 1–100 adet bitId + priority, isteğe bağlı rationale), reason (isteğe bağlı özet).
bits_delete
Sınırlı sayıda görevi tanımlayıcılarıyla siler. Bu araç iki çağrı gerektirir. Önce previewOnly: true ile çağırıp etkilenecek görevlerin tam listesini ve bir previewToken alın; listeyi kullanıcıya gösterin; ardından previewOnly: false ve size verilen belirteçle yeniden çağırın. Belirteç, silme işlemini önizlenen kümeye bağlar; böylece kullanıcının görmediği hiçbir şey silinemez.
Argümanlar: bitIds (zorunlu), previewOnly (zorunlu), previewToken (previewOnly false olduğunda zorunlu).
Silinen her görev tüm görünümlerden anında kaybolur ve yapay zekâ belleğinden çıkarılır; 30 günlük bir kurtarma penceresinin ardından kalıcı olarak temizlenir. Bu temizlik araçlar üzerinden geri alınamaz.
Takvim — calendar_*
Takvim araçları, bits_* ailesinin yönettiği görevleri okur ve yeniden planlar; yalnızca görevleri nasıl seçtikleri farklıdır. Sonuçları hiçbir zaman önbellekten sunulmaz, dolayısıyla gün sınırında yapılan bir sorgu her zaman güncel tarihi yansıtır.
calendar_today
Bugüne planlanmış görevleri önceliğe göre sıralı döndürür. Başka herhangi bir tarih için — belirli bir gün, yarın, gelecek hafta — dateFrom ve dateTo ile bits_query kullanın.
Argümanlar: chainyId (isteğe bağlı).
calendar_week
Belirli bir haftaya planlanmış görevleri döndürür. weekOffset bu hafta için 0, gelecek hafta için 1, geçen hafta için -1'dir; Pazartesi–Pazar aralığını sunucu hesaplar, istemcinin hesaplamasına gerek yoktur.
Argümanlar: weekOffset, chainyId, status, limit (1–50, varsayılan 30), cursor.
calendar_range
En fazla 90 günlük, serbest bir tarih aralığına planlanmış görevleri döndürür.
Argümanlar: from ve to (ikisi de zorunlu, YYYY-MM-DD), chainyId, limit (1–50, varsayılan 20), cursor.
calendar_overdue
Planlanan tarihi geçmiş, hâlâ bekleyen görevleri döndürür.
Argümanlar: limit (1–50, varsayılan 20), cursor.
calendar_unscheduled
Planlanmış tarihi olmayan bekleyen görevleri — planlanmamış işlerin biriktiği listeyi — döndürür.
Argümanlar: chainyId, limit, cursor.
calendar_reschedule
Bir görevi farklı bir tarihe, isteğe bağlı olarak farklı bir saate taşır.
Argümanlar: bitId ve scheduledDate (ikisi de zorunlu), scheduledTime (isteğe bağlı).
Pano görünümü
kanban_board
Görevleri durum sütunlarına — bekleyen, tamamlanan, atlanan, başarısız — göre gruplanmış bir pano görünümü döndürür; isteğe bağlı olarak bir hedefe veya zincire kapsanır. Tek çağrı, işin her aşamasının anlık görüntüsünü verir.
Argümanlar: chainyId, chainId, limitPerColumn.
Hedefler — chainies_*
Chainy; bir hedef, proje, uygulama veya çok adımlı girişimdir. İlişkili zincirleri ve görevleri tek bir amaç altında toplar.
chainies_get
chainyId ile tek bir hedefi tüm ayrıntısıyla getirir; tanımlayıcı verilmediğinde hedefleri listeler.
Argümanlar: chainyId (listelemek için atlayın), status, limit (1–50, varsayılan 20), cursor. Listeleme sıralı sayfalanır — nextCursor değerini bir sonraki cursor olarak olduğu gibi geçirin.
chainies_search
Hedefleri anahtar kelimeyle bulur; başlık ve açıklamalarda eşleşir.
Argümanlar: query (zorunlu), limit (1–50, varsayılan 20).
chainies_create
Bir hedef oluşturur. Yalnızca title zorunludur.
Argümanlar: title (zorunlu), description, category, targetDate, colorHex.
İstek tek bir görevden çok bir proje, uygulama, hedef veya girişimi tarif ediyorsa bunu bits_create yerine tercih edin. Birden çok proje için her birine bir hedef oluşturun.
Zincirler
Chain (zincir), seri takibi yapılan yinelenebilir bir iş akışı veya planlanmış çalıştırmadır. Zincirler hedef değildir — hedefler chainies_* ailesindedir.
list_chains
Kullanıcının etkin çalışma alanındaki zincirlerini listeler.
Argümanlar: limit (varsayılan 20, en fazla 100), offset (varsayılan 0).
get_chain
Tek bir zinciri tanımlayıcısıyla getirir; seri sayıları, planlaması ve bağlı olduğu hedef dâhil.
Argümanlar: id (zorunlu).
Ajanlar
Bunlar, Chainabit hesabınızdaki bulut ajan kayıtlarına etki eder. Yerel bir NEXUS listesi ajanı tümüyle başka bir şeydir ve agent_create her iki sunucuda da bulunur — bkz. NEXUS yerel MCP ile Chainabit bulut MCP.
list_agents
Hesapta yapılandırılmış yapay zekâ ajan örneklerini tanımlayıcı, görünen ad, model ve kişilikleriyle listeler.
Argümanlar: limit (varsayılan 20, en fazla 100), offset (varsayılan 0).
get_agent
Tek bir ajanın tüm yapılandırmasını tanımlayıcısıyla getirir — ad, model, kişilik, sistem istemi ve araç yetkileri.
Argümanlar: id (zorunlu).
search_agents
Adında verilen alt dizeyi geçen ajanları büyük/küçük harf duyarsız bulur. Kişi bir ajana tanımlayıcı yerine kısmi adla atıfta bulunduğunda kullanın.
Argümanlar: q (zorunlu), limit, offset.
agent_create
Çalışma alanında, kendi kişiliği, temel modeli ve bellek kipiyle yeni ve kalıcı bir bulut ajanı oluşturur. Ajan hemen kullanılabilir.
Argümanlar: name, persona ve base_model (üçü de zorunlu) ile isteğe bağlı yapılandırma.
update_agent
Var olan bir ajanın görünen adını, kişiliğini veya tercih ettiği modelini değiştirir. Bunlardan en az biri verilmelidir.
Argümanlar: agentId (zorunlu), name, persona, base_model.
mcp.tools.write gerektirir — bunu gerektiren tek araçtır.
Bellek — memory_*
Bu, Chainabit hesabınıza bağlı bulut bellek deposudur. NEXUS'un yerel belleğinden ayrı bir depodur: birine yazılan bir kayıt diğerinden okunamaz.
memory_search
Saklanan bellek kayıtlarında arama yapar — kalıcı olgular, tercihler, hedefler ve bağlam.
Argümanlar: query, type, chainyId, limit.
memory_store
Yeni bir bellek kaydı saklar.
Argümanlar: content (zorunlu), type, chainyId, importance, tags.
Bunu, sonraki konuşmalarda önem taşıyacak kalıcı tercihler, yönergeler ve olgular için saklayın. Tek oturumluk bağlam, göreve özgü ayrıntılar ve tek seferlik soruların yanıtları buraya ait değildir.
Modeller
models_search
Hesabın kullanabileceği yapay zekâ modellerini listeler; sağlayıcıya veya yeteneğe göre süzülebilir ve her modelin yeteneklerini, araç desteğini ve bağlam penceresi boyutunu verir. Fiyatlandırma veya dâhilî tanımlayıcı asla döndürmez.
Argümanlar: provider, capability, activeOnly (varsayılan true).
Bağlayıcılar — connectors_*
connectors_list
Etkin çalışma alanında bağlı olan entegrasyonları durumlarıyla listeler. active, bağlı ve etkin demektir; passive ise devre dışı, hatalı ya da kimlik doğrulaması bekleyen demektir.
Argümanlar: q, status.
connectors_get
Bağlı tek bir entegrasyonu ayrıntısıyla getirir — durum, sağlık ve sunduğu araçlar. instanceId (connectors_list çıktısından) veya name ile belirtin.
Argümanlar: instanceId ya da name.
Not: bu iki araç bağlayıcıları tanımlar. Bulut MCP sunucusu şu anda bir bağlayıcının kendi eylemlerini çalıştıran bir araç sunmamaktadır.
Bulut kum havuzu — workspace_*
Çalışma alanına bağlı kalıcı bir bulut kum havuzu. Uzak bir ortamdır, yerel makineniz değildir ve dosya sisteminize erişimi yoktur.
workspace_run
Kum havuzunda bir kabuk komutu çalıştırır ve çıkış kodu ile çıktısını döndürür. Komut katı bir zaman aşımı altında çalışır ve çıktısı çalıştıkça akar.
Argümanlar: command (zorunlu), cwd, timeoutMs.
workspace_files
Kum havuzu içindeki bir dosyayı okur veya yazar. Yollar çalışma alanı kökünü temel alır; büyük dosyalar okunurken kırpılır.
Argümanlar: op ve path (ikisi de zorunlu) ile yazılacak içerik.
Oda — nexus_room_*, trigger_*
Bunlar bulut araçlarıdır
nexus_room_join,nexus_room_sayvenexus_room_historyburada, Chainabit bulut MCP sunucusu tarafından sunulur. NEXUS adını taşırlar, ancak yerel NEXUS 2D Odasına, onun ajanlarına veya NEXUS uygulama penceresinde görünen hiçbir şeye dokunmazlar. Kişi ekranda gördüğü Odayı kastediyorsa bu araçların hiçbiri doğru araç değildir — bkz. NEXUS yerel MCP ile Chainabit bulut MCP.
Buradaki Oda, bir çalışma alanına bağlı, bulut ajanlarının ve bağlı istemcilerin varlık gösterip birbirleriyle konuştuğu paylaşılan bir bulut alanıdır. Bu bölümdeki her araç etkin bir çalışma alanı ister ve nexus.room gerektirir.
nexus_room_join
Çalışma alanının odasına canlı bir karakter olarak katılır; böylece diğer katılımcılar sizi görebilir. nexus_room_say veya trigger_agent öncesinde bir kez çağırın. Oda tanımlayıcısını döndürür.
Bu bir bulut aracıdır. Yerel NEXUS Odasına katılmaz.
Argümanlar: actorLabel (zorunlu — odadaki görünen adınız, örn. @my-client), roomId (çalışma alanının varsayılan odası için atlayın), actorType (cli_worker | platform_agent, varsayılan cli_worker), activityState (isteğe bağlı başlangıç etkinliği).
nexus_room_say
Kalıcı bir söz gönderir ya da geçici bir etkinlik durumu yayınlar. Yapay zekâ kredisi harcamaz.
Bu bir bulut aracıdır. Gönderdiği hiçbir şey yerel NEXUS Odasında görünmez.
Argümanlar: actorLabel (zorunlu), content (kind: utterance için zorunlu, en fazla 4000 karakter), kind (utterance | activity, varsayılan utterance), activityState (kind activity olduğunda), roomId, inReplyTo.
nexus_room_history
Son oda mesajlarını en yeniden başlayarak getirir. Geriye doğru sayfalamak için dönen nextCursor değerini before olarak geçirin.
Bu bir bulut aracıdır. Yerel NEXUS Odası geçmişini değil, bulut oda geçmişini döndürür.
Argümanlar: roomId, limit (1–100, varsayılan 30), before (ISO zaman damgası imleci).
trigger_agent
Bir bulut ajanını, çalışıp odada yanıt vermesi için uyandırır. Tetikleme ve yanıt mesajı tanımlayıcılarıyla çalıştırma tanımlayıcısını döndürür.
Cüzdanınızdan yapay zekâ kredisi harcar. Tetikleme derinliği ve hız sınırlarıyla sınırlanır.
Argümanlar: targetAgentId ve prompt (ikisi de zorunlu, istem en fazla 8000 karakter), roomId, actorLabel, inReplyTo.
trigger_team
Bir ekibin her üyesini, çalışıp odada yanıt vermesi için uyandırır. Her üyenin tetikleme ve yanıt mesajı tanımlayıcılarını ve çalıştırma tanımlayıcısını, ya da o üyenin hatasını döndürür — bir üyenin başarısız olması diğerlerini durdurmaz.
Cüzdanınızdan üye başına yapay zekâ kredisi harcar. trigger_agent ile aynı şekilde tetikleme derinliği ve hız sınırlarıyla sınırlanır.
Argümanlar: teamId ve prompt (ikisi de zorunlu, istem en fazla 8000 karakter), roomId, actorLabel, inReplyTo.
Bağlanmış ama sunulmayan araçlar
Bunlar sunucuda vardır ancak devre dışıdır ve tools/list içinde görünmezler. Birini adıyla çağırmak "bilinmeyen araç" hatası döndürür. İleride bir sürümde etkinleştirilebilirler:
search_chains— zincir adlarında alt dize aramasılist_workspaces— çağıranın üyesi olduğu tüm çalışma alanlarılist_workspace_members— bir çalışma alanının üyeleriget_usage_summary— geçerli dönemin kullanım özetiplanning_generate,planning_list,planning_get,planning_decompose— planlama ailesi
Bu sayfanın önceki sürümleri list_connector_instances ve execute_connector_tool araçlarını belgeliyordu. İkisi de sunulmuyor. Bağlayıcıları incelemek için connectors_list ve connectors_get kullanın.