Подключение MCP

MCP (Model Context Protocol) это протокол, по которому ИИ-агенты подключаются к внешним системам. Эсборд предоставляет MCP-сервер к доскам: агент (Claude Code, Codex, Cursor и другие) читает содержимое доски и создаёт на ней объекты от имени сотрудника, с его правами доступа.

Важно

Доступно с версии Эсборд >= 2026.3.1

Отдельная лицензия

MCP подключается дополнительной лицензией, она не входит в основную. Запросите файл лицензии у вашего менеджера. Пока лицензия не загружена, раздел MCP в личном кабинете показывает сообщение о том, что опция не подключена, а вызовы агентов отклоняются.

Что потребуется

1. Коробочная версия Эсборд нужной версии (см. выше), развёрнутая одним из трёх способов: Docker-compose standalone, Docker-compose HA или Kubernetes.

2. Отдельная виртуальная машина (или отдельный под в кластере) для MCP-сервера: он не входит в основной образ Эсборд. Причина в нагрузке: MCP-сервер рисует скриншоты досок и диаграммы, это заметный расход CPU и памяти, и держать его рядом с основными сервисами нежелательно.

3. Файл дополнительной лицензии MCP.

4. Сетевая связность: MCP-сервер должен видеть Эсборд по внутреннему адресу, и наоборот.

Системные требования MCP-машины

Характеристика	Минимальные требования	Рекомендуемые требования
Количество CPU	2	4
Оперативная память (RAM)	4 ГБ	8 ГБ
Дисковое пространство (HDD/SSD)	20 ГБ	20 ГБ

Как это устроено

Схема состоит из двух независимых направлений трафика. Их удобно держать в голове при настройке сети.

Вход: агент сотрудника в Эсборд. Агент обращается по обычному адресу вашей установки, https://sboard.mycompany.com/board-mcp/mcp. Запрос принимает тот же nginx, что отдаёт интерфейс Эсборд, и передаёт его MCP-серверу. Отдельный домен и отдельный сертификат не нужны.

Обратный канал: MCP-сервер в Эсборд. Чтобы работать с досками, MCP-серверу нужны внутренние сервисы Эсборд. Для этого на стороне Эсборд открывается служебный порт (по умолчанию 9443), доступный только MCP-серверу.

         сотрудник и его ИИ-агент
                   │  https://sboard.mycompany.com/board-mcp/mcp
                   ▼
   ┌──────────────────────────────┐        ┌──────────────────────────┐
   │ Эсборд                       │        │ MCP-сервер               │
   │   nginx :443 ────────────────┼───────▶│   board-mcp :3100        │
   │   служебный порт :9443 ◀─────┼────────┤                          │
   └──────────────────────────────┘        └──────────────────────────┘

Кроме служебного порта MCP-серверу нужны те же вспомогательные системы, что и Эсборд: хранилище изображений, очередь (Redis) и, по желанию, база данных. Где их взять, зависит от способа установки, поэтому инструкции разделены.

Доступ к служебному порту

На этом канале нет авторизации: он рассчитан на закрытый контур. Ограничьте доступ к нему адресом MCP-сервера средствами вашего межсетевого экрана.

Установка

Выберите инструкцию по способу установки вашей коробочной версии:

• Docker-compose standalone
• Docker-compose HA
• Kubernetes

Загрузка лицензии

Шаг общий для всех способов установки. Выполняется после того, как MCP-сервер запущен.

1. Войдите в панель администратора: https://sboard.mycompany.com/adminDashboard.
2. Откройте раздел Лицензия.
3. Загрузите файл дополнительной лицензии MCP в поле лицензии MCP и сохраните.

После сохранения на странице появится срок действия лицензии, а в разделе Статистика MCP начнут отображаться вызовы агентов.

Лицензия привязана к домену

Файл лицензии выпускается под домен вашей установки. Лицензия, выпущенная для другого домена, будет отклонена с ошибкой Invalid domain.

Проверка

Шаг общий для всех способов установки. Выполните с любой машины, где открыт домен Эсборд:

# должен вернуть 405: так и задумано, MCP работает только методом POST
curl -s -o /dev/null -w '%{http_code}\n' https://sboard.mycompany.com/board-mcp/mcp

# без токена должен вернуть 401
curl -s -o /dev/null -w '%{http_code}\n' -X POST https://sboard.mycompany.com/board-mcp/mcp \
  -H 'content-type: application/json' -d '{}'

Ответ	Что это значит
405 на GET и 401 на POST	Всё настроено верно, можно подключать агентов
503 на POST	MCP-сервер не достучался до Эсборд: проверьте служебный порт и адреса GRPC_*
502 на любой запрос	Эсборд не видит MCP-сервер: проверьте BOARD_MCP_HOST и публикацию порта 3100
404	Установка старее 2026.3.1 либо не применились настройки Эсборд: пересоздайте контейнер

Что дальше

• Подключение ИИ-агента: что делает сотрудник, чтобы подключить своего агента.
• События журнала: коды событий MCP для анализа данных в базе.