Установка MCP в Cursor — пошаговый гайд
Как добавить MCP-сервер в Cursor IDE: где лежит mcp.json, как написать конфиг, как проверить что сервер подцепился, типовые ошибки.
Обновлено:
Требования
- Cursor версии 0.48+ (поддержка MCP в стабильной ветке).
- uv установлен в системе. Без него
uvx-команды не запустятся.
Проверка uv:
uv --version
# uv 0.5.4 (или новее)
Если нет — установите:
# macOS / Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
# Windows (PowerShell)
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
# Альтернатива — через pipx
pipx install uv
Где лежит mcp.json
В Cursor поддерживается два уровня конфигурации:
| Уровень | Путь | Когда использовать |
|---|---|---|
| Глобальный | ~/.cursor/mcp.json | MCP, который нужен везде (например, базовые юр-проверки) |
| Проектный | <project>/.cursor/mcp.json | MCP только для конкретного проекта (например, 1С-интеграция для конкретного клиента) |
Проектные настройки дополняют глобальные. Если имена mcpServers совпадают — побеждает проектный.
На macOS / Linux:
# Глобальный
mkdir -p ~/.cursor
nano ~/.cursor/mcp.json
# Проектный
mkdir -p .cursor
nano .cursor/mcp.json
На Windows глобальный — %USERPROFILE%\.cursor\mcp.json.
Минимальный конфиг
Подключим mcp-cbr-rates (open-source, не требует токена):
{
"mcpServers": {
"atomno-cbr-rates": {
"command": "uvx",
"args": ["atomno-mcp-cbr-rates"]
}
}
}
Сохраните. Затем полностью перезапустите Cursor (Cmd+Q / закрыть из таскбара, не просто закрыть окно).
Проверка
После перезапуска откройте Settings → MCP (Ctrl+, → найдите “MCP”). Должен появиться сервер
atomno-cbr-rates с зелёной точкой статуса. Если серый кружок — сервер не запустился, см.
Troubleshooting.
В чате попросите агента:
«Какой курс доллара ЦБ на сегодня?»
Агент должен вызвать тул get_currency_rate(currency_code="USD") и ответить с актуальным курсом.
Конфиг с env-vars
Пример ФНС с MCP_FNS_API_KEY требует клиента с поддержкой размещённого режима.
Проверьте версию и условия подключения;
ключ и квота общие для ваших клиентов.
Клиент ФНС с поддержкой размещённого check_contractor принимает ключ через переменную окружения:
{
"mcpServers": {
"atomno-fns-check": {
"command": "uvx",
"args": ["atomno-mcp-fns-check"],
"env": {
"MCP_FNS_API_KEY": "YOUR_ATOMNO_API_KEY"
}
}
}
}
Важно: токен попадает в файл mcp.json. Если кладёте его в репозиторий — добавьте файл в
.gitignore. Лучше держите глобально в ~/.cursor/mcp.json, не в проекте.
Несколько MCP одновременно
Можно подключить десятки MCP — Cursor запустит каждый как отдельный процесс:
{
"mcpServers": {
"atomno-cbr-rates": {
"command": "uvx",
"args": ["atomno-mcp-cbr-rates"]
},
"atomno-fns-check": {
"command": "uvx",
"args": ["atomno-mcp-fns-check"]
},
"atomno-egrul": {
"command": "uvx",
"args": ["atomno-mcp-egrul"]
},
"atomno-cbr-rates-2": {
"command": "uvx",
"args": ["atomno-mcp-cbr-rates", "--log-level", "DEBUG"]
}
}
}
Имя ключа (atomno-cbr-rates) — произвольное, главное чтобы было уникальным. Cursor показывает
тулы агенту с префиксом этого имени.
Опции которые можно передать MCP
Все MCP семьи atomno-mcp-* поддерживают единый CLI:
uvx atomno-mcp-<name> --help
Полезные флаги:
--log-level DEBUG|INFO|WARNING|ERROR— детальность логов (можно следить черезCursor → Settings → MCP → Logs).--transport stdio|http|sse|streamable-http— транспорт. Для Cursor по умолчаниюstdio.--version— версия пакета.
В JSON это выглядит так:
"args": ["atomno-mcp-fns-check", "--log-level", "DEBUG"]
Производительность
При запуске Cursor стартует все MCP параллельно. Например, для десяти подключённых
серверов это ~3-5 секунд первичной загрузки (uvx скачивает пакеты в кэш ~/.cache/uv/,
дальше моментально).
Если стартап стал медленным — кэш uv мог разрастись. Очистка:
uv cache clean
Что дальше
- Claude Desktop → — для тех, кто работает в Claude Desktop.
- Troubleshooting → — что делать если MCP не подцепился.
- Каталог 14 MCP → — выбрать какие подключить.
Частые вопросы
Чем отличается глобальный mcp.json от проектного?
Глобальная настройка находится в ~/.cursor/mcp.json и предназначена для разных проектов. Файл .cursor/mcp.json внутри проекта задаёт подключение для этого проекта. Не сохраняйте действующие токены в конфигурации, которая попадает в репозиторий.
Как проверить подключение после настройки?
После полного перезапуска проверьте сервер в настройках MCP, затем выполните запрос, который вызывает его инструмент. В примере с курсами ЦБ это запрос курса валюты. Одного появления записи сервера недостаточно для проверки ответа источника.
Что нужно для подключения курсов валют ЦБ?
В примере используется uvx atomno-mcp-cbr-rates без ключа размещённого доступа. Cursor должен находить программу uvx; настройку другого сервера сверяйте с его переменными и ограничениями.
Можно ли использовать ключ из Cursor в другом своём клиенте?
Да, для действующего размещённого доступа ключ и квота подписки общие для REST и MCP. Формат конфигурации и имя переменной зависят от клиента и продукта; смена приложения не увеличивает лимит.
Нужно ли передавать ключ для запроса открытых курсов ЦБ?
Для показанного открытого клиента курсов используется запуск пакета через uvx. Не добавляйте ему ключ ФНС: параметры авторизации берутся из инструкции конкретного сервера.
Почему проектный конфиг с секретом нельзя отправить в репозиторий?
Он может открыть доступ по вашему ключу другим людям. Передавайте команде шаблон без значений секретов и настраивайте реальные значения отдельно.
Какой запрос выбрать для первой проверки подключения?
Один простой запрос к известному инструменту, например курс валют из инструкции. Проверьте выбранный инструмент и параметры; сразу большая задача с несколькими источниками затрудняет поиск ошибки.
