> ## Documentation Index
> Fetch the complete documentation index at: https://docs.avibe.bot/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP

> MCP 服务器接一次，Avibe 里的每个 Agent 都能用上它的工具。

**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 可以添加、配置、批准或删除服务器。

## 服务器需要你处理的时候

卡片上会写明缺什么：

| 卡片显示 | 含义 | 怎么做 |
| - | - | - |
| **需要登录** | 服务器要求你先登录它的服务方。登录之前，Agent 看不到它的工具。 | 选择**登录**，在新打开的标签页里完成授权。 |
| **需要配置** | 服务器的定义里有变量（比如一个 token）还没有填值。 | 选择**配置**，把它们填上。 |
| **待批准** | 这个服务器定义在项目仓库里。Owner 批准之前，它的工具不可用。 | 先看清它会运行什么，再选择**批准**。 |

## 属于某个项目的服务器

项目可以在根目录放一个 `.mcp.json` 文件，自带一组服务器，格式和 Claude Code 用的一样。在这个项目里工作的 Agent 除了全局服务器之外还能看到它们；其他项目里的 Agent 看不到。

这样的文件是随仓库一起来的，所以里面的每个服务器一开始都是**待批准**。文件里对应的条目一旦改动，就需要重新批准。

## 你填的值存在哪里

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

## 给 Agent 和命令行

Agent 用的，也是你可以自己运行的命令：

```bash theme={null}
vibe mcp --list                 # 这里可用的服务器
vibe mcp docs --list            # 名为 "docs" 的服务器有哪些工具
vibe mcp docs search --help     # 某个工具的参数
vibe mcp docs search --query "async Python"
```

`vibe mcp-add` 可以从命令行添加服务器。完整参考（包括 OAuth 选项和项目文件）见 Avibe 仓库里的 [MCP Hub](https://github.com/avibe-bot/avibe/blob/master/docs/MCP_HUB.md)。

→ 相关：[技能](https://docs.avibe.bot/zh/concepts/skills.md)教 Agent 怎么做你的事，MCP 服务器给它们做事的工具。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.