Как подключить MCP к Cursor: первый сервер

Чтобы подключить MCP к Cursor, добавь конфигурацию сервера в .cursor/mcp.json, проверь его состояние в настройках и попроси Agent выполнить задачу через появившийся инструмент. Для локального сервера Cursor запускает отдельный процесс; для удалённого — подключается к URL.

Начнём с официального примерного Filesystem MCP Server. Он даст агенту инструменты для работы с учебными файлами. Цель — увидеть настоящий вызов MCP, его аргументы и результат, прежде чем подключать внешние сервисы.

В комплекте — конфигурация и два вымышленных документа. Настройка Cursor сверена с документацией. Сервер версии 2026.8.31 проверен через MCP: инициализация, список инструментов, чтение учебного файла, ошибки для отсутствующего файла и пути вне разрешённой папки. Вызовы через интерфейс Cursor отдельно не проверялись.

1. Подготовь отдельный проект

Скачай учебный проект, распакуй его в отдельную папку и открой эту папку целиком в Cursor. Не добавляй её вложенной папкой в рабочий монорепозиторий для первого упражнения. Внутри находятся:

cursor-mcp-demo/
  .cursor/
    mcp.json
  fixtures/
    project-brief.md
    release-checklist.md
  README.md

project-brief.md описывает вымышленный сервис «Маяк»: запуск 28 сентября, первая версия содержит поиск и экспорт CSV. Второй файл задаёт три проверки перед релизом. Эти сведения нужны, чтобы отличить чтение файла от общего ответа модели.

Понадобятся Node.js и npm. В обычном терминале проверь node --version и npx --version. Пакет скачивается из npm при первом запуске. В конфигурации зафиксирована версия 2026.8.31, подтверждённая в npm на момент подготовки материала.

Filesystem Server поддерживает не только чтение, но и запись. Поэтому упражнение выполняется на копии учебных файлов. Ограничение каталога относится к этому MCP-серверу и не ограничивает другие встроенные инструменты Cursor.

2. Создай конфигурацию MCP

В проектном .cursor/mcp.json из комплекта уже записано:

{
  "mcpServers": {
    "demo-files": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem@2026.8.31",
        "${workspaceFolder}/fixtures"
      ]
    }
  }
}

demo-files — имя подключения. stdio означает обмен через стандартные потоки локального процесса. Элементы args передаются отдельными аргументами: не склеивай команду и путь в одну строку. ${workspaceFolder} подставляет корень проекта.

Cursor поддерживает проектный .cursor/mcp.json и глобальный ~/.cursor/mcp.json. Для упражнения достаточно проектной конфигурации. Если файл уже существует, добавь demo-files в существующий объект mcpServers, сохранив остальные подключения. Формат и подстановки описаны в документации Cursor MCP.

На Windows для пути, заданного вручную, используй прямые слеши либо экранируй обратные: C:/work/demo/fixtures или C:\\work\\demo\\fixtures. Подстановка ${workspaceFolder} обычно избавляет от необходимости прописывать личный путь в JSON.

3. Проверь подключение и доступ

Открой настройки Cursor и раздел Customize с MCP-подключениями; в более старом интерфейсе ищи Tools & MCP. Найди demo-files, включи сервер и при необходимости перезапусти его после изменения файла.

Проверь список инструментов. У этого сервера среди них должны быть list_allowed_directories, list_directory и read_text_file. Наличие записи в конфигурации не доказывает, что процесс запустился.

В Agent попроси:

Через MCP-сервер demo-files вызови list_allowed_directories.
Покажи фактически разрешённые каталоги. Пока не читай файлы и ничего не меняй.

Проверь карточку вызова и результат. Некоторые MCP-клиенты передают серверу Roots — список доступных корней. Filesystem Server может заменить ими каталоги из args; поэтому нельзя считать строку в JSON окончательным доказательством границы доступа. Если в ответе видны неожиданные рабочие каталоги, останови упражнение и проверь, какой проект открыт.

Механизм Roots, доступные инструменты и права описаны в README Filesystem Server. Имя инструмента в карточке Cursor может иметь префикс имени сервера — это нормально.

4. Выполни задачу через инструмент

Отправь второе задание:

Используй только MCP demo-files: сначала list_directory для fixtures,
затем read_text_file для project-brief.md и release-checklist.md.
Составь короткий план релиза: дата, функции первой версии и три проверки.
Для каждого пункта укажи имя файла-источника.
Ничего не записывай и не используй терминал вместо MCP.

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

Что проверить	Ожидаемый результат
В журнале есть вызов MCP	Видны сервер, имя инструмента и путь
Дата запуска	28 сентября 2026, источник project-brief.md
Функции	Поиск и экспорт CSV, без придуманного чата
Проверки	Поиск, экспорт с заголовками, отказ при отсутствии доступа
Файлы после задачи	Не изменились

После этого измени дату в учебном project-brief.md и попроси перечитать файл. Важен новый вызов инструмента и новая дата; старый ответ из контекста не проходит проверку актуальности.

Ещё один полезный тест — запросить несуществующий файл внутри fixtures. Агент должен сообщить об ошибке чтения, а не придумать содержимое. Не проверяй границы доступа на настоящих секретах: для этого достаточно специально созданного безобидного файла вне учебного каталога.

5. Разбери ошибки

Симптом	Что проверить
`npx` не найден	Node.js доступен процессу Cursor; перезапусти редактор после установки
Сервер долго запускается	Первый запуск скачивает пакет; проверь доступ к npm
JSON не читается	Нет комментариев, лишней запятой или неверного экранирования
Каталог не найден	Открыт корень учебного проекта; папка fixtures существует
Access denied	Фактический список разрешённых каталогов и абсолютный путь
Агент отвечает без MCP	Выбран Agent, инструмент включён, в запросе явно указан сервер

Если npx работает только в терминале, укажи полный путь к исполняемому файлу, доступному Cursor. На Windows запуск npm-команд через графическое приложение может потребовать cmd с аргументами /c, npx, затем аргументы пакета. Сначала проверь команду отдельно в терминале.

Не включай автоматическое одобрение всех инструментов только ради устранения ошибки подключения: оно не исправит путь или синтаксис JSON. Различай запуск процесса, регистрацию инструментов и разрешение конкретного вызова.

Как подключать следующие серверы

Для каждого нового MCP-подключения выбери одну проверяемую операцию: прочитать документ, найти задачу или получить структуру таблицы. Зафиксируй ожидаемый результат до первого вызова. Доступы и способы запуска бери из документации самого сервера.

Когда понадобится запись, добавь отдельный тест с учебным объектом и проверь изменения после выполнения. Для браузерного сценария продолжи разбор инструментов браузера для агента. А повторяемую последовательность шагов можно оформить как навык агента: MCP даёт доступ к действиям, инструкция задаёт порядок их применения.

Todo: попробуй на своей задаче1. Подготовь отдельный проект2. Создай конфигурацию MCP3. Проверь подключение и доступ4. Выполни задачу через инструментПрогресс сохраняется в этом браузере.

ПРАКТИКА НА КУРСЕ / AI PRODUCT CLUB

Собери своего ИИ-агента и проверь результат

«AI Agents: от vibe coding к AI-команде»: desktop agents, MCP, skills, evals и harness. Отдельные воркшопы — от подключения инструментов до контроля качества.

7 практических воркшопов · записи · вопросы автору в чате

Посмотреть программу курса ↗

Автор: Михаил Карпов — практик автоматизации и автор курсов AI Product Club.