一个账户。300+ MCP 工具。 直接在聊天工具中。

错误

工具错误将以 isError: true 的 MCP 工具结果返回。相同的 JSON 对象也存在于 structuredContent 和第一个文本内容块中：

{
  "error_code": "WORKSPACE_ACCESS_DENIED",
  "code": "WORKSPACE_ACCESS_DENIED",
  "message": "This connection has no access to this workspace.",
  "details": {
    "error_code": "WORKSPACE_ACCESS_DENIED",
    "workspace_id": 12345
  },
  "hint": "Use po_workspaces_list to see the workspaces this connection can access. Retrying will not change the result."
}

error_code

稳定且机器可读的代码。由于某些客户端可能会重写 error_code，因此它被镜像到 code 和 details.error_code 中。

message

面向人类的解释说明。

details

上下文信息，例如 http_status、retryable / retry_safe、suggested_backoff_ms、validation_errors 或已发送的 ID。

hint

为模型制定的下一步操作建议。

retryablehttp_status

顶层输出模式中声明的可选字段。

非错误：若缺少文件输入，基于文件的工具（提取、PDF）将返回以 FILE_UPLOAD_REQUIRED 开头的常规文本结果，其中列出了接受的输入或浏览器上传页面。

在传输层面，缺失、无效、过期或被撤销的令牌将收到 HTTP 401 状态码及 WWW-Authenticate 头（需重新执行 OAuth）。只要登录或工具目录暂时不可用，服务器将返回 HTTP 503 及 Retry-After（2–5 秒）。

速率限制与配额

• 每个 MCP 会话（Mcp-Session-Id）：最多同时 8 个工具调用。最后一列为 1 的工具按顺序运行：第二个并发调用将立即返回 SESSION_BUSY（约 300 ms 后重试，po_knowledge_graph_ask 为 500 ms）。其余工具最多支持 4 个并行调用，并等待最多 15 秒以获取可用资源。
• 每个访问令牌在所有会话中：同时最多 24 次工具调用（ACCOUNT_BUSY）。
• 每次工具调用均适用 PaperOffice API 的请求限制：免费和访客令牌至少享有每秒 5 次、每分钟 30 次、每小时 100 次、每天 500 次的请求额度；套餐值可能更高。付费套餐若剩余 Credits，则限制的是余额而非请求速率。受速率限制限制的调用不计费；它们返回 TRANSIENT_TRANSPORT_ERROR，其中 details.http_status 为 429，并在消息中包含等待时间。
• 时间限制：后端调用在 90 秒后中止（知识库中的写入操作随后返回 WRITE_OUTCOME_UNKNOWN 或 TRANSLATION_IN_PROGRESS，以避免盲目重试）；po_knowledge_graph_ask 在 120 秒后停止。
• 工具描述中提到的限制：每次 po_documents_upload_files 调用最多处理 10 个文件（仅限 /chatgpt），合并时每个 PDF 至少 2 个，每页最多返回 500 条搜索结果，每页最多 Workspaces，每页垃圾箱条目为 10–200。下载链接约在 10 分钟后过期，接管任务将锁定 15 分钟。
• 计费：MCP 调用按 REST API 在 Credits 中的调用方式进行计费。描述中注明“消耗积分”或“使用积分”的工具会启动 AI 处理并消耗更多 Credits。