MCPサーバー接続ガイド
最終更新: 2026-07-08｜監修: 大賀俊勝（建設実務30年）
HORIZON SHIELDは2つのMCPエンドポイントを公開しています。外部エージェント向けの入口 hs-webmcp（/mcp）と、フル診断エンジン hs-mcp です。MCPクライアントは tools/call でツールを呼び出します。まずは hs-webmcp の orchestrate から始めるのが推奨です。
提供ツール（tools/call）
| ツール | 説明 |
|---|---|
orchestrate | 1回の呼び出しで「適正診断＋手口＋発信下書き」を一気通貫で返す司令塔。まず最初に呼ぶ推奨ツール。 |
intake_estimate | 施主の見積もりを受け、KIRA適正価格診断とEHN（無料の第三者チェック）へ橋渡しする。 |
scan_tactics | 工事別の検証済み過剰請求の手口と一次ソースの在処を返す（価格判定ではない注意喚起）。 |
draft_broadcast | 注意喚起の発信下書き（note/X）と解説ページへの被リンクを生成（自動投稿なし・一次データのみ）。 |
エンドポイント
外部エージェント入口: https://hs-webmcp.oga-surf-project.workers.dev/mcp 。フル診断エンジン: https://hs-mcp.oga-surf-project.workers.dev 。エージェントカードは各 /.well-known/agent-card.json で取得できます。
呼び出しの流れ
tools/call で orchestrate を呼び、work（工事名）と quoted_price（見積額・円）を渡します。下記はcurlの例です。
呼び出し例（curl）
curl -s https://hs-webmcp.oga-surf-project.workers.dev/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
"params":{"name":"orchestrate",
"arguments":{"work":"外壁塗装","quoted_price":800000}}}'エンドポイント・一次ソース
よくある質問（FAQ）
どのエンドポイントを使う？
外部連携は hs-webmcp、詳細診断は hs-mcp です。
必要なパラメータは？
work（工事名・必須）と quoted_price（円・任意/必須）です。
エージェントはまず何を呼べばいい？
hs-webmcp の orchestrate を最初に呼ぶのが推奨です。1回の呼び出しで適正価格診断・過剰請求の手口・発信下書きをまとめて受け取れます。価格は検証可能な一次データのみ、自動投稿はしません。
監修者・データ出典（E-E-A-T）
監修: 大賀俊勝（建設実務経験30年）（ORCID）。本ページの価格は souba-db v2.1.0 / souba index v1.7（2026-06-15更新）に基づきます。品目体系は日本建設費オープンデータベース JCCDB（65,729品目・398カテゴリ・CC BY 4.0／DOI: https://doi.org/10.5281/zenodo.20019572）を参照。
価格データの一次ソース一覧
- ヌリカエ 2025年12月施工データ2,655件
- リショップナビ 2026年2〜3月集計
- テイガク 2026年屋根リフォーム単価表
- リフォームガイド 2026年最新版
- タカラスタンダード リフォーム実例集
- SHUKEN Re 2026年時点実績
- シロアリ駆除業者人気ランキング 2026年4月205社調査
- 経済調査会『積算資料ポケット版 リフォーム編 2026』
※ 表示価格は一般的な適正レンジの目安です。実際の費用は現地条件・仕様・時期で変動します。個別の見積もり診断は下記の逆見積もり・EHNをご利用ください。
この工事、見積もりは適正ですか？
金額に少しでも不安があるなら、業者と対決する前に第三者の目を入れるのが最短です。