MCP SERVICE
PDF 工具箱.
把 PDF 与图片处理能力接入你的 AI 助手。通过 MCP，一句话完成格式转换、拆分合并、图片转 PDF、水印和任务查询。
MCP 服务地址
Streamable HTTP
https://api.tensormaster.com/pdf/mcpWHY PDF TOOLKIT
面向 Agent 的文件处理能力
无需在多个工具之间切换，让 AI 助手直接调用稳定、可追踪的 PDF 工作流，适合内容整理、资料归档和电商办公场景。
多格式转换
PDF 或图片转 Word、Excel、Markdown，快速提取内容并继续编辑。
组合式处理
支持 PDF 拆分、合并、图片转 PDF 与文字水印，覆盖常用文档操作。
异步任务可追踪
任务创建、状态查询和结果下载分离，适合大文件与批量处理。
CLIENT QUICK START
常用客户端接入提示
不同客户端的菜单名称可能略有差异，但连接逻辑相同：填写地址、完成授权、确认工具可用。
豆包
远程 MCP / Connector 中填写地址，点击“去授权”，同意权限后返回确认连接。
Claude
让 Claude 在设置中添加 MCP 连接器，重启后输入 /mcp，选择 PDF 服务完成授权。
Codex（ChatGPT）
设置 → 插件 → 添加 MCP 服务器，选择流式 HTTP，保存后点击“进行身份验证”。
HOW TO CONNECT
两种方式，按你的客户端选择
OAuth 适合豆包、Claude、ChatGPT 等支持浏览器授权的客户端；不支持 OAuth 时，可使用 API Key。
OAuth 授权（推荐）
在支持 OAuth 的 MCP Client 中完成一次授权，后续由客户端自动刷新 Token。
- 1.在客户端添加远程 MCP，填入上方服务地址。
- 2.点击“去授权”或“进行身份验证”，注册或登录 MiaoDashi。
- 3.核对 PDF 工具权限范围，点击“同意”，返回客户端确认连接成功。
手动 API Key
适用于支持自定义 Header 的 MCP Client、curl 或本地调试。
- 1.打开账户中的“API 密钥与授权”，创建一个 API Key。
- 2.在 MCP Client 的 Header 中加入 Authorization。
- 3.将以下 JSON 复制到 Agent 对应的配置框中。
{
"mcpServers": {
"pdf": {
"type": "streamable-http",
"url": "https://api.tensormaster.com/pdf/mcp",
"headers": {
"Authorization": "Bearer md_api_xxx"
}
}
}
}AVAILABLE TOOLS
一组工具，完成流程
MCP Client 会自动发现工具和参数，你只需要描述目标，Agent 负责组织调用。
FAQ
常见问题
需要自己上传文件到 MCP 服务吗？+
MCP 请求使用可访问的 HTTPS 临时文件 URL。客户端或 Agent 需要先把附件映射为 file_url、file_urls 或 image_urls，再调用对应工具。
OAuth 和 API Key 应该选哪一种？+
支持浏览器授权时优先使用 OAuth；如果客户端只能配置 Header，使用 MiaoDashi 账户中的 API Key。两种方式都受账户积分和权限控制。
任务创建后如何获取结果？+
创建任务后保存 task_id，使用 get_pdf_task 查询 queued、running、succeeded 或 failed 状态；不要通过重复创建任务来轮询。