文档 / MCP 与 ACP
作为 MCP 服务器的 Yuli
yuli-mcp 如何将整个 IDE 开放给你的终端智能体、如何连接，以及 Yuli 关闭时会发生什么。
Yuli 内置 yuli-mcp，一个 Model Context Protocol（MCP） 服务器。借助它，Claude Code、Kiro、Codex 和 Antigravity 可以把整个 IDE 当作工具来使用：编译、测试、验证、浏览代码、查询数据库、操作 Web Studio 以及跟进任务。
在订阅模式下你无需任何配置：Yuli 会在启动每个智能体时为其注册 yuli-mcp。本页介绍其内部工作原理。
连接方式
Tu agente ──stdio / JSON-RPC 2.0──▶ yuli-mcp ──TCP 127.0.0.1 + token──▶ Yuli (motor)
| 组件 | 说明 |
|---|---|
| 与智能体之间的传输 | 通过 stdio 的 MCP，JSON-RPC 2.0，每行一条 JSON 消息。 |
| 协议版本 | 2025-06-18、2025-03-26 和 2024-11-05。 |
| 能力 | 工具。资源和提示词返回为空。 |
| 与 IDE 的连接 | 仅限 loopback（127.0.0.1）的 TCP 套接字，使用随机端口。 |
| 认证 | 每个请求都携带 Yuli 自己的会话令牌。它不是 Anthropic 或任何提供商的凭据。 |
| 长时间任务 | 发送进度通知。一次调用最长可持续 40 分钟。 |
连接文件
启动时，引擎会写入 endpoint.json，其中包含端口、令牌及其进程信息。在 Linux 和 macOS 上，该文件只有你的用户可以读取。
| 系统 | 路径 |
|---|---|
| Windows | %APPDATA%\.yulicode\claude-bridge\endpoint.json |
| macOS | ~/Library/Application Support/.yulicode/claude-bridge/endpoint.json |
当 Yuli 打开某个智能体的终端时，还会通过环境变量将端口和令牌连同项目根目录一起传给它。
稳定的二进制文件
智能体启动的是位于 Yuli 本地文件夹中的 yuli-mcp 稳定副本（Windows 上为 %LOCALAPPDATA%\.yulicode\bin\yuli-mcp.exe）。它在 Yuli 更新后依然保留，因此智能体的配置不会因更新而失效。
如果 Yuli 已关闭
只要 Yuli 打开了该项目，yuli_* 工具就能正常工作。否则：
- 工具列表只提供
yuli_status，用于说明原因。 - 调用会返回：“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.”
- hooks 会直接退出，不阻止任何操作：你的智能体可以继续工作。
- Claude Code 的状态行显示
◆ Yuli · desconectado。
如果 Claude Code 中的 /mcp 显示 yuli 出错，请在 Yuli 中打开该项目。工具会自动恢复。
子命令
| 命令 | 用途 |
|---|---|
yuli-mcp mcp --project <raíz> |
MCP 服务器。这是默认模式。 |
yuli-mcp hook <Evento> --project <raíz> |
将智能体的 hook 转发给 Yuli。 |
yuli-mcp gate --project <raíz> --stage <etapa> |
运行质量关卡。返回 0、1 或 2。 |
yuli-mcp --version |
显示版本。 |
--agent kiro|codex|antigravity 选项用于标识是哪个智能体在调用。这样，每个智能体都有自己的对话、任务和更改窗口。
你的智能体能获得多少工具
它能获得 Platform 模式在该项目中可以使用的全部工具：一组有专属名称的核心工具，以及引擎的其余能力。总数取决于项目：未启用的能力所对应的工具会被隐藏（例如，没有连接时隐藏数据库工具，未关联 Sonar 时隐藏 Sonar 工具）。
确切数量显示在智能体栏中：已连接 Yuli · N 个工具。
只有六个属于 Yuli 自身循环的内部工具不在其中：提出更改、启动子智能体、查找工具、提问、发布计划和更新计划。你的智能体有自己的同类工具，其计划会通过 yuli_progress 同步显示在 Yuli 中。
完整目录参见 Yuli 工具。
相同的防护机制
每次调用都遵循与 Yuli 自有智能体相同的规则：
- Yuli 中的授权与审批卡片。
- 项目的 hooks。
- 仅在你要求时才使用 Git、CI 和 DevOps。
- 机密受到保护。
- “停下”就是停下。
结果会显示在 Yuli 的面板中（运行、测试、问题），并计为验证。
外部连接器
如果你在 Yuli 中配置了 MCP 服务器（工具 → MCP 服务器…：GitHub、GitLab、Jenkins、CloudBees、Jira、SonarQube……），你的智能体也会通过 yuli-mcp 获得它们，名称形如 yuli_mcp_<servicio>_<herramienta>。只读工具可自由运行；会写入的工具需要批准，且绝不会在无人值守时运行。