MCP-сервер: что это и как подключить агента к доске

MCP-сервер — программа, которая предоставляет ИИ-приложению инструменты и контекст по протоколу Model Context Protocol. Представьте стандартный разъём: на одной стороне ваш ассистент, на другой — рабочий сервис. Через разъём можно прочитать данные или выполнить разрешённое действие. Сам сервер не становится нейросетью и не принимает решения вместо человека.

Что меняется после подключения доски

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

В архитектуре MCP различаются приложение-хост, клиент подключения и сервер. Пользователю не нужно реализовывать их самостоятельно: важно выбрать доверенное приложение, правильный адрес и подходящий способ авторизации. Эсборд остаётся местом работы команды, внешний ассистент — отдельным сервисом со своими условиями.

Перед первым запуском

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

Адрес облачного сервера: https://sboard.online/board-mcp/mcp. Не заменяйте его адресом самой доски. Ссылка на доску указывает объект, с которым нужно работать; адрес сервера указывает подключение. Транспорт и способ авторизации выбирают по инструкции конкретного клиента.

Подключение через OAuth

1. Откройте настройки подключений вашего ИИ-клиента и добавьте удалённый MCP-сервер с адресом выше.
2. Выберите OAuth, если клиент поддерживает этот способ. Не вставляйте персональный токен вместо OAuth.
3. Откройте предложенную страницу авторизации, проверьте домен и войдите в Эсборд.
4. Выберите нужную организацию и прочитайте запрашиваемые разрешения.
5. Вернитесь в клиент и дождитесь списка инструментов. Не запускайте одновременно несколько повторных авторизаций.

Названия пунктов зависят от приложения и версии. Актуальные экраны и варианты подключения собраны в быстром старте. Возможность добавлять серверы также зависит от аккаунта, тарифа и правил администратора ИИ-клиента.

Когда нужен персональный токен

Для клиента с авторизацией через заголовок откройте настройки организации Эсборд, раздел «Интеграции и AI», создайте персональный токен и используйте готовую конфигурацию для своего клиента. Сохраните токен сразу: секрет показывается один раз. Не отправляйте его в чат, статью, скриншот или Git.

В конфигурации ниже секрет заменён заглушкой. Это пример формата Cursor, а не универсальный файл для всех приложений. Разместите реальный секрет только в локальных настройках, исключённых из репозитория; сверяйтесь с инструкцией Cursor.

{
  "mcpServers": {
    "sboard": {
      "url": "https://sboard.online/board-mcp/mcp",
      "headers": { "Authorization": "Bearer YOUR_PERSONAL_TOKEN" }
    }
  }
}

Проверка: сервер подключён или только добавлен в список?

Отправьте запрос: «Прочитай название и список объектов этой тестовой доски. Ничего не создавай, не меняй и не удаляй. Если доступа нет, покажи ошибку». Сравните ответ с открытой доской. Список инструментов подтверждает подключение к серверу; успешное чтение конкретной доски подтверждает доступ к нужному объекту.

При подготовке материала 5 октября 2026 года чтение и создание диаграмм проверены реальными MCP-вызовами в Codex. Дополнительно новый HTTP-клиент с действующим персональным токеном успешно выполнил initialize, получил 34 инструмента через tools/list и прочитал тестовую доску. Это проверка подключения на уровне протокола, а не интерфейса установки. Это не означает, что каждый вариант интерфейса ChatGPT, Claude и Cursor прошёл чистую установку: для них используйте актуальную справку и повторите проверочный запрос в своём аккаунте.

Если сервер не появился или вернул ошибку

• Не виден список инструментов. Проверьте URL, поддерживаемый транспорт и настройки клиента; ошибка соединения ещё ничего не говорит о правах на доску.
• Ошибка авторизации. Проверьте, завершён ли OAuth или верен ли заголовок токена. Не публикуйте секрет вместе с логом.
• Доска не найдена или недоступна. Откройте её тем же аккаунтом, проверьте организацию и ссылку. MCP не расширяет ваши права.
• Чтение работает, изменение нет. Возможны права только на просмотр, недоступная операция или лимит. Сохраните точный текст ошибки вместо бесконечных повторов.

Что проверить перед подключением

Уточните, какие данные уйдут внешнему ассистенту, кто управляет токеном и как отозвать доступ. На облачном Бесплатном тарифе владельцу организации доступны 100 вызовов MCP-инструментов в сутки; одно сообщение может вызвать несколько инструментов. Условия ИИ-сервиса оплачиваются отдельно, актуальные лимиты указаны в тарифах Эсборд. Гостевой доступ к доске не равен доступу к MCP.

Две полезные задачи после проверки

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