Подключение MCP к Cursor: от выбора источника до первого результата
Как выбрать одну задачу, взять параметры из документации автора и проверить реальный вызов инструмента в Cursor.
Начните с одной операции, для которой нужен внешний источник: найти документ или получить сведения из рабочего сервиса. Карточка каталога помогает выбрать сервер, но не подтверждает его команду установки, доступ к вашим данным или успешный вызов.
Начните с задачи
Откройте документацию выбранного сервера и проверьте, что он предоставляет нужную операцию. Один законченный сценарий легче проверить: какие сведения вы передали, какой инструмент был вызван и что вернул источник. Список серверов — варианты для выбора, не рейтинг обязательных дополнений к редактору.
Выберите способ подключения
Для локального процесса Cursor использует конфигурацию с command и аргументами, для удалённого — адрес в url. Точный исполняемый файл, пакет или адрес берите у автора сервера. MCP сам по себе не означает, что требуется Node.js или npx.
Проектный файл .cursor/mcp.json относится к текущему проекту, пользовательский ~/.cursor/mcp.json — к вашим проектам в целом. Перед изменением сохраните существующие записи. Для токенов используйте способ, предусмотренный поставщиком; не помещайте личные ключи в общий репозиторий и в переписку об ошибке.
Проверьте подключение по фактам
- Добавьте конфигурацию из первичного источника и выполните указанные Cursor действия для её применения.
- Посмотрите список доступных инструментов выбранного сервера. Знакомое имя в настройках ещё не означает, что инструмент отвечает.
- Выберите один вызов с понятными параметрами и ожидаемым результатом. Для первого знакомства достаточно операции чтения на доступных вам данных.
- Сопоставьте фактический ответ с исходной задачей. Зафиксируйте версию клиента, источник настройки и дату собственной проверки. Если ответ неполон, не расширяйте вывод до «всё работает».
Режим подтверждения вызовов зависит от настроек и версии Cursor. Отсутствие диалога разрешения не означает, что запрос ничего не меняет: перед операцией проверьте её назначение и разрешения.
Если инструмент не появился
Проверьте выбранный файл конфигурации, точность имени сервера, доступность команды или URL и нужные параметры авторизации. Откройте Output → MCP Logs и найдите ошибку именно этого подключения. Не отправляйте необработанный журнал вместе с токенами.
Исправьте одну установленную причину и повторите проверку. При обращении к автору укажите клиент, транспорт, воспроизводимые шаги и сообщение об ошибке без секретов.
Граница этой инструкции
Официальные материалы Cursor прочитаны 15 октября 2026 года. Клиент и выбранный сервер в этой редакции не запускались; фактическая совместимость требует вашей отдельной проверки.