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

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

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

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

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

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

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

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

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

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 описывает также проектные конфиги и подстановку переменных окружения. Не храните персональный секрет в общем проектном конфиге.

{
  "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 → Активные токены». Если секрет попал в общий чат или репозиторий, сначала отзовите его, затем создайте новый.