Зачем агенту протокол, если он и так читает файлы
Claude Code хорошо справляется с тем, что лежит на диске: читает файлы проекта, правит код, запускает команды. Но про ваш трекер задач, рабочую базу данных или содержимое браузера он не знает ничего - это отдельные системы за пределами файловой системы. MCP решает ровно эту задачу: это стандартный протокол, по которому агент сам обращается к внешней программе - без того, чтобы вы вручную копировали данные туда-обратно.
Три слоя Claude Code - и MCP только один из них
Частая ошибка новичка - искать MCP-сервер, чтобы Claude писал текст в вашем стиле. Провод тут не нужен: данные никуда ходить не должны, нужен скилл с вашими правилами. MCP нужен именно тогда, когда данные реально живут в другой системе.
Первый сервер за одну команду
Самый безопасный способ попробовать MCP - подключить сервер документации Claude Code: ему не нужны ни аккаунт, ни ключ, ни оплата.
claude mcp add --transport http claude-code-docs https://code.claude.com/docs/mcp
Строка «Added...» в ответе подтверждает только то, что запись сохранена в файл настроек - это не значит, что сервер работает. Реальный статус показывает отдельная команда:
claude mcp list
Цель - значок «Connected» напротив имени сервера. Если статус другой, значений всего пять, и по каждому есть понятное действие: от «нужна авторизация» до «сервер не ответил, проверьте адрес».
Область установки - самая частая путаница новичка
Таблица прокручивается вбок на телефоне →
| Область | Где сервер работает | Когда подходит |
|---|---|---|
local (по умолчанию) | Только в текущей папке проекта | Пробуете сервер впервые |
project | Только в этой папке, но видно всей команде через git | Над проектом работает несколько человек |
user | Во всех ваших проектах | Сервер нужен постоянно, не только здесь |
Жалоба «вчера сервер был, сегодня пропал» почти всегда объясняется этой таблицей: по умолчанию используется область local, привязанная к конкретной папке. Добавьте сервер с флагом --scope user, и он будет доступен из любого проекта.
Доступ, который стоит выдавать с осторожностью
MCP-сервер получает доступ к данным и может выполнять действия от вашего имени - это не мелкая техническая деталь, а прямое следствие того, зачем протокол вообще нужен. Сервер, который тянет внешний контент, теоретически способен подсунуть модели чужую инструкцию (тот же риск промпт-инъекции, что и у любого текстового источника). Разумная практика простая: подключайте серверы из проверенных каталогов, а не по случайной ссылке из чужого поста, и не давайте доступ к почте, деньгам или паролям серверу, назначение которого не до конца понятно.
Памятка перед первым подключением
- Начните с сервера, который не требует аккаунта и ключа - так вы отделите проблему с настройкой от проблемы с доступом.
- После добавления обязательно проверьте статус отдельной командой - «Added» не значит «работает».
- Решите заранее, нужен ли сервер только в этом проекте или во всех - это область установки, поменять её на лету нельзя.
- Не подключайте сервер с доступом к деньгам или переписке, если не понимаете, зачем ему такой доступ.
- Уберите сервер, которым не пользуетесь - каждый подключённый сервер занимает часть окна контекста в каждой сессии.