ClawTank — RDP-сервер и MCP для управления Mac
ClawTank
Приложение для macOS с RDP-сервером и встроенным MCP, через который агент на этом Mac делает снимки экрана, кликает и печатает
- 55 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Агент видит весь экран Mac и вводит текст и клики в любую программу, где открыт ваш аккаунт
- Приложению нужны права на запись экрана и универсальный доступ, а сборка бета-версии не нотаризована
Установка
- Работает в
Ручная установка
claude mcp add clawtank --env CLAWTANK_AGENT_TOKEN=ct_… -- "/Applications/ClawTank.app/Contents/MacOS/clawtank-mcp"Команда из docs/agent-api.md. Сначала установите ClawTank из DMG и создайте токен во вкладке Agents настроек.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент видит весь экран Mac и вводит текст и клики в любую программу, где открыт ваш аккаунт
- Приложению нужны права на запись экрана и универсальный доступ, а сборка бета-версии не нотаризована
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
ClawTank — нативный RDP-сервер для macOS. К Mac `mini` или Mac Studio подключаются стандартными клиентами: Windows App на Windows, Mac, iPad и iPhone, приложением Microsoft на Android, `mstsc` на Windows или FreeRDP на Linux. Видео кодирует H.264 медиадвижок Apple `silicon`, рабочий стол подстраивается под окно клиента, а Mac без монитора обходится виртуальным дисплеем. Для агентов приложение включает Agent API, по умолчанию выключенный. После создания токена в настройках агент на этом же Mac подключает MCP-сервер clawtank-mcp из пакета приложения. Инструменты: `screenshot`, get_state, list_displays, `click`, move_mouse, `drag`, `scroll`, press_key, type_text, open_app, create_virtual_display и remove_virtual_display. Для скриптов есть REST на 127.0.0.1:3390. Пока агент работает, на каждом дисплее висит оранжевая плашка с кнопкой Stop, а каждое действие попадает в журнал соединений. Ввод человека всегда главнее: три секунды после него команды агента получают отказ.
Для кого. Владельцам Mac `mini` и Mac Studio без монитора, которым нужен удаленный рабочий стол и безопасный способ дать агенту управлять этим Mac.
Подходит, если
- Дома стоит Mac `mini`, а работать хочется с MacBook, Windows-ноутбука или iPad
- Агент должен кликать и печатать в программе, у которой нет ни API, ни командной строки
- Нужен виртуальный дисплей на Mac без подключенного монитора и без заглушки HDMI
- Удаленный доступ идет через Tailscale без перенаправления портов и без облака
- Хочется журнал соединений, где видно каждый скриншот, клик и запуск приложения агентом
Не подходит, если
- Требуется одновременная работа нескольких людей: поддерживается один сеанс RDP, раздельных сеансов по учетным записям macOS публичные API не дают
- У вас Intel Mac и нет желания собирать приложение: готовые сборки только для Apple `silicon`
- Нужен доступ к экрану блокировки: macOS показывает клиенту лишь обои, пока Mac не разблокируют за клавиатурой
- Агент работает на другой машине: Agent API слушает только 127.0.0.1
Пример запроса к агенту
Сделай скриншот экрана, открой TextEdit и набери в нем краткое содержание письма, которое я диктовал.MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
Переменные окружения
CLAWTANK_AGENT_TOKENобязательная, секрет- Токен агента, созданный в вкладка Agents в Settings
CLAWTANK_AGENT_URL- Адрес Agent API, если сменили порт
Ограничения
Релиз 0.9 в бета-статусе: нотаризации сборки нет, при первом запуске нужен ручной шаг Open Anyway, автообновлений пока нет. Требуется macOS 14 или новее на Apple `silicon`, а при каждом обновлении без подписи macOS просит заново выдать права на запись экрана и универсальный доступ.
Клиент и Mac должны находиться в одной сети либо оба в Tailscale. Агентский MCP-сервер входит в приложение, поэтому ClawTank должен быть установлен и запущен. Один монитор на сеанс, полноцветного AVC444 пока нет.
Как отключить. Выключите переключатель Allow AI agents to `control` `this` Mac в разделе Settings, вкладка Agents, или нажмите Stop на плашке: Agent API отключится и виртуальные дисплеи исчезнут. MCP-сервер уберите командой claude mcp `remove` clawtank.
Частые вопросы
Как подключить агента к Mac через ClawTank?
Включите Allow AI agents to `control` `this` Mac в настройках, создайте токен и выполните claude mcp add clawtank с переменной CLAWTANK_AGENT_TOKEN, указав бинарник clawtank-mcp из пакета приложения. Для Claude Desktop есть пакет .mcpb.
Видно ли, что агент управляет компьютером?
Да. На каждом дисплее появляется оранжевая плашка Agent in `control` с кнопкой Stop, меняется значок в строке меню, а каждое действие пишется в журнал. Набранный текст журнал хранит как число символов.
Нужен ли отдельный пароль для RDP?
Да, у ClawTank свой пароль, он не совпадает с паролем Mac. Утекший RDP-пароль не откроет связку ключей и sudo. Подключение идет по TLS с NLA, после пяти неудачных входов адрес блокируется на пять минут.
Как попасть на Mac из другой сети?
Ставьте Tailscale на Mac и устройство и входите в один аккаунт. По умолчанию принимаются только адреса локальной сети и Tailscale, пробрасывать порты наружу не рекомендуется.
Отправляет ли ClawTank данные в облако?
Нет. Приложение не делает собственных сетевых подключений и только принимает входящие RDP-соединения и необязательные вызовы Agent API на 127.0.0.1. Запись экрана на диск не ведется.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер для macOS: агент двигает мышь, печатает, управляет окнами и снимает экран, когда у приложения нет API
Remote macOS Use — управление удаленным Mac
mcp-remote-macos-use
MCP-сервер, через который Claude Desktop видит экран Mac по VNC, двигает мышь, жмет клавиши и открывает приложения
MCP-сервер дает агенту управлять окнами и приложениями: он читает экран как структуру и действует по имени элемента
MCP-сервер дает агенту видеть экран и управлять macOS, Windows и Linux: скриншоты, клики, ввод, OCR и память экрана
CLI и MCP-сервер для macOS: скриншоты, разбор интерфейса через accessibility и управление приложениями по кликам и вводу
MCP-сервер на Swift дает агенту управлять любым приложением macOS: кликать, печатать и читать дерево интерфейса
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| ClawTank — RDP-сервер и MCP для управления Mac (эта карточка) | нет | API-ключ | 55 | |
| macOS-MCP | нет | ключ необязателен | 240 | управление системой через API macOS без удаленного рабочего стола |
| computer-use-mcp | нет | не нужна | 400 | универсальный сервер управления экраном без собственного RDP-сервера |
Коротко о README
README ведет от установки образа DMG и первого запуска до подключения клиентов с Windows, Mac, iPad, Android и Linux. Таблица сравнивает ClawTank с Screen Sharing в macOS и Chrome Remote Desktop, отдельные разделы описывают устранение неполадок, известные ограничения и бета-тестирование. Подробности про Agent API вынесены в документ docs/agent-api.md.