腾讯文档 MCP · 安装到 Codex CLI 指南
2026-08-08

面向 OpenAI Codex CLI · 远程 MCP

腾讯文档 MCP → 安装到 Codex

把腾讯文档的官方 MCP 接进 Codex CLI，让 codex 直接用自然语言创建 / 编辑 / 管理你的云端文档。腾讯文档有 4 个独立 endpoint，每个都配成一个 MCP server 即可。

4个 endpoint 各配一个 server

Bearertoken 由 Codex 自动注入

~/.codexconfig.toml 一处搞定

0前置：准备 Access Token

腾讯文档 MCP 不走标准 OAuth 弹窗，鉴权靠一个 Access Token，由客户端通过 HTTP header 注入。你需要先拿到一个有效 token 并放进环境变量。

C 端（个人版 docs.qq.com）

环境变量：TDOC_OAUTH_ACCESS_TOKEN
注入 header：Authorization: Bearer <token>
获取：腾讯文档开放平台 OAuth 授权，或复用你在 WorkBuddy 已登录的票据

SaaS 端（企业版 saas.docs.qq.com）

环境变量：TDOC_ONEID_ACCESS_TOKEN
注入 header：X-Oneid-Access-Token: <token>
企业用户才需要，个人用户忽略

⚠️ Token 有有效期，过期后工具会报 400006 鉴权失败。建议把"刷新 token → 写回环境变量"做成脚本，或每次用前手动更新。

1确认 Codex CLI 已安装

装好 Codex CLI（需要 Node.js 22+），配置会写到 ~/.codex/config.toml。

# 安装（二选一）npm install -g @openai/codex# 或curl -fsSL https://chatgpt.com/codex/install.sh | sh# 验证codex --version

2写入 ~/.codex/config.toml

把下面整段粘进 ~/.codex/config.toml。4 个 endpoint 各是一个 server，主服务 + doc/sheet/slide 引擎分开配，能力才全。

# ===== 腾讯文档 C 端（个人版）=====# 主服务：通用 / 创建 / smartcanvas / smartsheet / OCR / scrape[mcp_servers.tencent_docs]
url = "https://docs.qq.com/openapi/mcp"bearer_token_env_var = "TDOC_OAUTH_ACCESS_TOKEN"# doc 引擎（Word 精细编辑）[mcp_servers.doc_mcp]
url = "https://docs.qq.com/api/v6/doc/mcp"bearer_token_env_var = "TDOC_OAUTH_ACCESS_TOKEN"# sheet 引擎（Excel 精细编辑）[mcp_servers.sheet_mcp]
url = "https://docs.qq.com/api/v6/sheet/mcp"bearer_token_env_var = "TDOC_OAUTH_ACCESS_TOKEN"# slide 引擎（PPT 精细编辑）[mcp_servers.slide_mcp]
url = "https://docs.qq.com/api/v6/slide/mcp"bearer_token_env_var = "TDOC_OAUTH_ACCESS_TOKEN"# ===== 腾讯文档 SaaS 端（企业版，可选）=====[mcp_servers.tencent_saas_docs]
url = "https://saas.docs.qq.com/api/v6/open/agent/mcp"env_http_headers = { "X-Oneid-Access-Token" = "TDOC_ONEID_ACCESS_TOKEN" }

为什么用 bearer_token_env_var：Codex 运行时会自动读取该环境变量，并把值注入 Authorization: Bearer <token> 请求头——正好匹配腾讯文档 C 端的鉴权方式，且 token 不落盘到配置文件。

3不想手写？用命令行添加

Codex CLI 提供 codex mcp add，效果等同于写 config.toml（只演示主服务，其余 3 个照葫芦画瓢）。

# 主服务（注意：--header 里的值建议用环境变量，避免硬编码）codex mcp add tencent_docs --url https://docs.qq.com/openapi/mcp \
  --header "Authorization: Bearer $TDOC_OAUTH_ACCESS_TOKEN"# 查看已配置的所有 MCPcodex mcp --help
codex mcp list

⚠️ 命令行 --header 里的 $VAR 不会被自动展开成环境变量值；真要接活，推荐第 2 步的 bearer_token_env_var 写法。

4验证连接

启动 Codex，用内置命令确认 4 个 server 都连上了、工具可见。

# 启动交互模式codex# 在 codex 提示符里输入：/mcp

应看到 tencent_docs / doc_mcp / sheet_mcp / slide_mcp 列出，且各自带可用工具。然后在对话里直接说：

用户：在腾讯文档新建一份周报，用 Markdown 写 进展/风险/计划用户：把这份 Excel 的 A1:C10 填成我的销售数据

5调用时认准 endpoint（重要）

腾讯文档把能力分散在 4 个 endpoint 上，codex 里它们就是 4 个独立 server。精细编辑务必走对应引擎，否则能力不全。

server 名	负责品类
`tencent_docs`	通用 / 创建 / smartcanvas / smartsheet / OCR / 网页剪藏
`doc_mcp`	doc（Word）精细编辑
`sheet_mcp`	sheet（Excel）精细编辑
`slide_mcp`	slide（PPT）精细编辑

6常见坑 & 解决

现象	原因 / 解决
工具不出现	改完 config 后重启 codex；CLI 模式最稳，VS Code 扩展偶有检测不到的已知 bug（issue #6465）
`400006 鉴权失败`	token 失效或未注入。检查环境变量是否 export、是否过期，重新获取后重试
项目里 server 没加载	项目级 `.codex/config.toml` 需设 `trust_level = "trusted"`；否则放全局 `~/.codex/config.toml`
`400016 类型不匹配`	用错品类 server（如用主服务改 doc）。先确认文档类型再路由
连接超时	检查网络 / 代理；可在 config 调大 `startup_timeout_sec = 30`

7参考 & 官方入口

Codex 高级配置文档腾讯文档首页

本页面向 OpenAI Codex CLI。如果你的 codex 是 ChatGPT/Codex 网页版 或 公司内部平台，配置入口不同——告诉我具体形态，我给你对应的版本。

无尘阁日记

无尘阁日记