Чтобы подключить MCP в Claude Code, выберите сервер под задачу, добавьте его в нужной области действия и проверьте соединение и права: прочитайте через него знакомую страницу. Не используете MCP - отключите его.
С подключениями самого Claude Code тоже начинайте с задачи. Откуда берётся сервер, какие инструменты он даёт и какой способ входа необходим - на это стоит посмотреть перед установкой обязательно.
Короткий маршрут для Notion:
- Выберите задачу: прочитать страницу без изменений.
- Определите область действия подключения и из папки выбранного проекта выполните
claude mcp add --transport http --scope local notion https://mcp.notion.com/mcp. - Проверьте доступ:
claude mcp listв оболочке,/mcpвнутри Code. Вход через браузер, проверка прав и чтения - в подробных шагах ниже.
Что вам нужно от MCP и нужен ли он вообще?
Сформулируйте действие: прочитать страницу Notion, выполнить задачу в браузере через Playwright MCP от Microsoft или получить компоненты дизайна через Figma MCP. Сервер сообщает агенту, какие инструменты доступны. Выбирайте те, которые нужны для вашей задачи, и давайте интеграции только нужные права.
Для файлов проекта отдельный сервер Filesystem может оказаться лишним. Code уже умеет читать и менять файлы и запускать Bash. Если нужна другая рабочая папка, проверьте встроенный --add-dir: он добавляет папки для чтения и редактирования. Выбирайте конкретную папку, чтобы не давать доступ к лишним файлам.
Если Code не видит нужную папку, в отдельной статье посмотрите, что мешает доступу и как это проверить.
Пример карточки выбора:
| Поле | Пример для Notion |
|---|---|
| Задача | Прочитать заранее выбранную несекретную страницу без изменений |
| Поставщик и источник | Notion, официальная инструкция |
| Нужные инструменты | Поиск и чтение выбранной страницы; точные имена смотреть после подключения в своей панели |
| Способ входа | OAuth - вход через браузер с подтверждением доступа |
| Допустимые права | Проверить разрешения при входе и доступ аккаунта к самой странице; в Code контролировать вызовы инструментов |
До запуска проверьте автора, адрес, команду и разрешения. Ставим только проверенные подключения. Даже от доверенного поставщика может прийти содержимое с вредоносными инструкциями для агента.
Задача в карточке - чтение. Согласие на OAuth само по себе не запрещает изменения в Notion.
Если выбираете подключения для своего агента, загляните в канал:
Где будет виден сервер: local, project или user?
Для личного подключения в текущем проекте подойдёт local.
| Область | Кто и где видит | Где хранится | Когда выбрать |
|---|---|---|---|
local | Только вы в текущем проекте | ~/.claude.json, запись под путём проекта | Личное подключение; вариант по умолчанию |
project | Пользователи текущего проекта с общей настройкой | .mcp.json в корне проекта | Совместная работа после проверки содержимого |
user | Вы во всех проектах на этой машине | ~/.claude.json | Личное подключение, нужное повсюду |
HTTP тоже можно сохранить в local. Транспорт задаёт способ связи с сервером, область действия - в каких проектах доступна настройка.
Серверы из .mcp.json нужно одобрить в интерактивной сессии. В claude -p и Agent SDK этого диалога нет.
Если имя повторяется, Code выбирает запись в порядке local, project, user. Берётся вся запись выбранного уровня, поля не смешиваются. Проверьте, какой адрес и параметры действуют, через claude mcp get notion.
Как подключить сервер: HTTP или локальная программа?
Code уже должен запускаться командой claude. Команды claude mcp ... выполняйте в оболочке из папки проекта, /mcp и /permissions - внутри интерактивной сессии Code. У вашего аккаунта должен быть доступ к выбранной странице сервиса.
HTTP: пример с Notion
- Сверьте адрес с официальной инструкцией Notion:
https://mcp.notion.com/mcp. - Выполните команду добавления:
claude mcp add --transport http --scope local notion https://mcp.notion.com/mcp- Перейдите к входу и проверке в следующем разделе.
--transport http выбирает HTTP; --scope local сохраняет личную настройку проекта. notion - имя записи, дальше - адрес сервера. Сообщение Added ... подтверждает сохранение настройки, но не доступ к странице.
Если нужна общая проектная настройка, вместо local используйте этот вариант:
claude mcp add --transport http --scope project notion https://mcp.notion.com/mcpЗатем запустите claude интерактивно и проверьте запрос одобрения серверов из .mcp.json. Команда claude mcp reset-project-choices сбрасывает прежний выбор, если его нужно изменить.
Для личного подключения во всех проектах на машине используйте user:
claude mcp add --transport http --scope user notion https://mcp.notion.com/mcpВыберите нужную область; выполнять все варианты не требуется.
Локальная программа: пример с Playwright
Для задачи в браузере проверьте требования к среде запуска в README Microsoft, подготовьте её и добавьте сервер:
claude mcp add --transport stdio --scope local playwright -- npx -y @playwright/mcp@latestСлева от -- - параметры Code. Справа - npx и аргументы программы, которая запускается на машине Code. @latest означает, что версия пакета не закреплена.
Локальному серверу тоже могут понадобиться ключи внешнего сервиса: stdio не означает работу без авторизации. Playwright выбирайте для задачи в браузере, для чтения страницы Notion он не нужен.
Для удалённого подключения используйте HTTP там, где он доступен. SSE устаревает. После добавления настройки проверьте работу сервера.
Добавлен - ещё не работает: как проверить вход, права и данные?
Даем интеграциям только нужные права. Сначала проверьте сохранённую запись, затем вход, соединение и инструменты, после этого прочитайте выбранную страницу.
- Проверьте запись в той же папке проекта:
claude mcp list
claude mcp get notionОткройте /mcp внутри Code. Проверьте имя, адрес, параметры и состояние сервера. Если проектная запись ожидает одобрения, проверьте её содержимое и одобрите доверенный сервер в интерактивной сессии.
- Пройдите вход в Notion через
/mcpи браузер. Альтернатива в оболочке:
claude mcp login notionПрочитайте разрешения перед согласием. Если они шире допустимого для вашей задачи, остановитесь. После входа проверьте, что выбранная страница открывается у вас в самом Notion: вход в аккаунт не даёт доступа к каждой странице.
- До вызова инструмента откройте
/permissions. Права аккаунта в сервисе и правила вызова инструментов Code проверяются отдельно. Для первого чтения настройте запрос подтверждения, чтобы видеть инструмент и его аргументы до запуска. Автоматическое согласие на изменение данных не выдавайте.
Правила Code проверяются в порядке deny, ask, allow: запрет, запрос подтверждения, разрешение. Просмотрите действующие правила. Фраза «ничего не меняй» в запросе или CLAUDE.md не заменяет правил в /permissions и ограничений у поставщика.
-
В
/mcpпроверьте соединение и доступные инструменты. Панель показывает их количество и отмечает серверы, которые заявили инструменты, но не предоставили ни одного. Если инструмента чтения нет, одного успешного входа недостаточно. -
Выберите несекретную страницу, содержимое которой вам известно. Дайте Code её ссылку или название и задание на чтение. Например:
Через инструменты сервера notion найдите и прочитайте страницу по этой ссылке. Верните её название и содержимое. Ничего не меняйте.
Подставьте ссылку на свою страницу. Проверьте имя инструмента и аргументы предложенного вызова. Если действие меняет данные или обращается к другой странице, не разрешайте его.
- Сверьте название и содержимое ответа с открытой страницей Notion. Вы должны увидеть вызов инструмента чтения и получить знакомые данные. Фразы агента «готово» недостаточно.
Sentry, например, позволяет ограничить подключение организацией и проектом через адрес сервера. У других поставщиков проверяйте, как ограничить доступ: дописывать похожие части пути к адресу Notion нельзя.
Если запись видна в нужном проекте, вход и соединение работают, а инструмент прочитал выбранную страницу, подключение проверено. Если нет - переходите к диагностике.
Кстати, я снял ролик «Полный гайд - Связка для первого агента Hermes Agent», обязательно посмотрите. В нём показываю подключения в Hermes; команды для Claude Code даны выше.
Внутри - какие права давать агенту, где искать MCP и как не поставить вредный MCP. Это поможет проверить поставщика и разрешения перед следующим подключением.
Как защитить проект через разрешения Claude Code, посмотрите в отдельной статье.
Если после подключения хотите собрать свой проект с ИИ-агентами, посмотрите программу практикума СмыслоКода.
Не подключается: что проверить по сообщению сервера?
Начните с claude mcp get notion в нужной папке и /mcp. Формулировки состояний зависят от версии клиента.
| Что видите | Возможная причина | Следующее действие | Как проверить исправление |
|---|---|---|---|
| Имени сервера нет | Другая папка или область; действует одноимённая запись | Сверьте папку и запись через claude mcp get notion с таблицей областей | В нужном проекте видны ожидаемая запись и адрес; затем проверьте соединение |
Pending approval | Общая проектная запись ждёт решения | Запустите интерактивный claude в проекте, проверьте запись и одобрите доверенный сервер | Ожидание одобрения исчезло; связь проверяется отдельно |
Needs authentication | Вход ещё не выполнен | Выполните claude mcp login notion | Требование входа снято; затем проверьте инструменты |
Failed to connect | Причина указана сервером | Откройте claude mcp get notion и прочитайте Issue: | После исправления указанной причины восстановлены соединение и инструменты |
| Связь есть, нужных данных нет | Возможно, выбрана другая страница, не хватает прав или вызван другой инструмент | Сверьте доступ к странице и разрешение вызванного инструмента | Чтение нужным инструментом возвращает знакомые данные выбранной страницы |
В Issue: может быть HTTP-ошибка, проблема транспорта или запуска, незаданный URL, отсутствующая переменная окружения. Исправьте указанную причину, прежде чем переустанавливать сервер.
Если явно переданный токен авторизации отклонён, возможна ошибка соединения. Проверьте токен вместо повторного OAuth. Действующие ключи и заголовки авторизации не публикуйте.
Не используете MCP - отключите его. Когда удалить совсем?
Временно отключить сервер, удалить настройку и отозвать доступ - разные действия.
Если подключение пока не нужно, выключите его в /mcp и проверьте отметку disabled. Настройка сохранится, выбор запишется для проекта в ~/.claude.json.
Если сервер больше не нужен, выясните область его записи. Для Notion из основного примера это local. Когда требуется отозвать OAuth-доступ, сначала выполните:
claude mcp logout notionЗатем удалите запись выбранной области:
claude mcp remove notion --scope local
claude mcp listЕсли имя осталось в списке, проверьте одноимённое подключение в другой области. Для project или user в команде удаления укажите соответствующую область.
remove убирает настройку и локально сохранённые OAuth-данные удалённого сервера. Уже выданные сервисом токены эта команда сама не отзывает. logout запрашивает отзыв там, где он поддерживается. Чтобы прекратить доступ, проверьте его состояние и на стороне сервиса. Выключенный переключатель в Code тоже не отзывает разрешения у поставщика.
Отключайте лишнее, чтобы контролировать доступ. Гарантированной экономии токенов это не обещает: поиск инструментов, tool search, откладывает загрузку их описаний до запроса. Нельзя считать, что все описания всегда целиком отправляются при каждом обращении.
Подробнее о том, как tool search находит нужный MCP-инструмент, - в отдельной статье.
Частые вопросы
Какую задачу хотите дать агенту: читать страницы, работать в браузере или что-то другое? Напишите в комментариях в канале, какое подключение выбираете и на какой проверке остановились.
Источники
- Anthropic: MCP - команды, области, вход, диагностика, отключение, поиск инструментов.
- Anthropic: разрешения - правила вызова инструментов.
- Anthropic: командная строка - встроенные инструменты, --add-dir.
- Notion: MCP - адрес сервера, OAuth.
- Microsoft: Playwright MCP - команда подключения.
- Sentry: MCP - ограничение организацией и проектом.
Новые материалы - дайджестом, без спама
Гайды выходят регулярно. Подпишись, чтобы не пропускать: пришлю подборку в Telegram или на email. Раз в неделю или каждый день - выбираешь сам.

