MCPサーバー

本サービスが公開している変更ログ（承認済みのみ）を、AIエージェントやプログラムから そのまま参照できる形で無料公開しています。認証は不要です。

MCPツール 4 種 ／ データは JSON（UTF-8）／ 認証 不要

接続する

MCP（Model Context Protocol）クライアントからは、次のURLに Streamable HTTP トランスポートで接続します。

POST https://fh-watch.com/mcp

認証・APIキーは不要です。

Claude Code から追加する

ターミナルで次の1行を実行します。

claude mcp add --transport http fhw https://fh-watch.com/mcp

設定ファイルに書く

プロジェクトの .mcp.json（または各クライアントの MCP 設定）に追記します。

.mcp.json
{
  "mcpServers": {
    "fhw": {
      "type": "http",
      "url": "https://fh-watch.com/mcp"
    }
  }
}

動作を確認する（curl）

生の JSON-RPC でツール一覧を取得できれば接続できています。

ターミナル
curl -s https://fh-watch.com/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

仕様

トランスポート
Streamable HTTP（POST のみ）
レスポンス
JSON（application/json）。SSEストリーミングは使いません
セッション
セッションレス。Mcp-Session-Id は発行しません
プロトコル版
2025-06-18 / 2025-03-26（初期化時にネゴシエート）
認証
不要（公開データのみを返す参照系ツールのため）
提供機能
tools のみ（resources / prompts は提供しません）

提供ツール（4種）

ツール名・引数名は押すとコピーできます。

list_changes

承認済み変更ログを新しい順に一覧する

category
カテゴリ名で完全一致
visa_type
在留資格タグで完全一致
since
ISO 8601。この日時以降の公開分
limit
1〜100、既定20
offset
既定0

get_change

変更ログを ID 単体で取得する

id必須
整数

search_changes

タイトル・変更点・要約を対象に部分一致検索する

q必須
検索語
limit
1〜100、既定20

list_sources

監視対象の公式ソース一覧と最終巡回日時・掲載件数を返す

引数なし

各ツールは content[0].text（JSON文字列）と structuredContent の両方で同じデータを返します。該当IDが無い・検索語が空などのデータ起因のエラーは、 JSON-RPCエラーではなく isError: true の結果として返します。

データスキーマ

変更ログ1件（items[] の各要素）は次のフィールドを持ちます。

フィールド型内容
idinteger安定ID。/changes/{id}/ に対応し、変更されません
source_idstring監視ソースID（list_sources が返す id に対応）
item_keystringソース内での項目キー（同一項目の同定用）
change_typestring変更の種別（例: new_item）
detected_atstring (ISO 8601)変更を検知した日時（UTC）
published_atstring (ISO 8601) | null本サービスで公開した日時（UTC）
titlestring変更のタイトル（事実ベース）。省庁サイトのリンク文言をそのまま保持する（末尾に [117KB] 等のサイズ表記が付くことがある。公開サイトでは表示時に落としている。同じ規則は正規表現 \s*[\[（(]\s*(?:PDF\s*[:：]?\s*)?[\d.,]+\s*[KMG]?B\s*[\])）]\s*$）
what_changedstring | null何が変わったか（差分の記述）
effective_datestring | null施行日 / 適用日。未確定は null
importancestring重要度（機械判定）。high＝施行日・期限が確定／mid＝パブコメ・議案・審議会など予告段階／low＝その他。解釈ではなく施行日の有無と出所で決まります
categoriesstring[]カテゴリ（固定語彙5種）
visa_typesstring[]対象の在留資格タグ（固定語彙）
summarystring | null要約（AI生成＋人間確認済み）
source_urlstring | null一次情報（公式）のURL
urlstring本サービスの安定URL（https://fh-watch.com/changes/{id}/）
correctionsobject[]訂正履歴。各要素は { at, note }
industriesstring[]業種スラッグ（特定技能の分野。掲載元・見出し・要約からの自動分類で、適用対象の判定ではありません）。未特定は空配列
proceduresstring[]手続スラッグ（documents＝様式・必要書類、council＝協議会 など）。見出し・要約の語からの自動分類で、該当なしは空配列。公開サイトの絞り込みには使っていません

内部の運用項目（AIモデル名・確認メモ・スナップショット参照・承認ステータス）は公開しません。 返るのは承認済み（approved）のエントリのみです。

更新頻度

公式ソースの巡回は日次で行い、検知した変更は人間が一次情報と突合して承認した ものだけを公開します。MCPが返すデータは、承認後の日次ビルドで更新される静的スナップショットです （generated_at が生成時刻）。したがって、承認から API 反映までは最大1日程度の遅れがあります。 レスポンスは最大5分間キャッシュされます。

各ソースの巡回状況（最終巡回日時・掲載件数）は情報ソース一覧で公開しています。

利用条件

  • 無料・認証不要。APIキーの登録は必要ありません。
  • 提供しているのはMCPサーバーのみです。REST API（/api/logs ほか）は 2026-09-19 に提供を止めました。
  • SLAはありません。可用性・応答時間・スキーマの安定性を保証するものではなく、 予告なく変更・停止する場合があります（ミッションクリティカルな用途には利用しないでください）。
  • 明示的なレート制限は設けていませんが、常識的な頻度でのアクセスにご協力ください。 過度なアクセスは配信基盤側で遮断される場合があります。
  • 引用時は出典を明記してください。すなわち (1) source_url（一次情報のURL）、(2) url（本サービスの安定URL）、 (3) 参照日 の3点です。AIエージェントの回答に使う場合も同様に明示してください。
  • 返すのは事実ベースの変更ログのみです。在留資格の可否判断・適法性の保証・ 個別事案への助言は含みません。
詳細は利用規約および免責事項をご確認ください。 掲載情報の正確性・完全性・最新性は保証されません。実際の手続・判断にあたっては、 必ず一次情報（公式情報）をご確認ください。