Перейти к содержанию

MCP-серверы

MCP (Model Context Protocol) — протокол, который позволяет агенту подключаться к внешним инструментам и источникам данных. В Koda Desktop MCP-серверы настраиваются во вкладке MCP в настройках приложения.

MCP-сервер

Когда нужен MCP

Обычному пользователю не нужно настраивать MCP для первых задач. MCP полезен, когда агенту нужен доступ к:

  • браузеру (например, chrome-devtools-mcp)
  • внутренним сервисам и API
  • документации и базам знаний
  • файловым наборам за пределами проекта
  • специализированным инструментам

Включайте только те серверы, которым доверяете.

Подробнее об MCP читайте в этом разделе документации: MCP-серверы (Model Context Protocol)

Транспорт

Koda Desktop поддерживает три типа транспорта MCP:

Запускает MCP-сервер как дочерний процесс. Команда и аргументы указываются в настройках.

Поля:

  • Команда — исполняемый файл или команда (например, npx)
  • Аргументы — параметры команды (например, -y chrome-devtools-mcp@latest)
  • Env — переменные окружения в формате KEY=value (по одной на строку)

Подключается к MCP-серверу по HTTP.

Поля:

  • URL — адрес сервера (например, https://example.com/mcp)
  • Headers — HTTP-заголовки в формате Name: value (по одному на строку)

Подключается к MCP-серверу через Server-Sent Events.

Поля:

  • URL — адрес сервера
  • Headers — HTTP-заголовки в формате Name: value (по одному на строку)

Добавление сервера

  1. Откройте Настройки → вкладка MCP
  2. В форме внизу заполните:
    • Имя — короткое имя сервера (например, chrome-devtools)
    • Транспорт — выберите тип транспорта
    • Заполните поля для выбранного транспорта
  3. Нажмите Добавить сервер

Редактирование и удаление

  • Нажмите иконку карандаша рядом с сервером, чтобы отредактировать его
  • Нажмите иконку корзины, чтобы удалить сервер

Статусы подключения

В списке MCP-серверов отображается текущий статус каждого:

  • Подключен — сервер работает и готов
  • Подключается — сервер запускается или переподключается
  • Отключен — сервер не подключился (проверьте команду, URL или логи)
  • Выключен — сервер выключен в настройках
  • Не проверен — сервер ещё не проверен для текущей сессии

MCP и режимы агента

В режиме агента можно ограничить доступные MCP-серверы. Это полезно, когда разные режимы требуют разных наборов инструментов.

Режима агента подробно разобраны на странице о пользовательские режимы

MCP и read-only

В режиме Только чтение MCP-серверы и изменяющие инструменты отключаются независимо от настроек режима. Это гарантирует, что read-only сессия не сможет изменить файлы через MCP.