Интеграции

MCP в Cursor: полное руководство

Детальное руководство по настройке managed MCP-хаба в Cursor — для новичков и опытных разработчиков.

Cursor — первый MCP-клиент, получивший нативную поддержку Streamable HTTP транспорта. Именно поэтому он — основной целевой редактор для ru-mcp.ru.

Почему managed MCP быстрее локального

Нет локальных процессов — не нужно ставить Python или Node. Cursor ходит по HTTP.
Нет ручных ключей — API-ключи к dadata, ФНС, Росреестру уже внутри. Вам не нужно заводить 5 аккаунтов.
Авто-обновления — мы релизим новые tools без вашего участия, Cursor подхватит их при tools/list.

Установка

Создайте или отредактируйте файл mcp.json:

{
  "mcpServers": {
    "ru-mcp": {
      "url": "https://hub.ru-mcp.ru/mcp/rmcp_ВАШ_ТОКЕН",
      "transport": "streamable-http"
    }
  }
}

Путь к файлу зависит от ОС — см. Быстрый старт. После сохранения полностью перезапустите Cursor.

Несколько MCP-серверов одновременно

У managed-хаба уже 10+ серверов под одним endpoint'ом — вам не нужно перечислять их отдельно. Но если нужно добавить свой локальный сервер, это делается так:

{
  "mcpServers": {
    "ru-mcp": {
      "url": "https://hub.ru-mcp.ru/mcp/rmcp_ВАШ_ТОКЕН",
      "transport": "streamable-http"
    },
    "my-local": {
      "command": "node",
      "args": ["/path/to/my-mcp-server/index.js"]
    }
  }
}

Глобальный конфиг vs проектный

Путь	Область	Когда использовать
`~/.cursor/mcp.json`	Глобально, все проекты	Для личных соло-проектов
`.cursor/mcp.json`	Только текущий проект	Для клиентских проектов с отдельными токенами

Per-project токены

Если вы делаете 3 проекта для разных клиентов, рекомендуем создать 3 токена (в личном кабинете → Токены → Создать) и положить каждый в соответствующий .cursor/mcp.json внутри проекта.

Преимущества:

Разделённый usage-лог — сможете выставить счёт клиенту за его долю вызовов
Можно отозвать токен клиента не трогая остальные
Разные квоты для разных проектов (на Pro — до 10 токенов)

Troubleshooting

Cursor не видит tools

Откройте Command Palette (Cmd/Ctrl + Shift + P) → MCP: List tools. Если список пуст — подключение не работает.
Проверьте формат токена: должен начинаться с rmcp_.
Проверьте доступность endpoint'а: curl -X POST https://hub.ru-mcp.ru/mcp/ТОКЕН -H "Content-Type: application/json" -d '{"method":"ping"}'

Ошибка «Quota exceeded»

Вы исчерпали лимит плана. Проверьте usage в /dashboard/usage, обновите тариф или дождитесь начала следующего биллинг-периода.

Tool вернул ошибку

Ошибки внешних API прокидываются как MCP-compliant JSON-RPC errors. Cursor покажет понятное сообщение. Если ошибка связана с нашей стороной — напишите в Telegram-поддержку.