​
Что такое MCP?

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

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

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

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

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

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

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

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

Просмотреть MCP-инструменты

Просмотрите доступные MCP-серверы

Кнопка "Добавить в Cursor"

Создайте кнопку “Добавить в Cursor”

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

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

​
Места хранения конфигурации

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

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

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

Создайте ~/.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...";
// ^ полный 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 и браузера в ваш рабочий процесс разработки.

​
Часто задаваемые вопросы