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

MCP-серверы для Cursor превращают агента из «читателя кода» в помощника, который ходит в ваши системы: базу данных, трекер задач, браузер. Подключаются они одним JSON-файлом, но у удобства есть цена: описания всех инструментов попадают в контекст. Ниже разберём, как подключить MCP-сервер к Cursor, какие бывают типы серверов, где хранить секреты и как не раздуть расход токенов. Опираемся на документацию Cursor по MCP; за деталями конкретного сервера обращайтесь к его README.

Что такое MCP и зачем он Cursor

Model Context Protocol — открытый протокол, по которому программа сообщает модели, какие у неё есть инструменты (функции), данные и шаблоны запросов. Cursor выступает клиентом: он запускает сервер или подключается к нему, показывает модели список инструментов, а когда модель решает вызвать один из них, исполняет вызов и возвращает результат. Общее объяснение есть в статье MCP-сервер: что это и как подключить в Claude Code↗.

Важно понимать распределение ролей. Сам сервер работает у вас (или на удалённом хосте), а модель, которую вы подключили через Zukko, видит только текстовое описание инструментов и результаты вызовов. Поэтому для MCP нужна модель, умеющая вызывать инструменты. Как именно ваша модель справляется с вызовами, проверьте на своей задаче.

Три типа серверов

По документации Cursor, поддерживаются три способа подключения:

Практическое правило: если сервер ставится как npm- или Python-пакет и работает с вашими локальными файлами, это stdio. Если это сервис в интернете (трекер, документация, облачная база), чаще удобен remote-вариант по URL.

Как подключить MCP-сервер к Cursor через mcp.json

Конфигурация лежит в одном из двух мест:

• .cursor/mcp.json в корне проекта — инструменты только для этого проекта;
• ~/.cursor/mcp.json в домашнем каталоге — инструменты для всех проектов.

По справке Cursor оба файла объединяются, а если сервер с одним и тем же именем есть в обоих, приоритет у проектного. Файл с ключами не коммитьте в git.

Локальный сервер (stdio)

{
  "mcpServers": {
    "my-server": {
      "command": "npx",
      "args": ["-y", "<пакет-сервера-из-его-README>"],
      "env": {
        "API_KEY": "${env:MY_SERVER_API_KEY}"
      }
    }
  }
}

Команду и аргументы берите из README конкретного сервера: мы не называем пакеты, чтобы не подсказать устаревшее имя. Для stdio-серверов доступно также поле envFile (путь к .env с переменными).

Удалённый сервер (HTTP или SSE)

{
  "mcpServers": {
    "my-remote": {
      "url": "https://example.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:MY_SERVICE_TOKEN}"
      }
    }
  }
}

Для серверов с OAuth Cursor поддерживает вход через браузер; если провайдеру нужны фиксированные данные клиента, в конфиге есть блок auth с CLIENT_ID и опциональными CLIENT_SECRET и scopes. За подробностями идите на страницу MCP в документации Cursor.

Секреты через переменные окружения

В значениях command, args, env, url и headers Cursor понимает подстановки: ${env:NAME}, ${userHome}, ${workspaceFolder}. Не пишите токены прямо в файл: задайте их в окружении и подставляйте через ${env:...}. Это особенно важно для .cursor/mcp.json, который лежит в репозитории.

Проверка и отладка

После сохранения файла сервер должен появиться в разделе Customize (в боковой панели Cursor), где его можно включить и выключить переключателем. Если сервер не поднялся, откройте панель Output (Cmd+Shift+U / Ctrl+Shift+U) и выберите в списке «MCP Logs»: там видны ошибки запуска, авторизации и вызовов.

Если вы пользуетесь консольным агентом Cursor, те же серверы доступны командам agent mcp list и agent mcp list-tools <имя>, а флаг --approve-mcps автоматически одобряет все MCP-серверы. По умолчанию Cursor спрашивает разрешение перед использованием инструмента MCP, и это стоит оставить включённым для всего, что пишет данные или удаляет их.

Как не перегрузить контекст

Каждый подключённый сервер добавляет в запрос описания своих инструментов: названия, пояснения, схемы аргументов. Они отправляются модели при каждом обращении и оплачиваются как входные токены. Масштаб зависит от сервера, поэтому не угадывайте, а измеряйте.

Пример расчёта (допущения). Пусть три сервера дают вместе 40 инструментов, и описания занимают около 8 000 токенов. При 200 запросах агента в неделю это 200 × 8 000 = 1 600 000 токенов входа. На claude-sonnet-5-5 (вход $0.4 за 1M, цены на 18 октября 2026) это 1.6 × $0.4 = $0.64 в неделю, а по официальной цене входа $2 за 1M — $3.20. На claude-opus-5-5 ($0.8 за 1M): 1.6 × $0.8 = $1.28. Для Claude в OpenAI-формате Cursor кэш не даёт скидки: весь вход идёт по цене входа. Цифры условные; ваши получите, сравнив расход одинаковой задачи с серверами и без них в разделе «Использование» кабинета. Размер описаний можно прикинуть заранее через POST /v1/messages/count_tokens.

Как держать это под контролем:

1. Подключайте только нужное. Лишний сервер платится токенами на каждом запросе, даже если ни разу не вызывался.
2. Раскладывайте по проектам. Серверы для базы данных держите в .cursor/mcp.json проекта, где база есть, а не в глобальном файле.
3. Выключайте на время. Переключатель в Customize отключает сервер, не удаляя настройку: такой сервер не загружается и не появляется в чате.
4. Ограничивайте права. Выдавайте серверу токены с минимально нужными правами и по возможности только на чтение.
5. Проверяйте источник. MCP-сервер исполняет код и ходит во внешние сервисы от вашего имени: ставьте только то, чьему автору доверяете, и просматривайте код для критичных интеграций.
6. Ставьте потолок расхода. Заведите отдельный ключ Zukko для Cursor и задайте дневной и месячный лимит, см. лимиты ключей↗.

Ключ Zukko подключается в Cursor отдельно от MCP и не влияет на конфигурацию серверов; как это сделать, описано в документации по Cursor↗.

Частые вопросы

Где лежит mcp.json в Cursor?

Для проекта — .cursor/mcp.json в его корне, для всех проектов — ~/.cursor/mcp.json. Серверы можно также ставить из Marketplace Cursor, без ручного редактирования файла.

Сервер подключён, но модель его не использует. Почему?

Cursor вызывает инструменты MCP, когда считает их подходящими, и просит подтверждения. Можно прямо назвать нужный инструмент в запросе. Если инструментов вызвать не получается совсем, проверьте, что сервер включён, и посмотрите «MCP Logs». Сам по себе вызов инструментов зависит от модели, поэтому сравните поведение на другой модели из списка.

Работает ли MCP при подключении моего ключа вместо подписки?

MCP исполняется на стороне Cursor и ваших серверов, а модель получает описание инструментов и результаты. Поэтому подмена провайдера на ключ Zukko его не отключает. Условия вашего плана Cursor по использованию своих ключей проверьте на cursor.com/pricing↗.

Чем MCP в Cursor отличается от MCP в Claude Code?

Принцип один, различаются файлы настройки и команды. Для Claude Code см. статью MCP-серверы в Claude Code↗.

Начните с одного сервера, измерьте разницу в расходе и только потом добавляйте следующий. Ключ для Cursor создаётся на странице API-ключей↗.