AI アシスタントを接続する
Agent DVR は Claude、ChatGPT、Cursor、VS Code Copilot などの AI アシスタント から直接使用できます。自然言語で質問してください。「昨夜どのようなアラート がありましたか?」、「今朝の玄関カメラで何が起こったか見せてください」、「ガレージのカメラ を無効にしてください」など。アシスタント は、画像を含めて、ライブカメラ、録画ファイル およびアラート ログから回答を得られます。
これは、外部工具類 に接続するために アシスタント が使用するオープン標準である Model Context Protocol (MCP) を通じて機能します。Agent DVR は 2 つの場所で MCP サーバー を提供し、あなたのニーズに合わせてサーバー に接続できます。
- Agent DVR に組み込まれている(ローカルエンドポイント): ローカルネットワーク上の独自のサーバー によって提供されます。アカウント またはサブスクリプションは不要です。同じコンピューター または LAN で実行されているアシスタント 向けです。
- iSpyConnect.com 経由(クラウドエンドポイント): ウェブポータルとモバイルアプリが使用するのと同じリモートアクセス を介して、どこからでもサーバー に接続できます。ポート 転送は不要です。iSpyConnect サブスクリプションが必要です。これは claude.ai、ChatGPT、携帯電話用です。
両方 とも同じ工具類 のセットを提供します。Agent DVR 8.0.3 以降が必要です。
ローカルエンドポイント
すべての Agent DVR サーバーはローカル Web サーバーの /mcp で MCP を提供します。したがって、Agent DVR UI を http://localhost:8090 で開いた場合、エンドポイントは http://localhost:8090/mcp です (LAN 上の別のコンピューターからサーバーのアドレスとポートを使用してください。例: http://192.168.1.10:8090/mcp)。既定では有効になっており、サーバー設定 - ローカルサーバーの AI アシスタント (MCP) エンドポイントで無効にできます。
アクセスは ローカル API の他の部分とまったく同じルールに従います。自分のネットワークからアクセスする場合、API を保護が有効になっていない限りログインは不要です。有効になっている場合、アシスタントは管理者ユーザーのユーザー名とパスワードを送信する必要があります (ほとんどの MCP クライアントでは認証ヘッダーを追加できます)。ネットワーク外からの接続には、さらに ライセンスが必要です。これは UI へのポート転送アクセスと同じです。
Claude Code
claude mcp add --transport http agentdvr http://localhost:8090/mcp
Cursor
.cursor/mcp.json に追加してください (または設定 - MCP 経由):。
{ "mcpServers": { "agentdvr": { "url": "http://localhost:8090/mcp" } } }
VS Code (Copilot)
.vscode/mcp.json に追加してください:
{ "servers": { "agentdvr": { "type": "http", "url": "http://localhost:8090/mcp" } } }
Claude Desktop
Claude デスクトップアプリはあなたのコンピューター上のサーバーに直接呼び出すことができないため、代わりにそれを行う小さな拡張機能を使用します。AgentDVR.mcpb をダウンロードしてから、Claude Desktop で 設定 - 拡張機能 を開き、ファイルをページにドラッグします。これは有効化済み の状態でインストールされ、http://localhost:8090/mcp に接続します。サーバーが別のコンピューター上にあるか、API を保護 が有効化済み の場合のみ、構成 をクリックしてください。Claude は各ツールが初めて使用されるときに許可を求めます。プロンプトを止めるには [常に許可] を選択してください。
その他のアシスタント
HTTP 経由で MCP ("ストリーム可能 HTTP") をサポートするクライアントは、同じ URL を使用できます。アシスタントの設定で "MCP サーバー"、"コネクター"、または "工具類" を探してください。
Claude ウェブアプリ、モバイルアプリ、および ChatGPT は、あなたのネットワーク上のサーバーにまったくアクセスできません。これらは クラウド エンドポイント を使用します。
クラウドエンドポイント
iSpyConnect サブスクリプションがあれば、お客様のサーバーは以下の場所からもアクセス可能です:
https://www.ispyconnect.com/mcp
そのURLをお客様のアシスタント内でカスタムコネクタまたはMCPサーバーとして追加してください(たとえば claude.ai および Claude アプリの 設定 - コネクタ、あるいは ChatGPT および Cursor で同等の場所)。アシスタントは iSpyConnect のサインインページを開きます。サインインして、表示だけでなく制御も許可するかどうかを選択し、許可 をクリックしてください。他の設定は不要です。お客様のアカウントに接続され、リモートアクセスが有効になっているすべての Agent DVR サーバーが利用可能になり、複数ある場合はアシスタントがどれを意味するのかを尋ねます。
リクエストはウェブポータルが使用するのと同じリレーを経由するため、ポート転送は不要であり、お客様のサーバーがインターネットに公開されることはありません。サブスクリプションが失効するとアクセスが停止され、各アシスタントのアクセスはいつでもそのアシスタント自体のコネクタ設定から削除できます。
お客様のサーバーは実行中で、iSpyConnect に接続されている必要があります(ローカルUIの南京錠アイコンがリモート接続の状態を示します)。サーバー設定 の 外部アクセスのブロック はこのエンドポイントもブロックします。
アシスタントができること
アシスタントは生の API ではなく、目的に特化した小さな工具類のセットを使用するため、回答は迅速で低コストです:
- 表示: サーバーとデバイスをリスト表示 (場所と状態付き)、アクティビティサマリーを取得 (カメラ単位、時間単位での録画ファイルとアラート、検出内容付き)、時間ウィンドウ内の録画ファイルをリスト表示、ウィンドウ全体をフレームグリッドで一目で確認、カメラを1日分のタイムラインで表示、1つの録画ファイルからフレームを抽出、カメラのライブスナップショットを撮影、アラートログを読む、ウェブUIで録画ファイルを開くためのリンクを取得できます。
- 制御: サーバーをアーム/ディスアームする、プロファイルを適用する、デバイスを有効または無効にする、録画モードを変更する、アラートと検出器をオン/オフに切り替える、PTZ カメラをプリセットに移動する、API からのその他の状態変更を実行する。
- その他すべて: 専用の工具類が当てはまらない場合にアシスタントが呼び出すことができるさらなる読み取りコマンドと制御コマンドのカタログ (システム統計、デバイスの完全なステータス、PTZ プリセットなど)。
アシスタントは、録画ファイルや写真を削除したり、デバイスまたはサーバーの設定を変更したり、デバイスを追加/削除したり、サーバーを再起動したりすることはできません。これらのコマンドは、どのエンドポイントを使用するかに関わらず、意図的に提供されていません。クラウド エンドポイントでは、表示と制御は別個の権限であり、サインイン ページで付与でき、使用法はリレーを保護するためにレート制限されます。
プロンプト例
- "過去24時間で誰かが玄関を訪れましたか?見せてください。"
- "今朝、どんな鳥が給餌器を訪れましたか?"
- "今日の道路はどのくらい混雑していて、どの時間帯でしたか?"
- "裏庭を1日分のタイムラインで見せてください。いつ雨が降り始めましたか?"
- "昨日はどんなアラートがありました?人物を検出したものはありましたか?"
- "今、玄関に誰がいますか?"
- "どのカメラがオフラインですか?"
- "外出します - すべてを外出中プロファイルで有効化します。"
- "ホームの場所のすべてのカメラを無効にしてください。"
- "配達員のクリップへのリンクを送ってください。"
既成ワークフロー
サーバーはプロンプトテンプレートも提供しており、プロンプト機能に対応したアシスタント (Claude Desktop、Claude Code、Cursor他) はスラッシュコマンドまたはメニューで表示します。それぞれが完全なマルチステップワークフローを実行し、結果を報告します:
- morning_briefing - 昨晩以降、カメラが捉えた内容: アクティビティ、アラート、注目すべき人物、車両と動物、およびカメラの状態。
- door_report - ドアカメラを訪れた人物、訪問時刻、各訪問者の動作、各クリップへのリンク。
- wildlife_report - カメラが捉えた動物と鳥、映像から判別できる限りの精度で識別。
- camera_health - すべてのサーバーとカメラをチェック (オフライン、無効化されています、エラー、沈黙しているカメラ)。
- day_in_review - カメラを1日分のフレームタイムラインで表示、シーンがどのように変化したかの説明付き。
トラブルシューティング
- アシスタントはローカルエンドポイントに接続できません: ブラウザで URL を確認してください - http://localhost:8090/mcp が応答する必要があります (エラーメッセージは問題ありませんが、「接続が拒否されました」はそうではありません)。ポートが「サーバー設定」の「ローカルサーバー」と一致していることを確認し、そこでエンドポイントが有効になっていることを確認してください。
- 401 認可されていません: API を保護 が有効になっているため、アシスタントは管理者ユーザーの認証情報を送信する必要があります。または、ネットワーク外から接続しています。
- 403 アクセス禁止: ライセンスなしでネットワーク外から接続しています。代わりに クラウドエンドポイント を使用してください。
- 404 見つかりませんでした: エンドポイントが「サーバー設定」で無効になっているか、サーバーが 8.0.3 より古いバージョンです。
- クラウドエンドポイントでサーバーがオフラインと表示されます: サーバーが iSpyConnect に接続されていません。ローカル UI の南京錠アイコンを確認し、「外部アクセスのブロック」がオフになっていることを確認してください。
- アシスタントが何をしているかを確認する: 「サーバー設定」で「ロギング」を「デバッグ」に設定し、「サーバーメニュー」からログを開きます。ローカルエンドポイントでは、すべてのリクエストと工具類の呼び出しが「MCP」プレフィックス付きでログに記録され、「引数」と実行時間が含まれます。クラウドエンドポイントを通じて工具類は iSpyConnect.com で実行され、サーバーは「RelayApi」プレフィックス付きでログに記録される個別の「コマンド」のみを参照します。