Atomno labs

Установка 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.jsonMCP, который нужен везде (например, базовые юр-проверки)
Проектный<project>/.cursor/mcp.jsonMCP только для конкретного проекта (например, 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

Большинство Pro/commercial MCP требуют API-токен через переменную окружения:

{
  "mcpServers": {
    "atomno-fns-check": {
      "command": "uvx",
      "args": ["atomno-mcp-fns-check"],
      "env": {
        "MCP_FNS_CHECK_TOKEN": "atl_xxxxx_xxxxx"
      }
    }
  }
}

Важно: токен попадает в файл 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 параллельно. Для 10 MCP — это ~3-5 секунд первичной загрузки (uvx скачивает пакеты в кэш ~/.cache/uv/, дальше моментально).

Если стартап стал медленным — кэш uv мог разрастись. Очистка:

uv cache clean

Что дальше