Перейти к содержимому
PD
MCP-серверы

MCP-сервер в Cursor: подключение и отличия

Где в Cursor настраиваются MCP-серверы, чем это отличается от терминального агента, что работает одинаково и на что стоит рассчитывать при переносе конфигурации.

Все статьи гида MCP-серверы · 11

Протокол один, а клиенты разные. Разберём, что в Cursor устроено иначе и что при этом остаётся общим.

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

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

Уровня два, как и у других клиентов:

  • Пользовательский - действует во всех ваших проектах.
  • Проектный - лежит в репозитории и работает у всех, кто его откроет.

Как и везде, секреты идут в переменные окружения, а не в файл. Проектный конфиг с токеном внутри уедет всем, кто клонирует репозиторий.

Чем отличается от терминального агента

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

Где видно результат. В редакторе вызовы инструментов отображаются в интерфейсе чата, и это удобнее для наблюдения. В терминале вы читаете текст.

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

Разрешения. Модель подтверждений в редакторе своя, и стоит один раз посмотреть, что именно выполняется без вопроса. Особенно это касается серверов с правами на запись - см. безопасность.

Что работает одинаково

Практически всё остальное:

  • Сам сервер. Один и тот же сервер подключается к любому совместимому клиенту, менять в нём ничего не нужно.
  • Правила выбора инструментов. Агент выбирает по описанию, и качество описаний важнее клиента.
  • Расход контекста. Описания инструментов занимают место в каждом запросе независимо от клиента.
  • Порядок отладки. Запустить руками, проверить stdout, проверить переменные, перезапустить клиента - см. настройку.

Перенос конфигурации между клиентами

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

Что стоит проверить при переносе:

  • Полный путь к исполняемому файлу. Разные клиенты запускают процессы в разном окружении, и PATH может отличаться.
  • Переменные окружения. То, что подхватывалось в одном клиенте, во втором может не подхватиться. Задавайте их явно в записи сервера.
  • Уровень конфигурации. Пользовательский против проектного: сервер, который «пропал», часто описан не там, где вы смотрите.

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

Что дальше

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

Вопросы и ответы

Где в Cursor настраиваются MCP-серверы?

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

Можно ли использовать один и тот же сервер в Cursor и в терминальном агенте?

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

Почему сервер работает в одном клиенте и не работает в другом?

Почти всегда окружение. Клиенты запускают процесс по-разному, и переменные окружения или PATH могут отличаться. Указание полного пути к исполняемому файлу и явное задание переменных в конфиге решают большинство таких случаев.

Ещё по теме