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

Как подключить 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

Путь к конфигу

Файл может не существовать по умолчанию — создайте его вручную.

Структура конфига

Та же самая, что у 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, только для текущего проекта.

Уровни области видимости

Для инструментов типа 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 — в чём разница и что выбрать

Конфиг для 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% случаев:

1. Нет корневого ключа "mcpServers" — файл читается без ошибок, но игнорируется полностью
2. Node.js не установлен или не в PATH — сервер не может запуститься
3. Опечатка в JSON — лишняя запятая или кавычка

Самый быстрый способ дебага: скопируйте команду из mcp.json и запустите вручную в терминале. Cursor скрывает ошибки, терминал — нет:

npx -y @modelcontextprotocol/server-github

Claude 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 серверы для старта

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.