MCP
MCP(AI から BOUNTY につなぐ仕組み)の接続を支える API。接続している本人の確認、画像や SVG の一時アップロード、接続リンクの受け取りと、受け取ったトークンの一覧・失効を扱う。
この分類のあらまし
- 誰が呼べるか
ログインした本人。一時アップロードの受け口へファイルを送る入口は、受け口を作ったときの一回限りの秘密で呼ぶ。
ログイン 5 件・認証なし 2 件
- 件数と印
この分類の API は 7 件・レート制限 5 件
短い時間に呼びすぎると断られる API(レート制限)。断られたら Retry-After の秒数を待って呼び直す。
- 契約での分類の説明
MCP 接続(リモート MCP の本人確認・一時アップロード・接続リンク)
よく使う順番
上から順に呼ぶことが多い組み合わせ。行を押すと、その API の詳細が右に開く(スマホは下から)。
すべての API7 件
この分類の API をすべて並べている。行を押すと、頁を移らずにその API の詳細が右に開き、送るもの・返るもの・呼び出しの見本が読める。閉じると一覧の同じ位置に戻る。
行の左の札は HTTP のメソッド。GET は情報の取得、POST は作成や操作の実行、PUT と PATCH は更新、DELETE は削除を表す。
- MCP 接続の確認: 接続している本人の表示名・運営権限・トークンの scope と期限(cookie のログインは token = null)・対象イベント・4S 連携と規約同意の状態・領域ごとの capabilities(can と、できない理由 1 つ。upload は予約できる purposes)・本人が管理する manages(イベント・会社・団体・学生発ベンチャー・BOSHU の主体)。can は各 API と同じ判定で、公開は常に draft_only(どの scope の API トークンでも・ログインでも)GET取得
/api/mcp/whoamiログイン・レート制限 - 画像・SVG の一時アップロードの受け口を作る(約 30 分・1 回限りの URL。バイト列は uploadUrl へ直接送る。公開なし)POST作成・操作
/api/mcp/uploadsログイン・レート制限 - 受け口へ生のバイト列を送る(?k= の 1 回限りの秘密だけが権限。ラスタは 4MiB まで WebP へ固定、SVG は 1MiB まで無害化)PUT更新
/api/mcp/uploads/{id}認証なし・レート制限 - 受け口へ multipart の file で送る(PUT と同じ検査)POST作成・操作
/api/mcp/uploads/{id}認証なし・レート制限 - MCP 接続リンクを受け取り、ログイン中の本人の API トークンを発行する(cookie のログインだけ・1 回限り・平文はこの応答だけ)POST作成・操作
/api/mcp/connect/{code}ログイン(cookie)・レート制限 - 本人が接続リンクから受け取った MCP トークンの一覧(平文なし)GET取得
/api/me/mcp-tokensログイン - 本人が自分の MCP トークンを失効させるDELETE削除
/api/me/mcp-tokens/{id}ログイン