Документация

MCP-сервер

Подключите AI-ассистентов к вашим проектам через Model Context Protocol. Просмотр, чтение, поиск и редактирование с теми же проверками конфликтов, что и в редакторе.

Ассистент запускает сервер MCP в IWE Code с флагом --mcp. Обмен идёт через стандартные потоки. Инструменты чтения файлов развёртывания могут подключаться к настроенным серверам.

Как это работает

  • Ассистент запускает бинарник IWE Code с флагом --mcp. Процесс обслуживает Model Context Protocol через стандартные потоки.
  • Сервер читает тот же файл рабочего пространства, что и приложение. Проекты, добавленные или выбранные в IWE Code, сразу видны ассистенту.
  • Инструменты покрывают просмотр, чтение, поиск и редактирование. Инструменты Git показывают ветки, изменённые файлы и недавние коммиты.
  • Редактирование требует токен ревизии из последнего чтения. Запись отклоняется, если файл изменился после чтения, — ничто не перезаписывается вслепую.

Подключение ассистента

Укажите клиенту путь к бинарнику приложения и добавьте флаг --mcp. Путь зависит от способа установки.

Claude Code принимает одну команду:

claude mcp add iwe -- /path/to/iwe --mcp

Claude Desktop, Cursor и другие клиенты читают конфигурацию mcpServers:

{
  "mcpServers": {
    "iwe": {
      "command": "/path/to/iwe",
      "args": ["--mcp"]
    }
  }
}

Инструменты

Сервер MCP предоставляет одиннадцать инструментов. Только write_file меняет существующие локальные текстовые файлы. Запрос tools/list возвращает схемы параметров.

list_projects
Показать пространства и проекты, отметив выбранный проект.
list_files
Показать файлы и папки на одном уровне проекта.
read_file
Прочитать текстовый файл. Ответ включает токен ревизии для редактирования.
write_file
Заменить содержимое существующего текстового файла по его токену ревизии.
search_files
Найти файлы нечётким поиском по имени и пути.
git_status
Показать текущую ветку и изменённые файлы.
git_log
Показать недавние коммиты с авторами, датами и ссылками.
list_deployments
Вывести подключения, зарегистрированные ключи SSH и профили. Результат не содержит секретов.
resolve_deployment_path
Передайте profile и один путь: local или remote. Инструмент сопоставляет пути без подключения.
deployment_read_remote
Передайте profile и абсолютный удалённый path. Инструмент читает файл UTF-8 размером до 512 КиБ.
deployment_compare
Передайте profile и path относительно проекта. Результат содержит localText, remoteText и identical. Лимит каждого файла составляет 512 КиБ.

Порядок редактирования

  1. Прочитайте файл. Ответ включает содержимое и токен ревизии.
  2. Отправьте изменённое содержимое обратно с тем же токеном.
  3. Сервер сверяет файл с токеном перед записью. Запись отклоняется, если файл изменился после вашего чтения.
  4. При отказе прочитайте файл снова и повторите.

Безопасность

  • Инструменты работают с проектами из вашего рабочего пространства. Локальные пути должны оставаться внутри проекта.
  • MCP использует сохранённые данные для подключения к серверу. Результаты инструментов не содержат учётных данных.
  • Данные рабочего пространства и файлы на сервере остаются без изменений. Для управления развёртыванием и передачи файлов используйте CLI.
  • Сервер отклоняет входящие строки JSON-RPC больше 1 МиБ. Для каждого текста при чтении с сервера действует лимит 512 КиБ.

Где взять бинарник

Используйте установленный бинарник приложения или соберите из исходников:

cargo build --release
# The binary lands in target/release/iwe

Документация разработчика

Документация для разработчиков подробно описывает протокол, инструменты и их ограничения.