MCP в Cursor: mcp.json, OAuth и ключи

Q: Как подключить MCP к Cursor?

Добавьте сервер в ~/.cursor/mcp.json (для всех проектов) или .cursor/mcp.json (для одного). Удалённому серверу нужен url ; вход — через OAuth по кнопке в настройках или ключом в headers . Сохраните файл, и сервер появится в разделе MCP настроек Cursor.

Q: Где находится mcp.json в Cursor?

Глобальный — в домашней папке: ~/.cursor/mcp.json . Проектный — в корне репозитория: .cursor/mcp.json . Если файла нет, создайте его вручную.

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

Через подстановку переменной окружения: "Authorization": "Bearer ${env:ИМЯ_ПЕРЕМЕННОЙ}" в поле headers . Cursor подставит значение при запуске.

Коротко: Cursor читает MCP-серверы из ~/.cursor/mcp.json (для всех проектов) и .cursor/mcp.json (для одного). Удалённому серверу достаточно поля url, а войти Cursor предложит через OAuth. Если браузерный вход неудобен, ключ передаётся в headers через переменную окружения.

Два файла — две области

Файл	Где действует	Что туда класть
`~/.cursor/mcp.json`	Во всех проектах	Поиск и документацию — то, что нужно всегда
`.cursor/mcp.json`	Только в этом репозитории	Инструменты под проект; файл можно закоммитить для команды — но без ключей

По документации Cursor на 17.09.2026.

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

Способ 1. Ссылка и вход через OAuth

Самый короткий путь — записать только адреса. Отметьте инструменты ниже: готовый mcp.json соберётся сам.

Settings → MCP в Cursor

Добавьте конфиг в ~/.cursor/mcp.json

Сохраните и войдите по OAuth

Соберите свой сервер

Отметьте инструменты — ссылки и конфиг обновятся сами.

Генерация изображений (Nano Banana)ПопулярноВеб-поискПопулярно

Ссылки коннекторов

Генерация изображений (Nano Banana)

https://twelver.ru/api/mcp/v1/image-generation

Веб-поиск

https://twelver.ru/api/mcp/v1/web-search

{
  "mcpServers": {
    "twelver-image-generation": {
      "url": "https://twelver.ru/api/mcp/v1/image-generation"
    },
    "twelver-web-search": {
      "url": "https://twelver.ru/api/mcp/v1/web-search"
    }
  }
}

Тот же mcp.json подходит для LM Studio, Windsurf, Cline, VS Code и любого клиента, который читает mcp.json.

Сохраните файл — рядом с сервером в настройках появится кнопка входа. Нажмите её, войдите в аккаунт Twelver в браузере, и сервер станет активным. Для OAuth нужен зарегистрированный аккаунт.

Способ 2. Ключ в заголовке

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

Ключ для Cursor

Получите ключ sk-… прямо на странице

Серию модели выберите любую — модель в Cursor остаётся своя, MCP-серверу нужен только ключ. Он подставится в строку ниже.

Нажмите — и получите base_url и API-ключ.

Регистрация и карта не нужны.

Бесплатно. Ключ появится прямо здесь.

Шаблон — так работать не будет~/.zshrc или ~/.bashrcПодсвеченное — заглушки. Их выдаёт кнопка выше: пара секунд, без регистрации и карты.

export TWELVER_API_KEY="sk-<ваш-ключ>"

И сошлитесь на переменную из mcp.json — Cursor подставит её при запуске, и ключ не попадёт в репозиторий:

{
  "mcpServers": {
    "twelver-web-search": {
      "url": "https://twelver.ru/api/mcp/v1/web-search",
      "headers": {
        "Authorization": "Bearer ${env:TWELVER_API_KEY}"
      }
    },
    "twelver-image": {
      "url": "https://twelver.ru/api/mcp/v1/image-generation",
      "headers": {
        "Authorization": "Bearer ${env:TWELVER_API_KEY}"
      }
    }
  }
}

Cursor на macOS, запущенный из Dock, может не видеть переменные из ~/.zshrc. Если сервер отвечает 401, запустите Cursor из терминала командой cursor . — так он унаследует окружение оболочки.

Подтверждение вызовов

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

Что попросить агента

«Прочитай актуальную документацию по миграции на новую версию библиотеки и составь план правок» — web-search и web-crawl вместо ответа по устаревшей памяти модели.
«Сгенерируй три варианта hero-картинки для лендинга 16:9 и вставь первую в разметку» — text-to-image вернёт ссылки на файлы. Подробнее о генерации — в главе генерация изображений и видео через MCP.

Если не работает

Симптом	Причина	Что делать
Сервер с индикатором ошибки	Ошибка в JSON или неверный адрес	Проверьте файл на валидность и что url скопирован целиком
401 при ключе	Cursor не видит переменную окружения	Запустите Cursor из терминала или проверьте, что переменная задана
Кнопки входа нет	В конфиге указан ключ в headers — сервер его принял, вход не нужен	Это нормально; уберите headers, если хотите входить через браузер
Агент не пользуется инструментами	Сервер выключен или запрос не требует инструмента	Проверьте переключатель и попросите явно: «найди в интернете…»

Если подключаете то же самое в других клиентах — инструкции для Claude и LM Studio. Страница-конструктор серверов для Cursor — MCP-серверы Twelver для Cursor.

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

Как подключить MCP к Cursor?

Добавьте сервер в ~/.cursor/mcp.json (для всех проектов) или .cursor/mcp.json (для одного). Удалённому серверу нужен url; вход — через OAuth по кнопке в настройках или ключом в headers. Сохраните файл, и сервер появится в разделе MCP настроек Cursor.

Где находится mcp.json в Cursor?

Глобальный — в домашней папке: ~/.cursor/mcp.json. Проектный — в корне репозитория: .cursor/mcp.json. Если файла нет, создайте его вручную.

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

Через подстановку переменной окружения: "Authorization": "Bearer ${env:ИМЯ_ПЕРЕМЕННОЙ}" в поле headers. Cursor подставит значение при запуске.

Можно ли отключить подтверждение вызовов MCP в Cursor?

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

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

Для большинства задач хватает поиска с чтением страниц, доступа к GitHub и браузера для проверки интерфейса; дизайнерам полезен Figma. Подборка с пояснениями — в статье лучшие MCP-серверы.

Попробуйте сами

Соберите свой MCP-сервер за минуту

Отметьте нужные инструменты — ссылки коннекторов и mcp.json соберутся сами. Подключается к Claude, Cursor, LM Studio, Codex и OpenCode.

Собрать MCP-сервер

Лендинг по темеMCP-инструменты Twelver на AndroidТот же чат в приложении

Оцените свой опыт