Bir İstemci Bağlama

Bu sayfa, bir CLI kodlama ajanının NEXUS ile bir MCP istemcisi olarak konuşmaya başladığı anı anlatır — yani yalnızca bir terminal bölmesinde kabuk komutları çalıştırmak yerine canvas_* ve agent_* araçlarını çağırmaya başladığı anı. Bu CLI ister NEXUS'un sizin için kendi bölmesinde başlattığı bir CLI olsun, ister tamamen NEXUS dışında çalışan bir CLI süreci olsun, süreç aynıdır. Her iki durumda da CLI'ın kendi yapılandırmasında nexus-mcp'yi işaret eden standart bir stdio MCP sunucu girdisi bulunmalıdır.

Hangi CLI başlığı altında listelenen barındırılan CLI'lar için, CLI etkinleştirilip NEXUS'un AI Providers listesinde algılandığında NEXUS bu girdiyi sizin yerinize otomatik olarak yazar — aşağıdaki Otomatik kurulum bölümüne bakın. MCP uyumlu diğer tüm CLI'lar için girdiyi bu sayfadan yararlanarak kendiniz ekleyin.

Bu sayfaya ne zaman ihtiyaç duyarsınız

Bir komut satırı ajanını NEXUS bölmesinde çalıştırmak, tek başına o ajanı canvas_*/agent_* araçlarına bağlamaz — yalnızca ona bir kabuk verir. Ajanın yapmasını istediğiniz her şey kabuk komutlarıyla ifade edilebiliyorsa orada durabilirsiniz. Bu sayfadaki adımlara, ajanın tuval üzerinde okuma veya çizim yapması ya da bir mesh mesajı başlatması gerektiği anda ihtiyaç duyarsınız — yani kabuk yerine nexus-mcp üzerinden geçen her şeyde.

Sunucu girdisi

MCP uyumlu her CLI, stdio sunucu girdisini kabaca aynı biçimde kabul eder: çalıştırılacak bir komut, isteğe bağlı argümanlar ve bir ortam bloğu. NEXUS'un sunucusu da farklı değildir:

json

{
  "mcpServers": {
    "nexus": {
      "command": "<path to the NEXUS MCP launcher>",
      "args": [],
      "env": {}
    }
  }
}

Üst düzey anahtar adı (yukarıda mcpServers) ve bu bloğun diskte nerede duracağı, yapılandırdığınız CLI tarafından belirlenir — o CLI'ın kendi belgelerine bakın. Girdinin biçimi ise — bir komut, zorunlu argüman yok, zorunlu ortam değişkeni yok — her yerde aynıdır.

Kimlik bilgisi girdinin bir parçası değildir

env alanını boş bırakın. NEXUS, bir loopback adresini veya yetki jetonunu ortam değişkeninden okumaz — oturum çalışmaya başladığında diske oturuma özel bir kimlik bilgisi dosyası yazar ve bağlanan CLI bu dosyayı bağlantı anında okur. Bu dosyanın tam olarak nerede durduğunu, nasıl adlandırıldığını ve bir jetonun neden ortamda dolaşmadığını Yollar ve Kimlik Bilgileri sayfasında bulabilirsiniz: bir ortam değişkeni, oturumun başlattığı her alt süreç tarafından devralınır ve sonradan kapsamı daraltmanın bir yolu yoktur; yalnızca sahibinin okuyabildiği izinlere sahip bir dosya ise yalnızca ona açıkça yönlendirilen bir şey tarafından okunur.

Kimlik bilgisi dosyasına, herhangi bir taşıyıcı jetona davrandığınız gibi davranın. Normal çalışma sırasında yeniden yazılır ve oturum kapandığında silinir — sona ermiş bir oturuma ait referansı elinde tutan bir istemci, orada eskimiş ama çalışan bir jeton değil, kullanılabilir hiçbir şey bulamaz.

Hangi CLI

NEXUS, kendi rayından birkaç CLI kodlama ajanını barındırır — bunların arasında Claude Code, Codex, Gemini CLI ve Chainabit CLI vardır — ve yukarıdaki girdi kendi yapılandırmasında mevcut olduğunda bunların herhangi biri nexus-mcp'nin MCP istemcisi olarak da davranabilir. Aynı stdio girdi biçimi bunların tümü için ve NEXUS tarafından hiç barındırılmayan, bağladığınız MCP uyumlu diğer her CLI için de geçerlidir. Her ürün kendi yapılandırma dosyasını ve üst düzey anahtar için kendi adını kullanır — girdinin gerçekte nerede duracağı için o ürünün kendi belgelerine bakın.

Otomatik kurulum

Şu barındırılan CLI'lar için, her biri AI Providers içinde etkinleştirilip algılandığında girdiyi NEXUS sizin yerinize yazar: Claude Code, Codex, Gemini CLI, Cursor, Antigravity, Kimi Code ve OpenClaw. Diğer her CLI — NEXUS tarafından hiç barındırılmayanlar dâhil — bu sayfadaki elle yapılan adımlara ihtiyaç duyar.

Bundan birkaç sonuç çıkar:

CLI başına, varsayılan olarak açıktır. AI Providers içindeki bu sağlayıcıların her birinin detay sayfasında, o CLI'ın girdisini kendiniz yönetmeyi tercih ederseniz kullanabileceğiniz kendi "NEXUS MCP server" anahtarı, ayrıca canlı bir Connected / Not Connected durumu ve elle bir Reconnect eylemi bulunur.
Bir sağlayıcıyı devre dışı bırakmak arkasını toplar. Bir sağlayıcıyı kapatmak (veya yalnızca MCP anahtarını kapatmak), geride eskimiş bir referans bırakmak yerine NEXUS'un yazdığı girdiyi kaldırır.
Kendini yeniden uygular. Girdi kaybolursa — örneğin CLI'ın yapılandırma dosyasını elle düzenlediyseniz — NEXUS bir sonraki başlatmasında girdiyi yeniden ekler.
Doldurduğu yol, nexus-mcp'nin kendi kurulum konumudur ve NEXUS bu yolu da güncel tutar; otomatik kurulan bir CLI için bu yolu bilmeniz ya da bakımını yapmanız gerekmez.

Bağlantıyı doğrulama

Girdi yerine oturduğunda CLI'ı başlatın ve bir keşif çağrısı yapın. Takılma veya bağlantı reddi yerine bir yanıt alınması, girdinin doğru olduğunu ve hangi protokol dönemini konuştuğunuzu gösterir. Bu çağrının, sunucunun desteklediği her iki dönemde nasıl göründüğü için Protokol Dönemleri sayfasına; bağlandıktan sonra canvas_* ve agent_* araçlarının mevcut olduğunu doğrulamak için Araç Ad Alanları sayfasına bakın.

Temiz bir bağlantıdan sonra bile bir tuval aracı çağrısı kendi gerekçesiyle başarısız olabilir — varsayılan olarak hiçbir rol verilmez. Bkz. Canvas: Roles & Permissions.

Sonraki adımlar

How to expose NEXUS to a CLI — yetkilendirme kontrolü ve ele alınması gereken iki sürüm anlaşması hatası dâhil, numaralandırılmış tam adımlar.
Bir CLI Bağlama — ilk kez yapılan uçtan uca anlatım.
Yollar ve Kimlik Bilgileri — kimlik bilgisi dosyasının konumu, adı ve izinleri.
MCP Protokolü — eksiksiz taşıma ve anlaşma sözleşmesi.

Bir İstemci Bağlama ​

Bu sayfaya ne zaman ihtiyaç duyarsınız ​

Sunucu girdisi ​

Kimlik bilgisi girdinin bir parçası değildir ​

Hangi CLI ​

Otomatik kurulum ​

Bağlantıyı doğrulama ​

Sonraki adımlar ​