テーマ
APIキー・API・MCP オプション
/orgs/{orgId}/api-keysで、SISA公開API(External API)と MCP(AI エージェント連携)へアクセスするためのAPIキーを発行・管理します。Basic・Business・Premium のプランで利用できます(Lite では利用できません)。
API・MCP オプションとキー発行の関係
APIキーの発行・失効はセキュリティ上の操作、API・MCP オプション(基本料 月額¥1,500・税込)の契約・解約は課金上の操作として、意図的に別々の操作として扱われています。
- 最初のAPIキーを発行すると、API・MCP オプションが自動的に有効化されます(別途申し込み手続きは不要)
- キーを1本失効させても、他にキーが残っていればAPI・MCP オプションの課金は継続します
- 「API・MCP オプションを解約」を実行すると、現在の請求期間の終わりまでは利用でき、期間終了時に発行済みのキーがすべて失効します。解約後も期間終了前であれば「解約を取り消す(再有効化)」ができます
APIキーを発行する
「発行」から、キー名(用途がわかる名前。例: 「社内ダッシュボード連携」)と権限(読み取り専用/ 読み取り・書き込み)を指定します。用途ごとにキーを分けておくと、権限の管理や必要になったときの失効がしやすくなります。
発行直後の画面にのみ、キーの値がそのまま表示されます。「クリップボードにコピーする」で控えておいてください。一覧に戻ると、以後この値を再表示することはできません。
キーを再生成・失効する
一覧の各キーから「再生成」(値だけを新しくして権限・キー名は維持)、または「失効する」(そのキーを完全に無効化)ができます。失効は取り消せません。
利用量と月の上限
APIキー画面の「API利用量」に、今月と先月のコール数(MCP 経由の内訳つき)と、超過分の利用料の見込みが表示されます。
料金のしくみ
- 基本料(月額¥1,500)に、プランごとの回数が含まれます: Basic 1,000・Business 3,000・Premium 5,000 コール/月
- 超えた分は 1,000 コールごとに¥300 です(1 コールでも超えると 1,000 コール分)。月ごとに計算し、翌月の請求に含まれます
- 計算例は料金ページにあります
月の上限(使いすぎの歯止め)
- 月のコール数には上限があり、既定は 100,000 コールです。上限に達すると、その月の残りはHTTPレスポンス
429 USAGE_LIMIT_EXCEEDEDで止まり、翌月 1 日(組織の請求タイムゾーン)に戻ります - 組織のオーナー・管理者は、「API利用量」の「月の上限」で上限を変えられます。設定できるのはプランの込みの回数〜1,000,000 コールです
- 保存の前に、その上限まで使った場合の超過利用料の最大額が表示されます。上限を上げるほど、払いうる額も上がります
- 今月すでに使った回数以下に下げると、保存した時点から翌月まで API が止まります(請求を止めたいときの操作として、保存はできます)
- 「既定(100,000 回)に戻す」で既定の上限に戻せます
- 上限の 80% と 100% に達したときは、オーナー・管理者にメールでお知らせします。上限を変えると、その月のお知らせは数え直します
AI エージェントに見に行かせる場合
数分おきに状況を見に行かせると、コール数はすぐに積み上がります(5 分おきに 3 コールで月およそ 26,000 コール)。変わったものだけを取る書き方で抑えられます → コール数を抑える書き方
イベント Webhook(SISA から送る)
同じ「APIキー」画面の「イベント Webhook」に URL を登録すると、アラートが届いた・インシデントが開いた・報告書を作成したなどの通知を SISA からその URL へ送ります(API・MCP オプションの機能・登録はオーナーと管理者のみ)。通知を受け取ったタイミングで、AI エージェントやプログラムを動かせます。イベント Webhook は API コールに数えません。
- 送り先は 5 つまで。送るイベントとプロジェクトを選べます
- 追加すると署名の秘密が 1 回だけ表示されます。受け取る側で、届いた通知が SISA からのものか確かめるのに使います
- 「テスト送信」で届くかをその場で確かめられます。「配送の記録」で直近 30 日の結果を見て、失敗したものを再送できます
- 24 時間続けて届かないと自動で停止し、メールでお知らせします。止まっている間のイベントは後から送りません
詳細は イベント Webhook に記載されています。