Подключить внешнего агента (MCP)

Откройте XTester Studio и свой учебный или рабочий проект. Выберите AI-клиент с поддержкой локальных MCP-серверов. Studio должна оставаться открытой, пока агент работает с её окном.

Быстрый путь: получить конфигурацию в Studio, добавить её в клиент, выбрать окно и проверить чтение проекта. Адрес сайта XTester не служит адресом локального MCP-сервера.

Скриншот программыXTester 1.0.0-preview.1

Увеличить скриншот

1. Выберите команду подключения MCP.

Скриншот программыXTester 1.0.0-preview.1

Увеличить скриншот

1. Скопируйте конфигурацию именно своего клиента.

Откроется «Настройки → Внешние агенты». Здесь есть карточки клиентов, копирование конфигурации, сведения о подтверждениях и ссылки на инструкции.

Выберите карточку своего клиента. «Скопировать команду» выдаёт регистрацию для Claude Code, «Скопировать конфиг Codex» — TOML, «Скопировать JSON» — блок для совместимых клиентов.

Скриншот программыXTester 1.0.0-preview.1

Увеличить скриншот

1. Здесь показаны пути этой установки; не копируйте путь со скриншота.

Используйте результат своей программы: он содержит действительный путь этой установки и необходимые аргументы. Если вместе с --studio скопирован --engine-dir и путь, сохраните их. Не заменяйте значения примером с чужого компьютера.

«Открыть папку конфигов» ведёт в mcp-connect. Там находятся claude-code.txt, codex.toml, mcp.json и README.md. Папка создаётся программой и обновляется при запуске движка; свои изменения сохраняйте в конфигурации AI-клиента. Фактические пути доступны в раскрываемых технических сведениях.

Скопируйте команду из карточки Claude Code и выполните её в терминале. В ней используется имя сервера xtester-studio. Для проверки регистрации доступны команды ниже.

Путь /absolute/path в примере обозначает место подстановки. Готовая команда из Studio уже содержит ваш путь и может содержать дополнительные аргументы — используйте её целиком.

claude mcp add --scope user xtester-studio -- "/absolute/path/XTester.McpHost" --studio

claude mcp list
claude mcp get xtester-studio

Скопируйте TOML из карточки Codex. MCP-серверы описываются в config.toml: обычно ~/.codex/config.toml; у доверенного проекта возможен отдельный .codex/config.toml.

Добавьте блок xtester-studio, сохранив остальные настройки и серверы. Пример показывает формат, а значения command и args берутся из вашей Studio. После добавления обновите подключение в клиенте или начните новую сессию и проверьте наличие сервера.

[mcp_servers.xtester-studio]
command = "/absolute/path/XTester.McpHost"
args = ["--studio"]

Кнопка «Скопировать JSON» выдаёт объект mcpServers. Внутри него находится запись xtester-studio с командой и аргументами локального процесса.

Claude Desktop: откройте настройки локальных MCP-серверов и файл claude_desktop_config.json через параметры разработчика. В macOS он обычно находится в ~/Library/Application Support/Claude/, в Windows — в %APPDATA%\Claude\. Добавьте запись сервера и перезапустите клиент.

Cursor: используйте .cursor/mcp.json проекта или ~/.cursor/mcp.json для личной общей настройки. Добавьте сервер в mcpServers и проверьте его в настройках MCP. Если клиент просит выбрать транспорт, нужен локальный stdio.

Сохраняйте другие записи mcpServers. В примере ниже путь условный; полный блок своей установки копируется в Studio.

{
  "mcpServers": {
    "xtester-studio": {
      "command": "/absolute/path/XTester.McpHost",
      "args": [
        "--studio"
      ]
    }
  }
}

Попросите клиента сначала показать живые окна Studio и выбрать нужный проект. При нескольких окнах важны имя проекта и тег окна. Для первой проверки запросите только чтение.

В Studio проверьте карточки проекта, клиента и прав. Подтвердите ограниченный доступ. Затем клиент должен получить сведения именно об этом проекте. Наличие записи сервера в настройках клиента само по себе ещё не подтверждает выбор окна.

Покажи открытые окна XTester Studio. После выбора моего окна подключись только для чтения. Назови проект и его файлы, ничего не изменяя.

Техническая последовательность: list_studio_sessions → select_studio_session → get_studio_attach_status → get_project_info. Идентификаторы берутся из свежих ответов хоста, а не из примера или прошлого запуска.

У select_studio_session указываются session_id, window_tag и запрашиваемый access. После ответа pending его requestId передаётся в get_studio_attach_status как attach_request_id. Чтение сведений о проекте выполняется после выданного доступа.

Параметр confirm=true подтверждает явно выбранное пользователем окно. Он не заменяет разрешение в диалоге Studio и не позволяет автоматически выбирать чужой проект.

Официальная инструкция Claude Code: https://code.claude.com/docs/en/mcp

Официальная инструкция Codex: https://learn.chatgpt.com/docs/extend/mcp?surface=cli

Локальные MCP-серверы и Claude Desktop: https://modelcontextprotocol.io/docs/develop/connect-local-servers

Официальная инструкция Cursor: https://cursor.com/docs/mcp