# Как подключить MCP-сервер к Cursor: инструкция для новичков
Каноническая страница: https://plainews.ru/posts/kak-podklyuchit-mcp-server-k-cursor
Опубликовано: 2026-09-15T06:41:05.144Z

Разбираем, как подключить MCP сервер к Cursor через настройки или файл mcp.json — с примерами конфигурации и разбором типичных ошибок подключения.
# Как подключить 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. Сохраните файл.

> **Важно.** Если папки `.cursor` нет в корне проекта — создайте её вручную и добавьте внутрь файл `mcp.json`.

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

Локальный сервер запускается командой на вашей машине (транспорт 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