Сервер 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 — это просто протокол, который делает его доступным для агента.

Модель безопасности

Текущие ограничения

Сервер предоставляет инструменты запроса/ответа. Живые подписки, разрешения на изменение для каждого инструмента и библиотека подсказок в настоящее время недоступны.

Помогите улучшить ccmux

Нашли ошибку, непонятную инструкцию или неудачный перевод? Мы рады любым улучшениям. Создайте issue или отправьте pull request.


Обнаружили ошибку или что-то устарело? Отредактируйте эту страницу на GitHub..