利用可能なMCPツール一覧

ThingsConnectのMCPサーバが提供するツールのパラメータ・レスポンス仕様

ThingsConnect のクラウド（MCPサーバ）が提供するツールの一覧です（全 56 種類）。接続方法はMCPサーバのセットアップを参照してください。

共通のルールです。

• パラメータ名は snake_case（edge_pc_id / device_id など）。レスポンスの JSON はツールによって snake_case と camelCase が混在します（下記の各節に実際の形を記載しています）。
• 参照できる範囲は接続トークンの組織（テナント）内だけです。他組織のエッジPC・デバイスを ID で指定しても「見つからない」として扱われます。
• 操作系のツールは「MCP（操作）」スコープを持つトークンでだけ使えます。 持たないトークンでは一覧にも出ません。対象は update_edge_pc_note / add_camera_device / update_device / remove_device / start_rtmp_stream / stop_rtmp_stream / create_dashboard / update_dashboard / delete_dashboard / add_widget / remove_widget / create_query / update_query / delete_query / onvif_probe_camera / onvif_register_camera / onvif_ptz_control / onvif_set_imaging / onvif_reboot_camera / protect_photo / capture / run_capture_job / protect_recording / unprotect_recording / update_camera_storage_settings の 25 個です。スコープの選び方はMCPサーバのセットアップを参照してください。
• パスワード・ストリームキー・エッジPC の認証情報は返しません。 レスポンスでは *** に伏せ、ツールの呼び出し記録にも伏せたまま残します。
• 組織全体で MCP を無効にしている場合は、どのツールも使えません（接続時に 403 が返ります）。設定は管理ダッシュボードの「組織設定」→「API・MCP」の「MCP サーバー」です。
• 画像を返すツール（get_device_snapshot / インライン指定の capture_device_image / get_snapshot / compare / capture）以外は、すべて JSON 文字列をテキストとして返します。

ツール一覧

エッジPC

デバイス（共通）

カメラ種別とソース欄

camera_kind によって使うソース欄が変わります。省略時は rtsp です。

usb / csi は先に list_local_cameras を呼んで値を取得してください（デバイスパスは推測できません）。width / height / fps は取り込み解像度で、rtsp では使いません（カメラ本体の設定に従います）。カメラ種別は登録後に変更できません（別の機器になるため、削除して登録し直します）。

カメラの映像・画像

センサ

AI アプリ

カメラに追加した AI アプリは、機器ではないのでデバイスのツールには出ません。1 件（インスタンス）が 1 台のカメラの映像を読み、結果を記録します。

ダッシュボード

クエリ（SQL）

ONVIF カメラ

撮影

撮影の撮影プリセットの向きと、メディアビューワーに保存した写真を扱います。場所は向きの名前（現場の呼称。「1 工区」「調整池」など）で指定します。 向きの無い撮影プリセットは、プリセット名がそのまま場所の名前になります。撮影ジョブ・撮影プリセット・外部送信先の登録は管理ダッシュボードの「撮影」で行い、ここでは参照・撮影と写真の保護を扱います。

• preset には向きの名前を渡します（パラメータ名は変えていません）。同じ名前の向きが複数の撮影プリセットにあるときは preset_name（撮影プリセットの名前）を、複数のカメラにあるときは device_id を添えます。
• 名前は表記ゆれを吸収します。 完全一致 → 前方一致 → 部分一致の順に探し、全角・半角と空白の違いは無視します。複数の場所が該当したときは候補を返すので、preset_name か device_id を添えて呼び直してください。
• 対象はメディアビューワーに保存したすべての撮影の写真です（スケジュール・手動・外部 API・エッジ内・その場で撮影のどれで撮ったかを問いません）。
• 画像は既定で横 1280px 程度に縮小したものを返します。 原寸（4K）が要るときだけ full に true を渡してください。
• 写真は撮ったエッジPC から読み出します。 エッジPC がオフラインの間は「画像を取得できませんでした（エッジPC がオフラインの可能性があります）。」を返します。
• compare は写真を並べて返すだけで、差分は検出しません。 何が変わったかの判断は読み手（AI と人）に委ねる設計です。
• protect_photo で保護した写真は、エッジPC の保存先が満杯になっても、保護していない録画と写真を消し切るまで残ります。 エッジPC がオフラインのときは失敗します。get_snapshot と compare は、保護した写真に「保護中」と添えて返します。
• capture は向きが登録された場所だけ撮れます（向きの無い撮影プリセットは、撮影ジョブの run_capture_job で撮ります）。外部送信先へは送りません。zoom は 0（引き）〜1（寄り）で、向きに登録されたズームを一時的に上書きします。

撮影ジョブを扱うツールです。

• run_capture_job の結果は、返った run_id を list_capture_deliveries に渡して確かめます。 撮影は依頼を受け付けた後にエッジPC で進むので、向きの多いジョブは結果が揃うまで時間がかかります。
• run_capture_job は無効にしたジョブでは失敗します。 外部 API からの起動を許可していないジョブでも実行できます（MCP の操作スコープで行う手動実行として扱い、撮影ログのトリガーは「手動」になります）。

録画

カメラの録画のうち残したい区間を自動削除から保護するほか、録画と静止画の保存サイズを変えられます（→ 録画を保護する、保存サイズを選ぶ）。

• 保護はエッジPC に対して行うので、エッジPC がオフラインのときは失敗します。 1 台のカメラで保護できるのは 200 区間までです。
• 保護してもエッジPC の外には残りません。 エッジPC の故障・撤去では失われ、保存先が満杯になれば保護した録画も古い順に消えます。
• 「録画の容量を減らしたい」と頼むと、AI は get_camera_storage_settings の値から推奨を出せます。 録画の縮小はエッジPC の CPU を常時使う（Raspberry Pi 5 で 1 台あたり 1 コアの約 6 割）ので、CPU の余裕が無ければ縮小を勧めません。カメラのビットレートが既に低いと縮小しても容量はあまり減らないため、カメラ側の設定を変える案も出します。

よく使うツールの詳細

list_edge_pcs

組織内のエッジPC一覧を返します。ほとんどの操作は edge_pc_id を必要とするため、多くの場合これが起点になります。

パラメータ: なし

レスポンス例:

[
  {
    "id": "edge-pc-test-001",
    "organizationId": "org-test-001",
    "name": "拠点A（テストエッジPC）",
    "note": "1F 東側の制御盤内",
    "thingName": "edge-device-01",
    "baseUrl": "https://edge-01.example.com",
    "createdAt": "2026-06-17T10:00:00.000Z",
    "updatedAt": "2026-06-17T10:00:00.000Z"
  }
]

thingName が画面でいう EDGE ID、baseUrl が Base URL です。note は画面の メモ（未設定なら null）。

list_devices

指定したエッジPCに登録されているカメラとセンサを返します。カメラに追加した AI アプリは含みません（list_ai_app_instances で取得します）。

パラメータ:

レスポンス例:

[
  {
    "id": "edge-device-01__8f14e45f-ceea-467a-9f3b-1b2c3d4e5f60",
    "edgePcId": "edge-pc-test-001",
    "edgePcName": "拠点A（テストエッジPC）",
    "type": "camera",
    "name": "工場エントランス",
    "note": "1F 東側の天井。脚立が必要",
    "cameraKind": "rtsp",
    "rtspUrl": "rtsp://192.168.1.100:554/stream1",
    "createdAt": "2026-06-17T10:05:00.000Z"
  }
]

type は camera か sensor です。note は画面の メモ（未設定なら null）。カメラは cameraKind（rtsp / usb / csi / http）に応じて rtspUrl / sourceUrl / videoDevice / cameraIndex のいずれかが埋まります。URL に含まれるパスワードは rtsp://admin:***@192.168.1.100:554/stream1 のように伏せて返します。伏せたままの URL を update_device に渡すとエラーになるので、映像ソースを変えるときは実際のパスワードを入れて渡してください。

list_local_cameras

エッジPCに物理接続された USB / Web カメラ・Raspberry Pi のカメラモジュールを検出します。add_camera_device で camera_kind に usb / csi を使う前に呼び、id をそのまま video_device / camera_index に渡してください（デバイスパスは推測できません）。

パラメータ:

レスポンス例:

{
  "cameras": [
    {
      "kind": "usb",
      "id": "/dev/v4l/by-id/usb-046d_HD_Pro_Webcam_C920_9A8B-video-index0",
      "name": "HD Pro Webcam C920",
      "devicePath": "/dev/video0",
      "modes": [{ "format": "mjpeg", "width": 1280, "height": 720, "fps": [30] }]
    }
  ],
  "tools": { "v4l2Ctl": true, "rpicamHello": false }
}

id は再起動や挿し直しでも変わらないパスです（devicePath は表示用で、認識順に振られるため登録には使いません）。modes は width / height / fps に指定できる組み合わせです。

エッジPCがオフラインでも検出ツールが未導入でもエラーにはならず、空の一覧を返します。 tools.v4l2Ctl（USB）・tools.rpicamHello（CSI）が false なら、その種別は検出できません。

get_device_snapshot

最新フレームを横 320px の低解像度（アスペクト比は維持）で返します。生存確認やざっと様子を見る用途向けです。画像コンテンツとして返るため、AI エージェントはそのまま内容を読み取れます。

パラメータ: edge_pc_id, device_id（ともに必須）

保存・外部サービスへの受け渡しなど高解像度が必要な場合は capture_device_image を使ってください。

capture_device_image

その場で高解像度の静止画を撮ります。

パラメータ:

既定（inline 省略時）は、短時間だけ有効な署名付き URL を返します。認証ヘッダなしで取得できるので、コードで取得して外部サービス（Google Drive・kintone など）へアップロードする用途に向いています。

{
  "image_url": "https://edge-01.example.com/capture/edge-device-01__8f14e45f-ceea-467a-9f3b-1b2c3d4e5f60?...",
  "expires_at": "2026-06-17T10:35:00.000Z",
  "resolution": "source"
}

inline: true を指定すると、URL ではなく画像そのものが返ります（max_width に縮小）。コード実行のできないクライアントではこちらを使ってください。

get_sensor_reading

センサの現在値を返します。値は単位を持たない数値で、単位・表示名は metric_key の定義から付与されます。

パラメータ: device_id（必須）

レスポンス例:

{
  "device_id": "edge-device-01__c9b1d2e3-4a5b-6c7d-8e9f-0a1b2c3d4e5f",
  "name": "電子天秤 001",
  "edge_pc": "拠点A（テストエッジPC）",
  "metric_key": "weight",
  "display_name": "重量",
  "unit": "kg",
  "value": 12.34,
  "connected": true,
  "updated_at": "2026-06-17T10:30:05.000Z",
  "record_history": true
}

センサ以外のデバイス ID を渡すとエラーになります。AI アプリの最新の結果は get_ai_app_instance で取得します。

get_sensor_history

センサの履歴を時間バケットで集計して返します。

パラメータ:

レスポンス例:

{
  "device_id": "edge-device-01__c9b1d2e3-4a5b-6c7d-8e9f-0a1b2c3d4e5f",
  "bucket": "1 minute",
  "from": "2026-06-17T09:30:00.000Z",
  "to": "2026-06-17T10:30:00.000Z",
  "points": [
    { "ts": "2026-06-17T09:30:00.000Z", "metric_key": "weight", "value": 12.1, "min": 12.0, "max": 12.3, "count": 12 }
  ]
}

list_ai_app_instances

カメラに追加した AI アプリを新しい順に返します。

パラメータ:

レスポンス例:

[
  {
    "instance_id": "edge-device-01__2b7e1516-28ae-4d2a-a6d2-15b2c3d4e5f6",
    "ai_app_id": "object-detection",
    "name": "入口の人数",
    "note": null,
    "edge_pc_id": "edge-pc-test-001",
    "edge_pc": "拠点A（テストエッジPC）",
    "camera_id": "edge-device-01__8f14e45f-ceea-467a-9f3b-1b2c3d4e5f60",
    "camera": "工場エントランス",
    "metric_keys": ["object_count"],
    "created_at": "2026-09-30T02:41:28.009Z"
  }
]

camera_id は映像を読むカメラのデバイス ID です。metric_keys は結果を記録する計測項目で、run_query やダッシュボードのウィジェットにも使えます。

get_ai_app_instance

AI アプリのインスタンス 1 件と、最新の結果を返します。

パラメータ: instance_id（必須。list_ai_app_instances で確認）

レスポンス例:

{
  "instance_id": "edge-device-01__2b7e1516-28ae-4d2a-a6d2-15b2c3d4e5f6",
  "ai_app_id": "object-detection",
  "name": "入口の人数",
  "camera": "工場エントランス",
  "metric_keys": ["object_count"],
  "connected": true,
  "last_error": null,
  "latest": { "count": 3, "top_label": "person", "top_confidence": 0.91, "value": null, "unit": null, "updated_at": null }
}

推論のアプリは count・top_label・top_confidence、メーター読み取りは value・unit・updated_at が入り、使わない項目は null です。まだ結果が無ければ latest が null になります。

get_ai_app_history

AI アプリの結果の履歴を時間バケットで集計して返します。パラメータは instance_id（必須）と、get_sensor_history と同じ from / to / bucket です。レスポンスも同じ形で、device_id の代わりに instance_id が入ります。

list_ai_events

AI アプリのイベントを新しい順に返します。在/不在ルールの切り替わり（presenceStart / presenceEnd）と、ナンバーの読み取り（plateRead）です。イベントは 30 日間残ります。

パラメータ:

レスポンス例:

{
  "total": 1,
  "events": [
    {
      "id": "…",
      "ts": "2026-09-28T10:30:01.000Z",
      "instanceId": "edge-device-01__8f14e45f-ceea-467a-9f3b-1b2c3d4e5f60",
      "instanceName": "ゲートのナンバー読み取り",
      "edgePcName": "第1工場",
      "eventType": "plateRead",
      "ruleId": null,
      "detail": { "plate": "品川300あ1234", "confidence": 0.98, "bbox": { "x": 0.41, "y": 0.62, "width": 0.12, "height": 0.06 } },
      "hasPhoto": true
    }
  ]
}

list_metrics

ダッシュボードのウィジェットを組む前に、指定できる metricKey と deviceId / edgePcId を調べるためのカタログです。

パラメータ: なし

レスポンス例:

{
  "metrics": [{ "metricKey": "weight", "displayName": "重量", "unit": "kg" }],
  "devices": [
    {
      "deviceId": "edge-device-01__c9b1d2e3-4a5b-6c7d-8e9f-0a1b2c3d4e5f",
      "name": "電子天秤 001",
      "edgePcId": "edge-pc-test-001",
      "edgePcName": "拠点A（テストエッジPC）",
      "metricKeys": ["weight"]
    }
  ]
}

create_dashboard / add_widget

ウィジェットは get_dashboard の結果と同じ camelCase で受け渡します（結果をそのまま編集して書き戻せます）。id と layout は省略でき、自動で補われます。

ウィジェットの型:

リクエスト例:

{
  "name": "拠点A 重量モニタ",
  "widgets": [
    {
      "type": "stat",
      "title": "現在の重量",
      "query": { "metricKey": "weight", "deviceId": "edge-device-01__c9b1d2e3-4a5b-6c7d-8e9f-0a1b2c3d4e5f" }
    },
    { "type": "timeseries", "title": "重量の推移", "query": { "metricKey": "weight" } }
  ]
}

queryTable / queryChart は query ではなく queryId（list_queries / create_query で得た保存クエリの ID）を指定します。

run_query / describe_query_schema

センサ・AI 推論の履歴に対して、読み取り専用の SQL を直接実行できます。先に describe_query_schema を呼んで表・列を確認してください。

• 実行できるのは SELECT / WITH で始まる単一文だけです。
• 自組織の行しか返りません。tenant_id の条件を書く必要はありません。
• MCP 経由の結果は 200 行で打ち切られます。より多くの行が必要な場合は集計するか、管理ダッシュボードのクエリから CSV で書き出してください。

レスポンス例:

{
  "columns": ["device_id", "avg_value"],
  "rows": [{ "device_id": "edge-device-01__c9b1d2e3-4a5b-6c7d-8e9f-0a1b2c3d4e5f", "avg_value": 12.2 }],
  "rowCount": 1,
  "truncated": false,
  "elapsedMs": 42
}

truncated が true のときは上限で打ち切られています。

エラー

エラー時は、isError を立てたテキストが返ります。構造化されたエラーコードは返しません。

主なメッセージです。

メッセージは英語です（Edge PC not found など）。

認証に失敗した場合は、ツール呼び出し以前に HTTP 401（{"error":"Unauthorized"}）が返ります。