Documentación / MCP y ACP
Kiro, Codex y Antigravity
Yuli como cliente ACP y servidor MCP a la vez, para trabajar con tu Kiro, tu Codex o tu Antigravity dentro del IDE.
Además de Claude Code, Yuli trabaja con Kiro, Codex y Antigravity, cada uno con tu propia cuenta. Para ellos, Yuli es un cliente ACP (Agent Client Protocol), igual que otros IDE, y a la vez su servidor MCP.
| Canal | Para qué |
|---|---|
| ACP | Yuli envía tus pedidos y recibe la respuesta en vivo, el razonamiento, los permisos y el plan. |
| MCP | El agente usa las herramientas yuli_*: build, pruebas, verificación, calidad, base de datos, Web Studio… |
Cada agente tiene su propia conversación, misión y ventana de cambios. Cambiar de agente nunca mezcla estados.
Elegir el agente
En el selector ¿Con quién trabajas? de arriba del chat, grupo «Tu suscripción · tu cuenta»:
| Agente | Cuenta |
|---|---|
| Claude Code | Tu cuenta de Claude (Pro, Max o Console). Ver Claude Code. |
| Kiro | Tu AWS Builder ID, Google o GitHub. |
| Codex | Tu cuenta de ChatGPT. |
| Antigravity | Tu cuenta de Google. |
Yuli nunca descarga ni redistribuye estos agentes: detecta el que instalaste.
Kiro
| Paso | Detalle |
|---|---|
| Instalar | Si falta, verás «Instala Kiro CLI para usarlo aquí» con el enlace a kiro.dev/cli y el comando oficial. Requiere la versión 1.28.2 o posterior. |
| Aviso | «Antes de empezar con Kiro»: Kiro usa tu cuenta y tus créditos, y el código que lee viaja a AWS bajo tus términos. |
| Iniciar sesión | Iniciar sesión abre kiro-cli login en una terminal de Yuli. Para máquinas remotas, Usar un código de dispositivo. |
| Reglas | En .kiro/steering/yuli.md y archivos de procedimientos, o con el primer pedido si la configuración está fuera del proyecto. |
Yuli arranca Kiro con kiro-cli acp y autenticación por el propio CLI. El token se queda en Kiro.
Codex
| Paso | Detalle |
|---|---|
| Instalar | npm install -g @openai/codex @agentclientprotocol/codex-acp. Yuli usa el adaptador ACP oficial codex-acp; si solo encuentra codex, te avisa que falta el adaptador. |
| Aviso | «Antes de empezar con Codex». |
| Iniciar sesión | codex login en una terminal de Yuli, o con código de dispositivo. |
| Reglas | En un bloque gestionado de AGENTS.md, o con el primer pedido si la configuración está fuera del proyecto. |
Antigravity
| Paso | Detalle |
|---|---|
| Instalar | Descarga el servidor ACP de Antigravity que publica Google y descomprímelo en ~/.antigravity/acp/. |
| Aviso | «Antes de empezar con Antigravity». |
| Iniciar sesión | No hay CLI de login: el servidor abre la página de Google en tu navegador y la sesión se abre sola. |
| Reglas | En .agent/rules/yuli.md, o con el primer pedido si la configuración está fuera del proyecto. |
Google indica que el acceso a Antigravity con herramientas no oficiales puede incumplir sus términos. Yuli lo muestra en el aviso previo. Revísalos antes de usarlo.
Trabajar con un agente ACP
- Conversación con el diseño de Yuli: la respuesta mientras se escribe, el razonamiento plegable, las herramientas como línea de tiempo, el plan, los archivos cambiados y la verificación.
- Cuadro de texto:
Enterenvía,Shift+Enteragrega una línea,@menciona archivos y/muestra los comandos que anuncia el agente. - Cola: si el agente está trabajando, lo que envíes queda en cola. Detener (o
Esc) cancela el turno. - Modelo, esfuerzo y modo: con las listas que anuncia el propio agente.
- Historial: abre una sesión anterior o empieza una nueva.
- Permisos: cada petición aparece en una tarjeta de Yuli con exactamente las opciones del agente. Yuli nunca inventa una opción ni responde por ti.
Criterio de terminado
Estos agentes no tienen un hook que bloquee el cierre del turno, así que Yuli lo aplica como cliente: si el turno cambió código y la verificación o la medición no están en verde, envía un seguimiento automático breve con lo que falta.
- Se ve en la conversación como mensaje de Yuli.
- Tiene un límite (3 por defecto) y lo puedes desactivar con Seguimientos automáticos, porque usa tus créditos.
- Si la conexión con el agente se cae, Yuli nunca reenvía nada por su cuenta.
Las mismas reglas
Git, CI y DevOps solo si lo pides; ramas solo si las pides; secretos protegidos; estructura y nombres revisados; hooks del proyecto. Las mismas que con Claude Code.
Otros agentes: solo reglas exportadas
Gemini CLI, Cursor y GitHub Copilot no se ejecutan dentro de Yuli. Lo que sí puedes hacer es darles las mismas reglas del proyecto: en el Centro de Gobierno, Agentes → Contexto, exporta a GEMINI.md, .cursor/rules/yuli.mdc y .github/copilot-instructions.md. Ver Gate y Centro de Gobierno.