Documentación / MCP y ACP
Yuli como servidor MCP
Cómo yuli-mcp expone todo el IDE a tu agente de terminal, cómo se conecta y qué pasa si Yuli está cerrado.
Yuli incluye yuli-mcp, un servidor del Model Context Protocol (MCP). Con él, Claude Code, Kiro, Codex y Antigravity usan el IDE completo como herramientas: compilar, probar, verificar, navegar el código, consultar la base de datos, operar Web Studio y seguir la misión.
En Modo suscripción no tienes que configurar nada: Yuli registra yuli-mcp en cada agente al iniciarlo. Esta página explica cómo funciona por dentro.
Cómo se conecta
Tu agente ──stdio / JSON-RPC 2.0──▶ yuli-mcp ──TCP 127.0.0.1 + token──▶ Yuli (motor)
| Pieza | Detalle |
|---|---|
| Transporte con el agente | MCP por stdio, JSON-RPC 2.0, un mensaje JSON por línea. |
| Versiones del protocolo | 2025-06-18, 2025-03-26 y 2024-11-05. |
| Capacidades | Herramientas. Recursos y prompts se responden vacíos. |
| Conexión con el IDE | Socket TCP solo en loopback (127.0.0.1), en un puerto aleatorio. |
| Autenticación | Un token de sesión propio de Yuli en cada petición. No es una credencial de Anthropic ni de ningún proveedor. |
| Tareas largas | Envía notificaciones de progreso. Una llamada puede durar hasta 40 minutos. |
El archivo de conexión
Al arrancar, el motor escribe endpoint.json con el puerto, el token y su proceso. En Linux y macOS el archivo solo lo puede leer tu usuario.
| Sistema | Ruta |
|---|---|
| Windows | %APPDATA%\.yulicode\claude-bridge\endpoint.json |
| macOS | ~/Library/Application Support/.yulicode/claude-bridge/endpoint.json |
Cuando Yuli abre la terminal de un agente, le pasa además el puerto y el token por variables de entorno, junto con la raíz del proyecto.
Un binario estable
Los agentes arrancan una copia estable de yuli-mcp en la carpeta local de Yuli (en Windows, %LOCALAPPDATA%\.yulicode\bin\yuli-mcp.exe). Sobrevive a las actualizaciones de Yuli, así que la configuración del agente no se rompe al actualizar.
Si Yuli está cerrado
Las herramientas yuli_* funcionan mientras Yuli está abierto con ese proyecto. Si no lo está:
- La lista de herramientas ofrece solo
yuli_status, que explica el motivo. - Una llamada responde: «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.»
- Los hooks salen sin bloquear nada: tu agente sigue funcionando.
- La línea de estado de Claude Code muestra
◆ Yuli · desconectado.
Si /mcp en Claude Code muestra yuli con error, abre el proyecto en Yuli. Las herramientas reaparecen solas.
Subcomandos
| Comando | Para qué |
|---|---|
yuli-mcp mcp --project <raíz> |
El servidor MCP. Es el modo por defecto. |
yuli-mcp hook <Evento> --project <raíz> |
Reenvía un hook del agente a Yuli. |
yuli-mcp gate --project <raíz> --stage <etapa> |
Ejecuta el gate de calidad. Devuelve 0, 1 o 2. |
yuli-mcp --version |
Muestra la versión. |
La opción --agent kiro|codex|antigravity identifica qué agente llama. Así cada agente tiene su propia conversación, misión y ventana de cambios.
Cuántas herramientas recibe tu agente
Recibe todo lo que el Modo Platform puede usar en ese proyecto: un núcleo de herramientas con nombre propio y el resto del motor. El total depende del proyecto: las herramientas de una capacidad que no está activa se ocultan (por ejemplo, las de base de datos si no hay conexiones, o las de Sonar si no está vinculado).
El número exacto aparece en la barra del agente: Conectado a Yuli · N herramientas.
Quedan fuera solo seis herramientas internas del ciclo propio de Yuli: proponer cambios, lanzar subagentes, buscar herramientas, preguntar, publicar el plan y actualizarlo. Tu agente tiene las suyas, y su plan se refleja en Yuli con yuli_progress.
Ver el catálogo en Herramientas de Yuli.
Las mismas guardas
Cada llamada pasa por las mismas reglas que el agente propio:
- Autorización y tarjetas de aprobación en Yuli.
- Hooks del proyecto.
- Git, CI y DevOps solo si lo pediste.
- Secretos protegidos.
- «Detente» significa detente.
Los resultados aparecen en los paneles de Yuli (Ejecución, Tests, Problemas) y cuentan como verificación.
Conectores externos
Si configuraste servidores MCP en Yuli (Herramientas → Servidores MCP…: GitHub, GitLab, Jenkins, CloudBees, Jira, SonarQube…), tu agente también los recibe a través de yuli-mcp, como yuli_mcp_<servicio>_<herramienta>. Las herramientas de lectura corren libres; las que escriben piden aprobación y nunca corren desatendidas.