Skip to main content
MCP 服务器和技能扩展 Agent 能做什么、知道什么。两者都在配置中心里管理,都是逐 Agent 启用的。

MCP 服务器

MCP(模型 Context Protocol)服务器为 Agent 提供额外工具。Vibex 支持三种传输方式:

添加步骤

  1. 打开 配置中心 → MCP,点击 新建 MCP 服务。
  2. 填写 名称,选择传输方式。
  3. 按传输方式填写 命令 / 参数 / 环境变量,或 URL / 请求头。
  4. 选择作用域:用户 或 工作区。
  5. 保存,然后在资源卡片上点击 验证。
  6. 在卡片下方的 Agent 启用范围 区域,为需要使用它的 Agent 打开开关。
校验是离线的:它只检查必填字段和 URL 格式(HTTP/SSE 必须以 http:// 或 https:// 开头),不会启动进程,也不会发起网络请求。所以校验通过不代表服务器真的能连上。
MCP 工具可能读取文件、访问网络或修改外部系统。先确认服务器来源和权限,再把它关联到 Agent。

技能

Skill 是一份 SKILL.md 加上它引用的辅助资源,用来给 Agent 补充可复用的领域知识或操作流程。来源可以是:

添加步骤

  1. 打开 配置中心 → 技能,点击 新建技能 或 导入已有技能。
  2. 填写 名称、描述 和 技能说明(也就是 SKILL.md 的正文)。
  3. 保存并 验证。
  4. 在 Agent 启用范围 里为需要的 Agent 打开开关。
配置好后,在输入框中输入 $ 就能查找并插入已启用的 Skill。

导出到 Agent 原生配置

MCP 和技能都可以写入 Agent 自己的配置文件,这样 Agent 的其它入口(例如外部 CLI)也能用上同一份配置。 在资源卡片上使用 预览导出 → 应用 → 回滚:
  1. 预览导出 会列出将要改动或新建的文件。
  2. 确认无误后再 应用。
  3. 出问题时从同一处 回滚 恢复。
写入目标取决于 Agent,例如 Codex 的 ~/.codex/config.toml、Claude 的 ~/.claude/settings.json,以及各 Agent 的技能目录。
应用之前一定要看预览。 Vibex 默认不改写 Agent 的原生 home 配置,只有你明确应用时才写入。

作用域与安全

使用最小作用域,避免把项目专属工具暴露给所有项目。MCP 服务器当前只提供 用户 和 工作区 两种作用域。 任何日志和诊断资料都必须去掉 token、私钥、环境变量值、提示词和文件内容。