腾讯文档 MCP 在线文档工具

要解决的具体问题

围绕腾讯文档 MCP 的常见调用问题，是文档类型选择、读取、创建、编辑和文件管理分散在多个工具中。工程师接入后往往要判断报告该用 smartcanvas 还是 doc，结构化数据该用 smartsheet 还是 sheet，网页剪藏、图片上传、空间节点权限又各自走不同接口。这个技能把这些选择规则和工作流收敛成一套可读的导航：先按场景选文档类型，再按固定接口链完成搜索、读取、创建、管理和异步任务。

技能如何工作

核心能力包括在线文档、Excel、PPT、思维导图、流程图、智能表格、收集表和知识库空间管理。新增文档默认优先 create_smartcanvas_by_mdx，编辑已有文档使用 smartcanvas.*；结构化数据先 smartsheet.list_tables 获取 sheet_id，再调用对应工具；Excel 计算、筛选、统计走 sheet.* 系列。常见链路是：manage.search_file 按关键词找到文档，拿到 file_id 后用 get_content 读取完整内容；创建时可传 parent_id 放入指定目录，node_id 同时作为文档 file_id 使用。异步任务如 PPT 生成、scrape_url 剪藏，推荐用子会话轮询，避免主会话阻塞。

适用边界与注意点

参数约束应以实际工具 Schema 为准，尤其是 file_id、content、分页字段和权限参数。删除节点默认只删当前节点，递归删除风险更高，需要谨慎。涉及鉴权失败、接口不存在、参数错误时，应按错误码先确认授权、工具可用性和参数合法性。若用户请求的能力在工具列表中不存在，应先上报不支持能力，而不是直接给出不可执行方案。