Что такое MCP?

Model Context Protocol (MCP) даёт Cursor возможность подключаться к внешним инструментам и источникам данных.

Зачем использовать MCP?

MCP подключает Cursor к внешним системам и данным. Вместо того чтобы каждый раз заново объяснять структуру проекта, интегрируйся напрямую со своими инструментами. Пиши серверы MCP на любом языке, который выводит в stdout или поднимает HTTP-эндпоинт — Python, JavaScript, Go и т. д.

Как это работает

Серверы MCP предоставляют возможности через протокол, подключая Cursor к внешним инструментам и источникам данных. Cursor поддерживает три способа транспорта:
ТранспортСреда выполненияРазвертываниеПользователиВводАутентификация
stdioЛокальноУправляется CursorОдин пользовательКоманда в shellВручную
SSEЛокально/удалённоРазвёртывание как сервераНесколько пользователейURL SSE-эндпоинтаOAuth
Streamable HTTPЛокально/удалённоРазвёртывание как сервераНесколько пользователейURL HTTP-эндпоинтаOAuth

Поддержка протокола

Cursor поддерживает следующие возможности протокола MCP:
ВозможностьПоддержкаОписание
ToolsПоддерживаетсяФункции, которые выполняет модель ИИ
PromptsПоддерживаетсяШаблоны сообщений и пользовательские рабочие процессы
ResourcesПоддерживаетсяСтруктурированные источники данных для чтения и ссылок
RootsПоддерживаетсяЗапросы сервера к границам URI или файловой системы, в пределах которых выполнять операции
ElicitationПоддерживаетсяИнициируемые сервером запросы на дополнительную информацию от пользователей

Установка серверов MCP

Установка в один клик

Ставь MCP‑серверы из нашей коллекции и входи через OAuth.

Использование mcp.json

Настрой свои пользовательские MCP‑серверы с помощью JSON‑файла:
{
  "mcpServers": {
    "server-name": {
      "command": "npx",
      "args": ["-y", "mcp-server"],
      "env": {
        "API_KEY": "value"
      }
    }
  }
}

Конфигурация STDIO‑сервера

Для STDIO‑серверов (локальных серверов командной строки) настрой эти поля в mcp.json:
ПолеОбязательноОписаниеПримеры
typeДаТип подключения сервера"stdio"
commandДаКоманда для запуска исполняемого файла сервера. Должна находиться в PATH системы или содержать полный путь"npx", "node", "python", "docker"
argsНетМассив аргументов, передаваемых команде["server.py", "--port", "3000"]
envНетПеременные окружения для сервера{"API_KEY": "${input:api-key}"}
envFileНетПуть к файлу окружения для загрузки дополнительных переменных".env", "${workspaceFolder}/.env"

Использование Extension API

Для программной регистрации MCP‑серверов Cursor предоставляет Extension API, который позволяет настраивать их динамически без изменения файлов mcp.json. Это особенно полезно для корпоративных сред и автоматизированных сценариев развёртывания.

Справочник по MCP Extension API

Узнай, как программно регистрировать MCP‑серверы с помощью vscode.cursor.mcp.registerServer()

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

Конфигурация проекта

Создай .cursor/mcp.json в своём проекте для проектных инструментов.

Глобальная конфигурация

Создай ~/.cursor/mcp.json в домашнем каталоге, чтобы инструменты были доступны везде.

Интерполяция конфигурации

Используй переменные в значениях mcp.json. Cursor подставляет переменные в следующих полях: command, args, env, url и headers. Поддерживаемый синтаксис:
  • ${env:NAME} — переменные окружения
  • ${userHome} — путь к твоей домашней папке
  • ${workspaceFolder} — корень проекта (папка, которая содержит .cursor/mcp.json)
  • ${workspaceFolderBasename} — имя корневой папки проекта
  • ${pathSeparator} и ${/} — разделитель путей ОС
Примеры
{
  "mcpServers": {
    "local-server": {
      "command": "python",
      "args": ["${workspaceFolder}/tools/mcp_server.py"],
      "env": {
        "API_KEY": "${env:API_KEY}"
      }
    }
  }
}
{
  "mcpServers": {
    "remote-server": {
      "url": "https://api.example.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:MY_SERVICE_TOKEN}"
      }
    }
  }
}

Аутентификация

Серверы MCP используют переменные окружения для аутентификации. Передавай API‑ключи и токены через конфиг. Cursor поддерживает OAuth для серверов, которым это нужно.

Использование MCP в чате

Агент Composer автоматически использует инструменты MCP из раздела Available Tools, когда это уместно. Попроси нужный инструмент по имени или опиши, что тебе нужно. Включай или отключай инструменты в настройках.

Переключение инструментов

Включай или отключай инструменты MCP прямо из чата. Нажми на название инструмента в списке, чтобы переключить его. Отключённые инструменты не подгружаются в контекст и недоступны для Agent.

Подтверждение использования инструментов

По умолчанию Agent запрашивает подтверждение перед использованием инструментов MCP. Нажми на стрелку рядом с названием инструмента, чтобы посмотреть передаваемые аргументы.

Автозапуск

Включи автозапуск, чтобы Agent мог использовать инструменты MCP без подтверждений. Работает как команды терминала. Подробнее о настройках автозапуска читай здесь.

Ответ инструмента

Cursor показывает ответ в чате с разворачиваемыми панелями аргументов и результатов:

Изображения как контекст

Серверы MCP могут возвращать изображения — скриншоты, диаграммы и т. п. Возвращай их в виде строк в кодировке base64:
const RED_CIRCLE_BASE64 = "/9j/4AAQSkZJRgABAgEASABIAAD/2w...";
// ^ полный base64 обрезан для удобства чтения

server.tool("generate_image", async (params) => {
  return {
    content: [
      {
        type: "image",
        data: RED_CIRCLE_BASE64,
        mimeType: "image/jpeg",
      },
    ],
  };
});
См. этот пример сервера для подробностей реализации. Cursor прикрепляет возвращённые изображения к чату. Если модель поддерживает изображения, она их анализирует.

Вопросы безопасности

Когда устанавливаешь MCP‑серверы, учитывай такие практики безопасности:
  • Проверяй источник: ставь MCP‑серверы только от доверенных разработчиков и из проверенных репозиториев
  • Проверяй разрешения: смотри, к каким данным и API сервер будет получать доступ
  • Ограничивай API‑ключи: используй ограниченные ключи с минимально необходимыми правами
  • Проводи аудит кода: для критичных интеграций просматривай исходники сервера
Помни, что MCP‑серверы могут обращаться к внешним сервисам и выполнять код от твоего имени. Всегда разбирайся, что именно делает сервер, перед установкой.

Примеры из реальной практики

Для наглядных примеров MCP в действии загляни в наш гайд по веб‑разработке, где показано, как интегрировать Linear, Figma и инструменты браузера в твой рабочий процесс разработки.

FAQ

MCP‑серверы подключают Cursor к внешним инструментам — Google Drive, Notion и другим сервисам — чтобы подтягивать документы и требования прямо в твой рабочий процесс.
Посмотри логи MCP: 1) Открой панель Output в Cursor (Ctrl+Shift+U) 2) Выбери «MCP Logs» в выпадающем списке 3) Проверь ошибки подключения, проблемы с аутентификацией или падения сервера. Логи показывают инициализацию сервера, вызовы инструментов и сообщения об ошибках.
Да! Переключай серверы вкл/выкл, не удаляя их: 1) Открой Settings ( Ctrl+Shift+J) 2) Перейди в Features → Model Context Protocol 3) Нажми тумблер рядом с нужным сервером, чтобы включить/отключить. Отключённые серверы не будут загружаться и появляться в чате. Это удобно для отладки или чтобы не захламлять список инструментов.
Если MCP‑сервер не отработал: — Cursor покажет сообщение об ошибке в чате — Вызов инструмента пометится как неуспешный — Можно повторить операцию или посмотреть логи для деталей — Другие MCP‑серверы продолжат работать нормально. Cursor изолирует сбои, чтобы один сервер не влиял на другие.
Для серверов на npm: 1) Удали сервер в настройках 2) Очисти кэш npm: npm cache clean --force 3) Добавь сервер заново, чтобы получить последнюю версию. Для кастомных серверов обнови локальные файлы и перезапусти Cursor.
Да, но соблюдай лучшие практики безопасности: — Используй переменные окружения для секретов, никогда не хардкодь их — Запускай чувствительные серверы локально с транспортом stdio — Ограничивай права API‑ключей до минимума — Проверяй код сервера перед подключением к чувствительным системам — Рассмотри запуск серверов в изолированных окружениях