Как подключить MCP-сервер к Claude Code и Cursor

Подключение MCP-сервера - механическая операция, но в ней есть несколько мест, где легко застрять на полчаса. Разберём порядок и способы проверки.

Где лежит конфигурация

У клиентов обычно два уровня, и выбор между ними важнее, чем кажется.

Пользовательский уровень. Файл в профиле пользователя. Сервер доступен во всех ваших проектах. Сюда кладут инструменты общего назначения и всё, что завязано на ваши личные доступы.

Проектный уровень. Файл в репозитории. Сервер получает каждый, кто откроет проект. Сюда кладут то, что нужно всей команде: доступ к базе проекта, к его трекеру, к его окружению.

Практическое следствие проектного уровня: клонируя чужой репозиторий, вы получаете и его конфигурацию серверов. Это удобно и одновременно означает, что чужой проект может привести с собой сервер, который вы не смотрели. Относитесь к этому как к зависимости - см. безопасность.

Подключение по шагам

1. Определите тип сервера. Локальный запускается клиентом как процесс, и в конфиге указывается команда запуска. Удалённый - это адрес, и указывается он.

2. Добавьте запись в конфигурацию. Минимум - имя сервера и команда или адрес. Имя произвольное, но оно попадёт в имена инструментов, поэтому короткое и понятное лучше.

3. Вынесите секреты в переменные окружения. Токены и пароли не должны лежать в файле, особенно в проектном. Конфиг ссылается на переменную, значение живёт в окружении.

4. Проверьте команду запуска отдельно. Запустите её в терминале руками и убедитесь, что она стартует. Половина проблем обнаруживается здесь за минуту.

5. Перезапустите клиента. Конфигурация читается при старте.

6. Проверьте, что сервер виден - см. следующий раздел.

Отдельно про Cursor: механика та же, но расположение файла и интерфейс отличаются - подробности в статье MCP-сервер в Cursor. Про особенности Claude Code - в статье MCP-серверы в Claude Code.

Проверка, что сервер виден

Три уровня проверки, и делать нужно все три.

Статус в списке серверов. Показывает, запустился процесс или нет. Если сервер помечен как упавший, проблема в запуске: команда не найдена, зависимость не установлена, порт занят.

Список инструментов. Спросите у агента, какие инструменты ему доступны. Сервер может числиться запущенным и не отдавать ничего - обычно это провал авторизации. Пустой список инструментов при живом сервере почти всегда означает неверный или отсутствующий токен.

Реальный вызов. Попросите сделать что-нибудь простое и безопасное через этот сервер. Только это подтверждает цепочку целиком: клиент нашёл сервер, сервер отдал инструменты, инструмент отработал, результат вернулся.

Что делать, если сервер не появился

По убыванию частоты:

• Не перезапустили клиента. Проверьте первым делом.
• Команда не найдена. Клиент запускает процесс в своём окружении, и PATH там может отличаться от вашей оболочки. Укажите полный путь к исполняемому файлу.
• Опечатка в конфиге. Сломанный JSON часто игнорируется молча: клиент читает файл, не может его разобрать и работает так, будто серверов нет. Проверьте синтаксис.
• Переменная окружения пуста. Пустая переменная выглядит для сервера так же, как отсутствующая, и он падает на инициализации.
• Сервер требует установки. Некоторые запускаются через менеджер пакетов и при первом запуске скачиваются; если сети нет или прокси мешает, запуск падает.
• Не тот уровень конфигурации. Добавили в проектный файл, а открыли другой проект.

Если сервер стартует руками, но не стартует из клиента, дело почти всегда в окружении: путях, переменных или правах. Разбор конфигурации и отладки - в статье про настройку.

После подключения

Две привычки, которые экономят время дальше:

Не подключайте лишнего. Каждый сервер занимает контекст описаниями инструментов в каждой задаче. Три нужных сервера работают лучше десяти на всякий случай.

Проверяйте права. Сервер с доступом на запись делает то, что ему скажут. Начинать стоит с чтения, а запись добавлять осознанно - см. безопасность и разрешения.

Общая картина - гид по MCP.