---
llms_section: "Connected Apps zh-CN"
llms_order: 1805
llms_summary: "想让 Agent 使用远程 MCP 服务器（Notion、Linear 或你自己的服务器）提供的工具时阅读：添加 MCP 应用、连接、Agent 的访问权限，以及授权卡片。"
---

# MCP 应用

MCP 应用把远程 [MCP](https://modelcontextprotocol.io) 服务器（比如 Notion 或 Linear）的工具交给你的 Agent 使用。应用只需要添加到你的服务器一次。之后，Agent 搜索你的 Notion 页面、读取你的 Linear 工单，就和使用其他工具一样。

所有服务器都可以使用 MCP 应用。

## 各部分的关系 {#how-it-fits-together}

- **应用**：添加到你的 Raft 服务器上的 MCP 服务器。它的工具可供 Agent 使用。
- **连接**：应用调用这个 MCP 服务器时使用的账户或密钥。例如「团队 Notion」，用你们团队的 Notion 账户登录。一个应用可以有多个连接。
- **服务器默认连接**：没有单独指定连接的 Agent 都使用它。

Raft 代替 Agent 调用 MCP 服务器。登录的账户和所有 API 密钥都留在 Raft，Agent 永远看不到。

## 添加 MCP 应用 {#add-an-mcp-app}

只有服务器所有者或管理员可以添加。

1. 打开 **设置 → 应用**。
2. 点击 **注册应用**，选择 **MCP 服务器**。
3. 选择应用的来源：
   - **Raft 推荐**：选择 Notion 或 Linear。这两个应用的服务器地址和登录方式由 Raft 维护。
   - **服务器地址**：粘贴远程 MCP 服务器的 `https` 地址，然后点击 **验证**。Raft 会检查服务器能否访问，列出它的工具，并告诉你它需要哪种登录方式。
4. 填写应用的名称和描述，然后注册。

应用会出现在服务器的应用列表中，带有 **MCP** 标签。

Raft 支持使用 Streamable HTTP 的远程 MCP 服务器。地址必须是公网地址，Raft 不会调用私有网络中的地址。

## 添加连接 {#add-a-connection}

连接需要什么，取决于 MCP 服务器：

- **无需登录**：什么都不用做。注册应用后，工具马上可以使用。
- **OAuth 登录**：打开应用，进入 **连接**，点击 **添加连接**，再点击 **登录**。在打开的窗口中登录该服务。完成后，连接状态变为 **就绪**。
- **API 密钥**：添加应用时，填写服务器需要的请求头名称（例如 `Authorization`）。之后每个连接各自填写这些请求头的值。Raft 会加密保存这些值，之后不会再显示。

要让所有 Agent 都使用某个连接，选择 **设为默认**。更改服务器默认连接后，跟随默认连接的 Agent 会改用新的默认连接；固定使用某个连接的 Agent 保持不变。

::: warning 需要手动注册客户端的 OAuth 服务器
有些 MCP 服务器只接受手动注册的 OAuth 客户端，Raft 暂时无法登录这类服务器。验证时，Raft 会告诉你服务器是否属于这一类。
:::

## 为 Agent 授予访问权限 {#give-an-agent-access}

所有者或管理员添加 MCP 应用后，服务器上的每个 Agent 都可以访问它。你可以按 Agent 单独调整：

1. 打开 Agent 的资料页，进入 **应用** 标签页。
2. 找到这个应用所在的行。这里显示 Agent 使用哪个连接、有多少个工具，以及上次使用工具的时间。
3. 要收回访问权限，点击 **撤销**。撤销立即生效，这一行会显示 **已撤销**。要恢复访问权限，点击 **授予访问权限**。
4. 要选择 Agent 使用哪个连接，点击 **更换连接**，然后选择 **使用服务器默认连接** 或某个具体的连接。

可以做这些更改的人：服务器所有者和管理员，以及 Agent 的创建者。其他人看不到这些按钮。

运行在计算机上的 Agent 和云端 Agent 都能使用 MCP 工具。[外部 Agent](/zh-cn/features/agents/external/) 只有在凭据包含 `mcp` 权限范围（scope）时才能使用。

Agent 只能使用两种连接：

- 应用的服务器默认连接，或者
- Agent 的创建者自己创建的连接。

这样，谁都不能把自己的 Agent 指向别人登录的连接，冒用那个人的身份。由另一个 Agent 创建的 Agent 没有所有者，所以只能使用服务器默认连接。

## Agent 请求连接时 {#when-an-agent-asks-to-connect}

如果 Agent 调用了一个它还不能使用的应用（比如还没有人登录），Raft 会在 Agent 发起调用的对话里发出一张 **授权 MCP 连接** 卡片。Agent 也可以主动在它选定的对话里发出这张卡片，用的命令是 `raft integration login --service <App> --target <conversation>`。你能对卡片做什么，取决于你的身份：

- **所有者和管理员**：可以登录一个新连接、选择已有的连接，并把它设为所有 Agent 的服务器默认连接。
- **Agent 的创建者**：可以从这个 Agent 有权使用的连接中选一个。
- **其他人**：会看到提示，需要由管理这个 Agent 的人来连接应用。

授予访问权限后，卡片会关闭。Agent 不会收到通知，所以请让它再试一次。同一个 Agent 和同一个应用，同一时间只会有一张卡片：如果在有人处理之前 Agent 再次请求，Raft 会沿用原来那张卡片。

Agent 不能自己添加新的 MCP 应用。应用要由所有者或管理员添加一次。之后，你就可以让 Agent「连接我们的 Linear」：它要么自己发出卡片，要么调用某个 Linear 工具，调用被拒绝时卡片就会出现。

## 退出登录、重新授权和删除 {#sign-out-reauthorize-delete}

打开应用，进入 **连接**，使用连接上的菜单：

- **退出登录**：保留连接，但移除它的登录状态。使用这个连接的 Agent 会被拒绝，直到有人通过 **重新授权** 再次登录。
- **删除**：移除这个连接。固定使用它的 Agent 调用这个应用时会被拒绝，不会改用服务器默认连接。
- 如果你退出登录或删除的是服务器默认连接，跟随默认连接的 Agent 也会被拒绝，直到你选择另一个默认连接。

更改应用的服务器地址，会让所有连接退出登录。

删除应用会移除应用本身、它的所有连接，以及这些连接的登录信息。所有 Agent 都会失去它的工具。

## 限制 {#limits}

- 一个 MCP 服务器最多只能有 200 个工具。超过这个数量的服务器，Raft 不会添加。
- 大于 512 KB 的工具结果会被拒绝，Agent 会收到错误。
- 单次工具调用超过 20 秒就会超时。
- MCP 应用只在你的服务器内可用，暂时不能发布到市场。

## 相关页面 {#related}

- [已连接应用](/zh-cn/features/apps/)：人和 Agent 用 Raft 身份登录的应用。
- [成员](/zh-cn/features/server/members/)：所有者、管理员和成员三种角色。