腾讯文档 MCP

问题背景

在自动化办公场景中，工程师经常需要把数据、报告、演示材料或流程说明写入腾讯文档，但不同文档类型对应的 doc_type、工具前缀和参数约束并不统一。直接调用容易出现选错文档类型、找不到 file_id、异步任务阻塞主会话、删除节点误伤子节点，以及 400006、-32601 等错误难以定位的问题。该技能把腾讯文档 MCP 的操作方式整理成路由式指南，用于降低对 smartcanvas、sheet、slide、smartsheet、form 等工具的选择成本。

工作方式

• 场景路由：报告和总结优先选择 smartcanvas，结构化数据使用 smartsheet，计算和表格操作使用 sheet，Word 编辑使用 docengine，PPT、思维导图、流程图和收集表分别路由到对应参考文档。
• 核心能力：支持文档创建、内容读取、文件管理、空间节点管理、图片上传、网页剪藏、不支持能力上报，以及 get_content 等公共接口。
• 关键步骤：先确认授权状态，再用 mcporter list tencent-docs 核对工具 Schema；创建时可使用 parent_id 指定目录，异步任务如 PPT 生成和网页剪藏建议用子会话轮询，主会话保持响应。

适用边界

• 权限约束：400006 通常表示 Token 鉴权失败，400007 表示 VIP 权限不足，需要先处理授权或权限问题。
• 操作风险：删除空间节点时默认仅删除当前节点，使用递归删除前必须确认范围。
• 兼容性原则：参数以 MCP 工具 Schema 为准，node_id 与 file_id 可对应，Markdown 内容使用 UTF-8，分页结果通过 has_next 判断是否继续读取。