McpServer.json

注意事項¶

パラメータ変更時はパラメータ変更時の確認事項を確認してください。

設定値¶

本パラメータファイルの設定は下記の通りです。

トップレベルオブジェクト¶

読み取り専用モード（ReadOnlyMode）¶

ReadOnlyModeがtrueの場合、読み取り専用モードとなり、以下の参照系ツールのみが利用可能になります。それ以外の書き込み系ツールは、拒否メッセージとともにブロックされます。

参照系ツール一覧¶

レートリミット設定（RateLimit）¶

レートリミットは一定時間内に行える操作の回数を制限する仕組みです。Pleasanter MCPでは、4種類のレートリミット方式を利用できます。

1. 複数のレートリミット方式を同時に有効化した場合、すべてのリミッタが連結適用されます。レートリミットはAPIキー単位でパーティション分割されます。
2. レートリミット超過時はHTTP 429が返却され、Retry-Afterヘッダーが付与されます。レスポンスボディにはJSON-RPCエラー形式でメッセージが含まれます。
3. 利用制限の確認は、ユーザがリクエストを送信したタイミングで行われます。リクエストを受け取ったシステムが、次にリセットされる時刻を計算し、現在の利用状況が制限内に収まっているかを判定します。このチェックはバックグラウンドで定期的に実行されるのではなく、リクエストのたびにその場で判定される仕組みです。

①FixedWindow（固定ウィンドウ）¶

一定時間（ウィンドウ）ごとにカウンタをリセットし、その枠内での操作回数を制限する方式です。ウィンドウの境界付近で操作が集中すると、場合によってはレートリミットの2倍近いスループットを許容する可能性があります。

②SlidingWindow（スライディングウィンドウ）¶

直近の一定期間（ウィンドウ）だけを対象に操作回数を制限する方式です。Pleasanter MCPではカウンタ近似方式という、ウィンドウを複数のセグメントに分割し、セグメント単位で操作回数を制限する方式を採用しています。一般的に、Fixed Windowよりもウィンドウ境界でのバーストが発生しづらいとされています。

SegmentsPerWindowを増やすと、時間分解能が細かくなり、メモリ消費と更新頻度が増えます。逆にSegmentsPerWindowを減らすと、FixedWindow方式に近づきます。

③TokenBucket（トークンバケット）¶

バケット内のトークンを消費する形で操作回数を制限する方式です。バケット内にトークンが存在する限り処理は即時許可され、枯渇した場合は拒否されます。バケット内のトークンは一定間隔で補充されます。単位時間あたりのリミットを設けつつ、瞬間的なスループット増加にも対応したい場合に向いています。

④Concurrency（同時実行数制限）¶

負荷制御に近い方式です。単位時間あたりの回数ではなく、同時実行数を制限します。同時実行開始時にカウントを増やし、完了時に減らします。

MCPログ設定（Logging）¶

MCPリクエスト・レスポンスのログに関する設定です。

対応バージョン¶

関連情報¶

• パラメータ設定：パラメータ変更時の確認事項
• MCPログ管理機能
• システムログをテキスト出力できるようにする