Documentație / MCP și ACP
Yuli ca server MCP
Cum expune yuli-mcp întregul IDE agentului tău din terminal, cum se conectează și ce se întâmplă dacă Yuli este închis.
Yuli include yuli-mcp, un server Model Context Protocol (MCP). Prin el, Claude Code, Kiro, Codex și Antigravity folosesc întregul IDE ca unelte: compilare, testare, verificare, navigare prin cod, interogarea bazei de date, operarea Web Studio și urmărirea misiunii.
În Modul abonament nu trebuie să configurezi nimic: Yuli înregistrează yuli-mcp în fiecare agent la pornire. Această pagină explică cum funcționează în interior.
Cum se conectează
Agentul tău ──stdio / JSON-RPC 2.0──▶ yuli-mcp ──TCP 127.0.0.1 + token──▶ Yuli (motor)
| Piesă | Detaliu |
|---|---|
| Transportul cu agentul | MCP prin stdio, JSON-RPC 2.0, câte un mesaj JSON pe linie. |
| Versiuni de protocol | 2025-06-18, 2025-03-26 și 2024-11-05. |
| Capabilități | Unelte. Resursele și prompturile primesc răspuns gol. |
| Conexiunea cu IDE-ul | Socket TCP doar pe loopback (127.0.0.1), pe un port aleatoriu. |
| Autentificare | Un token de sesiune propriu Yuli în fiecare cerere. Nu este o credențială Anthropic sau a vreunui furnizor. |
| Sarcini lungi | Trimite notificări de progres. Un apel poate dura până la 40 de minute. |
Fișierul de conexiune
La pornire, motorul scrie endpoint.json cu portul, tokenul și procesul lui. În Linux și macOS, fișierul poate fi citit doar de utilizatorul tău.
| Sistem | Cale |
|---|---|
| Windows | %APPDATA%\.yulicode\claude-bridge\endpoint.json |
| macOS | ~/Library/Application Support/.yulicode/claude-bridge/endpoint.json |
Când Yuli deschide terminalul unui agent, îi transmite în plus portul și tokenul prin variabile de mediu, împreună cu rădăcina proiectului.
Un binar stabil
Agenții pornesc o copie stabilă a yuli-mcp din folderul local Yuli (în Windows, %LOCALAPPDATA%\.yulicode\bin\yuli-mcp.exe). Aceasta supraviețuiește actualizărilor Yuli, așa că configurația agentului nu se strică la actualizare.
Dacă Yuli este închis
Uneltele yuli_* funcționează cât timp Yuli este deschis cu acel proiect. Dacă nu este:
- Lista de unelte oferă doar
yuli_status, care explică motivul. - Un apel primește răspunsul: „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-urile se încheie fără să blocheze nimic: agentul tău continuă să funcționeze.
- Linia de stare din Claude Code afișează
◆ Yuli · desconectado.
Dacă /mcp în Claude Code arată yuli cu eroare, deschide proiectul în Yuli. Uneltele reapar singure.
Subcomenzi
| Comandă | La ce servește |
|---|---|
yuli-mcp mcp --project <raíz> |
Serverul MCP. Este modul implicit. |
yuli-mcp hook <Evento> --project <raíz> |
Redirecționează un hook al agentului către Yuli. |
yuli-mcp gate --project <raíz> --stage <etapa> |
Rulează gate-ul de calitate. Returnează 0, 1 sau 2. |
yuli-mcp --version |
Afișează versiunea. |
Opțiunea --agent kiro|codex|antigravity identifică agentul care face apelul. Astfel, fiecare agent are propria conversație, misiune și fereastră de modificări.
Câte unelte primește agentul tău
Primește tot ce poate folosi Modul Platform în acel proiect: un nucleu de unelte cu nume propriu și restul motorului. Totalul depinde de proiect: uneltele unei capabilități inactive sunt ascunse (de exemplu, cele de bază de date dacă nu există conexiuni sau cele Sonar dacă nu este conectat).
Numărul exact apare în bara agentului: Conectat la Yuli · N unelte.
Rămân pe dinafară doar șase unelte interne ale ciclului propriu Yuli: propunerea modificărilor, lansarea subagenților, căutarea uneltelor, întrebările, publicarea planului și actualizarea lui. Agentul tău le are pe ale lui, iar planul lui se reflectă în Yuli prin yuli_progress.
Vezi catalogul în Uneltele Yuli.
Aceleași protecții
Fiecare apel trece prin aceleași reguli ca agentul propriu:
- Autorizare și carduri de aprobare în Yuli.
- Hook-urile proiectului.
- Git, CI și DevOps doar dacă le-ai cerut.
- Secrete protejate.
- „Oprește-te” înseamnă oprește-te.
Rezultatele apar în panourile Yuli (Rulare, Teste, Probleme) și contează ca verificare.
Conectori externi
Dacă ai configurat servere MCP în Yuli (Instrumente → Servere MCP…: GitHub, GitLab, Jenkins, CloudBees, Jira, SonarQube…), agentul tău le primește și pe acestea prin yuli-mcp, ca yuli_mcp_<servicio>_<herramienta>. Uneltele de citire rulează liber; cele care scriu cer aprobare și nu rulează niciodată nesupravegheat.