Dokumentation / MCP und ACP

Yuli als MCP-Server

Wie yuli-mcp die gesamte IDE für deinen Terminal-Agenten bereitstellt, wie die Verbindung zustande kommt und was passiert, wenn Yuli geschlossen ist.

Yuli enthält yuli-mcp, einen Server für das Model Context Protocol (MCP). Damit nutzen Claude Code, Kiro, Codex und Antigravity die komplette IDE als Werkzeuge: kompilieren, testen, verifizieren, durch den Code navigieren, die Datenbank abfragen, Web Studio bedienen und die Mission verfolgen.

Im Abo-Modus musst du nichts konfigurieren: Yuli registriert yuli-mcp bei jedem Agenten, wenn er gestartet wird. Diese Seite erklärt, wie es intern funktioniert.

Wie die Verbindung funktioniert

Tu agente  ──stdio / JSON-RPC 2.0──▶  yuli-mcp  ──TCP 127.0.0.1 + token──▶  Yuli (motor)
Baustein Detail
Transport zum Agenten MCP über stdio, JSON-RPC 2.0, eine JSON-Nachricht pro Zeile.
Protokollversionen 2025-06-18, 2025-03-26 und 2024-11-05.
Fähigkeiten Werkzeuge. Ressourcen und Prompts werden leer beantwortet.
Verbindung zur IDE TCP-Socket nur auf Loopback (127.0.0.1), auf einem zufälligen Port.
Authentifizierung Ein Yuli-eigenes Sitzungstoken bei jeder Anfrage. Es ist keine Zugangsberechtigung von Anthropic oder einem anderen Anbieter.
Lange Aufgaben Sendet Fortschrittsbenachrichtigungen. Ein Aufruf kann bis zu 40 Minuten dauern.

Die Verbindungsdatei

Beim Start schreibt die Engine endpoint.json mit Port, Token und ihrem Prozess. Unter Linux und macOS kann nur dein Benutzer die Datei lesen.

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

Wenn Yuli das Terminal eines Agenten öffnet, übergibt es ihm außerdem Port und Token über Umgebungsvariablen, zusammen mit dem Projektstammverzeichnis.

Eine stabile Binärdatei

Die Agenten starten eine stabile Kopie von yuli-mcp im lokalen Yuli-Ordner (unter Windows %LOCALAPPDATA%\.yulicode\bin\yuli-mcp.exe). Sie übersteht Updates von Yuli, sodass die Konfiguration des Agenten beim Aktualisieren nicht kaputtgeht.

Wenn Yuli geschlossen ist

Die yuli_*-Werkzeuge funktionieren, solange Yuli mit diesem Projekt geöffnet ist. Ist das nicht der Fall:

  • Die Werkzeugliste bietet nur yuli_status an, das den Grund erklärt.
  • Ein Aufruf antwortet: „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.“
  • Die Hooks beenden sich, ohne etwas zu blockieren: Dein Agent funktioniert weiter.
  • Die Statuszeile von Claude Code zeigt ◆ Yuli · desconectado.

Wenn /mcp in Claude Code yuli mit Fehler anzeigt, öffne das Projekt in Yuli. Die Werkzeuge erscheinen von selbst wieder.

Unterbefehle

Befehl Wofür
yuli-mcp mcp --project <raíz> Der MCP-Server. Das ist der Standardmodus.
yuli-mcp hook <Evento> --project <raíz> Leitet einen Hook des Agenten an Yuli weiter.
yuli-mcp gate --project <raíz> --stage <etapa> Führt das Qualitäts-Gate aus. Gibt 0, 1 oder 2 zurück.
yuli-mcp --version Zeigt die Version an.

Die Option --agent kiro|codex|antigravity gibt an, welcher Agent aufruft. So hat jeder Agent seine eigene Unterhaltung, Mission und sein eigenes Änderungsfenster.

Wie viele Werkzeuge dein Agent erhält

Er erhält alles, was der Platform-Modus in diesem Projekt nutzen kann: einen Kern von Werkzeugen mit eigenem Namen und den Rest der Engine. Die Gesamtzahl hängt vom Projekt ab: Werkzeuge einer Fähigkeit, die nicht aktiv ist, werden ausgeblendet (zum Beispiel die Datenbankwerkzeuge, wenn es keine Verbindungen gibt, oder die Sonar-Werkzeuge, wenn Sonar nicht verknüpft ist).

Die genaue Zahl steht in der Agentenleiste: Mit Yuli verbunden · N Werkzeuge.

Außen vor bleiben nur sechs interne Werkzeuge aus Yulis eigenem Zyklus: Änderungen vorschlagen, Subagenten starten, Werkzeuge suchen, Fragen stellen, den Plan veröffentlichen und ihn aktualisieren. Dein Agent hat dafür seine eigenen, und sein Plan wird in Yuli über yuli_progress gespiegelt.

Den Katalog findest du unter Yuli-Werkzeuge.

Dieselben Schutzmechanismen

Jeder Aufruf durchläuft dieselben Regeln wie der eigene Agent:

  • Freigabe und Genehmigungskarten in Yuli.
  • Hooks des Projekts.
  • Git, CI und DevOps nur, wenn du es verlangt hast.
  • Geschützte Geheimnisse.
  • „Stopp“ heißt Stopp.

Die Ergebnisse erscheinen in den Panels von Yuli (Ausführung, Tests, Probleme) und zählen als Verifizierung.

Externe Konnektoren

Wenn du in Yuli MCP-Server konfiguriert hast (Werkzeuge → MCP-Server…: GitHub, GitLab, Jenkins, CloudBees, Jira, SonarQube …), erhält dein Agent sie ebenfalls über yuli-mcp, als yuli_mcp_<servicio>_<herramienta>. Lesende Werkzeuge laufen frei; schreibende verlangen eine Freigabe und laufen nie unbeaufsichtigt.