MCP: AI 도구로 FlashDesk 제어하기

개요

Model Context Protocol(MCP) 은 맞춤형 스크립팅이나 전용 통합 없이 AI 도구가 외부 애플리케이션에 직접 호출할 수 있도록 하는 개방형 표준입니다. FlashDesk 와 동일한 PC 에서 실행되는 모든 MCP 호환 AI 도구는 FlashDesk 를 로컬 MCP 서버로 등록하여 즉시 사용할 수 있으며, FlashDesk 설정에는 붙여넣을 정확한 구성 정보를 제공합니다.

중요: MCP 지원은 기본적으로 꺼져 있으며 AI 도구가 실행되는 장치의 FlashDesk 설정에서 활성화해야 합니다. MCP로 진행되는 세션 중에도 원격 화면 창은 평소처럼 표시되며 숨겨지지 않습니다.

FlashDesk MCP 활용 사례

화면 확인과 제어, SSH를 통한 조사, 로그 및 데이터베이스 확인을 함께 활용한 실제 사례입니다. AI 도구는 FlashDesk MCP를 통해 정보를 가져오고 작업을 수행합니다.

화면 표시와 실제 상태가 다른 원인 조사
화면 표시와 처리 상태를 로그, 설정, 데이터베이스 기록과 비교하여 표시가 일치하지 않거나 처리가 멈춘 원인을 조사했습니다.
새 Linux PC의 환경 구성
원격 접속, Docker 및 필요한 앱을 설치하고, 백업에서 데이터베이스를 복원하며, 네트워크와 시간 동기화를 설정했습니다.
PC 간 연결이 안 되는 원인 파악
화면의 설정과 연결 상태를 확인하여 네트워크 설정 및 여러 네트워크 인터페이스와 관련된 문제를 조사했습니다. FlashDesk에 직접 연결할 수 없는 PC도 동일한 네트워크 내에서 사용이 허가되고 연결된 PC를 통해 SSH로 접근할 수 있다면 조사할 수 있습니다.
실행되지 않는 앱 복구
업데이트 후의 실행 문제와 로그 증가로 인한 디스크 공간 부족을 조사했습니다. 로그 정리, 설정 검토, Mac에서의 VS Code 실행 문제 복구 등을 수행했습니다.
실제 기기에서 Windows 및 macOS 앱 테스트
스크린샷으로 화면을 확인하고 클릭과 키 입력이 앱에 전달되는지 검증했으며, 조작 후 화면의 변화도 확인했습니다.
반복하는 조사 절차를 재사용 가능하게 정리
자주 사용하는 로그 확인과 데이터베이스 조회를 스크립트로 정리하여 이후 조사에서도 같은 절차를 사용할 수 있도록 했습니다.

YouTube에서 FlashDesk MCP 데모 보기

기본 사용법

1

FlashDesk 설정에서 MCP 활성화하기

AI 도구가 실행되는 장치에서 FlashDesk 설정의 외부 AI 도구 접근을 켭니다. 기본값은 꺼짐입니다.

2

FlashDesk를 MCP 서버로 등록하기

동일한 설정 화면에서 등록할 정확한 구성 정보를 보여주고 복사 버튼을 제공합니다. 해당 내용을 AI 도구의 자체 MCP 설정에 붙여넣으세요. 각 AI 도구는 로컬 MCP 서버를 등록할 별도의 위치를 가지므로, 해당 위치에 대한 정보는 도구별 MCP 문서를 참조하세요.

{
  "mcpServers": {
    "flashdesk": {
      "command": "C:\\Program Files\\FlashDesk\\FlashDesk.exe",
      "args": ["--mcp-server"]
    }
  }
}

3

AI 도구에 연결을 요청하기

연결할 저장된 장치를 AI 도구에 알려줍니다. 연결은 원격 장치의 일반적인 승인 절차를 거칩니다.

4

자연어로 작업하기

연결이 완료되면 수행하려는 작업을 설명하면 됩니다. 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 를 통해 열린 연결은 사용자가 직접 시작한 연결과 동일한 원격 장치의 승인 또는 공유 비밀번호 흐름을 따릅니다.

운영 참고 사항

권장 운영 절차

AI 도구는 가져온 화면과 로그를 바탕으로 조사를 진행합니다. 먼저 읽기 전용으로 상태를 확인하고, 제안된 변경 내용을 검토한 다음, 필요한 백업을 수행한 후에 변경하는 절차를 권장합니다.

MCP 지원은 기본적으로 꺼져 있으며 AI 도구가 실행되는 장치에서 활성화해야 합니다.
MCP로 진행되는 세션에서도 일반 연결과 마찬가지로 원격 화면 창이 평소처럼 표시됩니다.
MCP 를 통한 파일 전송, 파일 삭제 및 이름 변경, SSH 명령 실행은 개별적으로 확인되지 않습니다. 삭제는 휴지통을 거치지 않으며 되돌릴 수 없습니다. MCP 를 활성화하기 전에 AI 도구에 허용하려는 작업을 고려하세요.
MCP를 통해 실행하는 SSH 명령은 대상 장치의 SSH 키가 AI 도구가 실행되는 장치에 미리 저장되어 있어야 합니다.
파일 도구는 원격 장치와 AI 도구가 실행되는 장치 양쪽 모두에 도달합니다. 폴더와 그 내용을 함께 삭제하려면 명시적인 옵션이 필요하므로, 단일 실수한 지시 사항으로 전체 트리를 지울 수 없습니다.
업데이트, 종료, 재시작 도구는 연결 양쪽 모두에서 FlashDesk 를 중지하거나 재시작할 수 있습니다. AI 도구가 실행되는 장치에서 FlashDesk 를 재시작하면 MCP 연결도 종료되며, AI 도구는 다시 연결해야 합니다.