腾讯文档 MCP 提供了一套完整的在线文档操作工具,支持创建、查询、编辑多种类型的在线文档。
如需查看每个工具的详细调用示例、参数说明和返回值说明,请参考:
- - 包含所有工具的完整调用示例、参数说明、返回值说明及 API 结构、枚举值说明
- - 智能表格(SmartSheet)专项参考文档,包含字段类型枚举、字段值格式参考、典型工作流示例及所有 工具的详细说明
- - 智能文档(SmartCanvas)专项参考文档,包含元素类型说明、富文本格式枚举、典型工作流示例及所有 工具的详细说明
根据你所使用的环境,选择对应的配置方式:
无需额外安装,在 IDE 的 MCP 配置中添加腾讯文档服务即可直接使用。
配置步骤:
- 访问 https://docs..com/open/auth/mcp.html 获取你的个人 Token
- 在 IDE 的 MCP 配置中添加以下服务:
⚠️ 重要:Header 的 key 必须使用 ,不能使用其他名称(如 、、 等),否则鉴权将失败。
- 配置完成后,即可在 IDE 中直接调用所有腾讯文档工具,无需任何额外步骤。
在 OpenClaw 中使用时,需要先完成本地安装和注册。
安装步骤:
- 访问 https://docs..com/open/auth/mcp.html 获取 Token,并配置环境变量:
- 运行 setup.sh 完成 MCP 服务注册:
setup.sh 会自动将腾讯文档 MCP 服务注册到 mcporter,并验证配置是否成功。 如果未执行 setup,所有工具调用将无法找到 服务。
- 验证安装是否成功:
⚠️ 如果用户未配置 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 个工具()。
📖 所有工具的完整说明(使用场景、字段定义、枚举值、参数示例)请查阅:
包含:工作表操作、视图操作、字段操作、记录操作,以及字段类型枚举、字段值格式参考、典型工作流示例。
- 调用 查找目标文件夹
- 调用 在目标位置创建文档节点(doc_type 优先选择 smartcanvas)
- 调用 搜索文档
- 从结果中获取 (即 )
- 调用 获取文档内容
从零搭建任务管理表
查询并更新数据
📖 更多智能表格工作流示例请参考: - 典型工作流示例
- 默认使用 smartcanvas:除非用户明确指定其他格式,否则新增文档时优先使用 ;编辑已有智能文档时使用 系列工具
- 创建文档时支持 :所有 和 工具均支持 参数,可将文档直接创建到指定目录;不填则在根目录创建
- 删除节点: 默认仅删除当前节点(),使用 时会递归删除所有子节点,需谨慎
- Markdown 内容使用 UTF-8 格式,特殊字符无需转义
- 幻灯片必须遵循层级结构,每页包含 2-4 个段落标题
- 分页查询每页返回 20-40 条记录,使用 判断是否有更多
- 同时也是文档的
- 的 mermaid 内容必须全部使用英文
- 智能文档元素操作:、、 必须挂载在 下, 必须为 Page 类型元素 ID;操作前先调用 获取页面结构
- 智能文档分页查询: 使用 分页, 表示已获取全部内容
- 智能文档删除注意:删除 Page 元素时,其下所有子元素也会被一并删除
- 智能表格操作:所有 smartsheet.* 工具都需要 和 ,操作前先调用 获取 sheet_id
- 字段类型不可更新: 时 field_type 不能修改,但必须传入原值
- 记录字段值格式:不同字段类型的值格式不同,详见 - 字段值格式参考
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/241285.html