Мастер Claude · Блок 6. MCP и интеграции

Урок 51 из 93 · ~10 мин чтения

Что такое MCP и зачем он нужен

Урок пока закрыт

Курс проходится последовательно.

К текущему уроку

Обновление, август 2026

Подключения, добавленные в claude.ai, теперь автоматически доступны в терминале, а авторизация делается командой claude mcp login <имя> без входа в панель /mcp.

Актуальная версия: Урок 83. MCP сегодня

Почему это важно именно вам

Вы работаете с данными, разбросанными по десятку систем. Notion с задачами, Google Sheets с аналитикой, почта с договорами, CRM с клиентами, GitHub с документацией разработчиков. Каждый раз, когда нужно что-то проанализировать или написать — сначала открываете нужную систему, копируете данные, вставляете в Claude, получаете ответ, идёте в следующую систему. Это не автоматизация, это ручной труд с красивым интерфейсом.

MCP меняет эту схему принципиально. Claude перестаёт быть текстовым редактором, в который вы вставляете данные вручную, и становится инструментом, который сам идёт за данными туда, где они хранятся. Вы говорите «посмотри задачи в Notion по проекту X и напиши статус-отчёт» — и Claude именно это и делает, без вашего участия в переносе данных.

Для директора, который тратит значительную часть времени на сборку информации из разных источников, это не просто удобство. Это разница между «я использую Claude как умный блокнот» и «у меня есть ИИ-ассистент, который реально работает с моими системами». Фаза 6 курса — про именно это: превратить Claude из умного текстового инструмента в полноценного участника ваших рабочих процессов.

Что это такое

Представьте, что у вас на столе стоит специалист, который умеет всё что угодно, но физически не может встать из-за стола. Чтобы он проверил что-то в Notion — вы должны сами зайти, скопировать нужное и принести ему на листочке. Он прочитает, обработает, скажет что делать — но обратно в Notion запись внести тоже придётся вам.

Именно так работает «голый» Claude без MCP. Он не может сам открыть вашу базу задач, не может зайти в GitHub, не может прочитать последние сообщения из Slack. Он работает только с тем, что вы вложили в контекст текущего разговора.

MCP (Model Context Protocol) — это протокол, который решает эту задачу. Если продолжать аналогию: это как дать специалисту USB-ключ от вашего кабинета, чтобы он мог сам зайти и взять нужный документ. Или, если точнее, MCP — это как USB-стандарт для подключения внешних инструментов к Claude. Так же как USB позволяет подключить к компьютеру что угодно — мышь, флешку, внешний диск — и всё это работает по единому стандарту, MCP позволяет подключить к Claude любой внешний инструмент по единому протоколу.

Технически MCP — это открытый стандарт, разработанный Anthropic, который описывает как именно внешние системы должны предоставлять свои функции языковой модели. Разработчики Notion, GitHub, Google Drive написали MCP-серверы, которые «переводят» возможности своих систем в формат, понятный Claude. Вы подключаете такой сервер — и Claude получает возможность работать с этой системой напрямую.

MCP — открытый стандарт, не проприетарная фича

MCP работает не только с Claude — любой ИИ-инструмент может поддерживать этот протокол. Это означает, что MCP-серверы, которые напишут разработчики сегодня, будут работать и с будущими моделями. Экосистема растёт быстро: сегодня готовых MCP-серверов уже сотни, проверенные коннекторы собраны в каталоге Anthropic для самых разных сервисов.

Важно понимать разницу между MCP-сервером и MCP-клиентом. Claude Code — это клиент: он умеет подключаться к MCP-серверам и использовать их возможности. MCP-серверы — это отдельные программы, которые предоставляют доступ к конкретным системам. Когда вы подключаете MCP-сервер Notion, вы по сути устанавливаете «переходник», через который Claude может обращаться к вашей Notion-базе.

Как работает на практике

Разберём полный цикл: от нуля до работающего инструмента на примере, актуальном для директора.

Шаг 1. Посмотреть, что уже подключено

Откройте терминал и выполните:

claude mcp list

Эта команда показывает все MCP-серверы, подключённые в текущем проекте. Если вы только начинаете, список будет пустым. Это нормально.

Шаг 2. Понять, как устроено подключение

MCP-серверы хранятся в конфигурации Claude Code. Есть три области видимости: local (по умолчанию — только этот проект, запись в ~/.claude.json), project (файл .mcp.json в корне проекта, уезжает в репозиторий вместе с кодом) и user (все ваши проекты, тоже ~/.claude.json). В settings.json MCP-серверы не прописываются вообще. Для рабочих инструментов удобнее всего добавлять на уровне проекта — тогда коллеги, открывшие тот же репозиторий, получат те же инструменты.

Каждый MCP-сервер — это, по сути, отдельная программа, которую Claude Code запускает рядом с собой. Эта программа говорит на языке MCP-протокола и сообщает Claude, какие инструменты она предоставляет. Например, MCP-сервер Notion сообщает: «Я умею создавать страницы, читать базы данных, обновлять записи». Claude видит эти возможности и может использовать их в разговоре, когда это нужно для выполнения вашей задачи. Вы при этом не пишете никакого кода — просто формулируете задачу на русском языке, а Claude сам решает, какой инструмент вызвать и с какими параметрами.

Шаг 3. Подключить первый MCP-сервер

Допустим, вы хотите подключить MCP-сервер для работы с файловой системой — это самый простой пример, который не требует сторонних аккаунтов:

claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem /Users/ваш_пользователь/Documents

Разберём команду по частям:
- claude mcp add — добавить новый сервер
- filesystem — имя, которое вы даёте этому серверу (любое)
- -- — разделитель между параметрами Claude и командой запуска сервера
- npx -y @modelcontextprotocol/server-filesystem — команда запуска сервера (официальный сервер для файловой системы)
- /Users/ваш_пользователь/Documents — папка, к которой даёте доступ

После этого выполните claude mcp list снова — новый сервер появится в списке.

Шаг 4. Использовать инструмент в сессии

Запустите Claude Code:

claude

В начале сессии Claude Code автоматически подключит все настроенные MCP-серверы. Чтобы проверить, какие инструменты доступны, введите в сессии:

/mcp

Вы увидите список подключённых серверов и доступных инструментов. Теперь можно работать:

Посмотри файлы в папке Documents и найди все документы, созданные в этом месяце

Claude сам зайдёт в папку, прочитает список файлов и вернёт результат — без того, чтобы вы что-то копировали.

/mcp показывает статус подключения

Команда /mcp в сессии — это диагностический инструмент. Если сервер запустился с ошибкой (например, нет нужного пакета npm), вы увидите это здесь. Проверяйте в первую очередь сюда, если инструменты не работают.

Шаг 5. Управление серверами

Удалить сервер:

claude mcp remove filesystem

Получить детали о конкретном сервере:

claude mcp get filesystem

Эти три команды — list, add, remove — покрывают 90% работы с MCP-конфигурацией. Остальное (тонкие настройки, переменные окружения для токенов) разберём в следующих уроках Фазы 6.

MCP-сервер запускается при старте сессии

Каждый раз, когда вы открываете Claude Code в папке с настроенными MCP-серверами, Claude Code автоматически запускает все серверы из конфига. Это означает, что если сервер требует внешний процесс (например, работающий Docker-контейнер или базу данных), он должен быть доступен в момент запуска.

Частые ошибки

Ошибка 1: Положить сервер с личным токеном в project scope

По умолчанию claude mcp add добавляет сервер в локальную конфигурацию текущего проекта. Но если добавить сервер с флагом --scope user, он будет доступен во всех ваших проектах. Проблема: глобальный Notion-сервер с вашими токенами у коллеги, который откроет проект, не только не будет работать — он будет мешать. Правило: корпоративные инструменты с токенами — scope local или user, а project только тогда, когда файл действительно должен уехать команде.

Ошибка 2: Дать MCP-серверу слишком широкий доступ

Когда подключаете сервер файловой системы, можно указать корень диска / — и технически это сработает. Claude получит доступ ко всем файлам на компьютере. Это плохая идея по двум причинам: безопасность (любой запрос сможет читать любые файлы) и производительность (Claude будет путаться в тысячах нерелевантных файлов). Правило: давайте доступ только к тем папкам, которые нужны для конкретной задачи.

Ошибка 3: Ждать магии без объяснения задачи

MCP даёт Claude инструменты, но не телепатию. «Посмотри мои данные» без уточнения — плохой запрос даже с подключённым Notion. Claude не знает, какую базу данных открыть, что искать и в каком виде нужен результат. Правило: с MCP-инструментами запрос должен быть таким же конкретным, как и без них. Разница в том, что Claude теперь сам пойдёт за данными, а не попросит вас их принести.

Ошибка 4: Путать MCP-сервер и MCP-клиент

Распространённое заблуждение: «установить MCP» — значит установить что-то внутри Claude Code. На самом деле MCP-сервер — это отдельная программа, которая работает рядом. Claude Code подключается к ней. Если сервер упал или не запустился — Claude Code не выдаст ошибку немедленно, он просто не будет видеть инструменты этого сервера. Команда /mcp в сессии показывает реальный статус.

Практическое следствие: если вы обновили MCP-сервер или изменили его конфигурацию, переподключите его командой /mcp reconnect <имя> — перезапускать сессию целиком не нужно. Claude Code сам переподключает удалённый сервер, если соединение оборвалось; локальные stdio-серверы он не поднимает автоматически.

Токены и секреты в MCP-конфигурации

Многие MCP-серверы требуют API-токены (для Notion, GitHub, Slack). Не вписывайте токены напрямую в команду claude mcp add — они попадут в ~/.claude.json (для local и user) или в .mcp.json (для project) открытым текстом. В следующих уроках разберём правильный способ: переменные окружения через --env. Пока — запомните правило: если MCP-сервер просит токен, нужно делать это правильно, а не быстро.

Когда нужно / когда нет

MCP нужен, когда:

MCP не нужен, когда:

MCP не заменяет hooks — они работают на разных уровнях

Hooks (Фаза 5) управляют тем, что происходит вокруг запросов к Claude: логирование, уведомления, контроль действий. MCP расширяет то, с чем Claude может работать: какие системы он видит и какие действия может совершать. Правильная архитектура использует оба инструмента: hooks контролируют процесс, MCP обеспечивает доступ к данным.

Связь с другими уроками

День 41 (Hooks: события) — хорошая точка сравнения. Hooks работают на уровне событий внутри Claude Code (запрос начался, инструмент вызван, ответ готов). MCP работает на уровне внешних систем (что Claude может видеть и делать). Понимание разницы помогает выбрать правильный инструмент для конкретной задачи.

День 21 (Субагенты и .claude/agents/) — субагенты становятся значительно мощнее с MCP. Агент-аналитик, который умеет сам читать из базы данных, и агент-редактор, который умеет сам смотреть задачи в Notion — это принципиально другой уровень автоматизации. Фаза 6 строится на том, что вы уже умеете из Фазы 3.

День 60 (Capstone) — финальный урок курса будет интегрировать всё: CLAUDE.md, агентов, hooks и MCP в единую рабочую систему. MCP — последний крупный блок перед этим. После того как разберётесь с MCP в днях 51-59, capstone встанет на своё место.

Задание на сегодня

Выполните одно действие: проверьте текущее состояние MCP в вашей установке Claude Code.

Откройте терминал, перейдите в рабочую папку (или любую другую) и выполните:

claude mcp list

Запустите сессию:

claude

И внутри сессии введите:

/mcp

Критерий «выполнено»: вы видите вывод обеих команд и понимаете, что он означает. Пустой список — это нормально и означает, что MCP-серверы пока не настроены. Следующие уроки Фазы 6 будут добавлять конкретные серверы один за другим.

Если в списке уже что-то есть (например, если кто-то настраивал Claude Code до вас или вы экспериментировали раньше) — запишите себе, что именно там есть. Это пригодится при дальнейшей настройке.

Резюме

Следующий урок откроется после отметки.