腾讯文档 MCP 使用指南

腾讯文档 MCP 提供了一套完整的在线文档操作工具，支持创建、查询、编辑多种类型的在线文档。

📚 详细参考文档

如需查看每个工具的详细调用示例、参数说明和返回值说明，请参考：

references/api_references.md - 包含所有工具的完整调用示例、参数说明、返回值说明及 API 结构、枚举值说明
references/smartsheet_references.md - 智能表格（SmartSheet）专项参考文档，包含字段类型枚举、字段值格式参考、典型工作流示例及所有 smartsheet.* 工具的详细说明
references/smartcanvas_references.md - 智能文档（SmartCanvas）专项参考文档，包含元素类型说明、富文本格式枚举、典型工作流示例及所有 smartcanvas.* 工具的详细说明

⚙️ 配置要求

根据你所使用的环境，选择对应的配置方式：

✅ 场景一：CodeBuddy / 其他 IDE（推荐）

无需额外安装，在 IDE 的 MCP 配置中添加腾讯文档服务即可直接使用。

配置步骤：

访问 https://docs.qq.com/open/auth/mcp.html 获取你的个人 Token
在 IDE 的 MCP 配置中添加以下服务：

{
  "mcpServers": {
    "tencent-docs": {
      "url": "https://docs.qq.com/openapi/mcp",
      "headers": {
        "Authorization": "你的Token值"
      }
    }
  }
}

⚠️ 重要：Header 的 key 必须使用 Authorization，不能使用其他名称（如 token、auth、X-Token 等），否则鉴权将失败。

配置完成后，即可在 IDE 中直接调用所有腾讯文档工具，无需任何额外步骤。

🔧 场景二：OpenClaw（需要安装）

在 OpenClaw 中使用时，需要先完成本地安装和注册。

安装步骤：

访问 https://docs.qq.com/open/auth/mcp.html 获取 Token，并配置环境变量：

export TENCENT_DOCS_TOKEN="你的Token值"

运行 setup.sh 完成 MCP 服务注册：

bash setup.sh

setup.sh 会自动将腾讯文档 MCP 服务注册到 mcporter，并验证配置是否成功。如果未执行 setup，所有工具调用将无法找到 tencent-docs 服务。

验证安装是否成功：

mcporter list | grep tencent-docs

⚠️ 如果用户未配置 Token，请引导用户访问上方链接获取 Token，否则所有工具调用将返回鉴权失败。

🚨 错误码处理

常见错误码及解决方案

错误码	错误类型	解决方案
400006	Token 鉴权失败	🔑 检查 Token 配置：确认 Header 的 key 必须使用 `Authorization`；同时确认 Token 值正确，可访问 https://docs.qq.com/open/auth/mcp.html 重新获取
400007	VIP权限不足	⭐ 立即升级VIP：访问 https://docs.qq.com/vip?immediate_buy=1 购买VIP服务

🔧 调用方式

腾讯文档 MCP 的标准配置名称为 tencent-docs，通过内置 MCP Client 直接调用工具：

mcp: tencent-docs
tool: <工具名称>
arguments: { ... }

⚠️ 注意：arguments 必须是 JSON 对象，不能是字符串（即不能是 "{ ... }" 这样的字符串形式）。

支持的工具完整列表

⚠️ 以下工具列表仅供参考，实际可用工具以调用 tools/list 接口返回结果为准。

获取最新工具列表：
mcp: tencent-docs
method: tools/list

工具名称	MCP 调用格式	功能说明
create_smartcanvas_by_markdown	`create_smartcanvas_by_markdown`	⭐ 创建智能文档（首选）
create_excel_by_markdown	`create_excel_by_markdown`	创建 Excel 表格
create_slide_by_markdown	`create_slide_by_markdown`	创建幻灯片
create_mind_by_markdown	`create_mind_by_markdown`	创建思维导图
create_flowchart_by_mermaid	`create_flowchart_by_mermaid`	创建流程图
create_word_by_markdown	`create_word_by_markdown`	创建 Word 文档
query_space_node	`query_space_node`	查询空间节点
create_space_node	`create_space_node`	创建空间节点
delete_space_node	`delete_space_node`	删除空间节点
search_space_file	`search_space_file`	搜索空间文件
get_content	`get_content`	获取文档内容
batch_update_sheet_range	`batch_update_sheet_range`	批量更新表格
smartcanvas.*	见下方第 4 节	智能文档元素操作（页面/文本/标题/待办事项），详见 `references/smartcanvas_references.md`
smartsheet.*	见下方第 5 节	智能表格操作（工作表/视图/字段/记录），详见 `references/smartsheet_references.md`

详细调用示例请参考：references/api_references.md

⭐ 重要：文档类型选择指南

首选推荐：智能文档（smartcanvas）

新增文档：优先使用 create_smartcanvas_by_markdown 创建智能文档，原因如下：

📝 排版效果更美观，自动优化布局

🎨 支持更丰富的格式（标题、段落、列表、表格、代码块、引用、图片等）

📱 跨平台显示效果一致

编辑已有文档：使用 smartcanvas.* 系列工具对已有智能文档进行增删改查操作，详见 references/smartcanvas_references.md

文档类型选择决策树

需要创建什么类型的内容？
│
├─ 新增通用文档内容（报告、笔记、文章等）
│   └─ ✅ 使用 create_smartcanvas_by_markdown（首选）
│
├─ 编辑/追加已有智能文档内容
│   └─ ✅ 使用 smartcanvas.* 工具（详见 `references/smartcanvas_references.md`）
│
├─ 数据表格（需要计算、筛选、统计）
│   └─ ✅ 使用 create_excel_by_markdown
│
├─ 演示文稿（需要逐页展示、投影演示）
│   └─ ✅ 使用 create_slide_by_markdown
│
├─ 层次化知识整理（知识图谱、大纲）
│   └─ ✅ 使用 create_mind_by_markdown
│
├─ 流程/架构展示（流程图、时序图）
│   └─ ✅ 使用 create_flowchart_by_mermaid
│
├─ 结构化数据管理（多视图、字段管理、看板）
│   └─ ✅ 使用 smartsheet.* 工具（详见 `references/smartsheet_references.md`）
│
└─ 传统 Word 格式导出需求
    └─ 使用 create_word_by_markdown（仅在明确需要时）

支持的文档类型

类型	doc_type	推荐度	说明
智能文档	smartcanvas	⭐⭐⭐ 首选	排版美观，支持丰富组件
Excel	excel	⭐⭐⭐	数据表格专用
幻灯片	slide	⭐⭐⭐	演示文稿专用
思维导图	mind	⭐⭐⭐	知识图谱专用
流程图	flowchart	⭐⭐⭐	流程展示专用
Word	word	⭐⭐	传统格式，排版一般
收集表	form	⭐⭐	表单收集
智能表格	smartsheet	⭐⭐⭐	高级结构化表格，支持多视图、字段管理
白板	board	⭐⭐	在线白板

工具列表

📖 所有工具的完整调用示例、参数说明和返回值说明，请查阅 references/api_references.md

⚠️ 此 skill 中的工具列表仅作使用指导，实际可用工具以调用 tools/list 接口返回结果为准。 如遇工具不存在或参数不符，请先执行 tools/list 获取最新工具定义。

1. 创建文档类