1つのアカウント。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 が記載されているツールは順次実行されます: 2 つ目の同時呼び出しはすぐに SESSION_BUSY を返します（約 300 ms 後に再試行、po_knowledge_graph_ask の場合は 500 ms）。その他のツールは最大 4 の並列呼び出しで実行され、空き枠ができるまで最大 15 秒待機します。
• 全セッションのアクセストークンあたり：同時に実行可能なツール呼び出しは最大 24 件（ACCOUNT_BUSY）。
• 各ツール呼び出しには、PaperOffice API のリクエスト制限が適用されます。無料および訪問者トークンは、1秒あたり最低5回、1分あたり30回、1時間あたり100回、1日あたり500回のリクエストが保証されます。プラン別の上限はこれより高い場合があります。残高制の有料プランでは、リクエストレートではなく残高によって制限されます。レート制限により拒否された呼び出しは課金されず、details.http_status 429 と待機時間をメッセージに含めて TRANSIENT_TRANSPORT_ERROR を返します。
• 時間制限：バックエンド呼び出しは 90 秒後にタイムアウトされます（ナレッジベースへの書き込み操作では、盲目的に再試行する代わりに WRITE_OUTCOME_UNKNOWN または TRANSLATION_IN_PROGRESS が返されます）。po_knowledge_graph_ask は 120 秒後に停止します。
• ツール説明に記載されている制限：po_documents_upload_files の呼び出しあたり最大 10 ファイル（/chatgpt のみ）、マージ処理で PDF を 2 つ以上、ページあたり最大 500 件の検索結果、ページあたり最大 200 件の Workspaces、ページあたり 10〜200 件のゴミ箱エントリ。ダウンロードリンクは約 10 分で期限切れとなり、譲渡されたタスクは 15 間ロック状態になります。
• 課金：MCP の呼び出しは、REST API の呼び出しと同様に Credits で課金されます。「コストがかかる」または「クレジットを使用する」と説明にあるツールは AI 処理を開始し、より多くの Credits を消費します。