APIリファレンス：MCP

MCPサーバーを使うと、AIアシスタントはModel Context Protocolを通じてProcessMindと連携できます。Streamable HTTP上のJSON-RPC 2.0に対応しています。initializeを送信し、続けてtools/listを送信すると、利用可能なツール一覧を取得できます。list_processesなどの読み取りツールは、APIキーに読み取りスコープがある場合にのみ一覧に表示されます。書き込みツールには書き込みスコープが必要です。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リクエスト（バースト時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リクエスト（バースト時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リクエスト（バースト時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キーに必要なスコープまたは組織へのアクセス権がない、テナントが無効、またはプランでこのファイル形式が許可されていません