# ThingsConnect ドキュメント

> 現場のカメラ・センサをクラウドから管理し、AI から扱えるようにする IoT 基盤のドキュメント

ThingsConnect は、拠点に置いたエッジPC（Ubuntu）でカメラ・センサの映像と計測値を扱い、AWS のクラウドからまとめて管理する IoT 基盤です。外部からの接続口は 2 つあり、AI エージェントは MCP（/api/mcp）、既存のシステムや自動化ツールは REST API（/api/v1。組織の API トークンで認証）を使います。α（一般提供前）の段階で、ドキュメントは日本語のみです。

## はじめに

- [ThingsConnect とは](https://thingsconnect.app/docs/overview): ThingsConnect の位置づけ、できること、対応範囲、ドキュメントの読み方
- [システム構成](https://thingsconnect.app/docs/architecture): クラウドとエッジPCの役割分担、設定と映像・データの流れ、用語の定義
- [クイックスタート](https://thingsconnect.app/docs/quickstart): 評価・検証のために最短で動かし、カメラの映像と MCP の疎通を確認するまでの手順
- [ロードマップ](https://thingsconnect.app/docs/roadmap): ThingsConnect の今後の開発予定。四半期ごとの対応予定と、現在の実装状況の一覧

## 使い方ガイド

- [ガイドの読み方](https://thingsconnect.app/docs/guides): 管理ダッシュボードで現在できることの全体像と、機能別ガイドへの入口
- [ライブ映像](https://thingsconnect.app/docs/guides/viewer): 複数カメラの一覧、1 台を大きく見る個別画面、その場での撮影、ONVIF カメラの向き（PTZ）の操作
- [録画（NVR）と再生](https://thingsconnect.app/docs/guides/recording): カメラの常時録画を有効にし、タイムラインから再生・書き出しする
- [メディアビューワー](https://thingsconnect.app/docs/guides/photos): 撮影と判定ルールで保存した写真と録画を撮影プリセット・向きごとの時系列で見比べ、ZIP でまとめて保存し、写真をタイムラプス動画にする
- [撮影（静止画・録画・巡回撮影・外部送信）](https://thingsconnect.app/docs/guides/capture): 撮影プリセットで決めた向きを静止画か短い録画で撮り、メディアビューワーに保存するか、指定の URL へエッジPC から送る。向きを複数登録すると順に回って撮る（巡回撮影）
- [エッジPCの登録と監視](https://thingsconnect.app/docs/guides/edge-pcs): 現場のエッジPCをダッシュボードに登録し、稼働状況を監視する
- [通知](https://thingsconnect.app/docs/guides/notifications): エッジPC が設定どおりに動けていないとき（データの保存先を使えない・保持日数を保てていない・保護した録画や写真を削除した）に、ダッシュボードで知らせる
- [アカウント](https://thingsconnect.app/docs/guides/account): サインイン、複数の組織の切り替え、アカウント設定（メールアドレスとパスワードの変更）、パスワードを忘れた場合

### デバイス

- [デバイスの追加と管理](https://thingsconnect.app/docs/guides/devices): カメラ・センサの登録手順と、一覧画面の使い方
- [カメラの設定](https://thingsconnect.app/docs/guides/camera): カメラの種類ごとの違い、ライブ映像の有効/無効、音声、サブストリーム、YouTube Live などへの外部配信、配信のテロップ・モザイク、ONVIF カメラの登録
- [センサの設定](https://thingsconnect.app/docs/guides/sensors): センサの登録後の運用。現在値の確認、履歴保存の設定、つなぎ方と読み方の設定
- [地図で設置場所を見る](https://thingsconnect.app/docs/guides/map): エッジPC とデバイスの設置位置を地図に表示し、カメラの向きを確認する

### AI アプリ

- [AI アプリを使う](https://thingsconnect.app/docs/guides/ai-apps): カメラ映像から用途ごとの答えを出す AI アプリと、その結果・エビデンス画像の見方
- [AI 推論を使う](https://thingsconnect.app/docs/guides/inference): カメラ映像に AI モデルを適用する推論デバイスの状態確認と、閾値・間隔の調整

### データ活用

- [ダッシュボード](https://thingsconnect.app/docs/guides/dashboards): ウィジェットを自由に並べて、用途に合わせた常設画面を作る
- [クエリ（SQL）](https://thingsconnect.app/docs/guides/queries): 蓄積した計測値を任意の SQL で集計し、表示・CSV 出力・グラフ化する
- [分析（センサデータの可視化）](https://thingsconnect.app/docs/guides/analytics): 指標とエッジPCを選んで、センサ間の計測値を比較する

### カスタム処理

- [コンポーネント](https://thingsconnect.app/docs/guides/edge-components): 自作の処理をエッジPCで動かす。画面でスクリプトを書くか、コンテナイメージを指定してコンポーネントとバージョンを登録する
- [デプロイ](https://thingsconnect.app/docs/guides/deployments): 独自コンポーネントをエッジPCへ配る。宛先ごとの環境変数・シークレット、配布と稼働の状態、ログ、止め方
- [グループ](https://thingsconnect.app/docs/guides/edge-pc-groups): 複数のエッジPCをグループにまとめ、同じ独自コンポーネントを配る。後から入れた機体にも自動で配られる

### 組織

- [組織設定](https://thingsconnect.app/docs/guides/organization): 組織名と組織 ID、組織から抜ける、メンバーの招待とロール、オーナーを譲る、AI アプリとの接続、MCP サーバーの有効 / 無効、API トークンの発行と失効
- [使用量を確認する](https://thingsconnect.app/docs/guides/usage): エッジPCごとの映像の転送量を月単位で確認する
- [電文の形式](https://thingsconnect.app/docs/guides/line-formats): センサが電文のどこを計測値として読むかの形式。システムで用意した形式の一覧と、組織の形式の登録・編集

## MCP 連携

- [MCP連携 — AIエージェントとの接続](https://thingsconnect.app/docs/mcp): Model Context Protocol（MCP）を使った AI エージェントとの連携方法
- [MCPサーバのセットアップ](https://thingsconnect.app/docs/mcp/setup): ThingsConnectのMCPエンドポイントに接続し、AIエージェントから利用するための設定方法
- [利用可能なMCPツール一覧](https://thingsconnect.app/docs/mcp/tools): ThingsConnectのMCPサーバが提供するツールのパラメータ・レスポンス仕様
- [連携サンプル](https://thingsconnect.app/docs/mcp/samples): n8n・Make・自作スクリプトなど MCP を直接話せないツールから JSON-RPC で呼び出す設定例

## リファレンス

- [対応デバイス一覧](https://thingsconnect.app/docs/reference/devices): 接続できるカメラ・センサの種類と接続方式、検証済みの機器、未対応の範囲
- [構成を決めるときの考え方](https://thingsconnect.app/docs/reference/design): metric_key の決め方、1 デバイス = 1 つの数値、履歴を残すかどうか、エッジPC 1 台あたりの規模感
- [制限値と既定値](https://thingsconnect.app/docs/reference/limits): データ保持期間・行数上限・同時実行数など、運用設計で必要になる数値の一覧

## 運用

- [エッジPCの配備](https://thingsconnect.app/docs/operations/deploy): エッジPCがどう構成され、誰が何を用意するのか。設置時に必要な作業と確認手順
- [トラブルシューティング](https://thingsconnect.app/docs/operations/troubleshooting): 症状別の切り分け手順。どの層で止まっているかを上から順に確認する
- [FAQ](https://thingsconnect.app/docs/faq): 製品の位置づけ・対応範囲・必要な機材についてよくある質問

## REST API

- [ThingsConnect REST API](https://thingsconnect.app/docs/api)

### エッジPC

- [エッジPC の一覧を取得する](https://thingsconnect.app/docs/api/%E3%82%A8%E3%83%83%E3%82%B8pc/list-edge-pcs)

### デバイス

- [デバイスの一覧を取得する](https://thingsconnect.app/docs/api/%E3%83%87%E3%83%90%E3%82%A4%E3%82%B9/list-devices)
- [デバイスの詳細を取得する](https://thingsconnect.app/docs/api/%E3%83%87%E3%83%90%E3%82%A4%E3%82%B9/get-device)
- [デバイスの名前・メモ・機器情報を変更する](https://thingsconnect.app/docs/api/%E3%83%87%E3%83%90%E3%82%A4%E3%82%B9/update-device)
- [計測値の履歴を取得する](https://thingsconnect.app/docs/api/%E3%83%87%E3%83%90%E3%82%A4%E3%82%B9/get-device-metrics)
- [RTMP 配信を始める](https://thingsconnect.app/docs/api/%E3%83%87%E3%83%90%E3%82%A4%E3%82%B9/start-streaming)
- [RTMP 配信を止める](https://thingsconnect.app/docs/api/%E3%83%87%E3%83%90%E3%82%A4%E3%82%B9/stop-streaming)
- [カメラの向きを変える（PTZ）](https://thingsconnect.app/docs/api/%E3%83%87%E3%83%90%E3%82%A4%E3%82%B9/control-ptz)

### AI アプリ

- [AI アプリのインスタンスの一覧を取得する](https://thingsconnect.app/docs/api/ai-%E3%82%A2%E3%83%97%E3%83%AA/list-ai-app-instances)
- [AI アプリのインスタンスの最新の結果を取得する](https://thingsconnect.app/docs/api/ai-%E3%82%A2%E3%83%97%E3%83%AA/get-ai-app-instance)
- [AI アプリの結果の履歴を取得する](https://thingsconnect.app/docs/api/ai-%E3%82%A2%E3%83%97%E3%83%AA/get-ai-app-instance-metrics)
- [AI アプリのイベントを取得する](https://thingsconnect.app/docs/api/ai-%E3%82%A2%E3%83%97%E3%83%AA/list-events)

### データ

- [保存したクエリの一覧を取得する](https://thingsconnect.app/docs/api/%E3%83%87%E3%83%BC%E3%82%BF/list-queries)
- [保存したクエリを実行する](https://thingsconnect.app/docs/api/%E3%83%87%E3%83%BC%E3%82%BF/run-saved-query)

### 撮影

- [撮影ジョブの一覧を取得する](https://thingsconnect.app/docs/api/%E6%92%AE%E5%BD%B1/list-capture-jobs)
- [撮影ジョブを実行する](https://thingsconnect.app/docs/api/%E6%92%AE%E5%BD%B1/run-capture-job)
- [撮影ジョブの実行結果を取得する](https://thingsconnect.app/docs/api/%E6%92%AE%E5%BD%B1/get-capture-run)
- [撮影ログを取得する](https://thingsconnect.app/docs/api/%E6%92%AE%E5%BD%B1/list-capture-deliveries)

## Agent skills

- [thingsconnect](https://thingsconnect.app/.well-known/agent-skills/thingsconnect/SKILL.md): Read the ThingsConnect ドキュメント docs instead of answering from memory. 現場のカメラ・センサをクラウドから管理し、AI から扱えるようにする IoT 基盤のドキュメント Use when a task involves ThingsConnect ドキュメント: how it works, how to set it up or configure it, or its API.

## Agent resources

- [llms-full.txt](https://thingsconnect.app/llms-full.txt): The full Markdown of every page in one file.
- [Page Markdown](https://thingsconnect.app/index.md): Append `.md` to any page URL to fetch that page as raw Markdown.
- [JSON API](https://thingsconnect.app/api/docs/pages.json): Page index of the JSON docs API; each entry links the page's JSON and Markdown forms. Described by the OpenAPI document at https://thingsconnect.app/openapi.json.
- [Agent skills](https://thingsconnect.app/.well-known/agent-skills/index.json): Agent Skills discovery index of the skills this site publishes.
- [API catalog](https://thingsconnect.app/.well-known/api-catalog): RFC 9727 linkset of the APIs documented here.
- [AI catalog](https://thingsconnect.app/.well-known/ai-catalog.json): ARD manifest of the agent-facing resources on this site (MCP server, skills, APIs).
- [agent-readability.json](https://thingsconnect.app/agent-readability.json): Manifest of every agent-facing artifact on this site.
- [Sitemap](https://thingsconnect.app/sitemap.xml): Every indexable page URL with its last-modified date.