Короткий ответ
Cursor читает MCP-серверы из файла mcp.json. Два места на выбор: ~/.cursor/mcp.json — сервер будет доступен во всех проектах, .cursor/mcp.json в корне проекта — только в этом. Файла может не быть, тогда создайте его сами. После сохранения загляните в настройки Cursor, раздел MCP: там видно, поднялся сервер или упал.
Минимальная настройка
Сервер, который запускается на вашей машине:
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/me/work"],
"env": {}
}
}
}command — чем запускать, args — с какими аргументами, env — переменные окружения, обычно туда кладут токены и ключи.
Удалённый сервер описывается иначе: вместо command указывается адрес.
{
"mcpServers": {
"remote-server": {
"url": "http://localhost:3000/mcp",
"headers": { "API_KEY": "ваш-ключ" }
}
}
}Cursor понимает три способа связи: stdio для локальных серверов, а также SSE и Streamable HTTP для удалённых.
Что реально меняется в работе
Без MCP редактор видит только ваш код. С подключённым сервером агент дотягивается до того, что лежит снаружи: до базы данных, до задач в трекере, до документации библиотеки, до макета.
Разница заметна на простой задаче. «Почини ошибку в этом запросе» без MCP — агент угадывает структуру таблиц по коду. С подключённой базой он смотрит настоящую схему и видит, что поля с таким именем там просто нет.
Почему сервер не появился
Четыре причины покрывают почти все случаи.
Опечатка в JSON. Лишняя запятая после последнего элемента — файл не читается целиком, и ни один сервер не поднимется. Проверьте, что скобки закрыты.
npx не найден. Cursor запускает команду не из вашего терминала, а из своего окружения, и PATH там короче. Помогает полный путь до исполняемого файла.
Сервер требует ключ, а ключа нет. Процесс стартует и сразу падает. Смотрите текст ошибки в настройках — там обычно прямо написано, какой переменной не хватает.
Забыли перезапустить. Cursor перечитывает конфиг не всегда мгновенно, самый надёжный способ — закрыть и открыть заново.
С чего начать
Возьмите один сервер, а не пять сразу. Каждый подключённый сервер добавляет агенту список инструментов, и на десятке серверов модель начинает путаться, чем именно пользоваться. Для начала подойдёт файловый сервер или сервер документации — оба дают заметный эффект и ничего не ломают.
Если MCP для вас в новинку, начните с объяснения, что это такое, а потом уже возвращайтесь к настройке. Общий порядок подключения, одинаковый для всех редакторов, разобран в инструкции по подключению MCP.
Про доступы
MCP-сервер работает с вашими правами. Если вы дали ему ключ от рабочей базы, агент сможет туда писать, а не только читать. Для незнакомых серверов из чужих репозиториев это отдельный риск — что с ним делать, разобрано в материале про безопасность MCP.