腾讯文档在线协作自动化
通过 Tencent Docs Open API 以 curl + jq 创建、读取、列出、搜索和管理腾讯文档的自动化工作流,覆盖在线文档、在线表格、幻灯片、思维导图、流程图、智能表格与收集表七种类型,支持读取元数据与单元格区域、上传图片、创建副本,并对重命名/移动/删除等写操作强制先经用户确认。Use when the user 提到腾讯文档 / Tencent Docs / docs.qq.com、粘贴 docs.qq.com 链接,或想在其腾讯文档空间中创建、读取、整理文档时使用。Triggers include 腾讯文档、在线文档、在线表格、思维导图、流程图、智能表格、收集表。。如需完整版,请淘宝搜索店铺「AI灵匣」
skillhub install @org-b6kzcl68/tencent-docs
README 文档
8,354 字腾讯文档 MCP 使用指南
腾讯文档 MCP 提供了一套完整的在线文档操作工具,支持创建、查询、编辑多种类型的在线文档。
📚 详细参考文档
如需查看每个工具的详细调用示例、参数说明和返回值说明,请参考:
references/api_references.md- 包含所有工具的完整调用示例、参数说明、返回值说明及 API 结构、枚举值说明references/smartsheet_references.md- 智能表格(SmartSheet)专项参考文档,包含字段类型枚举、字段值格式参考、典型工作流示例及所有smartsheet.*工具的详细说明references/smartcanvas_references.md- 智能文档(SmartCanvas)专项参考文档,包含元素类型说明、富文本格式枚举、典型工作流示例及所有smartcanvas.*工具的详细说明
⚙️ 配置要求
✅ 如果已有 MCP 配置 如在codebuddy或其他ide工具中,则无需重复配置,可直接使用工具。
获取 Token
- 访问 https://docs.qq.com/open/document/mcp/get-token/ 获取你的 Token
- 登录后复制个人 Token
- 如果在 OpenClaw 中,配置环境变量
TENCENTDOCSTOKEN
⚠️ 如果用户未配置 Token,请引导用户访问上方链接获取 Token,否则所有工具调用将返回鉴权失败。
配置 Token 到请求 Header
在 MCP 客户端配置中,Token 需通过 HTTP 请求头传递,Header 的 key 必须为 Authorization,示例如下:
{
"headers": {
"Authorization": "你的Token值"
}
}
⚠️ 重要:无论使用何种 MCP 客户端,调用时 Header 的 key 必须使用
Authorization,不能使用其他名称(如token、auth、X-Token等),否则鉴权将失败。💡 不同 MCP 客户端的配置方式可能略有差异,但 Header key 统一使用
Authorization。
MCP 服务地址
- 访问地址:
https://docs.qq.com/openapi/mcp
🚀 快速开始(首次使用必读)
首次使用前,必须先完成初始化配置,运行 setup.sh 自动完成 MCP 服务注册:
bash setup.sh
setup.sh 会自动将腾讯文档 MCP 服务注册到 mcporter,并验证配置是否成功。 如果未执行 setup,所有工具调用将无法找到
tencent-docs服务。
验证配置
mcporter list | grep tencent-docs
🔧 调用方式
腾讯文档 MCP 的标准配置名称为 tencent-docs,通过内置 MCP Client 直接调用工具:
mcp: tencent-docs
tool: <工具名称>
arguments: { ... }
支持的工具完整列表
⚠️ 以下工具列表仅供参考,实际可用工具以调用
tools/list接口返回结果为准。获取最新工具列表:
mcp: tencent-docs method: tools/list
| 工具名称 | MCP 调用格式 | 功能说明 |
|---|---|---|
| createsmartcanvasby_markdown | createsmartcanvasby_markdown | ⭐ 创建智能文档(首选) |
| createexcelby_markdown | createexcelby_markdown | 创建 Excel 表格 |
| createslideby_markdown | createslideby_markdown | 创建幻灯片 |
| createmindby_markdown | createmindby_markdown | 创建思维导图 |
| createflowchartby_mermaid | createflowchartby_mermaid | 创建流程图 |
| createwordby_markdown | createwordby_markdown | 创建 Word 文档 |
| queryspacenode | queryspacenode | 查询空间节点 |
| createspacenode | createspacenode | 创建空间节点 |
| deletespacenode | deletespacenode | 删除空间节点 |
| searchspacefile | searchspacefile | 搜索空间文件 |
| get_content | get_content | 获取文档内容 |
| batchupdatesheet_range | batchupdatesheet_range | 批量更新表格 |
| smartcanvas.* | 见下方第 4 节 | 智能文档元素操作(页面/文本/标题/待办事项),详见 references/smartcanvas_references.md |
| smartsheet.* | 见下方第 5 节 | 智能表格操作(工作表/视图/字段/记录),详见 references/smartsheet_references.md |
详细调用示例请参考:references/api_references.md
⭐ 重要:文档类型选择指南
首选推荐:智能文档(smartcanvas)
- 新增文档:优先使用
createsmartcanvasby_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. 创建文档类
⭐ createsmartcanvasby_markdown(首选)
通用文档首选工具,通过 Markdown 创建智能文档,排版美观,支持所有 Markdown 基本结构。
适用场景:
- 📄 文档、报告、笔记、文章
- 📋 会议纪要、方案说明
- 📚 技术文档、教程
- 🗒️ 任何需要美观排版的内容
支持 parent_id 参数:可指定父节点 ID,将文档创建到指定目录下;不填则在根目录创建。
📖 调用示例请参考:
references/apireferences.md- createsmartcanvasbymarkdown
createexcelby_markdown
通过 Markdown 表格创建 Excel,适用于需要数据计算、筛选的场景。
适用场景:数据报表、统计表格、需要公式计算的场景
支持 parent_id 参数:可指定父节点 ID,将文档创建到指定目录下;不填则在根目录创建。
📖 调用示例请参考:
references/apireferences.md- createexcelbymarkdown
createslideby_markdown
通过 Markdown 创建幻灯片,遵循特定层级结构(# 主标题 → ## 章节 → ### 页面 → - 段落 → 缩进子项正文)。
适用场景:演示文稿、项目汇报、培训材料
支持 parent_id 参数:可指定父节点 ID,将文档创建到指定目录下;不填则在根目录创建。
📖 调用示例请参考:
references/apireferences.md- createslidebymarkdown
createmindby_markdown
通过 Markdown 创建思维导图,使用标题层级和列表嵌套表示结构。
适用场景:知识图谱、大纲整理、头脑风暴
支持 parent_id 参数:可指定父节点 ID,将文档创建到指定目录下;不填则在根目录创建。
📖 调用示例请参考:
references/apireferences.md- createmindbymarkdown
createflowchartby_mermaid
通过 Mermaid 语法创建流程图,mermaid 字段内容必须全部使用英文。
适用场景:流程图、时序图、架构图
支持 parent_id 参数:可指定父节点 ID,将文档创建到指定目录下;不填则在根目录创建。
📖 调用示例请参考:
references/apireferences.md- createflowchartbymermaid
createwordby_markdown
通过 Markdown 创建 Word 文档。注意:仅在用户明确要求 Word 格式时使用,否则请使用 smartcanvas。
支持 parent_id 参数:可指定父节点 ID,将文档创建到指定目录下;不填则在根目录创建。
📖 调用示例请参考:
references/apireferences.md- createwordbymarkdown
2. 空间管理类
queryspacenode
查询空间节点树结构,获取文件夹和文档列表。支持分页,每页返回 20 条。
📖 调用示例请参考:
references/apireferences.md- queryspace_node
createspacenode
在空间中创建新节点,支持创建文件夹(wikifolder)、在线文档(wikitdoc)、链接(link)。
📖 调用示例请参考:
references/apireferences.md- createspace_node
searchspacefile
在空间内搜索文档,支持按关键词匹配标题和内容,支持分页,每页返回 40 条。
⚠️ 注意:仅能搜索到文档类节点(word、excel、slide 等),无法搜索文件夹;如需查找文件夹,请使用
queryspacenode遍历节点树。
📖 调用示例请参考:
references/apireferences.md- searchspace_file
deletespacenode
删除空间中的指定节点,支持两种删除模式。
删除类型(remove_type):
current(默认):仅删除当前节点,子节点自动挂载到上级节点all:删除当前节点及其所有子节点(⚠️ 谨慎使用,会递归删除所有子节点)
📖 调用示例请参考:
references/apireferences.md- deletespace_node
3. 文档操作类
get_content
获取文档完整内容,传入 file_id 返回文档正文文本。
📖 调用示例请参考:
references/apireferences.md- getcontent
batchupdatesheet_range
批量更新表格单元格内容(仅适用于 Excel),数据从表格末尾追加,不覆盖已有内容。
📖 调用示例请参考:
references/apireferences.md- batchupdatesheetrange
smartcanvas.createsmartcanvaselement
在已有智能文档中新增元素,支持添加页面(Page)、文本(Text)、标题(Heading)、待办事项(Task)等多种类型元素。
元素层级约束:
Text、Task、Heading必须挂载在Page类型父节点下(parent_id必填)Page可不指定父节点,插入到根节点- 父节点不支持为
Heading类型
📖 完整说明请参考:
references/smartcanvasreferences.md- smartcanvas.createsmartcanvas_element
smartcanvas.getelementinfo
批量查询指定元素的详细信息,支持同时查询多个元素的内容、类型、父子关系等。
📖 完整说明请参考:
references/smartcanvasreferences.md- smartcanvas.getelement_info
smartcanvas.getpageinfo
查询指定页面内的所有元素,支持分页获取。使用 cursor 参数进行分页,is_over=true 表示已获取全部内容。
📖 完整说明请参考:
references/smartcanvasreferences.md- smartcanvas.getpage_info
smartcanvas.gettoplevel_pages
查询文档的所有顶层页面列表,返回根节点下的直接子页面,用于了解文档目录结构。
📖 完整说明请参考:
references/smartcanvasreferences.md- smartcanvas.gettoplevelpages
smartcanvas.update_element
批量修改元素内容,支持同时更新多个元素的文本、格式、标题级别、页面标题等属性。
📖 完整说明请参考:
references/smartcanvasreferences.md- smartcanvas.updateelement
smartcanvas.delete_element
批量删除元素,支持同时删除多个指定元素。
⚠️ 删除 Page 元素时,其下所有子元素也会被一并删除,请谨慎操作。
📖 完整说明请参考:
references/smartcanvasreferences.md- smartcanvas.deleteelement
smartcanvas.appendinsertsmartcanvasbymarkdown
通过 Markdown 文本向已有智能文档追加内容,内容追加到文档末尾。
📖 完整说明请参考:
references/smartcanvasreferences.md- smartcanvas.appendinsertsmartcanvasby_markdown
4. 智能文档(SmartCanvas)元素操作类
智能文档支持对页面、文本、标题、待办事项等元素进行完整的增删改查操作,共 7 个工具(smartcanvas.*)。
📖 所有工具的完整说明(使用场景、元素类型定义、枚举值、参数示例)请查阅:
references/smartcanvas_references.md包含:元素新增、元素查询、页面内容查询、顶层页面查询、元素修改、元素删除、Markdown 追加,以及标题级别枚举、颜色枚举、富文本格式说明、典型工作流示例。
5. 智能表格(SmartSheet)操作类
智能表格支持对工作表、视图、字段、记录进行完整的增删改查操作,共 12 个工具(smartsheet.*)。
📖 所有工具的完整说明(使用场景、字段定义、枚举值、参数示例)请查阅:
references/smartsheet_references.md包含:工作表操作、视图操作、字段操作、记录操作,以及字段类型枚举、字段值格式参考、典型工作流示例。
常见工作流
创建通用文档(推荐方式)
1. 优先调用 create_smartcanvas_by_markdown 创建智能文档
2. 从返回结果中获取 file_id 和 url
编辑已有智能文档
1. 调用 smartcanvas.get_top_level_pages 获取文档页面结构
2. 按需调用 smartcanvas.* 工具进行增删改查:
- 追加内容:smartcanvas.append_insert_smartcanvas_by_markdown(Markdown 方式)
- 新增元素:smartcanvas.create_smartcanvas_element
- 查询元素:smartcanvas.get_element_info / smartcanvas.get_page_info
- 修改元素:smartcanvas.update_element
- 删除元素:smartcanvas.delete_element
组织文档到指定目录
- 调用
queryspacenode查找目标文件夹 - 调用
createspacenode在目标位置创建文档节点(doc_type 优先选择 smartcanvas)
搜索并读取文档
- 调用
searchspacefile搜索文档 - 从结果中获取
nodeid(即fileid) - 调用
get_content获取文档内容
智能表格操作工作流
从零搭建任务管理表
1. 获取工作表列表 → smartsheet.list_tables(获取 sheet_id)
2. 添加字段(列)→ smartsheet.add_fields(任务名称、优先级、截止日期等)
3. 批量写入数据 → smartsheet.add_records
4. (可选)创建看板视图 → smartsheet.add_view(view_type=2)
查询并更新数据
1. 获取工作表 → smartsheet.list_tables
2. 查询记录 → smartsheet.list_records(获取 record_id)
3. 更新记录 → smartsheet.update_records(传入 record_id 和新字段值)
📖 更多智能表格工作流示例请参考:
references/smartsheet_references.md- 典型工作流示例
注意事项
- 默认使用 smartcanvas:除非用户明确指定其他格式,否则新增文档时优先使用
createsmartcanvasby_markdown;编辑已有智能文档时使用smartcanvas.*系列工具 - 创建文档时支持
parentid:所有create*bymarkdown和createflowchartbymermaid工具均支持parentid参数,可将文档直接创建到指定目录;不填则在根目录创建 - 删除节点:
deletespacenode默认仅删除当前节点(remove_type=current),使用all时会递归删除所有子节点,需谨慎 - Markdown 内容使用 UTF-8 格式,特殊字符无需转义
- 幻灯片必须遵循层级结构,每页包含 2-4 个段落标题
- 分页查询每页返回 20-40 条记录,使用
has_next判断是否有更多 nodeid同时也是文档的fileidcreateflowchartby_mermaid的 mermaid 内容必须全部使用英文- 智能文档元素操作:
Text、Heading、Task必须挂载在Page下,parentid必须为 Page 类型元素 ID;操作前先调用smartcanvas.gettoplevelpages获取页面结构 - 智能文档分页查询:
smartcanvas.getpageinfo使用cursor分页,is_over=true表示已获取全部内容 - 智能文档删除注意:删除 Page 元素时,其下所有子元素也会被一并删除
- 智能表格操作:所有 smartsheet.* 工具都需要
fileid和sheetid,操作前先调用smartsheet.listtables获取 sheetid - 字段类型不可更新:
updatefields时 fieldtype 不能修改,但必须传入原值 - 记录字段值格式:不同字段类型的值格式不同,详见
references/smartsheet_references.md- 字段值格式参考
同分类其他技能
查看全部 ›腾讯文档(docs.qq.com)-在线云文档平台,是创建、编辑、管理文档的首选 skill。涉及"新建/创建/编辑/读取/查看/搜索文
335 262.3万 WPS Office 全家桶WPS Office 全家桶 - 四引擎(WPS/MS Office/LibreOffice/纯Python)智能识别用户已安装软件,纯
182 109.3万 ppt-generator-skill智能 PPT 生成助手。根据用户描述的主题、行业、风格,自动生成漂亮的 PPT 文件。支持所有行业(商务、教育、科技、医疗、金融、创意等
378 91.6万 WPS Office 全家桶WPS Office 全家桶 - 四引擎(WPS/MS Office/LibreOffice/纯Python)智能识别用户已安装软件,纯
5 81.6万 秘书材料星公文写作-妙笔skill体制内资深办公室主任+管理学博士,自学编程开发的智能公文写作Skill,让所有办公室同仁少掉头发、少加无用的班,材料一稿过关,省下的时间
50 77.2万 WPS全家桶·办公管家.Skill当用户要处理 Word/Excel/PPT、做文档模板与排版、批量合并图表、公文一键套红头、会议纪要要素化、或跨引擎办公自动化时,WPS
2 73.8万