MCP-серверы¶

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

В Koda Desktop MCP-серверы настраиваются во вкладке MCP окна настроек: там серверы добавляются, редактируются и удаляются.

Когда нужен MCP¶

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

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

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

Использование серверов¶

Koda Desktop поддерживает три транспорта подключения: stdio, HTTP и SSE. Какой транспорт выбрать и какие поля заполнить — описано в разделе Добавление и редактирование страницы настроек MCP.

После добавления сервер подключается автоматически, и его инструменты становятся доступны агенту:

• агент видит инструменты всех подключённых серверов и сам решает, когда их вызвать;
• можно попросить явно — например, «открой страницу в браузере через chrome-devtools и проверь ошибки в консоли»;
• инструменты MCP-серверов агент вызывает так же, как встроенные;
• чтобы временно убрать сервер из работы агента, выключите его во вкладке MCP настроек — конфигурация сохранится, а инструменты перестанут передаваться.

Текущее состояние каждого сервера видно по статусу в списке вкладки MCP.

MCP в конкретном чате¶

Над полем ввода есть чип MCP с цветным индикатором состояния. Он показывает, сколько серверов подключено для текущего чата, и открывает список серверов с переключателями.

В этом списке можно:

• включить или выключить MCP-сервер только для текущего чата;
• включить или выключить отдельные функции сервера в этом чате.

Изменения действуют только в открытом чате и не меняют общие настройки. Доступный набор задаёт режим агента: сервер, выключенный в режиме, в чате не появится — см. MCP и режимы агента. Переключать MCP можно после ответа агента: во время работы запроса чип неактивен.

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

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

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

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

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