Как подключить MCP сервер к Cursor и Claude в 2026 году
MCP сервер подключается через JSON-конфиг в одном из двух мест: для Cursor это ~/.cursor/mcp.json или .cursor/mcp.json в корне проекта, для Claude Desktop — ~/.claude/claude_desktop_config.json, для Claude Code — команда claude mcp add прямо в терминале. Структура JSON одинакова во всех трёх случаях, отличается только путь к файлу. В этом гайде разберём каждый вариант по шагам: конкретные команды, типичные ошибки и почему больше серверов — хуже, а не лучше.
Что такое MCP и почему это важно прямо сейчас
MCP (Model Context Protocol) — открытый протокол от Anthropic, который позволяет AI-инструментам подключаться к внешним сервисам через единый стандарт. В мае 2026 года доступно уже больше 2 300 публичных MCP серверов, и протокол поддерживают Cursor, Claude Code, Windsurf, VS Code и десятки других инструментов.
Грубо говоря, это USB-C для AI. До MCP каждая интеграция требовала отдельного кода. Теперь один конфиг — и Cursor умеет работать с GitHub, базой данных, Notion, Slack или вашим собственным API.
Когда вы пишете в Cursor «добавь поле country в таблицу users» и агент сам лезет в Supabase, делает миграцию и возвращается с результатом — это MCP в действии. Без него пришлось бы открывать Supabase вручную, писать SQL, копировать результат обратно.
Как работает MCP сервер внутри
Три участника: хост (Cursor или Claude Desktop), клиент (коннектор внутри хоста) и сервер (внешняя программа с инструментами).
При запуске хост читает конфиг, запускает каждый сервер, загружает список его инструментов. Агент видит эти инструменты и сам решает, какой вызвать под задачу.
Два транспорта:
- stdio — сервер запускается локально как дочерний процесс, обмен через stdin/stdout. Самый распространённый вариант.
- Streamable HTTP — сервер работает как отдельный процесс или облачный сервис, общение по HTTP. Anthropic с апреля 2026 года официально рекомендует именно его для новых интеграций. Старый SSE-транспорт признан устаревшим.
Практическая разница: stdio требует Node.js или Python локально, HTTP работает без зависимостей на машине пользователя.
Как подключить MCP сервер к Cursor
Два уровня конфига
У Cursor два места для mcp.json:
~/.cursor/mcp.json— глобальный конфиг, работает во всех проектах.cursor/mcp.jsonв корне проекта — только для этого проекта
Если один и тот же сервер прописан в обоих местах, побеждает проектный конфиг. Для командных инструментов удобно хранить .cursor/mcp.json в репозитории — все получат одинаковую конфигурацию при клоне.
Структура файла
{
"mcpServers": {
"название-сервера": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "ваш_токен"
}
}
}
}Ключевые поля:
command— исполняемый файл (npx, python, node или docker)args— аргументы командной строкиenv— переменные окружения (токены, API-ключи)
Пример с тремя серверами
{
"mcpServers": {
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxxxxxxxxxxx"
}
},
"postgres": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-postgres", "postgresql://localhost/mydb"]
},
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/you/projects"]
}
}
}Как проверить, что сервер подключился
Откройте Cursor Settings -> Tools & MCP. Зелёный индикатор рядом с сервером — работает. Жёлтый — проблема. Серого нет — файл не читается.
Если инструменты не появляются, перезапустите Cursor полностью (Quit, не просто закройте окно).
Важный лимит
У Cursor потолок в 40 активных инструментов суммарно по всем MCP серверам. Превысите — агент молча теряет часть из них без предупреждения. Решение: в настройках каждого сервера отключайте инструменты, которые не используете.
Как подключить MCP сервер к Claude Desktop
Путь к конфигу
| Операционная система | Путь к файлу |
|---|---|
| macOS | ~/Library/Application Support/Claude/claude_desktop_config.json |
| Windows | %APPDATA%\Claude\claude_desktop_config.json |
| Linux | ~/.config/Claude/claude_desktop_config.json |
Файл может не существовать по умолчанию — создайте его вручную.
Структура конфига
Та же самая, что у Cursor. Разница только в пути к файлу:
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/you/documents"]
}
}
}После изменения конфига нужно полностью выйти из Claude Desktop и запустить снова. Горячая перезагрузка не работает.
Desktop Extensions — новый способ без JSON
С начала 2026 года Claude Desktop поддерживает Desktop Extensions — готовые MCP серверы в формате .dxt. Устанавливаются двойным кликом, без редактирования JSON и без проблем с PATH.
Чтобы найти доступные: откройте новый чат, нажмите «+» внизу, выберите Extensions. Для нетехнических задач — удобнее JSON-конфига. Для кастомных серверов или если нужен полный контроль — JSON по-прежнему выигрывает.
Как добавить MCP сервер в Claude Code
Claude Code — терминальный инструмент от Anthropic, и там MCP настраивается командой напрямую из консоли.
Базовая команда
claude mcp add <имя> <команда> [аргументы]Практические примеры
# Доступ к файловой системе
claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem ~/Documents ~/Projects
# GitHub
claude mcp add github -e GITHUB_TOKEN=ghp_xxxx -- npx -y @modelcontextprotocol/server-github
# PostgreSQL
claude mcp add postgres -- npx -y @modelcontextprotocol/server-postgres postgresql://localhost/mydbФлаг -e добавляет переменные окружения. Флаг -s user делает сервер глобальным (работает во всех проектах). По умолчанию — local, только для текущего проекта.
Уровни области видимости
| Флаг | Что значит | Где хранится |
|---|---|---|
| -s local (по умолчанию) | Только текущий проект, у вас на машине | .claude/settings.json |
| -s user | Все проекты | ~/.claude/settings.json |
| -s project | Вся команда через репозиторий | .mcp.json в корне проекта |
Для инструментов типа GitHub и filesystem — используйте -s user. Для проектных конфигов с командными токенами — -s project и добавьте .mcp.json в git.
Проверка и управление
# Список подключённых серверов
claude mcp list
# Проверить конкретный сервер
claude mcp test github
# Удалить сервер
claude mcp remove githubПрямо в сессии Claude Code работает команда /mcp — показывает, какие серверы подключены, какие грузятся, какие упали.
Stdio vs HTTP — в чём разница и что выбрать
| Параметр | stdio | Streamable HTTP |
|---|---|---|
| Где работает | Локально на вашей машине | Локально или в облаке |
| Зависимости | Node.js или Python локально | Не нужны |
| Команда | "command": "npx" | "url": "https://..." |
| Лучше для | Личных инструментов | Командных и облачных |
| Производительность | Быстрее (нет HTTP overhead) | Удобнее для remote |
Конфиг для HTTP-сервера выглядит иначе:
{
"mcpServers": {
"remote-server": {
"url": "https://your-mcp-server.example.com/mcp"
}
}
}Если работаете solo и нужен быстрый старт — stdio. Если нужен один сервер для всей команды или хотите избежать проблем с Node.js PATH — HTTP.
Сколько MCP серверов подключать
Один из главных инсайтов из практики: больше серверов — хуже, а не лучше.
Каждый сервер добавляет описания своих инструментов в контекстное окно AI. Подключили пять серверов с по 10 инструментов каждый — уже 50 инструментов в контексте. При 40+ инструментах качество выбора нужного заметно падает: агент начинает путаться, какой инструмент использовать.
Проверено на практике: три хорошо подобранных сервера работают лучше, чем десять установленных про запас.
Максим: «На NanaBanana мы начинали с 8 MCP серверов — казалось, чем больше, тем лучше. Потом оставили три: базу данных, GitHub и Exa для актуальной документации. Скорость агентских сессий выросла заметно, а ошибок стало меньше. Перестаньте коллекционировать серверы — подключайте только те, что используете каждый день.»
Рекомендуемый стартовый стек для большинства разработчиков: база данных + GitHub + filesystem. Этого хватает для 80% задач.
Типичные ошибки и как их исправить
Инструменты не появляются в Cursor после добавления конфига
Три причины в 90% случаев:
- Нет корневого ключа
"mcpServers"— файл читается без ошибок, но игнорируется полностью - Node.js не установлен или не в PATH — сервер не может запуститься
- Опечатка в JSON — лишняя запятая или кавычка
Самый быстрый способ дебага: скопируйте команду из mcp.json и запустите вручную в терминале. Cursor скрывает ошибки, терминал — нет:
npx -y @modelcontextprotocol/server-githubClaude Code не применяет изменения в конфиге
Claude Code не перезагружается на лету. После любых изменений в конфиге нужен полный перезапуск.
У Claude Code ошибка spawn claude ENOENT
Если Claude Code используется как MCP-сервер для другого клиента, команда claude должна быть в PATH. Если нет — укажите полный путь:
which claudeПолученный путь вставьте в поле command конфига.
В stdio-режиме работает локально, не работает в remote-окружении
stdio-транспорт запускает процесс на том же компьютере, где работает клиент. В remote-окружениях используйте Streamable HTTP.
Два сервера конфликтуют по названиям инструментов
Если два сервера регистрируют инструмент с одинаковым именем, Claude Code оставит один и проигнорирует второй. Решение — поле tools в конфиге сервера для переименования или фильтрации.
Проверенные MCP серверы для старта
| Сервер | Зачем нужен | Пакет |
|---|---|---|
| GitHub | Репозитории, PR, issues прямо из редактора | @modelcontextprotocol/server-github |
| PostgreSQL | Запросы к БД, управление схемой | @modelcontextprotocol/server-postgres |
| Filesystem | Чтение и запись файлов вне воркспейса | @modelcontextprotocol/server-filesystem |
| Exa | Актуальная документация и код, обходит knowledge cutoff | exa-mcp-server |
| Context7 | Последняя версия документации библиотек автоматически | @upstash/context7-mcp |
Exa особенно полезен при работе с новыми версиями фреймворков — модели AI обучались на данных до определённой даты и могут не знать последних изменений в API.
Как убедиться, что MCP сервер реально работает
После подключения сделайте простой тест. Для GitHub спросите агента: «Покажи мои последние репозитории». Для базы данных: «Список таблиц в текущей БД». Если ответ пришёл с реальными данными — всё настроено правильно.
В Claude Code используйте /mcp — там сразу видно статус каждого сервера без лишних шагов.
FAQ
Нужен ли Node.js для подключения MCP серверов?
Для stdio-серверов на npm — да, нужен. Большинство популярных серверов написаны на Node.js и запускаются через npx. Python-серверы требуют Python. HTTP-серверы работают без дополнительных зависимостей на машине пользователя.
Чем отличается mcp.json в Cursor от claude_desktop_config.json?
Только путём к файлу. Структура JSON идентична: корневой ключ mcpServers, внутри — объекты с полями command, args, env. Можно скопировать конфиг из одного инструмента в другой.
Можно ли подключить один MCP сервер к Cursor и Claude одновременно?
Да. Серверы настраиваются независимо в каждом инструменте. Один и тот же сервер, например GitHub, можно добавить и в Cursor, и в Claude Desktop, и в Claude Code — они работают параллельно.
Сколько MCP серверов можно подключить к Cursor?
Серверов — сколько угодно, но инструментов суммарно не больше 40. Превысите лимит — агент молча теряет часть из них. Отключайте инструменты, которые не используете активно.
Как подключить MCP сервер, которого нет в npm?
Можно подключить любой сервер, который умеет отвечать по stdio или HTTP. Для локального сервера укажите путь к исполняемому файлу в поле command. Например: "command": "/path/to/my-server".
Безопасно ли хранить API-ключи в mcp.json?
Файл ~/.cursor/mcp.json находится у вас на машине, это нормально. Но .cursor/mcp.json в проектной папке попадёт в git, если не добавить в .gitignore. Никогда не коммитьте реальные токены в репозиторий.
Что делать, если Cursor показывает жёлтый статус у сервера?
Запустите команду из конфига вручную в терминале — там будет конкретная ошибка. Чаще всего: нет Node.js, неверный API-ключ или опечатка в имени пакета.
Глоссарий
MCP (Model Context Protocol) — открытый протокол для подключения AI-инструментов к внешним сервисам. Разработан Anthropic в 2024 году, передан в Linux Foundation в декабре 2025.
stdio — тип транспорта, при котором MCP сервер запускается как локальный процесс и обменивается данными через stdin/stdout.
Streamable HTTP — тип транспорта через HTTP, официально рекомендован Anthropic с апреля 2026 года. Поддерживает удалённые серверы.
SSE (Server-Sent Events) — устаревший HTTP-транспорт, который заменяет Streamable HTTP. Ещё работает, но поддержка постепенно прекращается.
mcpServers — корневой ключ в JSON-конфиге, без него файл игнорируется полностью.
scope (область видимости) — в Claude Code определяет, где хранится конфиг сервера: local (только этот проект), user (все проекты), project (для команды через репозиторий).
knowledge cutoff — дата, до которой обучена модель. Серверы типа Exa помогают обойти это ограничение, подгружая актуальную документацию в реальном времени.
Все инструменты, которые упоминаются в статье, есть в каталоге AI-инструментов — с подробными обзорами, ценами и сравнениями. Если хотите разобраться, как выстроить рабочий стек под конкретный проект, запишитесь на консультацию к Максиму.
Обновлено: март 2026. Актуально для Cursor 0.5+, Claude Desktop 2026 и Claude Code с поддержкой MCP.