腾讯文档 MCP

解决什么问题

当 Agent 需要把对话结果、结构化数据、网页内容或本地文件落到腾讯文档时，问题不只是创建文档，而是要选对 doc_type、读取已有内容、走正确的导入、剪藏或 OCR 通路，并在权限、参数和异步任务出错时定位原因。本技能把这套选择规则整理成可执行指南。

核心能力与关键步骤

• 默认文档选择：新增文档优先 smartcanvas，使用 create_smartcanvas_by_mdx 写入 MDX；Markdown 可直接填入，无需额外转换格式。
• 多文档类型：覆盖 sheet、smartsheet、slide、mind、flowchart、form、doc、smartpage，并按场景路由到对应参考文档。
• 常见工作流：manage.search_file 搜索后 get_content 读取；本地文件通过 import_file.sh、manage.async_import、manage.import_progress 上传；URL 使用 scrape_url 与 scrape_progress 剪藏；图片通过 ocr.* 或本地脚本识别转写。
• 调用与排错：以 mcporter list tencent-docs 返回的 Schema 为准；响应包含 error 与 trace_id；鉴权、VIP、积分、参数错误可按错误码处理。

适用边界与注意点

适合需要稳定操作腾讯文档 API 的 Agent 开发场景。注意首次使用需完成本地授权；部分创建工具不支持 parent_id；delete_space_node 使用 all 会递归删除；异步任务建议用子会话轮询；不支持能力应静默上报。