Doc2X MCP：Codex

返回：Doc2X MCP 使用指南

本页以 Codex CLI 为例，演示如何把 Doc2X MCP 作为本地 MCP server 接入，并在对话中调用。

你需要准备什么

• Node.js（建议 LTS）与 npx
• DOC2X_API_KEY
• （可选）如需代理：确保 HTTPS_PROXY / HTTP_PROXY 对运行 Codex 的终端生效

添加 MCP 配置

在终端中执行：

codex mcp add doc2x --env DOC2X_API_KEY=sk-XXX -- npx -y @noedgeai-org/doc2x-mcp@latest

查看 MCP

在 Codex 会话中打开 MCP 列表：

• 在输入框中输入 /mcp 并回车
• 或在 UI 中找到 MCP/Tools 列表入口

你应该能看到名为 doc2x 的 MCP server，并且状态为可用。

使用 doc2x-mcp

• 把要解析的 PDF 放在当前工作目录（或准备好可被访问的绝对路径）
• 在对话里明确告诉模型“使用 doc2x MCP 解析并导出”，并给出文件名

示例提示词（按你的文件名替换）：

• 使用 doc2x-mcp 解析 ./paper.pdf，并导出为 Markdown。

排查思路（常见）

• 看不到 doc2x server：确认上面的 codex mcp add ... 命令执行成功，并重新打开/刷新会话。
• 启动时依赖安装失败：多数是网络/代理问题；可先在终端里确认 npx -y @noedgeai-org/doc2x-mcp@latest 能正常拉取依赖。
• Key 不生效：确认 --env DOC2X_API_KEY=... 中的值为真实 Key（注意大小写与前后空格）。