腾讯文档 MCP 使用指南

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

支持的文档类型

⚙️ 快速配置

首次安装使用时，需要先完成本地安装和注册，详见references/auth.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和使用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 编辑) is an independent MCP service, but shares the same Token withtencent-docs. After completing the authorization fortencent-docs, it is automatically configured and does not require separate authentication.
• Asynchronous tasks use spawned sub-sessions for polling:create_slide(PPT generation),scrape_url(webpage clipping), and other asynchronous tasks. It is recommended to use a spawned sub-session dedicated to polling, keeping the main session responsive to avoid blocking user interaction.

Issue Troubleshooting Guide

Common Error Codes

排查步骤

1. 匹配错误码：先查上方错误码表，按对应方案处理
2. 确认工具可用：mcporter list tencent-docs查看可用工具列表及参数定义
3. 确认授权状态：如有鉴权相关错误，重新执行references/auth.md中的授权流程
4. 查阅品类参考文档：根据场景路由表找到对应参考文档，确认工具调用规范和参数约束

SKILL 更新

每天使用 SKILL 前进行一次更新检查，按照如下的步骤执行:

1. 查看当前版本version读取本文件顶部 frontmatter 中的version字段；格式为 MAJOR.MINOR.PATCH
2. 查看最新版本latest：通过命令获取最新版本信息latest，输入参数version为上一步获取的当前版本

mcporter call "https://docs.qq.com/openapi/mcp" "check_skill_update" --args '{"version": "<version>"}'

JSON 格式数据返回，返回参数示例：

• latest: 最新版本号，格式为 MAJOR.MINOR.PATCH
• release_note: 最新版本发布说明
• instruction: 更新指令

3. 更新版本：如果当前版本version低于最新版本latest，则遵循instruction指令进行更新，或提示用户更新