支持的 Agent
MUX 的 Agent 数据分为两层：
- 核验定义：57 个逐项核验的 Agent 定义，其中 47 个有稳定的用户级全局 MCP 配置文件，可由 MUX 安全读写；另有 9 个 Skills-only 目标和只读的 Devin。
- 发现目录：来自公开 MCP 客户端目录与官方客户端矩阵，只作为后续核验的数据储备。目录包含 201 条记录，与核验定义合并去重后共保留 212 个 Agent identity，但不再作为单独标签页展示。
对于 MCP 能力，没有确认全局文件路径、顶层键和条目结构的客户端只保留来源数据，不会成为 MCP 可写目标。Skills-only Agent 只有在用户级目录契约另行核验后才会出现。这样可以持续扩大覆盖面，又不会把通用 JSON 猜测写进未知产品配置。
桌面端把 MCP、Model 与 Skill 都视为中央资产：先在顶部 MCPs、Models、Skills 工作区统一创建、导入和维护，再由 Agent 建立消费关系。单个 Agent 页面使用 MCPs → Model → Skills 三个标签，只展示该 Agent 期望使用的中央资产；这里不会创建 MCP、填写 Model、解析 Skill 来源或重新安装 Skill。
消费关系可在 Agent 页面或统一 CLI 中管理：MCP 与 Skills 每个 Agent 可选择多个；原生多模型 Agent 可分配多个 Profile、最多一个 current，单模型 Agent 仍最多一个。中央资产详情只负责资产生命周期和只读影响范围，不反向修改 Agent。MUX 再把 Agent 文件或 Skill link 作为 observed state 对账；仅在 Agent 中发现的外部配置保持只读，扫描不会静默接管。检测到历史 MCP / Skill 时，可显式纳管并把中央资产与原有消费关系作为同一项可恢复事务导入。
当前共有 15 个 Model target：13 个由 MUX 管理，MiniMax Code 与 Qoder 这 2 个因缺少等价的安全 writer 而保留为 guided target。
已核验列表
以下结果基于截至 2026-07-22 的官方文档、官方源码或签名应用包；Grok Build 使用 xAI 官方文档核验，MiniMax Code 使用官方签名的 3.0.51 macOS 应用包核验。
下表聚焦 MCP 契约：列出 47 个可写目标，并保留 Devin 作为明确的只读对照；Skills-only 定义见下方 Skills 能力与 用户级 Skills。
新 Qoder Desktop 的 MCP 契约于 2026-09-05 按新版官方文档核验。
| Agent | 格式 | 配置键 | 用户级全局路径 | 原生传输 |
|---|---|---|---|---|
| Agentkube | JSON | mcpServers | ~/.agentkube/mcp.json | stdio / http |
| Amp | JSON | amp.mcpServers | ~/.config/amp/settings.json | stdio / http |
| Amazon Q Developer IDE | JSON | mcpServers | ~/.aws/amazonq/default.json | stdio / http |
| Google Antigravity | JSON | mcpServers | ~/.gemini/config/mcp_config.json | stdio / http |
| Augment Code | JSON | mcpServers | ~/.augment/settings.json | stdio / http |
| BoltAI | JSON | mcpServers | ~/.boltai/mcp.json | stdio |
| Claude Code | JSON | mcpServers | ~/.claude.json | stdio / http |
| Claude Desktop | JSON | mcpServers | ~/Library/Application Support/Claude/claude_desktop_config.json | stdio |
| ChatMCP | JSON | mcpServers | ~/Library/Application Support/ChatMcp/mcp_server.json | stdio / http |
| Cline | JSON | mcpServers | ~/.cline/data/settings/cline_mcp_settings.json | stdio / http |
| CodeBuddy Code | JSON | mcpServers | ~/.codebuddy/.mcp.json | stdio / http |
| CodeWhale | JSON | servers | ~/.codewhale/mcp.json | stdio / http |
| Codex | TOML | mcp_servers | ~/.codex/config.toml | stdio / http |
| Continue | YAML | mcpServers | ~/.continue/config.yaml | stdio / http |
| GitHub Copilot CLI | JSON | mcpServers | ~/.copilot/mcp-config.json | stdio / http |
| Crush | JSON | mcp | ~/.config/crush/crush.json | stdio / http |
| Cursor | JSON | mcpServers | ~/.cursor/mcp.json | stdio / http |
| Devin | - | - | 只读目录 | - |
| Factory Droid | JSON | mcpServers | ~/.factory/mcp.json | stdio / http |
| Firebender | JSON | mcpServers | ~/.firebender/firebender.json | stdio / http |
| Gemini CLI | JSON | mcpServers | ~/.gemini/settings.json | stdio / http |
| Goose | YAML | extensions | ~/Library/Application Support/Block/goose/config/config.yaml | stdio / http |
| Grok Build | TOML | mcp_servers | ~/.grok/config.toml | stdio / http |
| Hermes Agent | YAML | mcp_servers | ~/.hermes/config.yaml | stdio / http |
| JetBrains Junie | JSON | mcpServers | ~/.junie/mcp/mcp.json | stdio / http |
| Kilo Code CLI | JSON | mcp | ~/.config/kilo/kilo.jsonc | stdio / http |
| Kimi Code CLI | JSON | mcpServers | ~/.kimi-code/mcp.json | stdio / http |
| Kiro | JSON | mcpServers | ~/.kiro/settings/mcp.json | stdio / http |
| LM Studio | JSON | mcpServers | ~/.lmstudio/mcp.json | stdio / http |
| MiniMax Code | JSON | mcpServers | ~/.mavis/mcp.json | stdio / http |
| Mistral Vibe | TOML | mcp_servers | ~/.vibe/config.toml | stdio / http |
| OpenCode | JSON | mcp | ~/.config/opencode/opencode.json | stdio / http |
| OpenHands CLI | JSON | mcpServers | ~/.openhands/mcp.json | stdio / http |
| Pi Coding Agent | JSON | mcpServers | ~/.pi/agent/mcp.json | stdio / http |
| Qoder IDE | JSON | mcpServers | ~/.qoder/mcp.json | stdio / http |
| Qoder Desktop | JSON | mcpServers | ~/.qoder/settings.json | stdio / http |
| Qoder CLI | JSON | mcpServers | ~/.qoder/settings.json | stdio / http |
| QoderWork | JSON | mcpServers | ~/.qoderwork/mcp.json | stdio / http |
| Qwen Code | JSON | mcpServers | ~/.qwen/settings.json | stdio / http |
| Roo Code | JSON | mcpServers | ~/Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/mcp_settings.json | stdio / http |
| Atlassian Rovo Dev CLI | JSON | mcpServers | ~/.rovodev/mcp.json | stdio / http |
| Stakpak | TOML | mcpServers | ~/.stakpak/mcp.toml | stdio / http |
| Tabnine | JSON | mcpServers | ~/.tabnine/mcp_servers.json | stdio / http |
| Visual Studio Code | JSON | servers | ~/Library/Application Support/Code/User/mcp.json | stdio / http |
| VT Code | TOML | mcp.providers | ~/.vtcode/vtcode.toml | stdio / http |
| Warp | JSON | mcpServers | ~/.warp/.mcp.json | stdio / http |
| Windsurf | JSON | mcpServers | ~/.codeium/windsurf/mcp_config.json | stdio / http |
| Zed | JSON | context_servers | ~/.config/zed/settings.json | stdio / http |
需要特别区分的目标
- Pi：Pi 核心不内置 MCP。MUX 的定义只适用于已安装社区
pi-mcp-adapter的环境，因此界面明确标为社区扩展。 - Devin：产品支持 MCP，但没有核验到稳定的用户级全局文件契约，因此保留在发现数据中，不进入 Agent 选择器。
- QoderWork：用户自定义 MCP 保存在
~/.qoderwork/mcp.json，使用mcpServers；MUX 不修改客户端数据目录中的内置 MCP。远程连接按官方导入格式写为streamable-http或sse。 - Qoder IDE / CLI / Desktop：三个独立入口。IDE（原
qoder）继续使用~/.qoder/mcp.json；新 Desktop（qoder-desktop，0.1.x）与 CLI（qoder-cli）共用~/.qoder/settings.json，修改同名 MCP 会影响两者。Desktop 0.1.8 的自定义 Models 可由 MUX 写入同文件的providers，重启后在会话中选用；CLI 仍通过/model配置；新版 Desktop Skills 的本地写入契约尚未核验。 - Claude Desktop / BoltAI：列出的本地文件只原生支持 stdio。远程 MCP 分别由 Claude Connectors 或 BoltAI 的
mcp-remote方案管理。 - Goose：通用文档示例使用
~/.config/goose/config.yaml，当前 macOS 源码实际采用~/Library/Application Support/Block/goose/config/config.yaml；MUX 按运行时代码定位。 - Grok Build：MCP 与自定义模型共用
~/.grok/config.toml。MUX 分别局部管理mcp_servers、[models].default和独立的 MUX 模型表，支持三种官方 API backend，并保留其他模型、认证、超时、权限和工具策略。认证只写env_key变量名，不写密钥正文。 - MiniMax Code：主配置与 MCP 配置分离，分别是
~/.mavis/config.yaml和~/.mavis/mcp.json。MUX 可安全管理mcpServers；Models 只提供引导，因为当前自定义 provider 会把options.apiKey明文写入 YAML。
Skills 能力
Skills 路径与上表的 MCP 配置路径分别核验，不能互相推断。当前为 45 个具有稳定 user-level 契约的已审计 Agent 声明 Skills 能力；运行时只显示本机安装探针命中的 Agent。没有公开稳定用户级目录、只有项目级目录或仅提供 rules/prompts 的产品继续保持只读或不接入 Skills writer。
Skills 分配按物理目录而不是 Agent 名称执行。~/.agents/skills 现在同时是 Codex、Goose、Warp 与 Zed 的首选目录，也是多个 Agent 的兼容读取目录，因此一次写入可能影响更多已安装产品。MUX 会在审阅页展示真实影响并归一化重复链接。链接指向同一份可写中央内容，消费者侧修改会形成中央 drift；路径矩阵、安装来源、后台安全校验和当前边界见 用户级 Skills。
不同 Agent 的格式差异
MUX 不把所有客户端都当成同一种 mcpServers JSON：
- OpenCode / Kilo 使用
type: local|remote，本地command是数组。 - Codex 使用 TOML 表和
http_headers；Grok Build 使用mcp_serversTOML 表和headers；Mistral Vibe 使用[[mcp_servers]]TOML 列表。 - Continue 使用 YAML 列表并要求根级
name、version、schema；Goose 和 Hermes 也使用各自的 YAML map。 - Gemini / Qwen 使用
httpUrl；Windsurf 和 Antigravity 使用serverUrl。 - Cline 把连接字段放在
transport子对象；Tabnine 把 HTTP 头放在requestInit.headers。 - Rovo、Amazon Q、Augment、OpenHands 等要求显式传输类型；Kimi / Hermes 只在旧 SSE 时写
transport: sse。
每个内置目标有独立 codec。升级时，MUX 会更新官方 schema 元数据，但保留用户对启用状态和全局路径的选择。
安全写入边界
MUX 会在本机解析 Agent 文件，但只把目标 MCP 条目的结构化连接字段提供给界面。完整配置文件不会进入界面、日志、来源缓存或网络，也不会通过“反序列化整份再重写”的方式覆盖用户配置。
- JSON / JSONC 使用语法树定位目标条目，保留注释、缩进、键顺序、其它 server 和其它顶层设置。
- TOML map 与 TOML list 都做局部编辑；YAML map / list 同样保留未受管内容和注释。
enabled、OAuth、超时、工具白名单、审批策略等 Agent 私有字段原样保留。- ChatMCP 文件只要包含 OAuth、token 或 client secret，MUX 就把整个文件视为外部管理并在备份前拒绝写入；敏感条目不会进入 MUX inventory 或备份。
- 无效文档、错误节点类型、重复目标键、YAML 多文档、备份失败或并发修改都会拒绝写入。
- 写前创建独立时间戳备份（Unix 下目录
0700、文件0600），最终通过同目录临时文件原子替换；符号链接目标和原配置文件权限保持不变。
MUX 当前只管理用户级全局配置，不提供项目级写入。
自定义 Agent
桌面 App 的 Agent 选择器旁点 +，或在 TUI 的 Agents 屏幕按 n，可添加 JSON、TOML 或 YAML 的自定义全局目标。自定义目标使用标准 map 布局；只有已核验内置目标会启用产品专属字段转换。内置目标只允许覆盖路径，避免把官方 schema 意外改成不兼容格式。
下一步 → 常见问题