MCP простыми словами
Если ты уже видел это сокращение в гайдах по Claude Code и ничего не понял, это нормально. Разберём без терминов.
Claude Code из коробки умеет одно: читать и менять файлы в папке проекта, запускать команды в терминале и работать с Git. Он ничего не знает про твой Google Диск, твою CRM или базу данных, если ты сам не покажешь ему эти данные текстом.
MCP это открытый протокол, что-то вроде универсального переходника между Claude Code и внешними сервисами. Ещё проще: обычная интеграция связывает две конкретные системы, эту с этой CRM, и если одна сторона сломается, чинить придётся связку целиком, а каждый новый сервис требует новой связки. MCP устроен как общая розетка: сервис один раз открывает наружу набор инструментов, а любая модель, которая этот протокол поддерживает, ими пользуется.
То есть один и тот же MCP-сервер, например для работы с таблицами или с Figma, одинаково работает с Claude Code, с Cursor и с чем угодно ещё, что появится через полгода.
Что это реально даёт агенту
Без MCP Claude Code отвечает и пишет код только на основе того, что ты вставил в чат руками.
Без MCP ИИ-ассистент умеет только отвечать на вопросы и генерировать текст. С MCP он получает руки: читает ваши файлы, ищет данные в интернете, правит код и отправляет письма.
Пример из практики: ты подключил Google Drive MCP-сервер, пишешь в чат «найди на диске все файлы с названием «контент-план» за последние 3 месяца и покажи список тем из каждого», Claude обращается к серверу, тот запрашивает Google Drive через твой аккаунт, и через несколько секунд ты получаешь сводку тем из файлов с датами и ссылками на документы. Без MCP пришлось бы открывать каждый файл вручную и копировать текст в чат.
Figma → код
Агент читает структуру макета, а не скриншот, и собирает верстку по реальным отступам и цветам.
Файловая система
Агент читает и сохраняет файлы в конкретной папке на компьютере, а не только внутри проекта.
Похожая идея есть и у российских сервисов: агент про данные в 1С, Битриксе или МойСкладе ничего не знает и знать не может, MCP решает это тем, что даёт модели доступ к внешней системе так, чтобы она умела не только читать данные, но и совершать в ней действия.
Как подключить первый MCP-сервер
Разберём на примере встроенной команды Claude Code, без сторонних сервисов и ключей.
- Открой терминал в папке проекта, где уже установлен и работает Claude Code.
- Проверь, что у тебя стоит окружение, которое требует сервер: Node.js или Python, зависит от конкретного сервера, это программная среда, которую большинство серверов требуют для запуска.
- Добавь сервер одной командой. Основной синтаксис: claude mcp add имя команда аргументы. Практический пример, добавление доступа к локальной файловой системе: claude mcp add my-filesystem -- npx -y @modelcontextprotocol/server-filesystem ~/Documents
- Проверь, что он подключился.
claude mcp add my-filesystem -- npx -y @modelcontextprotocol/server-filesystem ~/Documents
Added my-filesystem
claude mcp list
my-filesystem: connected
Каждая команда claude mcp add и claude mcp add-json выводит строку Added. Чтобы проверить, что Claude Code подключился, запусти claude mcp get имя-сервера. Управлять серверами дальше можно теми же командами: список всех настроенных серверов, детали конкретного сервера и удаление сервера, если он больше не нужен. Прямо в сессии Claude Code есть команда /mcp, она показывает какие серверы подключены, какие ещё грузятся, какие упали.
Частые ошибки при подключении
Три ситуации, которые встречаются почти у всех на первом сервере.
| Что видишь | Что делать |
|---|---|
| Сервер добавлен, но в чате как будто не работает | Скорее всего забыл перезапустить Claude Code после изменения конфига, изменения не применяются на лету, только после рестарта. |
| Сервер падает или пишет ошибку авторизации | Проверь, что переменная окружения с API-ключом прописана правильно в блоке env. |
| Сервер несколько раз не запустился и отключился сам | Статус виден в /mcp, там же можно перезапустить сервер вручную. |
Ещё один вариант первой проверки, который советуют в гайдах по MCP: запустить команду сервера напрямую в терминале, чтобы проверить её вывод, это быстро показывает, работает ли сервер сам по себе, до всякого Claude Code.
Нужно ли это тебе прямо сейчас
Честный ответ: почти наверняка нет, если ты только начал.
Claude Code и без единого MCP-сервера отлично пишет код, читает и правит файлы твоего проекта, работает с Git. MCP нужен, когда агенту не хватает данных или доступа, которых нет в самом проекте, например, доступ к таблице в Google Docs, к дизайну в Figma или к переписке в мессенджере.
Разработчики, которые уже давно на этом сидят, советуют именно такой порядок: поставить агента, задать три вопроса про свой текущий проект, сделать одну мелкую правку с проверкой диффа, завести CLAUDE.md, и только после этого подключать MCP-серверы.
И даже когда дойдёшь до этого шага, не старайся охватить всё сразу: выбери одну точку боли, обычно это база данных или трекер задач, и начни с неё, разберись как это меняет работу, потом добавляй второй сервер.
Что проверить, прежде чем подключать чужой сервер
MCP-сервер это чужой код, который получает доступ к твоим файлам или аккаунтам. Стоит проверять его так же осторожно, как любую программу, которую ставишь с чужого сайта.
- Добавляй только проверенные MCP-серверы, особенно те, которым требуется доступ к сети.
- Регулярно очищай список: убирай неиспользуемые серверы, если ими больше не пользуешься.
- Делай резервную копию файла конфигурации, где хранятся настройки серверов, на всякий случай.
- Не вставляй свои настоящие пароли и ключи в переписку с агентом, чтобы он «сам разобрался», в чём подключать MCP-сервер, а не показывать секреты текстом.