Let AI agents use AirSCP (MCP)
AI agents such as Claude Code, Codex CLI or Gemini CLI can drive AirSCP the way you do: the same menus, buttons and questions, and AirSCP’s own screenshots. AirSCP is an MCP server for them. It is off until you turn it on.
Steps
- Open AirSCP ▸ Settings… and turn on Allow AI agents to control AirSCP (MCP).
-
Settings shows the command that adds AirSCP to Claude Code. Click Copy and paste it into Terminal. It looks like this:
claude mcp add airscp -- /Applications/AirSCP.app/Contents/MacOS/AirSCP --mcpOther MCP clients take the same program with
--mcp. Codex:codex mcp add airscp -- /Applications/AirSCP.app/Contents/MacOS/AirSCP --mcp.For Claude Code there is also a plugin, with a skill that teaches Claude how to use AirSCP. In Claude Code, type
/plugin marketplace add kleash/airscp, then/plugin install airscp@airscp. - Ask your agent to do something in AirSCP, for example “upload the build folder to web-01”.

Allow or deny what an agent changes
Before an agent changes something, AirSCP asks you. A small window shows what the agent wants to do, over every app:
- Deny (the default, also Return and Esc): the agent is told that you said no.
- Allow Once: just this change.
- Allow for 15 Minutes: this change, and every change agents ask for in the next 15 minutes, without asking again.
If nobody answers within 45 seconds, nothing is done, and the agent is told so.
AirSCP asks before an agent:
- deletes, replaces or renames files, or copies them to or from a server (uploads, downloads, drops, Synchronize);
- zips or unpacks files on S3 storage, or makes a presigned link that lets anyone download a file;
- opens a file in another app;
- changes files’ permissions or owners (Make Executable too), or puts a key on a server or in the ssh agent;
- switches a tunnel on or off;
- runs a command, a file or a snippet, types into a Terminal tab, or closes a tab whose command still runs;
- kills a process, cancels, retries or resumes transfers, disconnects or quits;
- types, presses keys or clicks on a Windows desktop.
It doesn’t ask when an agent only looks, selects, goes to a folder, opens AirSCP’s own windows or fills in their fields. When AirSCP asks a question of its own first (Delete asks “Delete …?”), the window comes when the agent answers it.
To turn these questions off, open AirSCP ▸ Settings… and turn off Ask before agents change things. Agents can’t turn it off.

See what an agent does
- The sidebar’s footer shows Agent control on. While an agent acts, its dot pulses and the footer names the agent and its last action.
- Hover over it to see who is connected and since when. Click it for the last 20 actions in plain words, with Turn Off Agent Control and Settings….
- While AirSCP asks you about a change, the footer says Waiting for your OK. After Allow for 15 Minutes, the hover text says until when agents may change things without asking.

Windows desktops
An agent can work in a Remote Desktop too. It works the way a careful person at the keyboard does:
- Keys first. It opens File Explorer with ⊞ E, goes to a folder through the address bar (Alt D, the path, Return) and runs programs with ⊞ R. Keys don’t miss.
- Clicks where no key reaches. The agent clicks in the pixels of the desktop picture AirSCP gives it, so the window’s size, a Retina screen or full screen don’t move its clicks. After each click AirSCP shows it a close-up of the spot with a red cross, so it can see what it hit.
Safe by design
- Only programs of your own user account on this Mac can connect, through a private socket with a secret that changes at every launch.
- Agents never see saved passwords: password fields read as •••, and no tool reads the Keychain.
- AirSCP’s questions stay in the way: Delete still asks, and the agent has to answer.
- Changes wait for your OK (see Allow or deny what an agent changes).
- Turning the setting off closes the connection at once.
For agents and scripts
- The agent gets AirSCP’s guide when it connects, and a
guidetool for the details. Help ▸ Agent Guide shows the same text. - Agents go to a folder by its path and open a file or folder by its name (the
goandopentools). You see the panes move as they work, and they never need to click in the file list. - From a shell:
AirSCP --agent snapshot,AirSCP --agent menu path='Host > Connect',AirSCP --agent screenshot --out shot.png. - All of this help as plain text for agents: llms.txt and llms-full.txt.