Установка MCP-сервера в Cursor: пошаговый гайд для 2026

Полный туториал по подключению MCP в Cursor IDE: от установки uv до проверки работоспособности. Скриншоты, типовые ошибки, лучшие практики.

18 апреля 2026 · Atomno Labs ·

cursor
tutorial
mcp
setup

Cursor — самый популярный AI-IDE среди российских разработчиков. С 2025 поддерживает MCP, к 2026 это один из самых полированных experience’ов в индустрии. В этой статье — пошаговый гайд по установке любого MCP-сервера в Cursor, на примере atomno-mcp-fns-check (проверка контрагентов через ФНС).

Шаг 0: Установите uv

uv — менеджер Python-пакетов от Astral, замена pipenv / pip. Нужен для команды uvx, которая запускает MCP в изолированном окружении.

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

Проверка:

uv --version
# uv 0.5.4
uvx --version
# uvx 0.5.4

Если uvx --version не находит — uv не в PATH. Перезапустите терминал или добавьте ~/.local/bin в PATH (в ~/.zshrc или ~/.bashrc):

export PATH="$HOME/.local/bin:$PATH"

Шаг 1: Откройте Cursor mcp.json

В Cursor MCP-конфигурация лежит в файле mcp.json. Два уровня:

Уровень	Путь	Что делает
Глобальный	`~/.cursor/mcp.json`	Активен во всех проектах
Проектный	`.cursor/mcp.json` в корне проекта	Только в этом проекте, можно коммитить в git

Для первого MCP советуем глобальный:

mkdir -p ~/.cursor
nano ~/.cursor/mcp.json

(На Windows: %USERPROFILE%\.cursor\mcp.json.)

Шаг 2: Вставьте конфиг MCP

Минимальный сниппет для atomno-mcp-fns-check:

{
  "mcpServers": {
    "atomno-fns-check": {
      "command": "uvx",
      "args": ["atomno-mcp-fns-check"],
      "env": {
        "MCP_FNS_CHECK_TOKEN": "atl_xxxxx_замените_xxxxx"
      }
    }
  }
}

Важно:

Имя ключа (atomno-fns-check) — произвольное, главное чтобы было уникальным.
command: "uvx" — что Cursor запустит. Если у вас нет uv в PATH — укажите полный путь (/Users/<you>/.local/bin/uvx).
args — аргументы. Первый — имя пакета на PyPI.
env — переменные окружения, передаются в запущенный процесс MCP.

Шаг 3: Получите токен (если нужен)

Для open-source MCP без токенов (например, atomno-mcp-cbr-rates) — пропустите этот шаг.

Для Pro / commercial:

Идите на /pricing.
Запросите Pro-доступ через форму.
Sales-команда выдаст API-токен в течение рабочего дня.
Подставьте токен в env.MCP_FNS_CHECK_TOKEN.

Для open-source без токенов на public API — будут rate-limit’ы провайдера (10/мин у ФНС). Для production-нагрузки рекомендуем Pro.

Шаг 4: Перезапустите Cursor

Внимание: Reload Window (Ctrl+Shift+P → Developer: Reload Window) недостаточно. Нужно полностью завершить процесс:

macOS: Cmd+Q или Quit Cursor из меню.
Windows: правый клик по иконке в трее → Quit (если в трее) или закрыть все окна.
Linux: то же.

После запуска Cursor подцепит конфиг и стартует MCP.

Шаг 5: Проверка

Откройте Settings → MCP (Ctrl+, → найдите “MCP”). Должна появиться запись atomno-fns-check с зелёной точкой.

Если серый кружок — сервер не запустился. Кликните по записи, увидите логи. Типовые ошибки:

spawn uvx ENOENT — uvx не в PATH процесса Cursor. Решение: указать полный путь в command или прописать PATH в системных переменных.
401 Unauthorized — токен неправильный / истёк.
Connection timeout — провайдер не отвечает (редкое, временное).

Шаг 6: Используйте в чате

Откройте Cursor Composer (Cmd+L). Спросите:

«Проверь контрагента по ИНН 7707083893. Расскажи статус и риски.»

Cursor должен:

Подсветить, что вызывает MCP-tool check_inn с аргументом inn=7707083893.
Получить структурированный ответ.
Объяснить вам понятным языком.

Готово.

Best practices

1. Не коммитьте токены в git

Если используете проектный .cursor/mcp.json — добавьте его в .gitignore. Или используйте переменные окружения:

"env": {
  "MCP_FNS_CHECK_TOKEN": "${env:MCP_FNS_CHECK_TOKEN}"
}

И храните настоящий токен в ~/.zshrc / ~/.bashrc.

2. Включите DEBUG-логи если что-то не работает

"args": ["atomno-mcp-fns-check", "--log-level", "DEBUG"]

В Cursor Settings → MCP → Logs увидите подробный трейс HTTP-вызовов.

3. Подключайте несколько MCP сразу

Cursor стартует все параллельно. 5 MCP — это +2-3 секунды к старту IDE. Десяток — +5 секунд. В фоне работают независимо.

{
  "mcpServers": {
    "atomno-cbr-rates": { "command": "uvx", "args": ["atomno-mcp-cbr-rates"] },
    "atomno-fns-check": { "command": "uvx", "args": ["atomno-mcp-fns-check"], "env": {...} },
    "atomno-egrul": { "command": "uvx", "args": ["atomno-mcp-egrul"] },
    "atomno-zakupki": { "command": "uvx", "args": ["atomno-mcp-zakupki"], "env": {...} }
  }
}

4. Очищайте кэш uv раз в квартал

uvx кеширует все скачанные пакеты в ~/.cache/uv/. Со временем там накапливается несколько GB.

uv cache clean

При следующем запуске Cursor пакеты скачаются заново — это ~5 секунд лишних, не критично.

Что дальше

Каталог 10 MCP — выбрать какие подключить кроме fns-check.
Claude Desktop setup — для тех, кто работает в Claude.
Безопасность MCP — особенно важно перед production-использованием.
Troubleshooting — расширенный список типовых проблем.

Понравилась статья?

← Все статьи Каталог MCP →