Обновление, август 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 нужен, когда:
- У вас есть повторяющаяся задача, которая требует данных из конкретной системы. «Каждую неделю смотрю задачи в Notion и пишу статус-отчёт» — идеальный кандидат.
- Данные меняются, и копирование их вручную каждый раз утомительно или приводит к ошибкам.
- Нужно соединить данные из нескольких систем в одном запросе. Claude с MCP-серверами для Notion и Google Sheets может читать задачи и сопоставлять их с данными таблиц в одном разговоре.
- Вы уже понимаете задачу хорошо и хотите автоматизировать сбор данных, а не думать над тем, что именно нужно искать.
MCP не нужен, когда:
- Задача разовая. Скопировать данные один раз — это не проблема, которую нужно решать архитектурой.
- Данные легко и надёжно передаются текстом. Если вы работаете с конкретным документом, который уже у вас в руках — просто вставьте его в контекст.
- Система, к которой хотите подключиться, не имеет готового MCP-сервера, и вы не готовы его создавать. В этом случае лучше использовать hooks (Days 41-50) для автоматизации передачи данных.
- Данные конфиденциальны настолько, что вы не готовы настраивать постоянный программный доступ к ним. 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 до вас или вы экспериментировали раньше) — запишите себе, что именно там есть. Это пригодится при дальнейшей настройке.
Резюме
- MCP — открытый протокол для подключения внешних инструментов к Claude. Аналогия: USB-стандарт, только для ИИ и внешних сервисов.
- Без MCP Claude работает только с данными, которые вы вложили в контекст вручную. С MCP — сам читает Notion, GitHub, базы данных, файловую систему.
- Базовые команды:
claude mcp list— посмотреть подключённые серверы;claude mcp add— добавить;claude mcp remove— удалить. Команда/mcpвнутри сессии показывает статус подключения. - Токены для MCP-серверов нельзя вписывать открытым текстом в конфигурацию — правильный способ через переменные окружения разберём в следующих уроках.
- MCP не заменяет hooks и агентов — это разные уровни системы. MCP даёт доступ к данным, hooks управляют процессом, агенты определяют поведение.