如何关联 Dropbox MCP 远程服务器

已更新 Mar 18, 2026

In this article

person icon

本文适用于公测用户,面向一般用户发布。测试版受附加条款的约束。详细了解 Dropbox 产品测试版。

Dropbox MCP 远程服务器目前处于测试阶段,可让您直接在常用应用中轻松关联 Dropbox,因此您无需切换选项卡或中断工作流程,可以保持专注。

 

此集成功能根据开源模型上下文协议 (MCP) 标准构建,让您能够在基于 LLM 的环境中安全地访问和使用 Dropbox。

 

如果您属于以下情况,Dropbox MCP 服务器可以为您提供帮助:

  • 希望通过 IDE(例如 Cursor 或 Claude Code)浏览或查询 Dropbox 文件的开发人员。
  • AI 代理构建器,将 Dropbox 关联为数据源,用于检索、推理或工作流程自动化。
  • 使用 AI 助手查阅文档、整理文件、共享内容或从他人处收集文件的专业人士。
  • 使用 Dropbox 内容创建草稿、摘要、笔记或参考资料的作家或研究人员。
  • 使用与 MCP 兼容的客户端(如 Cursor、Claude 或 ChatGPT)处理 Dropbox 文件和文件夹。

可用工具

工具 说明
ListFolder
  • 浏览目录内容(每次调用最多 100 个项目)。
  • 获取基本文件信息:名称、大小、修改日期、文件 ID。
  • 使用光标分页浏览。
  • 处理包含空格和特殊字符的路径。
GetFileMetadata
  • 获取详细文件属性:大小、日期、MIME 类型。
  • 可使用文件路径或文件 ID。
  • 采用人类可读格式(例如,“2.71 MB”)。
GetFileContent
  • 从 PDF、Word 文档和其他可表示文本的文件中提取文本。
  • 支持最大 5 MB 的文件。
  • 内容链接:为所有文件提供 Dropbox 链接(即使文本提取失败)。
GetUsageAndQuota
  • 检索当前存储空间使用情况,以字节为单位(总占用空间)。
  • 检索当前存储空间限额,以字节为单位(总可用空间)。
  • 支持团队用户和个人用户,对于已加入团队的用户,该工具将检索整个团队的使用情况和限额。
搜索
  • 按名称或内容搜索文件和文件夹。
  • 按文件夹、文件类型或上次更新日期等进行筛选。
  • 按相关性或最近更改对结果进行排序。
  • 显示更多搜索结果。
创建文件夹
  • 通过指定文件夹路径,在 Dropbox 中的任何位置创建文件夹。
  • 响应内容包括文件夹详细信息,以便轻松衔接后续操作。
创建文件
  • 使用最大 5 MB 的内嵌 UTF-8 内容创建新的文本导向文件。
  • 最适合笔记、Markdown、JSON 和源代码等文档。
创建共享链接
WhoAmI
  • 获取经过身份验证的 Dropbox 用户的身份、团队/帐户背景信息以及根/主命名空间 ID。
复制
移动
  • 在 Dropbox 中移动或重命名一个或多个文件或文件夹。
  • 大型作业可能会在后台运行。
  • 使用 CheckJobStatus 跟踪进度。
删除
CheckJobStatus
  • 查看后台复制、移动、删除或文件夹恢复操作的状态。
DownloadLink
  • 为一个或多个文件创建临时的一次性下载链接。
  • 允许 MCP 客户端下载原始文件,而不是读取提取的文本。
ListSharedLinks
GetSharedLinkMetadata
  • 查看共享链接的详细信息。
  • 包括受众、到期日、密码保护和下载设置。
创建文件请求
GetFileRequest
  • 使用特定文件请求的 ID 查看其详细信息。
ListFileRequests
  • 查看由您所有的文件请求。
  • 包括上传 URL、目标文件夹、截止日期、开放状态和已提交文件数。
ListFileRevisions
  • 查看文件的修订历史记录,包括修订版 ID、时间戳、文件大小和删除状态。
  • 返回最多 100 个修订版,最新修订版排在最前。
RestoreFileRevision
  • 将早期文件修订版的内容恢复到某个 Dropbox 路径。
  • 可以重新创建已删除文件或替换目标路径中的现有文件。
ListRestoreEvents
  • 查看文件和文件夹活动,包括编辑、删除、移动、重命名和恢复。
恢复文件夹
  • 回退对文件夹及其子文件夹所做的更改,将文件夹及其内容恢复到更早的时间点。
GetTranscript
  • 将音频或视频文件转录为带时间戳的文本。
  • 支持句子或单词级时间戳。
  • 异步处理大文件。
GetMarkdown
  • 将支持的文档(包括 PDF 和 Word 文档)转换为 Markdown。
  • 支持 OCR,可从扫描的 PDF 中提取文本。
  • 可选择加入内嵌图片。
  • 大文档以异步方式处理。

支持的 MCP 客户端

Dropbox MCP 服务器支持为一组可信赖的 MCP 客户端进行动态客户端注册。即将支持更多客户端。目前,所有支持的 MCP 客户端如下:

 

支持的 MCP 客户端
Claude 代码
Claude 网页版
ChatGPT Codex
ChatGPT 网页版
Cursor
highlighter icon

注意

  • 您可以通过获取帮助,请求将特定 MCP 客户端添加为支持动态注册的客户端。
  • 在关联 MCP 服务器之前,无需进行其他设置。

如何关联 Dropbox MCP 远程服务器

Dropbox MCP 服务器位置:https://mcp.dropbox.com/mcp

设置步骤因您的 MCP 客户端而异。

warning icon

重要提示:如果您更改了 Dropbox 应用设置(例如添加新范围),则必须重新关联 Dropbox MCP 服务器。

关联 Cursor

设置连接器

  1. 在 Cursor 中,点击设置,然后点击 Cursor 设置
  2. 点击工具和 MCP,然后点击新建 MCP 服务器
  3. 复制以下配置:
{
  "mcpServers": {
    "Dropbox MCP": {
      "url": "https://mcp.dropbox.com/mcp"
    }
   }
}

关联 Claude 网页/桌面版

必要前提

  • 访问 Claude 自定义连接器适用于特定 Claude 套餐)

设置连接器

  1. 在 Claude 中,点击设置,然后点击连接器。
  2. 点击添加自定义连接器
  3. 输入以下内容:
    • 名称:Dropbox MCP
    • Dropbox MCP 服务器 URL:https://mcp.dropbox.com/mcp
  4. 单击添加

关联 Claude Code (CLI)

必要前提

  • Claude Code CLI 已安装

设置连接器

claude mcp add --transport http DropboxMCP https://mcp.dropbox.com/mcp

关联 ChatGPT 网页版

必要前提

  • 访问 ChatGPT 开发者模式(适用于特定套餐)

启用开发者模式

  1. 在 ChatGPT 中,点击设置,然后点击应用和连接器
  2. 单击高级设置
  3. 开发者模式切换为开启
  4. 查看有关未验证连接器的指令,然后点击确认

设置连接器

  1. 在 ChatGPT 中,点击设置,然后点击应用
  2. 点击创建应用
  3. 输入以下内容:
    • 名称:Dropbox MCP
    • MCP 服务器 URL:https://mcp.dropbox.com/mcp
    • 身份验证:OAuth
  4. 勾选我已了解并希望继续
  5. 单击创建

关联 ChatGPT Codex (CLI)

必要前提

  • Codex 在本地安装

设置连接器

  1. 添加连接器:
codex mcp add DropboxMCP --url https://mcp.dropbox.com/mcp
2. 登录连接器:
codex mcp login DropboxMCP

从其他 MCP 客户端关联

在关联 MCP 服务器之前,您需要一个 Dropbox 应用来获取 API 登录凭据。按照 Dropbox 应用设置说明操作。

Dropbox 应用设置

highlighter icon

注意您的 Dropbox 管理员可能会控制您是否可以注册或关联应用。如果您看不到创建应用或将 Dropbox 与其他服务关联的选项,请与团队管理员联系。详细了解应用集成功能的管理控件。

  1. 前往 Dropbox 应用控制台
  2. 点击创建应用
  3. 配置您的应用:
    • API:限定访问权限
    • 访问类型:整个 Dropbox
    • 应用名称:选择一个唯一名称
  4. 点击权限,然后启用:
    • files.metadata.read
    • files.content.read
    • files.content.write
    • sharing.write
    • account_info.read
    • sharing.read
    • file_requests.read
    • file_requests.write
  5. 为您的 MCP 客户端添加 OAuth 2 重定向 URI:
    • 请查看他们的文档,了解特定的 OAuth2 重定向 URI。
    • 有时可在关联 MCP 服务器的设置流程中获取。
  6. 收集您的登录凭据:
    • 单击设置
    • 点击生成访问令牌
    • 复制您的访问令牌
      • 注意:访问令牌的有效期很短,因此如果过期,您需要重新生成。
    • 复制应用键
    • 复制应用密钥
  7. 品牌标识中使用名称、图标和描述(可选)自定义您的应用。

常见问题解答

关联功能安全吗?

Dropbox MCP 使用 Dropbox OAuth 进行安全身份验证。您的数据始终受到 Dropbox 现有隐私和安全标准的保护。

这篇文章有用吗?

请告诉我们为什么它没有帮助:

感谢您告诉我们!

谢谢您的意见!