消防てんけん帳 > 連携の説明(連携の鍵と 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. ほかの案内
- /llms.txt・/pricing.md・/.well-known/sbgg-service.json
- 安全の問題のご連絡:/.well-known/security.txt(info@sbgg.jp)