MCP: AI 도구로 FlashDesk 제어하기
FlashDesk 는 AI 도구를 외부 애플리케이션과 연결하기 위한 개방형 표준인 Model Context Protocol(MCP) 을 구현합니다. Claude, ChatGPT, Cursor, Windsurf 와 같은 AI 도구는 자연어 명령을 통해 원격 장치의 화면을 확인하고 마우스 및 키보드를 제어하며 파일을 관리하고 SSH 명령을 실행하고 성능을 모니터링할 수 있습니다.
내용물
개요
Model Context Protocol(MCP) 은 맞춤형 스크립팅이나 전용 통합 없이 AI 도구가 외부 애플리케이션에 직접 호출할 수 있도록 하는 개방형 표준입니다. FlashDesk 와 동일한 PC 에서 실행되는 모든 MCP 호환 AI 도구는 FlashDesk 를 로컬 MCP 서버로 등록하여 즉시 사용할 수 있으며, FlashDesk 설정에는 붙여넣을 정확한 구성 정보를 제공합니다.
기본 사용법
FlashDesk 설정에서 MCP 활성화하기
AI 도구가 실행되는 장치에서 FlashDesk 설정의 외부 AI 도구 접근을 켭니다. 기본값은 꺼짐입니다.
FlashDesk를 MCP 서버로 등록하기
동일한 설정 화면에서 등록할 정확한 구성 정보를 보여주고 복사 버튼을 제공합니다. 해당 내용을 AI 도구의 자체 MCP 설정에 붙여넣으세요. 각 AI 도구는 로컬 MCP 서버를 등록할 별도의 위치를 가지므로, 해당 위치에 대한 정보는 도구별 MCP 문서를 참조하세요.
{
"mcpServers": {
"flashdesk": {
"command": "C:\\Program Files\\FlashDesk\\FlashDesk.exe",
"args": ["--mcp-server"]
}
}
}
AI 도구에 연결을 요청하기
연결할 저장된 장치를 AI 도구에 알려줍니다. 연결은 원격 장치의 일반적인 승인 절차를 거칩니다.
자연어로 작업하기
연결이 완료되면 수행하려는 작업을 설명하면 됩니다. AI 도구는 화면 캡처, 클릭, 타이핑, 이동 또는 파일 정리, 명령 실행 등 적절한 동작을 선택하여 수행합니다.
당신이 할 수 있는 일
- 저장된 연결과 폴더 목록을 확인하고 온라인 상태인 장치를 파악하며 세션을 열거나 확인하거나 닫습니다.
- 원격 화면의 전체 화면 또는 단일 영역 라이브 스크린샷을 가져오고, Windows 에서的前景 창 제목 및 위치를 읽습니다.
- 마우스를 이동하고 클릭하며 더블 클릭하고 스크롤하고 키를 누르고 원격 장치에서 텍스트를 입력합니다.
- 원격 장치와 동기화된 클립보드를 읽고 설정합니다.
- 파일과 폴더를 열거나 업로드하거나 다운로드하거나 이름 변경하거나 삭제하며, 이는 원격 장치와 AI 도구가 실행되는 장치 양쪽 모두에서 가능합니다.
- 화면 창 없이 SSH 전용 세션을 시작하고 원격 장치에서 셸 명령을 실행합니다.
- 화면 녹화를 시작하거나 중지하거나 상태를 확인합니다.
- 원격 장치를 사용하는 사람이 볼 수 있는 세션 채팅 메시지를 보내고 읽습니다.
- 프레임률, 왕복 시간, 패킷 손실, 혼잡 수준 및 Host의 CPU와 메모리 같은 라이브 비디오 통계를 읽고 목표 프레임률, 파이프라인 깊이 및 JPEG 품질을 조정합니다.
- 원격 장치에서 FlashDesk 업데이트를 확인하고 적용하며, 연결 양쪽 모두에서 FlashDesk 를 종료하거나 재시작합니다.
- 연결 목록을 정리하여 연결 이름을 변경하고 폴더를 생성하거나 이름 변경하거나 삭제하며 연결을 이동합니다.
지원되는 AI 도구
FlashDesk는 MCP를 지원하는 모든 AI 도구와 함께 작동합니다. 예를 들면:
- Claude Desktop 및 Claude Code
- ChatGPT 데스크톱 앱 및 Codex CLI
- Cursor
- Windsurf
- GitHub Copilot Chat을 사용하는 VS Code
각 도구마다 로컬 MCP 서버를 등록하는 위치가 다르며, 보통 설정 파일이나 CLI 명령을 사용합니다. 웹 전용 AI 채팅 인터페이스는 일반적으로 FlashDesk 같은 로컬 서버가 아니라 원격 MCP 서버만 지원합니다. 이 경우 해당하는 데스크톱 앱이나 CLI를 사용하세요.
작동 원리
| 목 | 설명 |
|---|---|
--mcp-server |
FlashDesk를 로컬 MCP 서버로 시작하는 플래그입니다. 이 프로세스는 요청을 FlashDesk로 연결할 뿐 그 자체로 Host나 Viewer가 되지는 않습니다. |
| 로컬 전용 | MCP 서버는 로컬 표준 입출력으로 통신하며 네트워크에 노출되지 않습니다. |
| FlashDesk 가 실행 중이어야 함 | 브리지 프로세스는 요청을 동일한 PC 에서 이미 실행 중인 FlashDesk 로 전달합니다. FlashDesk 가 실행 중이 아니면 요청은 자체적으로 작업을 시작하지 않고 오류를 반환합니다. |
| 동일한 승인 흐름 | MCP 를 통해 열린 연결은 사용자가 직접 시작한 연결과 동일한 원격 장치의 승인 또는 공유 비밀번호 흐름을 따릅니다. |
운영 참고 사항
- MCP 지원은 기본적으로 꺼져 있으며 AI 도구가 실행되는 장치에서 활성화해야 합니다.
- MCP로 진행되는 세션에서도 일반 연결과 마찬가지로 원격 화면 창이 평소처럼 표시됩니다.
- MCP 를 통한 파일 전송, 파일 삭제 및 이름 변경, SSH 명령 실행은 개별적으로 확인되지 않습니다. 삭제는 휴지통을 거치지 않으며 되돌릴 수 없습니다. MCP 를 활성화하기 전에 AI 도구에 허용하려는 작업을 고려하세요.
- MCP를 통해 실행하는 SSH 명령은 대상 장치의 SSH 키가 AI 도구가 실행되는 장치에 미리 저장되어 있어야 합니다.
- 파일 도구는 원격 장치와 AI 도구가 실행되는 장치 양쪽 모두에 도달합니다. 폴더와 그 내용을 함께 삭제하려면 명시적인 옵션이 필요하므로, 단일 실수한 지시 사항으로 전체 트리를 지울 수 없습니다.
- 업데이트, 종료, 재시작 도구는 연결 양쪽 모두에서 FlashDesk 를 중지하거나 재시작할 수 있습니다. AI 도구가 실행되는 장치에서 FlashDesk 를 재시작하면 MCP 연결도 종료되며, AI 도구는 다시 연결해야 합니다.