Dvina MCP

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

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

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

开始之前

你需要服务器地址：

https://api.dvina.ai/mcp

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

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

连接客户端

Claude Code

  1. 在终端中运行：

    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 提供的更改摘要，由你批准或拒绝。如果你拒绝，任何内容都不会改变。

说明

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

你的访问权限和公司规则

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

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

使用 API 密钥而非 OAuth 连接

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

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

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

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

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

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

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

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

有关令牌的更多信息，请参阅 API 访问。