Общий доступ к живому TUI через MCP

Эта страница переведена с английской документации. Команды, идентификаторы и примеры не изменены. Среда выполнения 7.24.4 · SDK 2.6.7. Английский оригинал

Статус: экспериментально Область: публично, текущее состояние Последняя проверка: 2026-10-04 Владелец: сопровождающие AX Code

TUIMCP — экспериментальный адаптер MCP по согласию для TUI AX Code в macOS и Linux. Он позволяет внешнему агенту читать ограниченное состояние интерфейса и перемещаться по тому же TUI, которым пользуетесь вы. Windows в этой версии не поддерживается.

Запустите TUI с явным общим доступом:

ax-code --tui-mcp
# Or attach to an existing local backend:
ax-code attach http://localhost:4096 --tui-mcp

Полоса TUIMCP показывает абсолютный частный путь endpoint.json. Настройте клиент MCP на запуск:

{
  "mcpServers": {
    "ax-code-tui": {
      "command": "ax-code",
      "args": ["mcp", "tui", "--endpoint", "/absolute/path/from/the/TUI/endpoint.json"]
    }
  }
}

Используйте путь, который показывает ваш работающий TUI. У каждого TUI своя конечная точка; автоматического обнаружения или выбора цели нет. Клиент должен работать от того же пользователя ОС. Считайте файл конечной точки возможностью: в нём секретный токен. Не фиксируйте его, не копируйте в запросы и не делитесь содержимым. Учётные данные бэкенда адаптеру никогда не передаются.

Инструменты

get_view_context: возвращает экземпляр и поколение, ревизию, маршрут, необязательный идентификатор сессии, готовность и то, заблокирована ли навигация. Он не возвращает стенограммы, черновики, заголовки сессий, пути рабочей области и учётные данные.
select_session: требует личность и ревизию из свежего контекста, идентификатор сессии проекта и уникальный UUID requestId. Он проверяет сессию через существующее аутентифицированное соединение бэкенда TUI. Успешный ответ подтверждает состояние маршрута приложения; отрисовка и загрузка сессии ещё могут идти. Идентификаторы сессий можно получить отдельно через обычные интерфейсы сессий AX Code.

Навигация отвергается, пока есть черновик или вложение, ожидается модальное окно или одобрение, сессии заняты, бэкенд отключён, активны наложения запуска или выхода либо пользователь взаимодействовал в последние 1,5 секунды. Изменённое состояние интерфейса или рабочей области делает старые ревизии недействительными. Эти инструменты не могут отправлять запросы, выполнять команды оболочки, одобрять разрешения или начинать работу агента.

Повторный одинаковый requestId возвращает исходную квитанцию, включая её исходный контекст. Повторное использование с другими аргументами — ошибка. После 128 запросов навигации новые запросы для этого процесса TUI отвергаются; доступ на чтение и существующие квитанции остаются. Перезапустите с явным общим доступом, чтобы сбросить этот предел. Квитанции не вытесняются в небезопасный повтор.

deadline_exceeded значит, что проверка отменена до навигации. timeout_unknown или outcome_unknown значит, что вызывающая сторона не получила окончательного исхода; операция могла примениться. Прочитайте текущий контекст, чтобы свести состояние. Адаптер никогда не повторяет автоматически. Успех соединения или транспорта сам по себе не значит, что навигация удалась; осмотрите isError и структурированный результат.

Отзыв и жизненный цикл

Щёлкните [Отозвать] на полосе TUIMCP или выполните /tui-mcp-revoke. Отзыв сразу ограждает ожидающую навигацию и закрывает сокет. Выход тоже закрывает конечную точку; перезапуск создаёт новую личность и токен. Упавший процесс может оставить бездействующий частный временный каталог; старые клиенты не могут через него присоединиться к новому TUI.

Общий доступ по умолчанию выключен и не сохраняется. Локальные проверки владельца и режима защищают от других пользователей ОС; TUIMCP — не песочница против кода, который уже выполняется от вашего пользователя. Если при запуске сообщается, что путь сокета слишком длинный, задайте более короткий частный временный корень через TMPDIR и запустите новый TUI.