# FlashDesk MCP

**English** | [日本語](#日本語)

Control **another PC's desktop** from Claude Code (and other AI tools) via the Model Context Protocol (MCP).

Claude Code's built-in Remote Control surfaces *your own* session on another device.
**FlashDesk is different:** it lets an AI tool drive **another machine's actual desktop** — take a
screenshot, move and click the mouse, type on the keyboard, run SSH commands, and transfer files —
for GUI work that SSH can't reach (installers, settings dialogs, desktop apps) on a **remote** machine.
The remote PC approves each connection.

> FlashDesk is a cross-platform remote desktop app (Windows / macOS / Linux / Android / iOS).
> The MCP server is built into the app. This repository documents how to use it.
> Product & downloads: https://flashdesk.io — MCP guide: https://flashdesk.io/mcp.html

## What the AI can do (MCP tools)

- List saved connections and check connection status; connect / disconnect
- Take a live screenshot of the remote screen
- Move the mouse, click, scroll; type text and press keys
- Get / set the clipboard
- List, upload, and download files and folders
- Run SSH commands on the remote device
- Start / stop / check screen recording

## Quick start (3 steps)

MCP is enabled on the **controlling** side — the PC where Claude Code runs. FlashDesk must be
installed there too (the MCP server is the local FlashDesk executable). The **remote** PC just needs
FlashDesk installed and to approve the incoming connection — no MCP setup on that side.

1. **On the PC running Claude Code:** install FlashDesk and turn on *external AI tool access* in
   Settings (off by default).
2. **On that same PC:** copy the MCP config (Settings → **Copy MCP config**) and paste it into Claude
   Code's MCP settings. `command` is that PC's local FlashDesk path:
   ```json
   {
     "mcpServers": {
       "flashdesk": {
         "command": "<path to FlashDesk>",
         "args": ["--mcp-server"]
       }
     }
   }
   ```
3. **Ask Claude Code, in natural language,** to connect to a saved remote device and get something
   done — e.g. *"connect to <device> and finish the installer that's open."* The AI decides when to
   screenshot, where to click, and what to type; FlashDesk performs it on the remote machine.

## Supported AI tools

Any MCP-compatible client: Claude Desktop, **Claude Code**, ChatGPT desktop / **Codex CLI**, Cursor,
Windsurf, VS Code (GitHub Copilot Chat). Web-only chats generally can't use a local MCP server — use a
desktop app or CLI.

## Security

- Connections require approval on the remote side; the remote screen window stays visible during an
  MCP-driven session (not hidden).
- Screen video, keystrokes, mouse input, transferred files, and SSH payloads are **not stored** on
  FlashDesk's relay servers. See https://flashdesk.io/security.html for details.

## Pricing

Free for personal, non-commercial use. Business / commercial use is Pro (¥980 / seat / month). A
"seat" is a device used on the controlling (Viewer) side; the remote PCs you connect to don't consume
seats.

---

## 日本語

[English](#flashdesk-mcp) | **日本語**

Claude Code（や他の AI ツール）から、**別の PC のデスクトップ**を MCP（Model Context Protocol）で操作します。

Claude Code の Remote Control は「**自分の**セッションを別の端末から見る」機能です。
**FlashDesk はそれとは別物**で、**別のマシンのデスクトップそのもの**を AI に操作させます。
スクリーンショット取得・マウス移動/クリック・キー入力・SSH コマンド実行・ファイル転送を、AI 側の
ツールとして呼べます。SSH では届かない GUI 作業（インストーラ・設定画面・GUI アプリ）を、**別拠点の**
マシンで片付けられます。接続は毎回、接続先の許可を通ります。

> FlashDesk はクロスプラットフォームの遠隔デスクトップアプリ（Windows / macOS / Linux / Android / iOS）です。
> MCP サーバーはアプリに内蔵されています。このリポジトリは使い方をまとめたものです。
> 製品・ダウンロード: https://flashdesk.io ／ MCP ガイド: https://flashdesk.io/mcp.html

### AI ができること（MCP ツール）

- 保存済み接続の一覧・接続状態の確認、接続 / 切断
- 遠隔画面のスクリーンショット取得
- マウス移動・クリック・スクロール、文字入力・キー入力
- クリップボードの取得 / 設定
- ファイル・フォルダの一覧・アップロード・ダウンロード
- SSH コマンドの実行
- 画面録画の開始 / 停止 / 状態確認

### 3 ステップで動かす

MCP を有効化して設定を貼るのは、どちらも **Claude Code を動かす側（操作する側）の PC** です。
そのため FlashDesk は操作する側にも入れておきます（MCP サーバーはローカルの FlashDesk 実行ファイル）。
**操作される側（別拠点の PC）**は、FlashDesk を入れて接続を許可できる状態にしておけば OK（MCP 設定は不要）です。

1. **操作する側の PC（Claude Code を動かす PC）**：FlashDesk を入れ、設定で「外部 AI ツールのアクセス」を ON（既定 OFF）。
2. **同じ PC**：FlashDesk 設定の「MCP 設定をコピー」で出る JSON を Claude Code の MCP 設定に貼る（`command` はその PC の FlashDesk 実行パス）。
   ```json
   {
     "mcpServers": {
       "flashdesk": {
         "command": "<この PC の FlashDesk 実行パス>",
         "args": ["--mcp-server"]
       }
     }
   }
   ```
3. **Claude Code に自然言語で頼む**：保存済みの接続先（別拠点の PC）を指定して「◯◯に接続して、△△しておいて」。
   画面を撮って状況を見る・どこをクリックするか・何を入力するかは AI が判断し、FlashDesk が遠隔のマシンで実行します。

### 対応 AI ツール

MCP 対応クライアント全般：Claude Desktop、**Claude Code**、ChatGPT デスクトップ / **Codex CLI**、Cursor、
Windsurf、VS Code（GitHub Copilot Chat）。Web だけのチャットは通常ローカル MCP を使えないので、デスクトップ版か CLI を使ってください。

### セキュリティ

- 接続には接続先側の許可が必要です。MCP 操作中も遠隔画面のウィンドウは隠されず表示されます。
- 画面映像・キー入力・マウス操作・転送ファイル・SSH の中身は、FlashDesk の中継サーバーには**保存されません**。詳しくは https://flashdesk.io/security.html 。

### 料金

個人の非商用利用は無料。業務・商用は Pro（¥980 / 席・月）。「席」は操作する側（Viewer）の端末数で、接続される側の PC は何台あっても席を消費しません。

---
*This repository is documentation for the FlashDesk app's MCP integration. Issues and questions welcome.*