Сервер MCP
Используйте ccmux MCP сервер, позволяющий агенту кодирования проверять сеансы, читать примечания к проекту и проверять использование. Создание сеанса, нажатие клавиш и завершение доступны только при включении мутации.
Двоичный файл сервера включен в ccmux v0.3.0 и более поздние версии. Установите ccmux и перед подключением клиента убедитесь, что его демон запущен.
Подключите это
В Claude Code зарегистрируйте локальный stdio-сервер для своей учётной записи:
claude mcp add --transport stdio --scope user ccmux -- ccmux-mcp
Запустить /mcp внутри Claude Code, чтобы проверить соединение. См. Документация Claude Code MCP для областей настройки и устранения неполадок.
Для конфигурации на уровне проекта используйте .mcp.json в корне проекта:
{
"mcpServers": {
"ccmux": { "command": "ccmux-mcp" }
}
}
Другие MCP-клиенты используют собственный формат настроек. Добавьте stdio-сервер с командой ccmux-mcp; используйте абсолютный путь к двоичному файлу, если клиент не может найти его на PATH.
Теперь у агента есть следующие инструменты:
| Инструмент | Что он делает |
|---|---|
list_sessions |
сеансы, видимые подключенному демону, с состоянием и агентом |
read_pane |
последние N строк экрана любого сеанса |
list_projects |
каждый проект в корне вашего проекта |
list_conversations |
прошлые темы Claude / Codex / Cursor / Antigravity / pi / Grok |
get_usage |
токены + стоимость, скользящее окно |
list_machines |
устройства tailnet и наличие запущенного ccmuxd |
list_notes |
каждая уценка в проекте |
read_note |
содержимое одной заметки |
search_notes |
поиск текста в заметках проекта |
get_daemon_health |
демон жив |
Эти инструменты доступны только для чтения. Они предоставляют информацию, доступную подключенному демону.
Когда вы хотите, чтобы он что-то делал
Добавить --allow-mutate к аргументам сервера. Для конфигурации Claude Code в рамках проекта:
{
"mcpServers": {
"ccmux": { "command": "ccmux-mcp", "args": ["--allow-mutate"] }
}
}
Это разблокирует:
| Инструмент | Эффект |
|---|---|
spawn_session |
начать сеанс в существующем проекте |
spawn_bare_session |
начать сеанс, не привязанный к проекту |
send_keys |
введите текст на панели сеанса |
kill_session |
завершить сеанс |
По умолчанию отключено по причине: агент, который может send_keys в вашу работу — это агент, который может вводить все, что вы можете ввести. Флаг — это согласие. Нет переопределения для каждого инструмента — вы включаете весь набор мутаций или выключаете его.
Без этого флага инструменты для изменения отсутствуют. tools/list. Перезапустите сервер MCP через ваш клиент после изменения его аргументов.
Управление удаленной машиной
CCMUX_HOST=mini.tail-xxxxx.ts.net:7474 ccmux-mcp
# or
ccmux-mcp --host mini.tail-xxxxx.ts.net:7474
Агент запускается локально и опрашивает демон на Mac mini. Инструменты мутации по-прежнему требуют --allow-mutate. Тот же протокол, те же инструменты — чуть больше Tailscale HTTP вместо локального сокета Unix. Полезно для «Я программирую на ноутбуке, но ночная работа Claude приходится на мини».
Для чего это вообще нужно
Несколько конкретных фигур:
Многосессионная оркестровка. Агент в одном сеансе порождает помощника в другом (spawn_session в другом проекте), считывает выходные данные после завершения (read_pane), возвращает результат, убивает помощника. Ни одного человека в курсе.
Межмашинная работа. Агент на вашем ноутбуке проверяет, как поживает его брат на Mac mini (list_sessions, read_pane), без использования SSH. Или запускается длительная сборка на мини (spawn_session
после настройки сервера MCP с помощью --host и --allow-mutate) и продолжает свою локальную работу.
Память проекта. Агент читает заметки проекта в начале сеанса (list_notes + read_note), чтобы он не повторял работу предыдущего агента. Заметки хранятся на диске в виде простой уценки; агенту не обязательно это знать.
Осведомленность о затратах. Прежде чем начать большую пробежку, агент проверяет
get_usage , чтобы узнать, сколько вы потратили на этой неделе, и get_daemon_health
, чтобы узнать, сколько сеансов уже запущено.
Ничто из этого не требует новой инфраструктуры. У ccmux все это уже было. MCP — это просто протокол, который делает его доступным для агента.
Модель безопасности
- Транспорт. stdio. Unix-сокет демона доступен только текущему пользователю; для HTTP-подключения нужен доступ к вашей сети tailnet.
- Мутация. Выключено, если вы не установите флажок.
- Ограниченное чтение.
read_paneограничено 500 строками, поэтому агент с ошибками не сможет перетащить демон вниз, запрашивая полную прокрутку при каждом вызове. - Крайний срок для каждого звонка. Каждый обработчик выполняется в 30-секундном контексте.
Текущие ограничения
Сервер предоставляет инструменты запроса/ответа. Живые подписки, разрешения на изменение для каждого инструмента и библиотека подсказок в настоящее время недоступны.
Сопутствующие руководства
- Настройка удаленного хоста , прежде чем нацеливаться на его демон.
- Прочтите ссылку HTTP API. для создания клиента непосредственно на основе ccmuxd.
Помогите улучшить ccmux
Нашли ошибку, непонятную инструкцию или неудачный перевод? Мы рады любым улучшениям. Создайте issue или отправьте pull request.
Обнаружили ошибку или что-то устарело? Отредактируйте эту страницу на GitHub..