Как подключить MCP-сервер к Cursor: инструкция для новичков

Разберём, как подключить MCP сервер к Cursor двумя способами — через панель настроек в один клик и вручную через файл конфигурации. Оба варианта официально поддерживаются редактором и подходят как для локальных, так и для удалённых серверов.

MCP (Model Context Protocol) — это протокол, который позволяет Cursor обращаться к внешним инструментам и источникам данных: базам данных, API, файловым системам и другим сервисам. Подключив MCP-сервер, вы расширяете возможности AI-агента внутри редактора.

Способ 1. Установка в один клик через Customize

Самый быстрый путь — использовать встроенную панель.

  1. Откройте Customize в Cursor.
  2. Перейдите в раздел MCPs.
  3. Найдите нужный сервер в списке и установите его в один клик.

Этот способ подходит для популярных серверов, которые уже добавлены в каталог Cursor.

Способ 2. Настройка через файл mcp.json

Если нужного сервера нет в каталоге или вы подключаете собственный, настройте его вручную через конфигурационный файл.

Где хранится файл конфигурации

Cursor поддерживает две области видимости:

УровеньПуть к файлуКогда использовать
Проектный`.cursor/mcp.json` в корне проектаСервер нужен только для конкретного проекта
Глобальный`~/.cursor/mcp.json`Сервер должен быть доступен во всех проектах

Как открыть mcp.json через настройки

  1. Откройте Settings в Cursor.
  2. Перейдите в раздел Tools & MCP.
  3. Нажмите New MCP Server — Cursor откроет файл mcp.json.
  4. Добавьте конфигурацию сервера внутри объекта mcpServers.
  5. Сохраните файл.

Пример конфигурации для локального сервера

Локальный сервер запускается командой на вашей машине (транспорт stdio):

json
{
  "mcpServers": {
    "my-server": {
      "command": "npx",
      "args": ["-y", "@my-org/mcp-server"],
      "env": {
        "API_KEY": "your-api-key"
      }
    }
  }
}

Поле command указывает исполняемый файл, args — аргументы запуска, env — переменные окружения (например, ключи API).

Пример конфигурации для удалённого сервера

Для удалённых серверов (SSE или Streamable HTTP) вместо command и args используется поле url:

json
{
  "mcpServers": {
    "remote-server": {
      "url": "https://example.com/mcp"
    }
  }
}

После сохранения файла найдите сервер в списке и нажмите Connect, чтобы пройти аутентификацию, если она требуется.

Как проверить, что сервер подключён

  1. Откройте Settings → Tools & MCP.
  2. Найдите сервер в списке — Cursor автоматически подхватывает изменения в mcp.json.
  3. Убедитесь, что рядом с сервером нет ошибки, и включите его через переключатель на вкладке MCP.

Если сервер не появился в списке, перезапустите Cursor — изменения в некоторых конфигурациях применяются только после перезагрузки редактора.

Типичные ошибки при подключении

  • Файл mcp.json лежит не в той папке. Проверьте, что используете .cursor/mcp.json в корне проекта или ~/.cursor/mcp.json для глобального конфига.
  • Опечатка в объекте `mcpServers`. Конфигурация каждого сервера должна быть вложена именно в этот объект, а не находиться на верхнем уровне JSON.
  • Не указан обязательный `env`. Если сервер требует API-ключ или токен, а поле env отсутствует — подключение завершится ошибкой авторизации.
  • Не пройдена аутентификация для удалённого сервера. После добавления url не забудьте нажать Connect рядом с сервером.
  • Cursor не увидел изменения. Перезапустите редактор, если сервер не появился в списке после редактирования файла вручную.

FAQ

Можно ли подключить несколько MCP-серверов одновременно?

Да, все серверы добавляются как отдельные ключи внутри объекта mcpServers в одном файле mcp.json.

Чем отличается проектный mcp.json от глобального?

Проектный файл (.cursor/mcp.json) применяется только к текущему проекту, глобальный (~/.cursor/mcp.json) — ко всем проектам в Cursor.

Нужно ли перезапускать Cursor после изменения конфигурации?

Cursor обычно подхватывает изменения в mcp.json автоматически, но если сервер не появился в списке, перезапустите редактор.

Какие транспорты поддерживает Cursor для MCP-серверов?

Поддерживаются stdio (для локальных серверов через command/args), а также SSE и Streamable HTTP для удалённых серверов через поле url.

Где включить или отключить уже подключённый сервер?

В Settings → Tools & MCP — там отображается список всех серверов с переключателем включения.

Источники

  • https://cursor.com/help/customization/mcp.md
  • https://cursor.com/docs/mcp.md
  • https://snyk.io/articles/how-to-add-a-new-mcp-server-to-cursor/
  • https://knowledgebase.businessmap.io/hc/en-us/articles/35975184680594-Local-MCP-Guide
  • https://learn.microsoft.com/en-us/azure/developer/azure-mcp-server/get-started/tools/cursor
  • https://cloud.tencent.com/developer/article/2662652
  • https://docs.ovaledge.com/release8.1/mcp-server/deployment-options/remote-mcp/set-up-cursor-with-remote-mcp
  • https://github.com/this-rs/project-orchestrator/blob/main/docs/integrations/cursor.md