​
Что такое 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.

Browse MCP Tools

Просматривай доступные MCP‑серверы

Add to Cursor Button

Создай кнопку «Add to Cursor»

​
Использование 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.

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

По умолчанию агент запрашивает подтверждение перед использованием инструментов 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‑ключи: Используй ограниченные API‑ключи с минимально необходимыми правами
  • Проводь аудит кода: Для критически важных интеграций изучай исходный код сервера
Помни, что MCP‑серверы могут получать доступ к внешним сервисам и выполнять код от твоего имени. Всегда разбирайся, что делает сервер, перед установкой.

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

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

​
FAQ