本文へ

消防てんけん帳 > 連携の説明(連携の鍵と MCP)

連携の説明(連携の鍵と MCP)

消防てんけん帳 は、AI の道具(MCP)や他の仕組みから、物件の期限と報告の進みを読めるようにしています。道具はすべて読むだけで、点検票・報告を変えることはできません。建物のオーナーの氏名・住所・電話などの個人の情報は返しません。

1. 連携の鍵をもらう

鍵は、事業者の管理者が、設定の画面の「連携の鍵」で発行します(どのプランでも使えます)。鍵は sb_ で始まり、発行の直後に1回だけ表示されます。当社は鍵そのものを保存せず、ハッシュだけを持ちます。止めた鍵はすぐに使えなくなります。

スコープできること
mcp:invoke/api/mcp を呼べる
read:summaryオーナーの個人の情報を含まない、物件の期限・報告の進み・判定を読める

2. 鍵を確かめる

curl -H "Authorization: Bearer sb_live_xxxxxxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \n  https://shobo-tenkencho.com/api/partner/v1/ping

鍵が無い・違うときは 401、スコープが足りないときは 403 を返します。

3. MCP

入口は https://shobo-tenkencho.com/api/mcp(Streamable HTTP の JSON-RPC 2.0。応答は JSON 1件)。認証は上の鍵を Authorization: Bearer で送ります。使える方法は initialize・tools/list・tools/call・ping・server/discover です。対応する版:2025-11-25・2025-06-18・2025-03-26。

curl -X POST https://shobo-tenkencho.com/api/mcp \n  -H "Authorization: Bearer sb_live_…" -H "Content-Type: application/json" \n  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"list_deadlines","arguments":{"within_days":60}}}'

道具(3つ。どれも readOnlyHint=true・destructiveHint=false・idempotentHint=true・openWorldHint=false)

名前中身
list_deadlines
点検と報告の期限の一覧
物件ごとの次の機器点検(6か月)・総合点検(1年)・消防署への報告(特定防火対象物1年/それ以外3年)の期限と状態(過ぎた・近い・まだ)。オーナーの氏名・連絡先は含まない。
get_report_pipeline
報告の進み
報告書の状態ごとの件数(作成・オーナーへ送付・受領・消防署へ提出済み)と、受領待ち・提出待ちの物件の番号と名称。
get_building_judgement
物件の判定
用途(令別表第一)と延べ面積などから判定した、報告の周期と、消防設備士・消防設備点検資格者による点検の要否、根拠の条文。

4. 回数の上限と記録

鍵ごとに1分に60回までです。超えると 429 と Retry-After(待つ秒数)を返します。呼び出しは、日時・道・応答の番号・かかった時間を記録し、事業者の管理者が確かめられます(中身や個人の情報は記録しません)。

5. できないこと

  • 点検票・報告書・物件を作る・変える・消すこと
  • 建物のオーナーの氏名・住所・電話・メールを読むこと
  • 申し込みと支払い(人が画面で行います:https://shobo-tenkencho.com/signup)

6. ほかの案内