腾讯云企业网盘 (TCED) 技能

通过 tced-mcp MCP 工具操作腾讯云企业网盘，支持 OAuth2 授权认证、空间管理和文件操作。

前置要求

要求	说明
Node.js	>= 18.0.0
npm / npx	随 Node.js 安装，用于获取和运行 `tced-mcp`
浏览器	任意浏览器即可（可在本机或其他设备上打开授权链接）
网络访问	需能访问 `pan.tencent.com`（授权页面）和 `api.tencentsmh.cn`（API 端点）
本地凭据存储	`~/.tced-mcp/auth.json` — 存储 OAuth2 Token 和配置（自动创建）

⚠️ 凭据安全：~/.tced-mcp/auth.json 中包含 OAuth2 AccessToken 和 RefreshToken。建议确保该文件权限为 600（仅所有者可读写）：
chmod 600 ~/.tced-mcp/auth.json

概览

TCED MCP Server 基于 OAuth2 第三方授权模式，调用 login 获取授权链接，用户在浏览器中完成授权后，将授权码传回 login(code) 即可操作已授权的空间和文件。支持桌面和无界面服务器（headless）两种场景。

类别	工具	说明
认证	`login`	发起 OAuth2 授权（两阶段：获取授权 URL → 传入 code 完成登录）
认证	`logout`	登出账号
认证	`list_accounts`	列出所有已登录账号
认证	`switch_account`	切换活跃账号
认证	`current_account`	查看当前账号信息
空间	`list_authorized_spaces`	列出已授权空间
空间	`switch_space`	切换到指定空间
空间	`current_space`	查看当前活跃空间
文件	`upload_file`	上传文件（本地文件或文本内容）
文件	`download_file`	下载文件（获取链接或保存到本地）
文件	`file_info`	查看文件/目录详情
文件	`list_directory`	列出目录内容
文件	`search_files`	搜索文件和目录

首次使用 — 自动设置

当用户首次要求操作企业网盘时，按以下流程操作：

步骤 1：检查 MCP 服务是否可用

尝试调用 current_account 检查 tced-mcp 是否已在 MCP 客户端中配置并运行。

如果可用：跳到「OAuth2 授权登录」
如果不可用：继续步骤 2

步骤 2：配置 MCP 客户端

tced-mcp 已发布到 npm，无需手动安装。只需在 MCP 客户端配置文件（如 mcp.json）中添加：

{
  "mcpServers": {
    "tced-mcp": {
      "command": "npx",
      "args": ["-y", "[email protected]"],
      "env": {
        "TCED_PAN_DOMAIN": "https://pan.tencent.com",
        "TCED_BASE_PATH": "https://api.tencentsmh.cn"
      }
    }
  }
}

⚠️ 供应链安全说明：

args 中必须锁定具体版本号（如 [email protected]），不要使用 @latest。锁定版本可防止包被劫持时自动拉取恶意版本。升级时应手动修改版本号并验证 changelog。

必须配置 env 字段，显式指定 TCED_PAN_DOMAIN 和 TCED_BASE_PATH 为官方生产地址。这两个环境变量会在每次启动时强制覆盖本地缓存（~/.tced-mcp/auth.json）中的域名配置，确保 API 请求始终指向可信端点。

不要将 env 中的域名修改为非官方地址，除非你完全了解风险——所有 API 请求（包含 OAuth2 Token）都会发送到配置的端点。

配置完成后重启 MCP 客户端使配置生效。

步骤 3：验证安装

也可以使用脚本快速检查环境：

{baseDir}/scripts/setup.sh --check

OAuth2 授权登录

检查登录状态

调用 current_account 检查是否已登录。已登录则跳到「选择空间」，否则继续登录。

发起授权登录（两阶段）

第一步：调用 login()（不传参数），返回授权 URL。

有界面场景：MCP 会自动尝试打开浏览器（如果打开失败会提示手动访问）
无界面场景（headless）：将授权 URL 复制到任意设备的浏览器中打开

用户在网盘页面（pan.tencent.com）完成：

登录企业网盘账号
选择要授权的企业
选择要授权的空间 — ⚠️ 每次授权只选一个空间，AccessToken 与该空间一对一绑定
点击「同意授权」

授权成功后，页面会展示授权码（code），请复制该授权码。

第二步：调用 login(code: "粘贴授权码")，完成 token 交换。若只授权了一个空间则自动切换到该空间。

⚠️ 核心规则：每个 AccessToken 只对应一个空间。如需操作其他空间，必须重新调用 login 授权目标空间。

⏰ 超时限制：授权链接 5 分钟内有效。超时后需重新调用 login() 获取新链接。

选择空间（多空间场景）

如果授权了多个空间：

调用 list_authorized_spaces 获取空间列表
调用 switch_space(spaceId) 切换到目标空间

核心操作流程

浏览目录

list_directory(filePath: "docs", limit: 50)

支持 marker 翻页、排序和筛选，详见 references/api_reference.md。

☁️ TCED Cloud Drive | 腾讯云企业网盘

Install via CLI (Recommended)