APIリファレンス：MCP

MCPサーバーを使用すると、AIアシスタントはModel Context Protocolを通じてProcessMindと連携できます。Streamable HTTP上でJSON-RPC 2.0を使用し、initializeを送信してからtools/listを送信すると、ツールカタログを確認できます。list_processesなどの読み取りツールは、APIキーにreadスコープがある場合にのみ一覧に表示されます。書き込みツールにはwriteスコープが必要です。tools/callを使用すると、引数を指定してツールを呼び出せます。セッションをまたいで使用する情報はメモリーツール（remember、recall、forget）に保存できます。長時間実行されるAI生成はツール呼び出しごとに追跡されるため、_meta["io.modelcontextprotocol/related-task"]にタスク参照を付けると、ProcessMindがそのタスクのステータスを呼び出しとともに返します。tasks/list、tasks/get、tasks/cancelの拡張メソッドは提供されません。

Model Context Protocolサーバーエンドポイント（Streamable HTTP上のJSON-RPC）

Streamable HTTP上のJSON-RPC 2.0：initialize、tools/list、tools/call、resources/list、resources/read、prompts/list。読み取りツールにはキーのreadスコープ、書き込みツールにはwriteスコープが必要です。ツールカタログはMCPガイドに記載されています。x-api-keyまたはAuthorization: Bearer <token>（OAuthトークンエンドポイントから取得したトークン）で認証してください。

エンドポイント： POST /v1/mcp/{tenantId}

認証： テナントスコープのAPIキー · readスコープ · レート制限20 req/s（バースト40）

パラメーター：

名前	型	場所	必須	説明
tenantId	string	パス	はい	形式：uuid

リクエスト本文：

MCP JSON-RPCリクエスト

{}

レスポンス（200）：

MCP JSON-RPCレスポンス

{
	"message": "string"
}

フィールド	型	必須	説明
message	string	はい

エラー：

• 401 APIキーがない、無効、無効化済み、または期限切れです
• 403 APIキーに必要なスコープまたは組織へのアクセス権がない、テナントが非アクティブ、またはプランでファイル形式が許可されていません

OAuth 2.1認可エンドポイント（PKCE）、302リダイレクトでredirect_uriに戻り、?code=…を付与

エンドポイント： GET /v1/mcp/{tenantId}/oauth/authorize

認証： パブリック、APIキー不要 · レート制限10 req/s（バースト20）

パラメーター：

名前	型	場所	必須	説明
tenantId	string	パス	はい	形式：uuid
client_id	string	クエリ	はい
redirect_uri	string	クエリ	はい	形式：uri
code_challenge	string	クエリ	はい
code_challenge_method	S256	クエリ	いいえ	許可される値：S256
state	string	クエリ	いいえ

エラー：

• 302 code + stateを付けてredirect_uriにリダイレクト
• 400 不正なリクエスト：無効なフィルター式、モデルのないプロセス、サポートされていないアップロード形式、必須フィールドの欠落など
• 401 APIキーがない、無効、無効化済み、または期限切れです

OAuth 2.0トークンエンドポイント（client_credentialsまたはauthorization_code + PKCE）

エンドポイント： POST /v1/mcp/{tenantId}/oauth/token

認証： パブリック、APIキー不要 · レート制限5 req/s（バースト10）

パラメーター：

名前	型	場所	必須	説明
tenantId	string	パス	はい	形式：uuid

レスポンス（200）：

アクセストークン

{
	"access_token": "string",
	"token_type": "Bearer",
	"expires_in": 0
}

フィールド	型	必須	説明
access_token	string	はい	POST /v1/mcp/{tenantId}用の短期Bearer JWT
token_type	Bearer	はい	許可される値：Bearer
expires_in	number	はい

エラー：

• 400 不正なリクエスト：無効なフィルター式、モデルのないプロセス、サポートされていないアップロード形式、必須フィールドの欠落など
• 401 APIキーがない、無効、無効化済み、または期限切れです
• 403 APIキーに必要なスコープまたは組織へのアクセス権がない、テナントが非アクティブ、またはプランでファイル形式が許可されていません