ACORG docs

主题

腾讯文档 MCP ​

腾讯文档 MCP 适合把腾讯文档中的在线文档、智能表格、幻灯片、思维导图、流程图和协作空间接入 AI 客户端,用于需求梳理、资料总结、文档创建、表格更新和验收核对。

官方文档:https://docs.qq.com/aio/p/scscyt11f44r7mn?p=zUl82NjI94qGab1NeQghFDF&nlc=1

腾讯云 MCP 广场:https://developer.cloud.tencent.com/mcp/server/11803

适用场景 ​

  • 读取腾讯文档中的需求说明、项目计划、会议纪要、验收标准和历史资料。
  • 在空间中搜索文档,根据标题或正文定位目标文件,再读取完整内容。
  • 通过 Markdown 创建智能文档、Excel、幻灯片、思维导图、Word 文档或流程图。
  • 对已有智能文档追加内容、修改元素、查询页面结构或删除元素。
  • 对智能表格进行工作表、视图、字段和记录的增删改查。
  • 在使用腾讯文档作为主要协作空间的团队中接入 AI 助手。

配置要求 ​

腾讯文档 MCP 是远程 HTTP MCP 服务。先访问授权页获取个人 Token:

text
https://docs.qq.com/open/auth/mcp.html

在支持远程 MCP 的 IDE 或客户端中添加:

json
{
  "mcpServers": {
    "tencent-docs": {
      "url": "https://docs.qq.com/openapi/mcp",
      "headers": {
        "Authorization": "YOUR_TOKEN"
      }
    }
  }
}

Header 的 key 必须是 Authorization,不要写成 token、auth、X-Token 等其他名字,否则会鉴权失败。

OpenClaw 场景需要先设置环境变量并运行安装脚本:

bash
export TENCENT_DOCS_TOKEN="YOUR_TOKEN"
bash setup.sh
mcporter list | grep tencent-docs

如果没有配置 Token,工具调用会返回鉴权失败。

工具能力 ​

实际工具以 tools/list 返回为准。官方文档列出的主要能力包括:

分类典型工具用途
创建文档create_smartcanvas_by_markdown、create_excel_by_markdown、create_slide_by_markdown、create_mind_by_markdown、create_flowchart_by_mermaid、create_word_by_markdown用 Markdown 或 Mermaid 创建不同类型文档
空间管理query_space_node、create_space_node、search_space_file、delete_space_node查询空间节点、创建文件夹或文档节点、搜索和删除节点
文档操作get_content、batch_update_sheet_range获取文档正文、批量追加更新 Excel 单元格
智能文档smartcanvas.*查询页面结构,新增、更新、删除页面/文本/标题/待办等元素
智能表格smartsheet.*管理工作表、视图、字段和记录

调用时参数必须是 JSON 对象,不要把 JSON 再包成字符串。

text
mcp: tencent-docs
tool: search_space_file
arguments: { "keyword": "需求评审" }

文档类型选择 ​

新增通用文档时,官方指南推荐优先使用智能文档:

需求推荐工具
报告、笔记、方案、会议纪要、教程create_smartcanvas_by_markdown
需要计算、筛选、统计的数据表create_excel_by_markdown
项目汇报、培训材料、投影演示create_slide_by_markdown
层级化知识整理、头脑风暴create_mind_by_markdown
流程图、时序图、架构图create_flowchart_by_mermaid
多视图结构化数据、看板、字段管理smartsheet.*
明确要求传统 Word 格式create_word_by_markdown

创建文档类工具支持 parent_id,可将文档创建到指定目录;不填时创建到根目录。

典型工作流 ​

搜索并读取文档 ​

  1. 使用 search_space_file 搜索目标文档。
  2. 从结果中获取 node_id;腾讯文档指南说明 node_id 同时也是 file_id。
  3. 使用 get_content 读取正文。
  4. 让 Agent 输出需求摘要、验收标准、风险点或待确认问题。

创建通用文档 ​

  1. 优先使用 create_smartcanvas_by_markdown。
  2. 用 Markdown 组织标题、段落、列表、表格、代码块和引用。
  3. 如需放入指定目录,先用 query_space_node 找到目标目录并传入 parent_id。
  4. 从返回结果中保存 file_id 和 URL。

编辑已有智能文档 ​

  1. 使用 smartcanvas.get_top_level_pages 获取顶层页面。
  2. 使用 smartcanvas.get_page_info 分页读取页面元素。
  3. 追加内容时使用 smartcanvas.append_insert_smartcanvas_by_markdown。
  4. 精细编辑时使用 smartcanvas.create_smartcanvas_element、smartcanvas.update_element 或 smartcanvas.delete_element。

智能表格更新 ​

  1. 使用 smartsheet.list_tables 获取 sheet_id。
  2. 需要新增字段时调用 smartsheet.add_fields。
  3. 批量写入或更新记录时调用 smartsheet.add_records、smartsheet.update_records。
  4. 查询记录时先拿到 record_id,再执行更新。

提示词示例 ​

text
请在腾讯文档空间中搜索“支付改造验收”相关文档。
读取命中的需求说明和验收表,整理业务目标、功能范围、验收标准、风险点和待确认问题。
只读取信息,不要创建、更新或删除文档。
text
请把下面的项目复盘内容创建为腾讯文档智能文档。
优先使用 create_smartcanvas_by_markdown,创建前先告诉我目标目录和文档标题。

常见问题 ​

错误或现象处理方式
400006 Token 鉴权失败确认 header key 是 Authorization,Token 值正确,必要时重新获取
400007 VIP 权限不足按腾讯文档要求开通或升级 VIP 权限
找不到 tencent-docs 服务检查 MCP 配置名称、URL、客户端是否支持远程 MCP;OpenClaw 需执行 setup
工具不存在或参数不符先调用 tools/list 获取最新工具定义
删除节点风险过大delete_space_node 的 remove_type=all 会递归删除子节点,只在明确确认后使用

注意事项 ​

  • Token 属于敏感凭据,不要写入公开仓库、页面源码或可被前端打包的配置。
  • 腾讯文档里可能包含客户资料、合同、报价、账号信息或内部决策,接入前要确认授权范围。
  • 新增通用文档优先使用 create_smartcanvas_by_markdown;只有用户明确要求 Word 时再使用 create_word_by_markdown。
  • 创建流程图时,官方指南要求 Mermaid 内容全部使用英文。
  • 查询空间节点和页面元素存在分页,要根据返回字段继续拉取,不要只读第一页就下结论。
  • 删除 Page 元素会连带删除其下子元素;批量删除、移动或递归删除前必须让 Agent 列计划并等待确认。
  • 文档内容可能不是最终事实来源,关键结论要结合代码、Issue、PR 或正式审批记录核验。

相关页面 ​