Documentation / MCP et ACP

Yuli comme serveur MCP

Comment yuli-mcp expose tout l’IDE à votre agent de terminal, comment il se connecte et ce qui se passe lorsque Yuli est fermé.

Yuli inclut yuli-mcp, un serveur du Model Context Protocol (MCP). Grâce à lui, Claude Code, Kiro, Codex et Antigravity utilisent l’IDE complet sous forme d’outils : compiler, tester, vérifier, naviguer dans le code, interroger la base de données, piloter Web Studio et suivre la mission.

En mode abonnement, vous n’avez rien à configurer : Yuli enregistre yuli-mcp dans chaque agent au démarrage de celui-ci. Cette page explique son fonctionnement interne.

Comment il se connecte

Tu agente  ──stdio / JSON-RPC 2.0──▶  yuli-mcp  ──TCP 127.0.0.1 + token──▶  Yuli (motor)
Élément Détail
Transport avec l’agent MCP via stdio, JSON-RPC 2.0, un message JSON par ligne.
Versions du protocole 2025-06-18, 2025-03-26 et 2024-11-05.
Capacités Outils. Les ressources et les prompts reçoivent une réponse vide.
Connexion avec l’IDE Socket TCP uniquement en loopback (127.0.0.1), sur un port aléatoire.
Authentification Un jeton de session propre à Yuli dans chaque requête. Ce n’est pas un identifiant d’Anthropic ni d’aucun fournisseur.
Tâches longues Envoie des notifications de progression. Un appel peut durer jusqu’à 40 minutes.

Le fichier de connexion

Au démarrage, le moteur écrit endpoint.json avec le port, le jeton et son processus. Sous Linux et macOS, seul votre utilisateur peut lire ce fichier.

Système Chemin
Windows %APPDATA%\.yulicode\claude-bridge\endpoint.json
macOS ~/Library/Application Support/.yulicode/claude-bridge/endpoint.json

Lorsque Yuli ouvre le terminal d’un agent, il lui transmet en outre le port et le jeton via des variables d’environnement, ainsi que la racine du projet.

Un binaire stable

Les agents lancent une copie stable de yuli-mcp située dans le dossier local de Yuli (sous Windows, %LOCALAPPDATA%\.yulicode\bin\yuli-mcp.exe). Elle survit aux mises à jour de Yuli : la configuration de l’agent ne se casse donc pas lors d’une mise à jour.

Si Yuli est fermé

Les outils yuli_* fonctionnent tant que Yuli est ouvert avec ce projet. Sinon :

  • La liste des outils ne propose que yuli_status, qui en explique la raison.
  • Un appel répond : « 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. »
  • Les hooks se terminent sans rien bloquer : votre agent continue de fonctionner.
  • La ligne d’état de Claude Code affiche ◆ Yuli · desconectado.

Si /mcp dans Claude Code affiche yuli en erreur, ouvrez le projet dans Yuli. Les outils réapparaissent d’eux-mêmes.

Sous-commandes

Commande À quoi elle sert
yuli-mcp mcp --project <raíz> Le serveur MCP. C’est le mode par défaut.
yuli-mcp hook <Evento> --project <raíz> Transmet un hook de l’agent à Yuli.
yuli-mcp gate --project <raíz> --stage <etapa> Exécute le gate de qualité. Renvoie 0, 1 ou 2.
yuli-mcp --version Affiche la version.

L’option --agent kiro|codex|antigravity identifie l’agent appelant. Ainsi, chaque agent dispose de sa propre conversation, de sa propre mission et de sa propre fenêtre des modifications.

Combien d’outils votre agent reçoit-il ?

Il reçoit tout ce que le mode Platform peut utiliser dans ce projet : un noyau d’outils nommés et le reste du moteur. Le total dépend du projet : les outils d’une fonctionnalité inactive sont masqués (par exemple, ceux de base de données s’il n’y a aucune connexion, ou ceux de Sonar s’il n’est pas lié).

Le nombre exact apparaît dans la barre de l’agent : Connecté à Yuli · N outils.

Seuls six outils internes, propres au cycle de Yuli, sont exclus : proposer des modifications, lancer des sous-agents, rechercher des outils, poser une question, publier le plan et le mettre à jour. Votre agent dispose des siens, et son plan est reflété dans Yuli via yuli_progress.

Voir le catalogue dans Outils de Yuli.

Les mêmes garde-fous

Chaque appel passe par les mêmes règles que l’agent intégré :

  • Autorisation et cartes d’approbation dans Yuli.
  • Hooks du projet.
  • Git, CI et DevOps uniquement si vous l’avez demandé.
  • Secrets protégés.
  • « Arrête-toi » signifie arrête-toi.

Les résultats apparaissent dans les panneaux de Yuli (Exécution, Tests, Problèmes) et comptent comme vérification.

Connecteurs externes

Si vous avez configuré des serveurs MCP dans Yuli (Outils → Serveurs MCP… : GitHub, GitLab, Jenkins, CloudBees, Jira, SonarQube…), votre agent les reçoit aussi via yuli-mcp, sous la forme yuli_mcp_<servicio>_<herramienta>. Les outils de lecture s’exécutent librement ; ceux qui écrivent demandent une approbation et ne s’exécutent jamais en mode autonome.