腾讯文档 TENCENT DOCS

核心用法

腾讯文档MCP是一套完整的在线文档操作工具集，覆盖文档全生命周期管理。用户可通过自然语言指令完成文档创建、内容编辑、知识库管理和文件操作等任务。支持8种文档类型，包括智能文档（smartcanvas）、Excel表格、PPT幻灯片、思维导图、流程图、Word文档、智能表格和收集表。

创建文档：使用create_smartcanvas_by_mdx创建排版美观的智能文档，支持MDX高级格式；Excel用create_sheet_by_markdown；PPT用create_slide异步生成。

编辑文档：智能文档使用smartcanvas.*系列工具；Word精细编辑需调用独立服务tencent-docengine；表格计算使用tencent-sheetengine。

知识库管理：支持空间创建、节点管理、文件夹操作，通过space.*和manage.*工具实现目录组织和权限控制。

内容获取：get_content通用接口可读取所有文档类型内容，manage.search_file支持关键词检索。

显著优点

1. 生态完整：腾讯文档官方出品，与微信、QQ、企业微信生态无缝集成，协作场景覆盖全面
2. 格式丰富：国内少有的同时支持思维导图、流程图、智能表格、收集表的MCP技能
3. 智能排版：smartcanvas支持MDX格式，可嵌入组件、实现专业级排版效果
4. 精细编辑：docengine和sheetengine提供单元格级、段落级的精确操作能力
5. 异步任务优化：PPT生成、网页剪藏等长耗时任务支持子会话轮询，不阻塞主交互

潜在局限

1. VIP门槛：部分高级功能（如大容量存储、高级模板）需付费升级，错误码400007直接提示购买VIP
2. 授权复杂度：首次使用需完成本地安装和Token配置，对非技术用户有一定门槛
3. 异步依赖：PPT生成等任务需轮询等待，实时性不如纯同步接口
4. 格式兼容：从传统Word/Excel迁移至智能文档存在一定学习成本

适合人群

• 企业团队：需要多人协作编辑、知识库管理的项目组
• 内容创作者：追求排版美观的自媒体、运营人员
• 数据管理者：需结构化数据管理和可视化的分析师
• 教育场景：教师制作课件、学生整理笔记

常规风险

1. 数据隐私：文档内容存储于腾讯云端，敏感商业数据需谨慎评估
2. Token安全：TENCENT_DOCS_TOKEN需妥善保管，避免泄露导致文档被非法访问
3. 误删风险：delete_space_node使用all参数会递归删除所有子节点，操作不可逆
4. 服务依赖：依赖腾讯文档在线服务，网络波动或平台维护可能影响可用性

版本维护

建议每日使用前执行check_skill_update检查版本更新，当前版本1.0.23，遵循MAJOR.MINOR.PATCH语义化版本规范。

核心功能与定位

腾讯文档 MCP Skill 是腾讯官方推出的完整在线文档操作解决方案，覆盖从创建、编辑到管理的全生命周期。作为 T1 可信度级别的企业级工具，它深度整合了腾讯文档生态的核心能力。

核心能力矩阵

文档创建：支持 8 种文档类型，包括智能文档（smartcanvas，首推）、Excel 表格、PPT 幻灯片、思维导图、流程图、传统 Word、收集表和智能表格（smartsheet）。其中智能文档采用 MDX 高级排版格式，支持丰富组件，是日常报告、笔记、文章的首选格式。

编辑能力：

• 智能文档：完整的 smartcanvas.* 工具链，支持 MDX 精细编辑
• Word 文档：独立 tencent-docengine 服务，支持 resolve_document_structure 获取完整结构树，可精确定位表格行列、文本框内部
• Excel 表格：tencent-sheetengine 服务支持单元格级精细操作
• 异步任务：PPT 生成、网页剪藏等采用 spawn 子会话轮询机制，避免阻塞主交互

知识库管理：完整的空间/节点/文件夹管理体系，支持创建空间、查询空间列表、管理节点结构，其中 node_id 与 file_id 统一标识。

数据操作：智能表格（smartsheet）支持多视图、字段管理的高级结构化数据操作，适合轻量级数据库场景。

显著优点

1. 生态整合：与腾讯文档网页端无缝互通，创建的文档可直接分享协作
2. 格式先进：智能文档（smartcanvas）的 MDX 格式支持现代排版需求
3. 精细编辑：Word 和 Excel 支持结构树解析，实现传统 Office 软件级别的精确操控
4. 安全合规：通过 GDPR、CCPA 认证，采用标准 OAuth2 授权，Token 本地存储
5. 异步优化：耗时任务采用子会话轮询，主会话保持响应

潜在局限

1. VIP 限制：部分高级功能需要腾讯文档 VIP，错误码 400007 明确提示权限不足
2. 网络依赖：必须在线访问 docs.qq.com，无离线编辑能力
3. 格式兼容性：智能文档（smartcanvas）与 Word 格式互通存在局限，复杂排版可能丢失
4. 分页限制：查询接口每页仅 20-40 条，大数据量场景需多次轮询

适合人群

• 企业团队：需要云端协作、权限管理、知识库建设的组织
• 内容创作者：习惯 Markdown/MDX 写作者，智能文档格式友好
• 数据管理者：需要轻量级结构化数据管理的 smartsheet 用户
• 办公自动化：需要通过 MCP 工具链批量处理文档的开发者

常规风险提示

• Token 安全：用户授权 Token 存储于本地 mcporter 配置，需在可信环境使用
• 删除风险：delete_space_node 的 remove_type=all 会递归删除子节点，操作不可逆
• 版本更新：建议每日使用前执行 check_skill_update 检查版本

技术架构亮点

Skill 采用模块化设计，tencent-docs 作为主服务，tencent-docengine 和 tencent-sheetengine 作为独立精细编辑服务，三者共用同一 Token，授权一次即可全域使用。网络层仅访问官方 docs.qq.com 域名，HTTPS 加密，无第三方依赖，纯系统工具（curl/jq/openssl）实现。