Подключение ИИ-агента

Инструкция для сотрудника. Предполагается, что администратор уже установил MCP-сервер и загрузил лицензию.

Агент работает от вашего имени и с вашими правами: он видит те доски, которые доступны вам, и создаёт объекты как вы. Гостям организации MCP недоступен.

Шаг 1. Откройте раздел MCP

Раздел доступен в двух местах, они равнозначны:

• личный кабинет → Интеграции и AI;
• панель на доске → Персональный токен.

Если раздела нет или он показывает сообщение

Значит дополнительная лицензия MCP не загружена в вашей установке либо у вас роль гостя. Обратитесь к администратору Эсборд.

Шаг 2. Выберите способ подключения

Быстрое подключение (без токена)

Подходит для агентов, умеющих входить через браузер: Claude в браузере и десктоп-приложении и другие клиенты с поддержкой OAuth.

1. Скопируйте адрес MCP-сервера из раздела, он вида https://sboard.mycompany.com/board-mcp/mcp.
2. Добавьте его в вашем клиенте как пользовательский коннектор (в Claude: Настройки → Коннекторы → Добавить пользовательский коннектор).
3. Клиент откроет браузер, вы подтвердите доступ на странице согласия, и подключение готово.

Токен при этом никуда вставлять не нужно.

Персональный токен

Подходит для агентов в терминале и редакторах кода.

1. Нажмите Сгенерировать токен и скопируйте его. Токен показывается один раз.
2. Пропишите его в настройках агента, примеры ниже.

Токен это доступ к вашим доскам

Он действует год и равносилен вашей учётной записи в части работы с досками. Не передавайте его третьим лицам и не храните в общих репозиториях. Если токен утёк, удалите его в том же разделе: после удаления подключённые по нему агенты перестанут работать.

Шаг 3. Настройте агента

Везде ниже <адрес MCP-сервера> это значение из раздела, <токен> это ваш персональный токен.

Claude Code: выполните команду в терминале и перезапустите Claude Code:

claude mcp add --transport http --scope user sboard <адрес MCP-сервера> --header "Authorization: Bearer <токен>"

Codex: откройте конфиг (~/.codex/config.toml, на Windows %USERPROFILE%\.codex\config.toml) и добавьте настройки. Строка experimental_use_rmcp_client должна стоять в самом начале файла, блок [mcp_servers.sboard] в конце:

# в самое начало файла
experimental_use_rmcp_client = true

# в конец файла
[mcp_servers.sboard]
url = "<адрес MCP-сервера>"

[mcp_servers.sboard.http_headers]
Authorization = "Bearer <токен>"

Cursor: добавьте сервер в ~/.cursor/mcp.json (на Windows %USERPROFILE%\.cursor\mcp.json):

{
  "mcpServers": {
    "sboard": {
      "url": "<адрес MCP-сервера>",
      "headers": { "Authorization": "Bearer <токен>" }
    }
  }
}

Шаг 4. Проверьте

Попросите агента показать список доступных инструментов, в нём появятся инструменты с префиксом sboard_. Дальше можно работать обычными просьбами: «найди доску по названию», «создай доску и разложи на ней план», «покажи, что сейчас на доске».

Если что-то не работает

Что видите	Что это значит
Агент сообщает, что MCP подключается отдельной лицензией	Лицензия MCP не загружена или истекла, обратитесь к администратору
Ошибка авторизации, 401	Токен неверный, удалён или истёк, выпустите новый
Агент сообщает, что исчерпан дневной лимит	В вашей установке задан предел вызовов в сутки, обратитесь к администратору
Инструменты не появились в списке	Проверьте адрес сервера и перезапустите клиент: большинство из них читают конфиг только при старте