1. Найдите способ запуска

    В инструкции выбранного сервера найдите локальную команду для stdio либо адрес конечной точки Streamable HTTP. Адрес страницы с описанием сервера вместо MCP endpoint не подойдёт.

  2. Выберите область настройки

    Для одного проекта откройте <проект>/.cursor/mcp.json, для всех проектов — ~/.cursor/mcp.json. Альтернативный путь — Customize → MCPs → добавление сервера. Если файл уже есть, добавьте запись в существующий объект mcpServers.

  3. Запишите параметры сервера

    Для stdio нужны command и, если требуются, args и env; команда должна запускаться на вашем компьютере. Для HTTP укажите url, а требуемые сервером заголовки — в headers. Имя сервера в mcpServers задайте уникальным. Подставляйте только команду или URL из документации конкретного сервера.

  4. Настройте вход и проверьте подключение

    При OAuth выполните предложенный Cursor вход. Для ключа используйте переменную окружения через ${env:NAME}, а не значение в общем файле проекта. После сохранения откройте Customize → MCPs, проверьте сервер и список инструментов; если конфигурация не обновилась, перезапустите Cursor.

  5. Проверьте один инструмент

    Откройте Agent, разрешите доступ к нужному инструменту и задайте узкий вопрос на чтение. Убедитесь, что ответ получен через выбранный сервер и соответствует источнику.

Что проверить

  • Поддержка stdio или HTTP у Cursor не означает, что выбранный сервер предлагает оба транспорта.
  • Проектный mcp.json может попасть в репозиторий: не храните в нём ключи и токены.
  • Локальная команда выполняет код на вашем компьютере; сверяйте издателя и права перед запуском.