- Выберите конкретную задачу: например, получить список issues проекта или прочитать схему тестовой базы.
- Для примера подключения к системе задач сначала дайте серверу право читать названия issues и статусы.
- Для локального сервера в конфигурации указывают команду запуска и параметры, для удалённого — поддерживаемый адрес и авторизацию.
- Agent может сам выбрать подходящий MCP-инструмент из доступных.
- Для тренировки используйте сервер, который читает файлы лишь из специально выделенной учебной папки.
MCP (Model Context Protocol) позволяет агенту Cursor использовать инструменты за пределами редактора: обращаться к репозиториям, читать разрешённые данные и выполнять действия через подключённые серверы. Это полезно для автоматизации разработки, но добавляет риск: инструмент с правом записи может изменить сторонний сервис. Поэтому подключение начинается с проверки разрешений и теста на безопасных данных.
Что нужно для первого MCP-подключения
Выберите конкретную задачу: например, получить список issues проекта или прочитать схему тестовой базы. Не подключайте сразу все инструменты команды. Для каждого сервера уточните его происхождение, поддерживаемый транспорт, способ авторизации и перечень операций. Cursor поддерживает конфигурацию MCP через файл настроек и управление инструментами в интерфейсе; доступность конкретного транспорта зависит от типа сервера и среды.
Как организовать подключение
- Определите, какие данные агенту действительно нужны для задачи.
- Выберите проверенный MCP-сервер, совместимый с Cursor.
- Укажите параметры подключения в настройках или конфигурации
mcp.json. - Настройте авторизацию с минимальными правами, без передачи пароля в промпте.
- Проверьте, что сервер отображается в списке доступных инструментов.
- Запустите безопасный запрос на чтение, затем изучите аргументы и ответ.
- Только после проверки разрешайте необходимые действия записи.
Для примера подключения к системе задач сначала дайте серверу право читать названия issues и статусы. Попросите Cursor перечислить три открытые задачи, не меняя их. После успешной проверки можно изучить отдельную операцию создания комментария. Такое разделение помогает понять, какие действия происходят во внешней системе.
Как выглядит конфигурация MCP
Для локального сервера в конфигурации указывают команду запуска и параметры, для удалённого — поддерживаемый адрес и авторизацию. Ниже упрощённый образец структуры без действующих секретов. Название команды и аргументы должны соответствовать выбранному серверу.
{
"mcpServers": {
"project-tools": {
"command": "node",
"args": ["./tools/mcp-server.js"]
}
}
}
Никогда не вставляйте настоящий токен в пример для публичного репозитория. Используйте безопасные переменные окружения или механизм учётных данных, предусмотренный сервером. Если сервер работает удалённо, проверьте, как выполняется аутентификация и какие данные передаются за пределы рабочего пространства.
Почему нужен контроль перед вызовом инструмента
Agent может сам выбрать подходящий MCP-инструмент из доступных. Перед подтверждением посмотрите имя инструмента, аргументы и целевой объект. Удаление issue, запуск миграции базы или изменение прав пользователя должны требовать отдельного согласования. Режим автоматического выполнения допустим для узкого набора проверенных операций, но не для всего каталога инструментов.
| Тип инструмента | Контроль |
|---|---|
| Чтение issues | Только нужный репозиторий |
| Доступ к БД | Тестовая база и право чтения |
| Создание PR | Ветка, владелец и проверка diff |
| Управление задачами | Запрет удаления без подтверждения |
Воспроизводимое подключение файлового MCP
Для тренировки используйте сервер, который читает файлы лишь из специально выделенной учебной папки. Установите Node.js 24 или новее, создайте пустой каталог без секретов, а затем файл .cursor/mcp.json в репозитории. Пример рассчитан на macOS/Linux, путь замените на собственный:
{
"mcpServers": {
"demo-files": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem@2.3.0",
"--read-only",
"/home/user/safe-demo"
]
}
}
}
В Windows для запуска npx может понадобиться cmd /c; путь укажите в формате вашей системы. Выбор версии 2.3.0 или более новой исправленной версии важен: более старые версии файлового сервера имели уязвимости. Указанный сервер должен предоставлять только чтение. Не заменяйте параметр read-only полным доступом ради простоты.
Откройте Customize → MCP и проверьте появление сервера в списке. Попросите Agent перечислить содержимое разрешённого каталога, затем попытайтесь создать файл: в режиме только чтения операция должна быть недоступна. Если инструменты не появились, проверьте JSON, Node.js, npx, путь к папке, сетевую доступность и ошибки запуска. Для GitHub и баз нужны отдельные совместимые серверы и минимальные разрешения; этот пример не предоставляет доступа к этим сервисам.
Как подключить GitHub или тестовую базу
Для GitHub начните с совместимого проверенного MCP-плагина в разделе Customize → MCP. При установке через каталог инструментов проверьте издателя и запрос разрешений, затем пройдите предусмотренную авторизацию. Ограничьте доступ конкретным репозиторием и сначала выполните только чтение списка задач или pull request. Если GitHub уже подключён средствами Cursor либо через команды Git, дополнительный MCP может не потребоваться.
Для базы данных принцип такой же, но риск выше: выделите отдельную тестовую БД, создайте пользователя с правом SELECT к нужным таблицам и исключите персональные данные из примеров. После подключения попросите агента показать схему одной таблицы и выполнить безопасный запрос только на чтение. Не выдавайте права удаления, изменения схемы и управления пользователями. Разрешения определяются сервером MCP и учётной записью БД, а не одной фразой «не удаляй» в промпте.
Если MCP не работает
Сначала проверьте, стартует ли сервер самостоятельно. Затем посмотрите файл конфигурации, путь к исполняемой команде, формат авторизации и состояние соединения. Проблема «инструментов нет» может означать ошибку запуска сервера, а «доступ запрещён» — недостаток прав токена. Не решайте проблемы авторизации выдачей административного токена: исправьте настройки конкретной операции.
Как защитить данные компании
Устанавливайте список разрешённых серверов, ведите журнал обращений и не подключайте неизвестные инструменты к рабочим данным. Если агент получает текст из issues или сторонних документов, считайте его недоверенным содержимым: текст может содержать инструкции, которые нельзя выполнять. Проверяйте команду и цель действия независимо от ответа внешнего сервера.
Связь MCP с другими функциями Cursor
Для закрепления политики доступа полезны Cursor Rules. Для автоматического запуска заданий с внешними инструментами предназначены Cursor Automations, где контроль прав особенно важен. Сначала испытайте MCP в обычном чате на чтении, затем расширяйте операции.
Нужно ли подключать GitHub через MCP?
Не обязательно: часть функций Git доступна через редактор и обычные команды. MCP имеет смысл, когда нужно дополнительное действие в сервисе и есть понятный выигрыш относительно существующего процесса.
Как убедиться, что подключение безопасно?
Составьте список доступных инструментов, проверьте предел их полномочий и выполните тест с минимальными данными. Любой доступ на запись должен быть обоснован конкретной задачей.