Как подключить MCP-сервер Эсборд к ChatGPT, Claude и Cursor

У разных MCP-серверов могут отличаться адрес, способ авторизации и список инструментов. Поэтому начать стоит не с копирования чужого конфига, а с инструкции выбранного сервиса. Ниже подключаем удалённый сервер Эсборд и отдельно объясняем, что проверять для любого другого сервера.

Что понадобится

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

Адрес Эсборд: https://sboard.online/board-mcp/mcp. Это адрес подключения, а не ссылка на отдельную доску. Для сервера другого поставщика возьмите URL и требования к авторизации из его документации, не меняйте только название в готовом примере.

Если ещё не знакомы с терминами, сначала прочитайте короткое объяснение MCP. Здесь дальше разбираем настройку, а не устройство протокола.

Быстрый старт: подключение через промпт

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

Подключи MCP-сервер Sboard.

Эндпоинт: https://sboard.online/board-mcp/mcp (транспорт http, авторизация — OAuth, без статического токена). Если сервер с таким URL уже настроен, не добавляй его повторно.

Запусти OAuth-авторизацию и дай мне ссылку для открытия в браузере. Не повторяй login и не вызывай инструменты, пока я не подтвержу завершение авторизации.

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

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

ChatGPT: подключение через OAuth

В приложении с агентом, умеющим управлять подключениями, сначала попробуйте промпт выше. Для ручного подключения в веб-версии:

1. Включите Developer mode в настройках. В текущей документации OpenAI это Settings → Security and login; в некоторых версиях переключатель находится в разделе «Плагины». Доступ зависит от аккаунта и политики рабочего пространства.
2. Откройте Плагины ChatGPT, нажмите «+», укажите название «Эсборд» и адрес https://sboard.online/board-mcp/mcp.
3. Выберите OAuth, оставьте Client ID и Client Secret пустыми. Если предложен способ регистрации клиента — выберите DCR. Создайте подключение после проверки предупреждения.
4. Войдите через Эсборд, выберите организацию, проверьте права и подтвердите доступ.
5. В новом чате выберите подключение Эсборд в меню инструментов и отправьте проверочный запрос без изменений.

Путь ручного подключения сверяйте с официальной инструкцией OpenAI. В справке Эсборд есть остальные экраны и пример результата. При отсутствии режима разработчика проверьте доступ с администратором; один промпт не отменяет ограничения аккаунта.

Claude Desktop: подключение через интерфейс

1. Откройте раздел настройки подключений: Customize → Connectors → Add. Названия пунктов могут отличаться в вашей версии клиента.
2. Добавьте пользовательский удалённый коннектор: имя «Эсборд» и URL сервера.
3. Запустите подключение и пройдите вход в Эсборд. Проверьте организацию и запрошенные разрешения перед подтверждением.
4. Вернитесь в Claude и убедитесь, что подключение активно.

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

Если Claude показывает настройки авторизации, выберите Sign in now и Register automatically. Не добавляйте персональный токен в Request headers для этого OAuth-сценария. После входа включите коннектор в нужном разговоре. Все экраны подключения и настройки разрешений — в справке.

Claude Code: настройка из терминала

В Эсборд откройте «Интеграции и AI» нужной организации и создайте персональный токен. Он показывается один раз. В блоке подключения выберите Claude Code и используйте подготовленную команду. Универсальный пример с заполнителем приведён ниже, после инструкции.

В документации Claude Code для удалённых HTTP-серверов используется команда claude mcp add --transport http. Заголовок авторизации передаётся отдельно. После добавления проверьте состояние сервера командой /mcp внутри клиента.

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

Cursor: настройка файла mcp.json

Для персонального подключения откройте ~/.cursor/mcp.json на macOS или Linux; на Windows — %USERPROFILE%\.cursor\mcp.json. Вставьте пример из блока ниже и замените заполнитель. Если другие серверы уже настроены, добавьте только запись sboard внутрь существующего mcpServers, не заменяйте весь файл.

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

Пошаговая инструкция Cursor поможет найти настройки в Эсборд. Для начала не нужно подключать все рабочие доски: проверьте доступ на одном учебном примере.

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

claude mcp add --transport http sboard https://sboard.online/board-mcp/mcp --header "Authorization: Bearer YOUR_TOKEN"

Первый запрос: только чтение

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

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

Что делать, если подключение не работает

• 401 или ошибка авторизации. Проверьте, не остался ли заполнитель, не отозван ли токен и не потерян ли пробел после Bearer. Не публикуйте токен в скриншоте ошибки.
• 403 или недостаточно прав. Проверьте организацию и разрешения пользователя. Переподключение не выдаёт новых прав автоматически.
• Сервер подключён, но нужной доски нет. Сверьте аккаунт, организацию и сам URL доски.
• Некорректный JSON. Проверьте запятые и скобки. Комментарии из чужой инструкции могут быть недопустимы в конкретном файле.
• Инструмент не найден. Убедитесь, что он предоставляется сервером и разрешён клиентом. Не все серверы предлагают одинаковые возможности.

Для диагностики сохраняйте текст ошибки без секретов, название клиента и шаг, на котором возникла проблема. Описание «ничего не работает» не позволяет отличить сетевую ошибку от отсутствия прав.

Как отключить доступ

Удаление сервера из клиента прекращает использование этого подключения в нём. Чтобы отозвать персональный токен Эсборд во всех клиентах, удалите его в «Интеграции и AI → Активные токены». Если секрет попал в общий чат или репозиторий, сначала отзовите его, затем создайте новый.