接入你的智能体
发布者自己的命令。不是 PlugMCP 端点。
用我们的密钥与日志托管一份副本。
npx -y [email protected]Claude Code 没有针对本地命令的安装链接。复制下方命令并在终端中运行。
claude mcp add arena-bridge -- npx -y arena-bridge@0.20.6在终端中运行。
{ "mcpServers": { "arena-bridge": { "command": "npx", "args": [ "-y", "[email protected]" ] } }}claude_desktop_config.json
远程 URL 还是本机命令？ 两种安装方式的区别
来自发布者
Полное дерево функциональности — в feature-tree.md.
Облачный агент (Arena.ai Agent Mode, Claude, Cursor, любой MCP-клиент) работает в песочнице с выходом в интернет, но не имеет доступа к вашему компьютеру. — это маленький HTTP-сервис на вашей машине: он слушает только localhost, выставляется наружу туннелем (cloudflared / ngrok / Tailscale) и отдаёт агенту инструменты, которые вы ему разрешили:
Give a cloud AI agent (Arena.ai Agent Mode, Claude, Cursor, ...) controlled access to your own machine over HTTP/MCP: files, shell, Chrome and the macOS desktop, with an approval gate, trust windows and an audit log.
arena-bridgeВсё, что меняет состояние, проходит через гейт подтверждений, а каждое действие пишется в журнал.
Без вашего arena-bridge approve агент ничего не сделает. Наблюдать за машиной можно без
подтверждений, а работать «без вопросов» — внутри окна доверия, которое вы открываете сами.
Одна команда ставит и командную строку, и нативное приложение для macOS:
curl -fsSL https://raw.githubusercontent.com/vernikr/arena-bridge/main/install.sh | sh
Или по отдельности:
npm i -g arena-bridge # только командная строка
pip install arena-bridge # то же самое на Python
Приложение macOS можно скачать и без терминала — в каждом выпуске лежат готовые сборки: Apple silicon · Intel. Распаковать и перетащить в «Программы».
# 1. один раз: создать конфиг, проверить машину, поднять API + туннель
arena-bridge setup --root ~/projects --root ~/Documents
# 2. скопировать блок «Paste this into the agent chat» и вставить его в чат с агентом
macOS и Gatekeeper. Приложение подписано локально, поэтому при первом запуске система может сказать «нельзя открыть, так как разработчик не проверен». Обойти это можно без терминала: правый клик по Arena Bridge в «Программах» → Открыть → Открыть. Через терминал:
xattr -dr com.apple.quarantine "/Applications/Arena Bridge.app".
setup печатает готовый промпт и публичный URL. Дальше — просто говорите агенту задачу.
Туннель под присмотром: если cloudflared/ngrok упадёт, мост поднимет его заново и сам
напечатает новый публичный адрес. Постоянный адрес вместо случайного — arena-bridge tunnel --bin ngrok --domain <зарезервированный домен>.
Нужен туннель? Поставьте cloudflared (brew install cloudflared или бинарник в /usr/local/bin).
Можно и через ngrok — arena-bridge tunnel --bin ngrok; с сохранённым токеном и зарезервированным
доменом публичный адрес остаётся постоянным, и промпт агенту не нужно копировать заново:
arena-bridge tunnel --bin ngrok --authtoken <token> --domain <name>.ngrok-free.dev.
Мост можно поднять как службу macOS — он стартует вместе с системой, переживает закрытие терминала и поднимается заново после сбоя:
arena-bridge service install # облако, случайный адрес
arena-bridge service install --bin ngrok --domain mymac.ngrok-free.app # постоянный адрес
arena-bridge service status # состояние и текущий URL
arena-bridge url # текущий публичный адрес
arena-bridge service uninstall
arena-bridge service install # launchd: стартует вместе с системой, URL всегда живой
arena-bridge url # текущий публичный URL
pipx install arena-bridge # или: pip install arena-bridge
arena-bridge setup --root ~/projects
Полный каталог с JSON-схемами: GET /tools или arena-bridge tools.
Свой минимальный CDP-клиент внутри пакета: ни puppeteer, ни playwright не нужны.
// браузер агента: свой профиль, без ваших cookie
{"tool": "chrome_launch", "args": {"headless": true, "url": "https://example.com"}}
// прочитать структуру страницы
{"tool": "chrome_snapshot", "args": {"mode": "ax"}}
// кликнуть и ввести
{"tool": "chrome_click", "args": {"text": "Sign in"}}
{"tool": "chrome_type", "args": {"selector": "input[name=q]", "text": "hello", "submit": true}}
// скриншот
{"tool": "chrome_screenshot", "args": {"path": "shot.png"}}
headless: true — без окна (по умолчанию), headless: false — видимое окно;~/.arena-bridge/chrome-profile-*), в ваши сессии агент не попадает;Ваш настоящий Chrome (с вашими логинами) — через chrome_attach:
open -na "Google Chrome" --args --remote-debugging-port=9222 --user-data-dir="$HOME/.chrome-debug"
{"tool": "chrome_attach", "args": {"port": 9222}}
Любое действие в присоединённом браузере требует локального подтверждения. Инструментов чтения cookies и localStorage нет.
Через Peekaboo (это же использует и MCP-режим Peekaboo):
{"tool": "mac_see", "args": {"app": "Safari", "mode": "window"}} // скриншот + id элементов
{"tool": "mac_element", "args": {"name": "Save"}} // найти кнопку по названию
{"tool": "mac_click", "args": {"on": "B3"}} // клик по id из mac_see
{"tool": "mac_set", "args": {"on": "B2", "value": "hello"}} // вписать значение напрямую
{"tool": "mac_type", "args": {"text": "hello", "submit": true}}
{"tool": "mac_key", "args": {"key": "cmd+s"}}
{"tool": "mac_menu_click", "args": {"app": "Safari", "item": "Save"}} // пункт меню по названию
{"tool": "mac_wait", "args": {"name": "Saved", "timeout": 20}} // дождаться результата
{"tool": "mac_apps", "args": {}} // что запущено
{"tool": "mac_permissions", "args": {}} // чего не хватает в macOS
Установить Peekaboo: brew install peekaboo (или бинарник в /usr/local/bin/peekaboo).
Проверено с Peekaboo 4.9 (4.3 тоже работает, но синтаксис команд обновлён под 4.9).
macOS asks for Screen Recording and Accessibility for the Arena Bridge app; without them screenshots and clicks fail. See macOS permissions.
macOS отдаёт приложениям два разных слоя: картинку экрана и Accessibility API — дерево элементов интерфейса с названиями, ролями и значениями. Второй слой полезен агенту сильнее:
Практический вывод: с выданным Accessibility агент работает заметно точнее и тише. Разрешение
даётся один раз в Системные настройки → Конфиденциальность и безопасность → Универсальный
доступ (for the Arena Bridge app, see macOS permissions). mac_permissions shows the current state.
Каждый вызов записывается: аргументы, результат, время выполнения. Рядом с журналом хранятся доказательства — снимки экрана, деревья Accessibility, деревья меню, список рабочих столов.
arena-bridge audit # последние вызовы
arena-bridge audit artifacts # сохранённые файлы (скриншоты, деревья)
arena-bridge audit <id> # одна запись целиком
arena-bridge audit prune # удалить старые артефакты (по умолчанию старше 14 дней)
arena-bridge audit dir # где всё это лежит
Агенту доступно то же самое: audit_log (вызовы) и audit_artifact (сам артефакт — PNG в base64
или дерево Accessibility в JSON), а также GET /audit и GET /audit/artifact?entry=<id>&file=<name>.
Полезно, чтобы оглянуться назад: что было на экране и что находилось в интерфейсе.
Агент может писать вам в Telegram и читать ваши ответы — даже если вы сейчас не в чате с ним.
# один раз: привязать бота (токен от @BotFather и ваш chat id)
arena-bridge telegram setup --token 123456:AA... --chat-id 190771108
# проверить связь
arena-bridge telegram test
# посмотреть, что вам писали
arena-bridge telegram inbox
Что это даёт:
notify_user — агент пишет вам: «сделал», «нужно ваше решение», «вот результат».
С {"wait_for_reply": true} вызов ждёт вашего ответа прямо в Telegram.telegram_inbox — агент читает то, что вы написали боту: ответы, правки, поручения.telegram_status — бот, список чатов, число непрочитанных сообщений./approve <id> — разрешить, /deny <id> — отказать. Из терминала тоже можно:
arena-bridge approve <id>.Как это устроено и что защищено:
~/.arena-bridge/config.json (права 0600); агент этот файл
прочитать не может — он в списке защищённых путей;--chat-id (по умолчанию — ваш);~/.arena-bridge/telegram/.Одно уточнение: для бота api_id/api_hash не нужны — они пригодятся только для режима
«личного аккаунта» (MTProto), который пока не включён.
Окно, в котором всё видно и всё управляется: статус, пуск/стоп, подтверждения, журнал.
git clone https://github.com/vernikr/arena-bridge.git
cd arena-bridge/macos/ArenaBridge
./build.sh # → dist/Arena Bridge.app
cp -R "dist/Arena Bridge.app" /Applications/
Нужен только Swift из Xcode Command Line Tools (xcode-select --install), Xcode целиком не
требуется. Собирается под текущую архитектуру: ARCH=x86_64 для Intel, ARCH=arm64 для
Apple Silicon. Готовые сборки для обеих архитектур появляются в каждом выпуске на GitHub
(см. «Быстрый старт»), собирать самому не нужно.
Окно следит за машиной само: статус, подтверждения и доверенное окно обновляются каждые несколько секунд, журнал — чуть реже. Кнопка обновления (⌘R) есть на всякий случай.
Когда агенту нужно решение, приложение показывает системное уведомление macOS «Approval needed» — в строке меню и в центре уведомлений. Внутри окна запрос тоже виден сразу, в карточке «Подтверждения».
«Настроить…» собирает конфиг, службу и запуск одной кнопкой: туннель (ngrok/cloudflared), зарезервированный домен, authtoken, папки для агента, Telegram (токен бота и chat id).
Иконка приложения лежит в macos/ArenaBridge/Resources/AppIcon.png; build.sh сам собирает
из неё .icns и кладёт в бандл. Вокруг знака прозрачно — на светлом фоне иконка не белая.
The bridge takes screenshots and clicks through the helper arena-bridge-agent inside Arena Bridge.app, so macOS needs two permissions for it:
Check them at any time with arena-bridge permissions (exit code 3 when something is missing) or with the mac_permissions tool. The app shows a warning on the Control card when either permission is missing. Click Fix… to open the step-by-step guide.
The screen runtime is the helper arena-bridge-agent inside the app (/Applications/Arena Bridge.app/Contents/Helpers/arena-bridge-agent). macOS checks that helper, so it is the entry to switch on. Each missing permission has its own Fix … button on the Control card, which opens a guide with that permission's steps.
Harder cases:
/Applications. Move it there first. macOS ties permissions to the exact file location.The Keep permissions after updates… button in each permission guide opens the same steps inside the app.
macOS identifies an app by its signature. Builds without your own certificate are ad-hoc signed, and macOS can reset their permissions after every rebuild. To avoid this, create a certificate once:
Arena Bridge Local. Identity Type: Self-Signed Root. Certificate Type: Code Signing. Click Create, then Done.Arena Bridge Local. Three items appear: a certificate, a public key and a private key. Double-click the item whose Kind is certificate, expand Trust, set When using this certificate to Always Trust, close the window, and enter your password.ARENA_SIGN_IDENTITY="Arena Bridge Local" bash macos/ArenaBridge/build.sh. Install the app and grant the permissions once more. Later builds signed the same way keep them.Release downloads are ad-hoc signed, so after installing one, follow the grant steps again. The Control card warning and arena-bridge permissions show the state after every update.
Имя приложения лежит в трёх местах, и тесты следят, чтобы они совпадали:
Фоновая служба в «Системных настройках → Вход» называется так же, как приложение, а не
«node» или «python»: запускает её помощник внутри бандла приложения, а без приложения — небольшой
скрипт ~/.arena-bridge/Arena Bridge.
Под сообщением «Approval needed» появляются нативные кнопки:
Approve once Approve for 3h Deny
Кнопки работают и в приложении на Mac, и в Telegram; сообщение в Telegram после нажатия
переписывается на итог. Прежние команды /approve <id> и /deny <id> тоже работают.
arena-bridge trust --for 2h # всё, на 2 часа
arena-bridge trust --for 30m --tools bash # только команды
arena-bridge trust --for 1h --paths ~/projects/my-app # только эта папка
arena-bridge trust --status
arena-bridge trust --status --json # для приложений и скриптов
arena-bridge trust --off
roots и в защищённых каталогах по-прежнему PROTECTED;--paths ограничивает доверие конкретными папками; bash под такое ограничение не попадает —
чтобы доверять командам, укажите --tools bash явно;~/.arena-bridge/trust.json), агент открыть его не может;Агенту можно выдать несколько независимых профилей браузера — например «рабочий», «клиентский», «тестовый». В каждом свои входы, и они переживают перезапуск моста.
arena-bridge browser login work # открыть Chrome с профилем «work»
# вы логинитесь в нужные сайты и закрываете окно — входы сохраняются
arena-bridge browser list # какие профили есть
arena-bridge browser close work # закрыть окно этого профиля
Агент открывает тот же профиль через chrome_launch {"profile":"work"} — уже с вашими входами.
Каталог профилей агент тоже видит: chrome_profiles.
browser login специально запускает обычный Chrome без отладочного порта и флагов
автоматизации: Google и другие сайты отказывают во входе браузеру, который выглядит
управляемым извне. Отладочный доступ появляется только потом, в агентском
chrome_launch, когда вход уже выполнен. Старое имя browser open оставлено как
алиас той же команды.
Ваш собственный Chrome (на порту 9222, с вашими сессиями) доступен отдельно — через
chrome_attach; любые действия в нём требуют подтверждения.
Рекомендация для ноутбука с 16 ГБ и Intel 2019: отдельные профили браузера + фоновый режим + при необходимости второй рабочий стол macOS. Полноценная виртуальная машина того не стоит.
POST /approvals/:id требует локальный токен.roots — PROTECTED. Защищённый список по умолчанию включает
~/.ssh, ~/.aws, ~/.arena-bridge, ~/.npmrc, профили браузеров, ключи.bash, запись, удаление, управление вашим Chrome и десктопом ждут
arena-bridge approve <id>. Подтверждать нужно, пока вызов ожидает решения.
После timeout или expired запрос закрыт и его approval_id больше не принимается.
Для продолжения откройте arena-bridge trust --for 1h и повторите вызов один раз либо
согласуйте новый вызов, который пользователь подтвердит во время ожидания.~/.arena-bridge/audit.log (JSONL) — кто, что и когда вызвал.127.0.0.1, наружу — только туннель с HTTPS.arena-bridge rotate # новый агентский токен (действует мгновенно)
arena-bridge rotate --device # новый девайсный токен
arena-bridge audit -n 50 # что происходило
GET /health liveness (без авторизации)
GET /tools каталог инструментов с JSON-схемами
GET /prompt этот промпт для агента
GET /approvals ожидающие подтверждения
GET /audit журнал работы с артефактами
GET /audit/artifact сохранённый артефакт (entry=, file=)
POST /call {"tool":"bash","args":{...}}
POST /exec {"command":"...","cwd":"...","timeout_sec":120}
GET|PUT|DELETE /files?path=/abs/path
POST /approvals/:id {"decision":"approve"|"deny"} — только по локальному токену
POST /mcp MCP Streamable HTTP (protocolVersion 2025-06-18)
curl -sS -X POST "https://<ваш-url>/call" \
-H "Authorization: Bearer $ARENA_BRIDGE_TOKEN" \
-H "Content-Type: application/json" \
-d '{"tool":"sysinfo","args":{}}'
npm install # зависимостей нет — только dev-тесты
npm test # 52 теста Node: direct, approval, trust, MCP, hub, туннель, Chrome, десктоп
npm run test:python # 44 теста Python: то же самое
Тесты не требуют ни Chrome, ни Peekaboo: используются фейковые CDP- и Peekaboo-серверы
(test/fake-cdp.mjs, test/fake-peekaboo.sh).
src/ Node-реализация (zero dependencies)
ws.mjs минимальный WebSocket-клиент
cdp.mjs клиент Chrome DevTools Protocol
browser.mjs 17 инструментов chrome_*
mac.mjs 20 инструментов mac_* (Peekaboo, Accessibility API)
trust.mjs окно доверия
policy.mjs проверка путей (roots / protected)
engine.mjs каталог, гейт подтверждений, аудит
direct.mjs HTTP-сервер
hub.mjs хаб для нескольких машин
cli.mjs команды
arena_bridge/ тот же функционал на Python (stdlib only)
MIT
Give a cloud AI agent (Arena.ai Agent Mode, Claude, Cursor, ...) controlled access to your own machine over HTTP/MCP: files, shell, Chrome and the macOS desktop, with an approval gate, trust windows a
{ "mcpServers": { "arena-bridge": { "command": "npx", "args": [ "-y", "[email protected]" ] } }}概览
Give a cloud AI agent (Arena.ai Agent Mode, Claude, Cursor, ...) controlled access to your own machine over HTTP/MCP: files, shell, Chrome and the macOS desktop, with an approval gate, trust windows and an audit log.
工具
暂无工具列表。远程服务器在首次健康检查后会获得工具列表。
常见问题
在本页复制适用于 Cursor、Claude Desktop、Claude Code 或 VS Code 的 stdio 配置。它使用发布者的安装方式，而不是 PlugMCP 代理。
此记录未列出必需的环境变量。
Arena Bridge 通过 stdio 在本地运行。
上次检查时间：2026-11-14。 Give a cloud AI agent (Arena.ai Agent Mode, Claude, Cursor, ...) controlled access to your own machine over HTTP/MCP: files, shell, Chrome and the macOS desktop, with an approval gate, trust windows and an audit log.