Belgeler / MCP ve ACP

MCP sunucusu olarak Yuli

yuli-mcp'nin IDE'nin tamamını terminal ajanınıza nasıl açtığı, nasıl bağlandığı ve Yuli kapalıysa ne olduğu.

Yuli, bir Model Context Protocol (MCP) sunucusu olan yuli-mcp ile birlikte gelir. Bu sayede Claude Code, Kiro, Codex ve Antigravity IDE'nin tamamını araç olarak kullanır: derleme, test etme, doğrulama, kodda gezinme, veritabanını sorgulama, Web Studio'yu kullanma ve görevi izleme.

Abonelik modunda hiçbir şey yapılandırmanız gerekmez: Yuli, her ajanı başlatırken yuli-mcp'yi ona kaydeder. Bu sayfa içeride nasıl çalıştığını açıklar.

Nasıl bağlanır

Ajanınız  ──stdio / JSON-RPC 2.0──▶  yuli-mcp  ──TCP 127.0.0.1 + token──▶  Yuli (motor)
Parça Ayrıntı
Ajanla taşıma katmanı stdio üzerinden MCP, JSON-RPC 2.0, satır başına bir JSON iletisi.
Protokol sürümleri 2025-06-18, 2025-03-26 ve 2024-11-05.
Yetenekler Araçlar. Kaynaklar ve prompt'lar boş yanıtlanır.
IDE ile bağlantı Rastgele bir portta, yalnızca loopback (127.0.0.1) üzerinde TCP soketi.
Kimlik doğrulama Her istekte Yuli'ye ait bir oturum token'ı. Anthropic'in veya herhangi bir sağlayıcının kimlik bilgisi değildir.
Uzun görevler İlerleme bildirimleri gönderir. Bir çağrı 40 dakikaya kadar sürebilir.

Bağlantı dosyası

Motor başlarken port, token ve süreç bilgisini içeren endpoint.json dosyasını yazar. Linux ve macOS'ta dosyayı yalnızca sizin kullanıcınız okuyabilir.

Sistem Yol
Windows %APPDATA%\.yulicode\claude-bridge\endpoint.json
macOS ~/Library/Application Support/.yulicode/claude-bridge/endpoint.json

Yuli bir ajanın terminalini açtığında, port ve token'ı proje köküyle birlikte ortam değişkenleri aracılığıyla da iletir.

Kararlı bir ikili dosya

Ajanlar, Yuli'nin yerel klasöründeki kararlı bir yuli-mcp kopyasını başlatır (Windows'ta %LOCALAPPDATA%\.yulicode\bin\yuli-mcp.exe). Bu kopya Yuli güncellemelerinden etkilenmez; böylece ajanın yapılandırması güncelleme sırasında bozulmaz.

Yuli kapalıysa

yuli_* araçları, Yuli o projeyle açık olduğu sürece çalışır. Açık değilse:

  • Araç listesi yalnızca nedenini açıklayan yuli_status aracını sunar.
  • Bir çağrı şu yanıtı verir: «Yuli Code is not open (or this project isn't open in it). Open the project in Yuli and try again; the Yuli tools work while Yuli is running.»
  • Hook'lar hiçbir şeyi engellemeden çıkar: ajanınız çalışmaya devam eder.
  • Claude Code'un durum satırı ◆ Yuli · bağlı değil gösterir.

Claude Code'da /mcp, yuli için hata gösteriyorsa projeyi Yuli'de açın. Araçlar kendiliğinden yeniden görünür.

Alt komutlar

Komut Ne için
yuli-mcp mcp --project <raíz> MCP sunucusu. Varsayılan mod budur.
yuli-mcp hook <Evento> --project <raíz> Ajanın bir hook'unu Yuli'ye iletir.
yuli-mcp gate --project <raíz> --stage <etapa> Kalite gate'ini çalıştırır. 0, 1 veya 2 döndürür.
yuli-mcp --version Sürümü gösterir.

--agent kiro|codex|antigravity seçeneği hangi ajanın çağırdığını belirtir. Böylece her ajanın kendi konuşması, görevi ve değişiklik penceresi olur.

Ajanınız kaç araç alır

Platform modunun o projede kullanabildiği her şeyi alır: kendi adı olan çekirdek araçlar ve motorun geri kalanı. Toplam sayı projeye bağlıdır: etkin olmayan bir yeteneğin araçları gizlenir (örneğin bağlantı yoksa veritabanı araçları ya da Sonar bağlı değilse Sonar araçları).

Tam sayı ajan çubuğunda görünür: Yuli'ye bağlı · N araç.

Yalnızca Yuli'nin kendi döngüsüne ait altı dahili araç dışarıda kalır: değişiklik önerme, alt ajan başlatma, araç arama, soru sorma, planı yayımlama ve güncelleme. Ajanınızın kendi araçları vardır ve planı yuli_progress ile Yuli'ye yansır.

Kataloğu Yuli araçları sayfasında görün.

Aynı korumalar

Her çağrı, Yuli'nin kendi ajanıyla aynı kurallardan geçer:

  • Yuli'de onay ve onay kartları.
  • Proje hook'ları.
  • Git, CI ve DevOps yalnızca siz istediyseniz.
  • Korunan gizli bilgiler.
  • «Dur» demek durmak demektir.

Sonuçlar Yuli panellerinde (Çalıştırma, Testler, Sorunlar) görünür ve doğrulama olarak sayılır.

Harici bağlayıcılar

Yuli'de MCP sunucuları yapılandırdıysanız (Araçlar → MCP sunucuları…: GitHub, GitLab, Jenkins, CloudBees, Jira, SonarQube…), ajanınız bunları da yuli-mcp üzerinden yuli_mcp_<servicio>_<herramienta> olarak alır. Okuma araçları serbestçe çalışır; yazanlar onay ister ve asla gözetimsiz çalışmaz.