Что такое MCP?

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

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

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

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

MCP‑серверы открывают свои возможности через протокол, подключая Cursor к внешним инструментам и источникам данных. Cursor поддерживает три метода транспорта:
TransportExecution environmentDeploymentUsersInputAuth
stdioLocalCursor managesSingle userShell commandManual
SSELocal/RemoteDeploy as serverMultiple usersURL to an SSE endpointOAuth
Streamable HTTPLocal/RemoteDeploy as serverMultiple usersURL to an HTTP endpointOAuth

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

Cursor поддерживает следующие возможности протокола MCP:
FeatureSupportDescription
ToolsSupportedFunctions for the AI model to execute
PromptsSupportedTemplated messages and workflows for users
RootsSupportedServer-initiated inquiries into uri or filesystem boundaries to operate in
ElicitationSupportedServer-initiated requests for additional information from users

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

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

Устанавливай MCP‑серверы из нашей коллекции и проходи OAuth‑аутентификацию.

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

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

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

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

MCP Extension API Reference

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

Где хранить конфигурацию

Project Configuration

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

Global Configuration

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

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

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

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

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

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

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

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

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

Автозапуск

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

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

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

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

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

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