Cursor, Claude и другие клиенты: как подключить MCP-сервер

«Подключите ИИ к CRM за один вечер» - красивая фраза на слайде. На практике админ всё равно копирует URL, вставляет ключ токена и проверяет, что агент видит хотя бы одну сделку. Не революция, а десять минут внимательной настройки - зато потом менеджер не копирует данные из Bitrix24 в чат руками.

Теория протокола - в Что такое MCP. Устройство токена и прав - в Bestrank MCP: доступ по токену. Привязка портала Bitrix24 - в Подключение Bestrank MCP к Bitrix24. Здесь - куда вписать адрес, где взять ключ и как понять, что сервер действительно подключился.

Что понадобится до настройки клиента

Соберите четыре вещи:

1. Аккаунт в админке Bestrank MCP - создать токен и привязать портал.
2. Ключ токена - длинная строка; храните как пароль, не в общем чате.
3. Адрес сервера: https://mcp.bestrank.ru/mcp/ - с https и завершающим слэшем.
4. AI-клиент с поддержкой MCP - Cursor, Claude Desktop или другой из актуального списка в Подключение MCP.

Без токена клиент «увидит» сервер, но не ваш Bitrix24. Без привязки портала - увидит пустой или ограниченный набор возможностей.

Шаг 1: токен в админке Bestrank

Зайдите в административный раздел на https://mcp.bestrank.ru (или на адрес вашего зеркала, если развёрнут отдельный инстанс).

1. Создайте новый токен - понятное имя: «Claude - отдел продаж», «Cursor - админ».
2. Привяжите подключение Bitrix24 (или другой провайдер) - см. подключение к Bitrix24.
3. Отметьте разрешённый список возможностей: инструменты, ресурсы, промпты. Для первого теста хватит чтения сделок и одного справочника.
4. Скопируйте ключ - он показывается при создании; потом посмотреть можно в карточке токена.

Отдельные ключи на человека или роль - проще отозвать доступ, не ломая всем работу.

Шаг 2: Cursor

Cursor - наш основной клиент для тех, кто уже живёт в IDE: разработчики, внедренцы, «тот самый» сотрудник, который тянет автоматизацию.

Где настраивать

Конфигурация MCP в Cursor - файл .cursor/mcp.json в проекте или глобальные настройки MCP в приложении (раздел MCP Servers). Актуальный вид экрана может чуть меняться между версиями - ориентир: «добавить remote MCP server по URL».

Что указать

• URL сервера: https://mcp.bestrank.ru/mcp/
• Аутентификация: ключ токена в заголовке, как описано в Подключение MCP - там же пример JSON для конфига.

После сохранения перезапустите Cursor или перезагрузите список MCP-серверов. В панели инструментов должны появиться возможности Bestrank - названия инструментов, которые вы включили на токене.

Проверка

Спросите агента в чате: «Какие инструменты Bestrank тебе доступны?» или «Найди сделку с ID …» (подставьте реальный тестовый ID). Если ответ «нет доступа» - проверьте ключ, галочки на токене и привязку Bitrix24.

Шаг 3: Claude Desktop

Claude Desktop удобен менеджерам: отдельное приложение, без IDE. Настройка MCP - через конфигурационный файл Claude (на Windows обычно в %APPDATA%\Claude\claude_desktop_config.json, на macOS - ~/Library/Application Support/Claude/claude_desktop_config.json).

Добавьте блок сервера Bestrank:

• URL: https://mcp.bestrank.ru/mcp/
• ключ токена - по инструкции из Подключение MCP

Сохраните файл, полностью перезапустите Claude Desktop. MCP подхватывается при старте.

Проверка

В новом диалоге иконка инструментов или список подключённых серверов должен показывать Bestrank. Задайте простой запрос на чтение CRM. Менеджеру не нужно знать JSON - достаточно один раз настроить админу.

Шаг 4: другие клиенты

Экосистема MCP растёт: появляются плагины для других редакторов и корпоративные оболочки. Общие правила те же:

• transport Streamable HTTP на https://mcp.bestrank.ru/mcp/ - основной вариант;
• ключ токена в заголовках запроса;
• клиент должен принимать ответы в форматах, которые ожидает сервер (детали - в гайде).

Устаревшие клиенты только с SSE - отдельные URL; на production Bestrank они включаются администратором сервера. Если ваш клиент «не видит» сервер - сверьтесь с разделом legacy в Подключение MCP.

Типичные проблемы и что делать

«Сервер недоступен»

• Проверьте URL: именно https, путь /mcp/, слэш в конце.
• Корпоративный прокси иногда режет нестандартные API - попросите IT белый список для mcp.bestrank.ru.

«401 / доступ запрещён»

• Неверный или просроченный ключ.
• Токен отключён в админке.
• Ключ скопирован с лишним пробелом.

«Инструментов нет»

• На токене не отмечены инструменты - зайдите в карточку и включите.
• Портал Bitrix24 не привязан или webhook устарел - см. статью про подключение Bitrix24.

«Агент отвечает, но данные не из CRM»

• Модель ответила «из головы», не вызвав инструмент. Уточните запрос: «используй инструмент CRM, найди…».
• На токене нет права на этот инструмент.

Claude не подхватил конфиг

• Не перезапустили приложение.
• Синтаксическая ошибка в JSON - проверьте запятые и кавычки; валидатор JSON спасает нервы.

Безопасность на уровне офиса

• Не коммитьте ключ в git - .cursor/mcp.json с секретами добавьте в .gitignore или используйте переменные окружения, если клиент поддерживает.
• Не шлите ключ в Telegram «на всякий случай» - заведите отдельный токен и отзовите после теста.
• Разные люди - разные ключи - видно, кто нагружает API; отзыв точечный.

Это те же привычки, что с паролями от CRM, только ключ относится к агенту.

Кейс: мы подключали отдел из пятнадцати человек

Не все пятнадцать полезли в настройки - и правильно.

1. Админ создал три токена: «только чтение - руководство», «задачи и комментарии - менеджеры», «полный тест - IT».
2. IT настроил Claude на двух ноутбуках менеджеров по инструкции на одну страницу.
3. Cursor оставили себе - правка промптов и проверка новых инструментов.
4. Неделю собирали «какие вопросы задают» - расширили ресурсы воронки и один промпт для утренней сводки.

Подключение заняло не «квартал цифровизации», а пару рабочих дней с перерывами на созвоны.

Кейс: один power-user без отдела IT

Компания поменьше, «технический» человек один. Он:

1. Прочитал Bestrank MCP: что это и как устроен доступ.
2. Создал токен, привязал Bitrix24 за вечер.
3. Подключил Cursor по гайду Подключение MCP.
4. Показал директору Claude с тем же ключом «только чтение» - директор увидел сводку по сделкам без обучения IDE.

Масштабирование - когда появится запрос от второго отдела, а не «сразу всем».

Что дальше после подключения

Клиент работает - это начало, не финал.

• Разберите инструменты, ресурсы и промпты под ваши процессы.
• Добавьте сценарии из промптов для типовых задач.
• Для CRM-команды - зачем MCP бизнесу.

Вопрос напоследок

Какой запрос к CRM вы бы дали агенту завтра утром - если бы он уже видел ваш Bitrix24? «Просроченные задачи команды», «сделки без активности», «история по клиенту перед созвоном» - один такой сценарий и есть повод настроить токен, а не откладывать «до цифровой трансформации».

Подключить Bestrank MCP к Cursor или Claude - задача на один вечер для человека, который умеет копировать URL и не публикует ключ в общий чат. Адрес: https://mcp.bestrank.ru/mcp/. Ключ - из админки. Дальше качество определяют не клиент, а настройка токена и привычки команды.

Актуальные конфиги и troubleshooting - в Подключение MCP. Клиент не из списка или портал за нестандартным firewall - напишите в поддержку Bestrank.