# 通过 MCP 在其他应用中使用 Dvina

> 将 Claude Code、ChatGPT 或 Cursor 等 MCP 客户端连接到 Dvina，登录后，允许它在你批准的情况下读取你在 Dvina 中的内容并添加内容。

Dvina 有自己的 MCP 服务器。连接 Claude Code、ChatGPT 或 Cursor 等 MCP 客户端后，该应用就能以你的身份搜索你的 Dvina、读取你的文档和记忆，以及添加笔记、任务和提醒。

## 开始之前

你需要服务器地址：

```text
https://api.dvina.ai/mcp
```

如果你的公司在自己的服务器上运行 Dvina，请使用公司的 Dvina API 地址，并在末尾加上 `/mcp`。请向管理员获取该地址。

服务器使用 Streamable HTTP。如果客户端要求选择传输方式，请选择 HTTP。

## 连接客户端

::: tabs

=== Claude Code

1. 在终端中运行：

    ```sh
    claude mcp add --transport http dvina https://api.dvina.ai/mcp
    ```

2. 启动 Claude Code，运行 `/mcp`，选择 **dvina**，然后登录 Dvina。

=== ChatGPT

1. 在 ChatGPT 中打开添加 MCP 服务器的位置。
2. 输入 `https://api.dvina.ai/mcp` 作为服务器地址。如果系统询问登录方式，请选择 OAuth。
3. 按照 ChatGPT 的提示登录 Dvina。

=== Cursor

1. Open the place where Cursor lets you add an MCP server.
2. Add a server named `dvina` with the address `https://api.dvina.ai/mcp`.
3. Sign in to Dvina when Cursor asks.

:::

你不需要客户端 ID 或密钥。客户端首次连接时会自动向 Dvina 注册。

## 登录

Dvina 的 MCP 服务器通过 OAuth 让你在浏览器中登录：

1. 像平时一样登录 Dvina。
2. 如果你属于多个工作区，请在 **选择工作区** 下选择一个，然后选择 **继续**。客户端仅在该工作区中工作。
3. 在 **授权访问** 下确认应用名称，然后选择 **允许访问**。如果你不认识该应用，请选择 **拒绝**。

客户端会保持连接，因此你不需要每次都登录。

## 客户端可以做什么

客户端可以看到 Dvina 的工具，并在你的请求需要时使用它们：

| 功能领域                   | 客户端可以执行的操作                                                                                                                       |
| ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| **搜索**             | 同时搜索你的聊天、文档、记忆和世界。                                                                                      |
| **记忆**             | 列出和读取你的记忆文件，添加新文件，或修改现有文件。                                                                               |
| **世界**              | 列出你的主题，显示 Dvina 对某个主题或其他任何事物的了解，并列出你的动态。                                                  |
| **文档**          | 列出、读取和搜索你的资料库，创建笔记和文件夹，上传文件，以及替换、移动或重命名文档，或将文档移到废纸篓。 |
| **画布**             | 列出和读取你的画布，创建画布，或重写页面。                                                                             |
| **任务和目标**    | 列出你的任务并读取其执行情况，启动任务或为实现某个目标而运行的任务，为任务追加工作，或停止任务。                |
| **定时消息** | 列出定时消息，安排一次性或重复发送的消息或提醒，或取消它们。                                                                 |
| **智能体和技能**  | 列出和读取你的智能体和技能，创建智能体，添加技能，或修改智能体或技能。                                                        |
| **项目**           | 列出你的项目，并显示项目的文件夹和近期任务。                                                                             |
| **共享**            | 查看谁有权访问某个项目，以及他人与你共享了什么，或授予或移除他人的访问权限。                                           |
| **设置**           | 显示你的偏好设置，或开启或关闭记忆。                                                                                             |

客户端无法永久删除任何内容、打开公开链接、连接或断开应用，也无法更改管理或账单设置。

## 批准更改

客户端执行操作时，遵循与 Dvina 其他地方相同的规则：

- 读取操作无需询问你即可执行。
- 添加新内容（如笔记、记忆文件或任务）无需询问你即可执行。这类操作不会更改已有内容。
- 更改或移除内容（如将文档移到废纸篓、重写画布页面、停止任务或共享项目）会先征求你的同意。客户端会显示 Dvina 提供的更改摘要，由你批准或拒绝。如果你拒绝，任何内容都不会改变。

> [!NOTE]
> 如果客户端无法请你确认，Dvina 就不会执行该客户端发起的更改。请改用 Dvina 应用进行更改，或使用能够请求确认的客户端。

## 你的访问权限和公司规则

客户端以你的身份运行，只能访问你在 Dvina 中能看到的内容，执行你有权进行的操作：

- 只有在你仍是工作区成员时，客户端才能运行，而且只能执行你的角色允许的操作。
- 如果管理员关闭了某项功能（如文件上传），客户端也无法使用该功能。
- 客户端添加或更改的内容会经过公司的数据保护规则检查，与在应用中操作时一样。
- 客户端添加或更改的内容会记录在你的[审计日志](/docs/teams/audit-log)中，标记为助手代你执行的操作，并注明操作来自哪个客户端。
- 客户端的操作会计入你的用量，并受你通常的用量限制约束。

## 使用 API 密钥而非 OAuth 连接

在 Enterprise 套餐中，客户端可以使用个人访问令牌连接，无需登录。对于无法通过 OAuth 登录的客户端或脚本，可以使用这种方式。

1. 打开设置，选择 **API 访问**。
2. 在**个人访问令牌**下，选择**创建令牌**。
3. 输入**名称**，选择**访问权限**和**到期时间**，然后选择**创建令牌**。
4. 在**复制你的令牌**下，复制令牌。令牌只会显示这一次。

选择客户端需要的访问权限：

- **只读：**客户端只能看到用于读取的工具。它可以搜索和读取你在 Dvina 中的内容，但不能添加或更改任何内容。
- **读写：**客户端可以看到所有工具，更改仍需你批准，与使用 OAuth 时一样。

在 `Authorization` 标头中发送令牌，将其放在 `Bearer` 之后。例如，在 Claude Code 中：

```sh
claude mcp add --transport http dvina https://api.dvina.ai/mcp --header "Authorization: Bearer <your token>"
```

如果使用其他客户端，请在可为 MCP 服务器设置标头的位置添加相同的标头。

令牌以你的身份在创建它的工作区中运行，使用你目前在该工作区的角色权限。要替换令牌，请在**个人访问令牌**下打开它，然后选择**轮换…**：新令牌会替换旧令牌，旧令牌会立即失效。要停用令牌，请选择**撤销…**：任何使用该令牌的客户端或脚本都会立即停止工作。

有关令牌的更多信息，请参阅 [API 访问](/docs/dvina-mcp/api-access)。

## 相关内容

- [自定义应用和 MCP 服务器](/docs/connectors/custom-apps)
- [API 访问](/docs/dvina-mcp/api-access)
- [使用 dvina 命令](/docs/dvina-mcp/cli)
- [团队概览](/docs/teams/overview)