跳转到主要内容
MCP（Model Context Protocol）是给 AI Agent 提供工具的一种通用方式：搜索一个文档站、查询数据库、提一个 issue、调用你在用的某个服务。每一组工具由一个 MCP 服务器提供。 在 Avibe 里，一个服务器只需要接一次。之后每个 Agent 都能调用它的工具：歪比（Vibey）、Claude Code、Codex 和 OpenCode 都一样。

Avibe 怎么对待一个服务器

  • 所有 Agent 共用一份列表。 Avibe 把服务器集中放在一处，并告诉每个 Agent 有哪些可用。Agent 在任务需要时查看某个服务器的工具，再通过 vibe mcp 命令调用。
  • 已有的服务器会被自动找到。 如果你在这台电脑上给 Claude Code、Codex 或 OpenCode 配过 MCP 服务器，Avibe 会找到它们并一起列出来。列出和添加都不会改动这些工具自己的配置文件；但在 Avibe 里删除这样一个服务器，会把它从那个工具的配置文件里一并删掉，删除前的确认框会说明这一点。
  • 全局或按项目。 服务器可以在所有地方可用，也可以只在某个项目里可用。

添加服务器

在工作台里打开技能，切到 MCP 标签页，选择添加 MCP。有两种方式：
  • 粘贴 JSON 导入。 把服务器文档里给出的 mcpServers 配置块粘贴进来。
  • 填写。 填上名称和 URL 或命令。填网址就是一个 HTTP 服务器；其他内容会被当作命令，由 Avibe 在你的电脑上启动。服务器需要的话，再加上 Headers 或环境变量。
就像对话框里写的：添加成功后，所有 Agent 都可调用。之后，这个服务器的卡片上会列出它的工具。 Avibe 支持以本地命令运行的服务器（stdio），以及通过 Streamable HTTP 访问的服务器。只支持旧版 SSE 传输的服务器用不了。 只有这个 Avibe 的 Owner 可以添加、配置、批准或删除服务器。

服务器需要你处理的时候

卡片上会写明缺什么：

属于某个项目的服务器

项目可以在根目录放一个 .mcp.json 文件，自带一组服务器，格式和 Claude Code 用的一样。在这个项目里工作的 Agent 除了全局服务器之外还能看到它们；其他项目里的 Agent 看不到。 这样的文件是随仓库一起来的，所以里面的每个服务器一开始都是待批准。文件里对应的条目一旦改动，就需要重新批准。

你填的值存在哪里

你在 Headers、环境变量或配置里填的 token，以及登录之后服务器给你的登录凭证，都保存在你电脑上 Avibe 自己的私有文件里。它们不在你的 Vault 里，而 Agent 和你是同一台电脑上的同一个用户。在项目的 .mcp.json 里，请写成 ${TOKEN} 这样的占位符，再通过配置填入实际的值，这样 token 本身就不会跟着仓库一起提交。

给 Agent 和命令行

Agent 用的，也是你可以自己运行的命令：
vibe mcp-add 可以从命令行添加服务器。完整参考（包括 OAuth 选项和项目文件）见 Avibe 仓库里的 MCP Hub。 → 相关：技能教 Agent 怎么做你的事，MCP 服务器给它们做事的工具。