VibeCoderzVibeCoderz
Все статьи
Claude Code2026/05/158 мин чтения

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

Пошаговый разбор, как подключить MCP‑сервер к Cursor, Claude Desktop и Claude Code: конкретные команды, пути к конфигу и типичные ошибки. Узнайте, почему единый протокол упрощает работу с API и сервисами.

Содержание (11)+

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 — в чём разница и что выбрать

ПараметрstdioStreamable 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% случаев:

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

СерверЗачем нуженПакет
GitHubРепозитории, PR, issues прямо из редактора@modelcontextprotocol/server-github
PostgreSQLЗапросы к БД, управление схемой@modelcontextprotocol/server-postgres
FilesystemЧтение и запись файлов вне воркспейса@modelcontextprotocol/server-filesystem
ExaАктуальная документация и код, обходит knowledge cutoffexa-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-ключ или опечатка в имени пакета.



Все инструменты, которые упоминаются в статье, есть в каталоге AI-инструментов — с подробными обзорами, ценами и сравнениями. Если хотите разобраться, как выстроить рабочий стек под конкретный проект, запишитесь на консультацию к Максиму.


Обновлено: октябрь 2026. Актуально для Cursor 0.5+, Claude Desktop 2026 и Claude Code с поддержкой MCP.

Автор

Максим Наговицын

Маркетинг-стратег, IT-предприниматель, ментор по вайбкодингу

2026/05/15

10+ лет в маркетинге, 300+ клиентских проектов: сайты, реклама, боты. Создатель GoBanana (228K+ пользователей, 11.6 млн ₽ выручки) и VibeCoderz. Делаю AI-продукты сам через Claude Code, Cursor, Windsurf и консультирую тех, кто хочет так же.

Об авторе →
All Posts

Инструменты, упомянутые в статье

Читать далее

📄 Статья

Claude Opus 5.5 и Sonnet 5.5 в 2026 что нового у Anthropic

Claude Opus 5.5 вышел 22 сентября 2026 и открыл семейство Claude 5.5 от Anthropic. Он дешевле Opus 5 на 20% по цене токена, генерирует ответ на 30% быстрее и в тестах самой Anthropic обгоняет более дорогой Fable 5.1. Через шесть дней, 28 сентября, по…

2026/10/1210 мин
📄 Статья

SonarQube MCP: как подключить проверку качества кода к Claude Code

SonarQube MCP подключается к Claude Code двумя путями: одной командой claude mcp add с Docker-контейнером или через плагин sonarqube и навык /sonarqube:sonar-integrate. После этого агент сам запрашивает у Sonar замечания, Quality Gate и покрытие тест…

2026/10/018 мин
📄 Статья

Субагенты в Codex и OpenClaw: разбиваем задачу на роли за пределами Claude Code

Субагенты codex — это дочерние потоки, которые главный агент запускает под собственным управлением для параллельных или изолированных задач. В марте 2026 OpenAI перевела эту функцию в статус GA: до 6 одновременных субагентов и guardian-подтверждения…

2026/09/1510 мин
📄 Статья

Claude Code Skills с GitHub: готовые скиллы для вашего агента

Официальный магазин скиллов Claude Code удобный, но маленький. Большая часть действительно рабочих claude code skills с github лежит прямо в публичных репозиториях разработчиков, минуя всякую курацию. Обновлено: сентябрь 2026. Ниже — как найти такой…

2026/09/157 мин
📄 Статья

Hermes Agent Plugins: расширяем агента модулями и скиллами

Hermes Agent Plugins — это две параллельные системы расширения агента: нативные плагины с полным доступом к внутренним хукам и портативные пакеты по открытому стандарту Agent Plugins 1.0, которые запускаются не только в Hermes, но и в Claude Code, Cu…

2026/09/157 мин
📄 Статья

Langfuse MCP: подключаем наблюдаемость к Claude Code и Cursor

Langfuse MCP — это сервер, который дает агенту в Claude Code или Cursor прямой доступ к трейсам, метрикам и промптам вашего проекта в Langfuse. Вместо того чтобы вручную открывать веб-интерфейс и искать нужную трассировку, вы просто спрашиваете агент…

2026/09/047 мин