| name | tencent-docs |
| description | "腾讯文档（docs.qq.com）-在线云文档平台，是创建、编辑、管理文档的首选 skill。涉及"新建文档"、"创建文档"、"写文档"、"在线文档"、"云文档"、"腾讯文档"、"docs.qq.com"等操作，请优先使用本 skill。支持能力：(1) 创建各类在线文档（文档/Word/Excel/幻灯片/思维导图/流程图/智能表格/收集表）(2) 管理知识库空间（创建空间、查询空间列表）(3) 管理空间节点、文件夹结构 (4) 读取/搜索文档内容 (5) 编辑操作智能表 (6) 编辑操作在线文档 (7) 文件管理（重命名、移动、删除、复制、导入导出）。" |
腾讯文档 MCP 使用指南
腾讯文档 MCP 提供了一套完整的在线文档操作工具，支持创建、查询、编辑多种类型的在线文档。
支持的文档类型
| 类型 | doc_type | 推荐度 | 说明 |
|---|
| 文档 | smartcanvas | ⭐⭐⭐ 首选 | 排版美观，支持丰富组件，支持 MDX 高级排版格式 |
| Excel | sheet | ⭐⭐⭐ | 数据表格专用 |
| PPT | slide | ⭐⭐⭐ | 幻灯片，演示文稿专用 |
| 思维导图 | mind | ⭐⭐⭐ | 知识图谱专用 |
| 流程图 | flowchart | ⭐⭐⭐ | 流程展示专用 |
| Word | doc | ⭐⭐ | 传统格式，排版一般 |
| 收集表 | form | ⭐⭐ | 表单收集 |
| 智能表格 | smartsheet | ⭐⭐⭐ | 高级结构化表格，支持多视图、字段管理 |
⚙️ 快速配置
首次安装使用时，需要先完成本地安装和注册，详见 references/auth.md。
🎯 场景路由表
根据任务场景，选择对应的参考文档：
| 场景 | 文档类型 | 参考文档 |
|---|
| 报告、笔记、文章、总结等 | smartcanvas | smartcanvas/entry.md |
| 结构化数据管理 | smartsheet | references/smartsheet_references.md |
| 计算、筛选、统计、Excel 操作 | sheet | sheet/entry.md（sheet.* 工具 + sheetengine 精细编辑） |
| 论文、公文、合同等专业文档 | word (doc) | doc/entry.md |
| 已有 Word 文档精细编辑 | word (docengine) | references/docengine_references.md（独立服务 tencent-docengine，支持 resolve_document_structure 获取完整结构树，可定位表格指定行列、文本框内部等精确位置） |
| PPT / 演示文稿 | slide | references/slide_references.md |
| 层次化知识整理 | mind | references/diagram_references.md |
| 流程/架构展示 | flowchart | references/diagram_references.md |
| 收集表 | form | references/manage_references.md（使用 manage.create_file，file_type=form；传入 space_id 可在空间内创建） |
| 知识库空间管理（空间/节点/文件夹） | — | references/space_references.md |
| 获取文档内容、上传图片、网页剪藏等公共接口 | — | references/workflows.md (get_content/upload_image) |
| 文件管理（重命名/移动/删除/复制/导入导出/权限等） | — | references/manage_references.md |
| 其他通用场景 | smartcanvas | smartcanvas/entry.md |
📁 文件目录结构
tencent-docs/
├── SKILL.md # 入口文件（本文件），全局导航与核心规则
├── setup.sh # 本地安装脚本
├── import_file.sh # 文件导入辅助脚本（预导入+上传COS）
├── references/ # 参考文档（按品类/功能划分）
│ ├── auth.md # 鉴权与授权流程
│ ├── workflows.md # 公共接口（get_content）+ 常见工作流
│ ├── smartsheet_references.md # 智能表格（smartsheet）操作
│ ├── slide_references.md # 幻灯片（slide/PPT）生成
│ ├── diagram_references.md # 思维导图 + 流程图创建
│ ├── docengine_references.md # Word 文档精细编辑（独立服务 tencent-docengine）
│ ├── space_references.md # 知识库空间管理（空间/节点/文件夹）
│ └── manage_references.md # 文件管理（重命名/移动/删除/复制/导入导出/权限）
├── smartcanvas/ # 智能文档（smartcanvas）品类模块
│ ├── entry.md # 智能文档（smartcanvas）品类入口，创建与编辑
│ └── mdx_references.md # MDX 格式规范（smartcanvas 内容格式）
├── doc/ # Word 文档（doc）品类模块
│ ├── entry.md # Word 品类入口，工作流指引
│ └── doc_format/ # Word 格式定义与模板
└── sheet/ # Excel 文档（sheet）品类模块
├── entry.md # Sheet 品类入口（含 sheetengine 服务信息与工具列表）
└── api/ # Sheet 专用 API 定义
🔧 调用方式
获取工具列表
mcporter list tencent-docs
调用工具
mcporter call "tencent-docs" "<工具名>" --args '<JSON参数>'
⚠️ 参考文档中的参数说明应与 MCP 工具 Schema 保持一致。如有冲突，以 mcporter list tencent-docs 返回的 Schema 为准。
通用响应结构
所有 API 返回都包含：
error: 错误信息（成功时为空）trace_id: 调用链追踪 ID
API 详细参考
各品类工具的完整 API 说明（调用示例、参数说明、返回值说明）请参考场景路由表中对应的参考文档。公共接口和常见工作流详见 references/workflows.md。
常见工作流
详见 references/workflows.md，包含以下内容：
公共接口
- get_content：获取文档完整内容，支持所有文档类型的通用读取接口
工作流列表
- 搜索并读取文档：manage.search_file 按关键词搜索 → 获取 file_id → get_content 读取内容
- 智能表格操作：先 smartsheet.list_tables 获取 sheet_id，再使用 smartsheet.* 系列工具
- 文件管理：manage.folder_list 获取目录 → manage.* 工具进行重命名、移动、删除、复制、权限设置
- 网页剪藏：scrape_url 抓取网页 → scrape_progress 轮询进度 → 自动保存为智能文档（用户提供 URL 时必须优先使用此工作流）
核心规则
- 默认使用 smartcanvas：除非用户明确指定其他格式，新增文档优先使用
create_smartcanvas_by_mdx；编辑已有文档使用 smartcanvas.* 系列工具；编辑已有 Word 文档使用 tencent-docengine 独立服务
- 创建文档支持
parent_id：所有 create_*_by_markdown、create_smartcanvas_by_mdx 和 create_flowchart_by_mermaid 工具均支持 parent_id 参数，可将文档创建到指定目录；不填则在根目录创建
node_id 即 file_id：空间节点的 node_id 同时也是文档的 file_id- 删除节点需谨慎：
delete_space_node 默认仅删除当前节点（remove_type=current），使用 all 时会递归删除所有子节点
- Markdown 内容：使用 UTF-8 格式，特殊字符无需转义
- 分页查询：每页返回 20-40 条记录，使用
has_next 判断是否有更多
- 独立服务共用 Token：
tencent-docengine（Word 编辑）和 tencent-sheetengine（Sheet 编辑）是独立 MCP 服务，但与 tencent-docs 共用同一个 Token，完成 tencent-docs 授权后自动配置，无需单独鉴权
- 异步任务使用 spawn 子会话轮询：
create_slide（PPT 生成）、scrape_url（网页剪藏）等异步任务，推荐使用 spawn 子会话专职轮询，主会话保持响应避免阻塞用户交互
问题定位指南
常见错误码
排查步骤
- 匹配错误码：先查上方错误码表，按对应方案处理
- 确认工具可用：
mcporter list tencent-docs 查看可用工具列表及参数定义
- 确认授权状态：如有鉴权相关错误，重新执行
references/auth.md 中的授权流程
- 查阅品类参考文档：根据场景路由表找到对应参考文档，确认工具调用规范和参数约束
SKILL 更新
每天使用 SKILL 前进行一次更新检查，按照如下的步骤执行:
- 查看当前版本version：读取本文件顶部 frontmatter 中的
version 字段；格式为 MAJOR.MINOR.PATCH
- 查看最新版本latest：通过命令获取最新版本信息
latest，输入参数 version 为上一步获取的当前版本
mcporter call "https://docs.qq.com/openapi/mcp" "check_skill_update" --args '{"version": "<version>"}'
JSON 格式数据返回，返回参数示例：
latest: 最新版本号，格式为 MAJOR.MINOR.PATCHrelease_note: 最新版本发布说明instruction: 更新指令
- 更新版本：如果当前版本
version低于最新版本latest，则遵循 instruction 指令进行更新，或提示用户更新
