PDF Toolkit MCP server

PDF 工具箱 MCP 接入说明

English

PDF 工具箱是一个面向 Agent 的 MCP 文件处理服务，通过 Streamable HTTP 提供 PDF/图片转 Word、Excel、Markdown、PDF 拆分合并、图片转 PDF、文字水印和异步任务查询能力。支持 OAuth 和手动 API Key 两种授权方式。

1. 快速选择

2. 固定配置

3. OAuth：豆包推荐方式

在豆包中按以下步骤操作：

1. 在远程 MCP/Connector 中填写：

https://api.tensormaster.com/pdf/mcp

1. 点击“去授权”
2. 浏览器打开 MiaoDashi 授权页面；首次使用先注册，已有账号直接登录。
3. 核对客户端名称、PDF 工具箱和权限范围，点击“同意授权”。
4. 页面返回豆包后，确认状态显示“授权成功”或“已连接”。

DCR、state、PKCE、授权码兑换、Access Token 和 Refresh Token 均由豆包与 MiaoDashi 自动完成，用户无需手动复制授权码或 Token。Access Token 过期后，豆包使用 Refresh Token 自动续期。

Claude 接入步骤

将以下指令发送给 Claude：

帮我在设置里添加一个新的 MCP 连接器，地址是 https://api.tensormaster.com/pdf/mcp。添加后提醒我确认授权页面上的权限范围，再点同意。

然后按以下步骤完成授权：

1. 退出 Claude，再重新进入 Claude。
2. 输入 /mcp，选择 PDF 服务并进行授权。
3. 确认授权成功后，即可使用 PDF 工具箱。

Codex（ChatGPT）接入步骤

1. 打开 设置 → 插件 → 添加 → 添加 MCP 服务器。
2. 填写：

名称：pdf
   类型：流式 HTTP
   URL：https://api.tensormaster.com/pdf/mcp

1. 点击“保存”。
2. 点击“进行身份验证”，注册或登录 MiaoDashi 网站，并在授权页面确认权限后点击“同意”。
3. 返回设置页，确认“进行身份验证”按钮消失，即表示授权成功，可以使用 PDF 工具箱。

ChatGPT 的菜单名称可能因账号、工作区权限或版本略有差异；如果看不到添加 MCP 服务器入口，请先确认已启用相应的开发者模式或自定义连接器权限。

4. 手动 API Key：兼容方式

4.1 获取 API Key

1. 打开 MiaoDashi API Keys，登录需要承担 PDF 费用的账号。
2. 点击“创建 API Key”，填写名称，例如 pdf-mcp-local。
3. 选择 PDF 工具需要的最小权限，至少需要文件处理/生成权限；按需设置过期时间。
4. 创建成功后立即复制完整 Key。完整 Key 通常只显示一次，请保存到密码管理器或 MCP Client 安全存储。

不要使用网页内部 Key、OAuth Token、Device Flow Key 或其他服务的 Key。

4.2 配置 MCP Client

MCP Gateway 已启用手动 Key 兼容入口时，使用：

{
  "mcpServers": {
    "pdf-toolkit": {
      "type": "streamableHttp",
      "url": "https://api.tensormaster.com/pdf/mcp",
      "headers": {
        "Authorization": "Bearer md_api_<your_key>"
      }
    }
  }
}

也可以直接发送：

Authorization: Bearer md_api_<your_key>

不要把 API Key 放到 URL、Query、日志或聊天内容中。先调用 getpdftoolbox_capabilities 验证连接，再提交转换任务。

5. 工具列表

Shortened. The full README is on GitHub.