腾讯文档 MCP 使用指南

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

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

• – 包含所有工具的完整调用示例、参数说明、返回值说明及 API cursor 教程 结构、枚举值说明
• – 智能表格（SmartSheet）专项参考文档，包含字段类型枚举、字段值格式参考、典型工作流示例及所有 工具的详细说明
• – 智能文档（SmartCanvas）专项参考文档，包含元素类型说明、富文本格式枚举、典型工作流示例及所有 工具的详细说明

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

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

配置步骤：

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

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

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

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

安装步骤：

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

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

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

3. 验证安装是否成功：

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

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

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

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

获取最新工具列表：

详细调用示例请参考：

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

• 新增文档：优先使用 创建智能文档，原因如下：
  • 📝 排版效果更美观，自动优化布局
  • 🎨 支持更丰富的格式（标题、段落、列表、表格、代码块、引用、图片等）
  • 📱 跨平台显示效果一致
• 编辑已有文档：使用 系列工具对已有智能文档进行增删改查操作，详见

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

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

⭐ create_smartcanvas_by_markdown（首选）

通用文档首选工具，通过 Markdown 创建智能文档，排版美观，支持所有 Markdown 基本结构。

适用场景：

• 📄 文档、报告、笔记、文章
• 📋 会议纪要、方案说明
• 📚 技术文档、教程
• 🗒️ 任何需要美观排版的内容

支持 参数：可指定父节点 ID，将文档创建到指定目录下；不填则在根目录创建。

📖 调用示例请参考： – create_smartcanvas_by_markdown

create_excel_by_markdown

通过 Markdown 表格创建 Excel，适用于需要数据计算、筛选的场景。

适用场景：数据报表、统计表格、需要公式计算的场景

支持 参数：可指定父节点 ID，将文档创建到指定目录下；不填则在根目录创建。

📖 调用示例请参考： – create_excel_by_markdown

create_slide_by_markdown

通过 Markdown 创建幻灯片，遵循特定层级结构（ 主标题 → 章节 → 页面 → 段落 → 缩进子项正文）。

适用场景：演示文稿、项目汇报、培训材料

支持 参数：可指定父节点 ID，将文档创建到指定目录下；不填则在根目录创建。

📖 调用示例请参考： – create_slide_by_markdown

create_mind_by_markdown

通过 Markdown 创建思维导图，使用标题层级和列表嵌套表示结构。

适用场景：知识图谱、大纲整理、头脑风暴

支持 参数：可指定父节点 ID，将文档创建到指定目录下；不填则在根目录创建。

📖 调用示例请参考： – create_mind_by_markdown

create_flowchart_by_mermaid

通过 Mermaid 语法创建流程图，mermaid 字段内容必须全部使用英文。

适用场景：流程图、时序图、架构图

支持 参数：可指定父节点 ID，将文档创建到指定目录下；不填则在根目录创建。

📖 调用示例请参考： – create_flowchart_by_mermaid

create_word_by_markdown

通过 Markdown 创建 Word 文档。注意：仅在用户明确要求 Word 格式时使用，否则请使用 smartcanvas。

支持 参数：可指定父节点 ID，将文档创建到指定目录下；不填则在根目录创建。

📖 调用示例请参考： – create_word_by_markdown

query_space_node

查询空间节点树结构，获取文件夹和文档列表。支持分页，每页返回 20 条。

📖 调用示例请参考： – query_space_node

create_space_node

在空间中创建新节点，支持创建文件夹（）、在线文档（）、链接（）。

📖 调用示例请参考： – create_space_node

search_space_file

在空间内搜索文档，支持按关键词匹配标题和内容，支持分页，每页返回 40 条。

⚠️ 注意：仅能搜索到文档类节点（word、excel、slide 等），无法搜索文件夹；如需查找文件夹，请使用 遍历节点树。

📖 调用示例请参考： – search_space_file

delete_space_node

删除空间中的指定节点，支持两种删除模式。

删除类型（remove_type）：

• （默认）：仅删除当前节点，子节点自动挂载到上级节点
• ：删除当前节点及其所有子节点（⚠️ 谨慎使用，会递归删除所有子节点）

📖 调用示例请参考： – delete_space_node

get_content

获取文档完整内容，传入 返回文档正文文本。

📖 调用示例请参考： – get_content

batch_update_sheet_range

批量更新表格单元格内容（仅适用于 Excel），数据从表格末尾追加，不覆盖已有内容。

📖 调用示例请参考： – batch_update_sheet_range

smartcanvas.create_smartcanvas_element

在已有智能文档中新增元素，支持添加页面（Page）、文本（Text）、标题（Heading）、待办事项（Task）等多种类型元素。

元素层级约束：

• 、、 必须挂载在 类型父节点下（ 必填）
• 可不指定父节点，插入到根节点
• 父节点不支持为 类型

📖 完整说明请参考： – smartcanvas.create_smartcanvas_element

smartcanvas.get_element_info

批量查询指定元素的详细信息，支持同时查询多个元素的内容、类型、父子关系等。

📖 完整说明请参考： – smartcanvas.get_element_info

smartcanvas.get_page_info

查询指定页面内的所有元素，支持分页获取。使用 参数进行分页， 表示已获取全部内容。

📖 完整说明请参考： – smartcanvas.get_page_info

smartcanvas.get_top_level_pages

查询文档的所有顶层页面列表，返回根节点下的直接子页面，用于了解文档目录结构。

📖 完整说明请参考： – smartcanvas.get_top_level_pages

smartcanvas.update_element

批量修改元素内容，支持同时更新多个元素的文本、格式、标题级别、页面标题等属性。

📖 完整说明请参考： – smartcanvas.update_element

smartcanvas.delete_element

批量删除元素，支持同时删除多个指定元素。

⚠️ 删除 Page 元素时，其下所有子元素也会被一并删除，请谨慎操作。

📖 完整说明请参考： – smartcanvas.delete_element

smartcanvas.append_insert_smartcanvas_by_markdown

通过 Markdown 文本向已有智能文档追加内容，内容追加到文档末尾。

📖 完整说明请参考： – smartcanvas.append_insert_smartcanvas_by_markdown

智能文档支持对页面、文本、标题、待办事项等元素进行完整的增删改查操作，共 7 个工具（）。

📖 所有工具的完整说明（使用场景、元素类型定义、枚举值、参数示例）请查阅：

包含：元素新增、元素查询、页面内容查询、顶层页面查询、元素修改、元素删除、Markdown 追加，以及标题级别枚举、颜色枚举、富文本格式说明、典型工作流示例。

智能表格支持对工作表、视图、字段、记录进行完整的增删改查操作，共 12 个工具（）。

📖 所有工具的完整说明（使用场景、字段定义、枚举值、参数示例）请查阅：

包含：工作表操作、视图操作、字段操作、记录操作，以及字段类型枚举、字段值格式参考、典型工作流示例。

1. 调用 查找目标文件夹
2. 调用 在目标位置创建文档节点（doc_type 优先选择 smartcanvas）

1. 调用 搜索文档
2. 从结果中获取 （即 ）
3. 调用 获取文档内容

从零搭建任务管理表

查询并更新数据

📖 更多智能表格工作流示例请参考： – 典型工作流示例

• 默认使用 smartcanvas：除非用户明确指定其他格式，否则新增文档时优先使用 ；编辑已有智能文档时使用 系列工具
• 创建文档时支持 ：所有 和 工具均支持 参数，可将文档直接创建到指定目录；不填则在根目录创建
• 删除节点： 默认仅删除当前节点（），使用 时会递归删除所有子节点，需谨慎
• Markdown 内容使用 UTF-8 格式，特殊字符无需转义
• 幻灯片必须遵循层级结构，每页包含 2-4 个段落标题
• 分页查询每页返回 20-40 条记录，使用 判断是否有更多
• 同时也是文档的
• 的 mermaid 内容必须全部使用英文
• 智能文档元素操作：、、 必须挂载在 下， 必须为 Page 类型元素 ID；操作前先调用 获取页面结构
• 智能文档分页查询： 使用 分页， 表示已获取全部内容
• 智能文档删除注意：删除 Page 元素时，其下所有子元素也会被一并删除
• 智能表格操作：所有 smartsheet.* 工具都需要 和 ，操作前先调用 获取 sheet_id
• 字段类型不可更新： 时 field_type 不能修改，但必须传入原值
• 记录字段值格式：不同字段类型的值格式不同，详见 – 字段值格式参考