推荐入口：原生 MCP stdio
安装包内置 chunfeng mcp。它不依赖 Node 启动脚本，MCP 客户端可以直接把 Mycel app binary 当作 stdio server。
chunfeng 是 Mycel 的内部可执行名（crate / bundle binary），MCP 配置里请照抄，不要改成 mycel——改了会连不上。
{
"mcpServers": {
"chunfeng": {
"type": "stdio",
"command": "/Applications/Mycel.app/Contents/MacOS/chunfeng",
"args": ["mcp"]
}
}
}Codex 配置
Codex 使用 TOML 片段：
[mcp_servers.chunfeng]
command = "/Applications/Mycel.app/Contents/MacOS/chunfeng"
args = ["mcp"]Agent 支持矩阵
| Agent | 当前可用路径 | 边界 |
|---|---|---|
| Claude Code | 通用 MCP JSON；设置面板提供注册状态。 | 真实写配置后建议在本机重启客户端验证。 |
| Codex | Codex TOML；交付记录里覆盖了配置片段与探测逻辑。 | 需要用户自己的 Codex 环境。 |
| OpenCode | 设置面板包含 OpenCode provider 与 probe 入口。 | 按通用 MCP 行为排障。 |
| Pi | 支持本地 CLI 探测与 AI 工作台选择。 | 模型发现来自本机配置；未登录时只显示未认证状态。 |
| Gemini CLI | 可按通用 MCP 客户端接入。 | 仓库里有活动识别与展示色标，不等同于一键安装。 |
| Kiro | 可按通用 MCP 客户端接入。 | 仓库里有活动识别与展示色标，不等同于一键安装。 |
| Hermes Agent | 可按通用 MCP 客户端接入，并支持已验证模型参数。 | 仍需要你自己安装并登录对应 CLI。 |
| exo | 可按通用 MCP 客户端接入。 | 仓库里有活动识别与展示色标，不等同于一键安装。 |
| CodeBuddy Code | 可被探测并在工作台显示。 | 当前只承诺探测与状态展示。 |
| WorkBuddy | 可被探测并在工作台显示。 | 当前只承诺探测与状态展示。 |
| ZCode | 支持本地模型配置发现。 | 模型行只展示已发现配置，不发明未验证 flag。 |
| Qwen Code | 可被探测并在工作台显示。 | 当前只承诺探测与状态展示。 |
| Cursor CLI | 支持通用 MCP stdio 配置与本地模型配置发现。 | 发现只读取已验证 schema，不接受泛称“任意 JSON”。 |
| GitHub Copilot CLI | 可被探测并在工作台显示。 | 当前只承诺探测与状态展示。 |
| Aider | 可被探测并在工作台显示。 | 当前只承诺探测与状态展示。 |
| Amp | 可被探测并在工作台显示。 | 当前只承诺探测与状态展示。 |
工具边界
当前 MCP 文档列出 20 个工具，覆盖 vault 上下文、搜索、提案、动作指导、候选记忆、结果回看等。写入类工具遵循提案契约：创建或修改笔记时先生成提案，等待用户在 Mycel 里审批。
若只需要读取上下文，优先使用 vault map、search 和 get_note 类工具；若要改内容，使用 propose 类工具。
AI 工作台与本地模型发现
Mycel 的 AI 工作台支持在多 agent 之间切换目标，并在有本地配置时显示该 agent 已发现的模型目录。发现是只读的，不会替你写配置，也不会发明命令行参数。
- 当前只从五类本地配置发现模型：Codex、Claude Code、ZCode、Cursor CLI、Pi。
- 其中只有 Claude Code、Codex、Cursor CLI、Hermes Agent、Pi 的模型参数路径经过验证；不支持模型 flag 的 agent 会在工作台中禁用具体模型行。
- ZCode 只接受已观察到的
{'{'} model: {'{'} main, lite {'}'} {'}'}配置形状；其他形状会被忽略，而不是猜测语义。 - Cursor CLI 只读取
.cursor/cli-config.json的已验证字段；不要把任意 MCP JSON 配置误当成模型目录来源。 - 发现不到模型时，工作台会回退到静态默认选项；这不等于 agent 不可用，只表示本机未暴露可验证的模型配置。
BYOK 与费用
Mycel 不把外部 LLM token 打包进产品。你使用自己的 agent 与模型账号，Mycel 只负责本地库、审批队列和 MCP bridge。
Bridge 排障
- 先确认 Mycel 桌面端正在运行。
- 再检查 MCP 设置面板的客户端状态与 bridge 状态。
- 若工作台里的 agent 已安装但模型列表为空，优先区分“未登录”“无本地配置”“该 agent 不支持模型 flag”三种情况。
- 若客户端已经读到配置但工具不可见，重启对应 agent 客户端。
- 若二进制路径不存在，重新安装 Mycel 或改用当前安装路径。
