MCP-серверы: «Интеграции»

MCP-сервер даёт агенту инструменты из других программ: среды разработки, трекера задач, внутреннего сервиса. MCP (Model Context Protocol) — протокол, по которому программы их отдают. Например, 1С:EDT через MCP показывает агенту метаданные и ошибки проекта. Серверы подключают в разделе «Интеграции». Список серверов общий для всех проектов.

#Как подключить сервер

1. Откройте «Настройки → Интеграции» (группа «Что умеет агент»). Можно и быстрее: наберите в поле ввода команду /mcp или /mcps.

2. Нажмите «Подключить инструмент». Если серверов ещё нет, кнопка называется «Другой…».

3. В форме «Новый инструмент» выберите «Тип» и заполните поля:

   Поле	Что ввести
   «Тип»	«По адресу» — сервер уже запущен и доступен по HTTP. «Команда» — DevMachine сам запустит сервер на компьютере
   «Имя»	Строчные латинские буквы, цифры, - и _, до 40 символов, без пробелов. Например, jira
   «Адрес»	Для типа «По адресу», например http://localhost:8765/mcp
   «Команда»	Для типа «Команда», например npx -y server. Путь с пробелами берите в кавычки
   «Токен»	Для типа «По адресу», если сервер его требует. Поле необязательное

4. Нажмите «Сохранить». Сервер подключится сразу.

Подключённые серверы видны в карточке «Контекст агента» (кольцо-индикатор в строке ввода), в строке «MCP». Если у сервера есть готовые запросы, они появятся в списке «/», в группе «Интеграции».

#Как выбрать инструменты

У сервера бывает много инструментов, а описание каждого уходит модели в каждом запросе. Чем меньше инструментов, тем быстрее и дешевле ответы, поэтому оставьте агенту только нужные.

1. В форме сервера в строке «Инструменты» нажмите «Выбрать…». DevMachine запросит у сервера список и, пока ждёт ответа, покажет «Спрашиваем сервер…».
2. Отметьте нужные инструменты. Кнопка «Все» отмечает все инструменты, «Ничего» снимает все отметки. У шаблона 1С:EDT есть ещё кнопка «Рекомендованные».
3. Сохраните форму. Над списком серверов в «Интеграциях» появится заметка «Выбор инструментов применится после перезапуска агента.» Нажмите в ней кнопку «Перезапустить агента».

Запросить список инструментов можно только у сервера «По адресу». От сервера типа «Команда» агент получает сразу все инструменты. Выбрать часть из них можно только в файле ~/.koder/mcp.json, в поле tools. Как править файл — в разделе Файл со списком серверов.

#Подтверждение перед вызовом

У каждого отмеченного инструмента есть флажок «спрашивать». Если флажок стоит, агент перед каждым вызовом этого инструмента показывает карточку «Разрешить инструмент интеграции?» и ждёт, пока вы ответите. Ставьте флажок у инструментов, которые что-то меняют: создают объекты, удаляют, отправляют. Новое положение флажка агент тоже учтёт после перезапуска.

#Подключить 1С:EDT

Для 1С:EDT есть готовый шаблон.

1. Установите в EDT MCP-плагин и запустите EDT с проектом.
2. В «Интеграциях» нажмите «Подключить 1С:EDT».
3. Форма заполнится сама: имя edt, адрес http://localhost:8765/mcp, рекомендованный набор инструментов. У инструмента modify_metadata (он меняет метаданные) флажок «спрашивать» уже стоит.
4. Нажмите «Сохранить».

Как агент работает с EDT и как настроить сам EDT — на странице Разработка на 1С.

#Как управлять серверами

В строке каждого сервера видны его состояние и переключатель «Включён».

В меню «Ещё» в строке сервера пункт «Изменить» открывает форму, а «Удалить» убирает сервер. Перед удалением DevMachine переспросит: «Удалить «…»? Агент потеряет его инструменты.»

#Файл со списком серверов

Список серверов хранится в файле ~/.koder/mcp.json. Обычно трогать его не нужно: хватает «Интеграций». Вручную файл правят, например, чтобы выбрать инструменты сервера типа «Команда» или передать ему переменные окружения.

{
  "mcp": {
    "edt": {
      "type": "remote",
      "url": "http://localhost:8765/mcp",
      "enabled": true,
      "timeout": 120000,
      "tools": ["list_projects", "read_module_source", "modify_metadata"],
      "ask": ["modify_metadata"]
    },
    "files": {
      "type": "local",
      "command": ["npx", "-y", "server"],
      "environment": { "API_URL": "http://localhost:3000" },
      "enabled": true
    }
  }
}

• type: remote — сервер по адресу, local — запуск командой.
• headers — заголовки запроса к серверу по адресу; токен из формы попадает сюда как Authorization: Bearer ….
• environment — переменные окружения для сервера типа «Команда» (local): имя каждой переменной и её значение. Значение — строка в кавычках.
• timeout — сколько ждать ответа, в миллисекундах.
• tools — какие инструменты дать агенту; если поля нет, агент получит все. ask — перед вызовом каких из них спрашивать.

Агент читает файл при запуске, поэтому после ручной правки перезапустите приложение DevMachine целиком. Кнопки «Перезапустить агента» здесь не будет: она появляется, только если выбор инструментов или флажки «спрашивать» поменяли в форме. Если в файле ошибка JSON, приложение его не перезапишет, а неверную запись агент пропустит.

#Ограничения

• Вход через браузер (OAuth) не поддерживается. Подключить можно сервер без входа или с токеном в заголовке.
• MCP-серверы из репозитория не запускаются. Агент получает только серверы из ~/.koder/mcp.json и встроенные модули. Так чужой репозиторий не подключит агенту свои инструменты.
• Проект на сервере (SSH). «Интеграции» правят ~/.koder/mcp.json на сервере, где работает агент. localhost в адресе — это сам сервер. Список инструментов DevMachine запрашивает через SSH-соединение.
• Токен хранится в ~/.koder/mcp.json открытым текстом. Читать файл может только ваша учётная запись. Сохранённый токен форма не показывает и пишет: «сохранён — оставьте пустым, чтобы не менять».
• Что уходит наружу. Описания выбранных инструментов уходят модели в каждом запросе. Сами вызовы идут с компьютера, где работает агент, прямо на адрес сервера. Ответ сервера агент читает и передаёт модели, как любой результат инструмента.

#Что дальше

• Разработка на 1С — EDT, BSL и выгрузки конфигуратора.
• Разрешения и вопросы агента — как отвечать на карточки.
• Модули — встроенные наборы инструментов агента.
• Плагины — свой экран и свои инструменты для агента.