통합: AI 어시스턴트

Agent DVR는 Claude, ChatGPT, Cursor 및 VS Code Copilot 같은 AI 어시스턴트에서 직접 사용할 수 있습니다. 일반 언어로 질문하세요 - "어제 밤에 받은 알림이 뭔가요?", "오늘 아침 진입로 카메라에서 뭐가 일어났는지 보여줘", "차고의 카메라들을 비활성화해" - 어시스턴트가 라이브 카메라, 녹화 파일 및 알림 로그의 이미지를 포함하여 답변합니다.

이것은 모델 컨텍스트 프로토콜(MCP)을 통해 작동하며, 이는 어시스턴트가 외부 공구에 연결하는 데 사용하는 개방형 표준입니다. Agent DVR은 두 위치에서 MCP 서버를 제공하며, 귀하에게 적합한 곳에 어시스턴트를 연결합니다:

• Agent DVR에 내장됨(로컬 엔드포인트): 로컬 네트워크의 자신의 서버에서 제공됩니다. 계정이나 구독이 필요하지 않습니다. 같은 컴퓨터 또는 LAN에서 실행 중인 어시스턴트용입니다.
• iSpyConnect.com을 통함(클라우드 엔드포인트): 웹 포털과 모바일 앱이 사용하는 것과 동일한 원격 액세스를 통해 어디서나 서버에 도달하며, 포트 포워딩이 필요하지 않습니다. iSpyConnect 구독이 필요합니다. claude.ai, ChatGPT 및 휴대폰용으로 사용할 수 있는 것입니다.

둘 다 동일한 공구 집합을 노출합니다. Agent DVR 8.0.3 이상이 필요합니다.

모든 Agent DVR 서버는 로컬 웹 서버의 /mcp에서 MCP를 제공하므로, http://localhost:8090에서 Agent DVR UI를 열면 엔드포인트는 http://localhost:8090/mcp입니다(LAN의 다른 컴퓨터에서 서버의 주소와 포트를 사용하세요. 예: http://192.168.1.10:8090/mcp). 기본적으로 켜져 있으며 서버 설정 - 로컬 서버의 AI Assistant (MCP) Endpoint에서 끌 수 있습니다.

접근 권한은 로컬 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("Streamable HTTP")를 지원하는 모든 클라이언트가 동일한 URL을 사용할 수 있습니다. 어시스턴트의 설정에서 "MCP 서버", "커넥터" 또는 "공구"를 찾아보세요.

Claude 웹 앱 및 모바일 앱, 그리고 ChatGPT는 자신의 네트워크에 있는 서버에 도달할 수 없습니다. 클라우드 엔드포인트를 사용합니다.

iSpyConnect 구독을 사용하면 다음 주소에서도 서버에 액세스할 수 있습니다:

https://www.ispyconnect.com/mcp

해당 URL을 어시스턴트에서 사용자 정의 커넥터 또는 MCP 서버로 추가합니다(예: claude.ai 및 Claude 앱의 설정 - 커넥터, 또는 ChatGPT 및 Cursor의 동등한 기능). 어시스턴트가 iSpyConnect 로그인 페이지를 열고 로그인하고, 제어 및 보기를 허용할지 선택한 다음 허용을 클릭합니다. 다른 설정은 필요하지 않습니다: 계정에 연결되고 원격 액세스가 사용됨으로 설정된 모든 Agent DVR 서버를 사용할 수 있으며, 두 개 이상이 있으면 어시스턴트가 어느 것을 의미하는지 묻습니다.

요청은 웹 포털이 사용하는 것과 동일한 릴레이를 통해 이동하므로 포트 포워딩이 필요하지 않으며 서버가 인터넷에 노출되지 않습니다. 구독이 만료되면 액세스가 중지되며, 각 어시스턴트의 액세스는 언제든지 어시스턴트 자체의 커넥터 설정에서 제거할 수 있습니다.

서버가 실행 중이어야 하고 iSpyConnect에 연결되어야 합니다(로컬 UI의 자물쇠 아이콘이 원격 연결 상태를 표시합니다). 서버 설정의 외부 액세스 차단도 이 엔드포인트를 차단합니다.

보조자는 원본 API가 아닌 목적에 맞게 설계된 소형 공구 집합을 사용하므로 응답이 빠르고 비용 효율적입니다:

• 보기: 서버와 장치들을 나열하고(위치 및 상태 포함), 활동 요약을 얻으며(카메라별 시간별 녹화 파일 및 알림, 감지된 내용 포함), 시간 범위 내의 녹화 파일을 나열하고, 전체 창을 프레임의 격자로 한 눈에 보고, 카메라의 하루 일과를 프레임의 타임라인으로 보고, 한 개의 녹화 파일에서 프레임을 샘플링하고, 카메라의 라이브 스냅샷을 촬영하고, 알림 로그를 읽으며, 웹 UI에서 녹화 파일을 열 수 있는 링크를 얻습니다.
• 제어: 서버 활성화 및 비활성화, 프로파일 적용, 장치들 활성화 또는 비활성화, 녹화 모드 변경, 알림 및 감지기 켜기 또는 끄기, PTZ 카메라를 프리셋으로 이동, API의 기타 상태 변경.
• 기타: 전용 공구가 맞지 않을 때 보조자가 호출할 수 있는 추가 읽기 및 제어 명령어 목록(시스템 통계, 장치의 전체 상태, PTZ 프리셋 등).

보조자는 녹화 파일 또는 사진을 삭제하거나, 장치나 서버 구성을 변경하거나, 장치를 추가 또는 제거하거나, 서버를 다시 시작할 수 없습니다. 이러한 명령어는 사용하는 엔드포인트와 관계없이 의도적으로 제공되지 않습니다. 클라우드 엔드포인트에서 보기 및 제어는 로그인 페이지에서 부여하는 별도의 권한이며, 릴레이를 보호하기 위해 사용법이 제한됩니다.

프롬프트 예시

• "지난 24시간 동안 누군가 앞문에 온 사람이 있나요? 보여주세요."
• "오늘 아침에 어떤 새들이 먹이주는 곳을 방문했나요?"
• "오늘 차도는 얼마나 바빴고, 언제였나요?"
• "하루 종일 뒷정원을 보여주세요. 언제 비가 내리기 시작했나요?"
• "어제 어떤 알림을 받았고, 그 중에 사람이 있었나요?"
• "지금 앞문 앞에 누가 있나요?"
• "어떤 카메라가 오프라인이야?"
• "나가려고 해요 - Away 프로필로 모든 것을 활성화해주세요."
• "홈 위치의 모든 카메라를 비활성화해."
• "배송업체 영상의 링크를 보내주세요."

미리 준비된 워크플로우

서버는 또한 프롬프트 지원을 제공하는 어시스턴트(Claude Desktop, Claude Code, Cursor 등)가 슬래시 명령어 또는 메뉴로 표시하는 프롬프트 템플릿을 제공합니다. 각각은 완전한 다단계 워크플로우를 실행하고 결과를 보고합니다:

• morning_briefing - 지난 저녁 이후 카메라가 본 내용: 활동, 알림, 주목할 만한 사람, 차량 및 동물, 그리고 카메라 상태.
• door_report - 문 카메라에 온 사람, 시간, 각 방문객의 행동 및 각 영상의 링크.
• wildlife_report - 카메라가 포착한 동물 및 새, 영상이 허용하는 범위 내에서 식별됨.
• camera_health - 모든 서버와 카메라를 오프라인, 비활성화됨, 오류 및 조용해진 카메라에 대해 확인.
• day_in_review - 하루 종일 카메라를 프레임의 타임라인으로 보기, 장면이 어떻게 변했는지에 대한 설명 포함.

• 보조자가 로컬 끝점에 연결할 수 없음: 브라우저에서 URL을 확인하세요 - http://localhost:8090/mcp가 응답해야 합니다(오류 메시지는 괜찮지만 "연결 거부"는 아닙니다). 포트가 "서버 설정" - "로컬 서버"와 일치하고 끝점이 활성화되어 있는지 확인하세요.
• 401 권한 없음: API 보호가 활성화되어 있으므로 보조자가 관리자 사용자의 자격 증명을 보내야 하거나 네트워크 외부에서 연결하고 있습니다.
• 403 금지됨: 라이선스 없이 네트워크 외부에서 연결하고 있습니다. 대신 클라우드 끝점을 사용하세요.
• 404 찾을 수 없음: 끝점이 서버 설정에서 꺼져 있거나 서버가 8.0.3보다 오래되었습니다.
• 클라우드 끝점에서 서버가 오프라인이라고 표시됨: 서버가 iSpyConnect에 연결되지 않았습니다. 로컬 UI의 자물쇠 아이콘을 확인하고 "외부 액세스 차단"이 꺼져 있는지 확인하세요.
• 보조 기능이 수행 중인 작업 확인: 서버 설정에서 로그 기록을 디버그로 설정하고 서버 메뉴에서 로그를 엽니다. 로컬 끝점에서는 모든 요청과 공구 호출이 인수 및 소요 시간과 함께 "MCP" 접두사로 기록됩니다. 클라우드 끝점을 통해 공구는 iSpyConnect.com에서 실행되며 서버는 "RelayApi" 접두사로 기록된 개별 명령어만 확인합니다.