MCP в Claude Code: как подключить и дать только нужные права

Опубликовано 22.05.2026Обновлено 07.11.20268 мин чтенияСредний
Футуристический USB-C порт — центральный узел, от которого расходятся светящиеся потоки к иконкам разных сервисов.
Что узнаешь
  • Выбрать MCP под задачу и область действия подключения
  • Подключить сервер через HTTP или запустить локальную программу
  • Проверить права чтением данных и убрать ненужный доступ
Средний
805просмотров
1поделились

Чтобы подключить MCP в Claude Code, выберите сервер под задачу, добавьте его в нужной области действия и проверьте соединение и права: прочитайте через него знакомую страницу. Не используете MCP - отключите его.

С подключениями самого Claude Code тоже начинайте с задачи. Откуда берётся сервер, какие инструменты он даёт и какой способ входа необходим - на это стоит посмотреть перед установкой обязательно.

Короткий маршрут для Notion:

  1. Выберите задачу: прочитать страницу без изменений.
  2. Определите область действия подключения и из папки выбранного проекта выполните claude mcp add --transport http --scope local notion https://mcp.notion.com/mcp.
  3. Проверьте доступ: 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

  1. Сверьте адрес с официальной инструкцией Notion: https://mcp.notion.com/mcp.
  2. Выполните команду добавления:
bash
claude mcp add --transport http --scope local notion https://mcp.notion.com/mcp
  1. Перейдите к входу и проверке в следующем разделе.

--transport http выбирает HTTP; --scope local сохраняет личную настройку проекта. notion - имя записи, дальше - адрес сервера. Сообщение Added ... подтверждает сохранение настройки, но не доступ к странице.

Если нужна общая проектная настройка, вместо local используйте этот вариант:

bash
claude mcp add --transport http --scope project notion https://mcp.notion.com/mcp

Затем запустите claude интерактивно и проверьте запрос одобрения серверов из .mcp.json. Команда claude mcp reset-project-choices сбрасывает прежний выбор, если его нужно изменить.

Для личного подключения во всех проектах на машине используйте user:

bash
claude mcp add --transport http --scope user notion https://mcp.notion.com/mcp

Выберите нужную область; выполнять все варианты не требуется.

Локальная программа: пример с Playwright

Для задачи в браузере проверьте требования к среде запуска в README Microsoft, подготовьте её и добавьте сервер:

bash
claude mcp add --transport stdio --scope local playwright -- npx -y @playwright/mcp@latest

Слева от -- - параметры Code. Справа - npx и аргументы программы, которая запускается на машине Code. @latest означает, что версия пакета не закреплена.

Локальному серверу тоже могут понадобиться ключи внешнего сервиса: stdio не означает работу без авторизации. Playwright выбирайте для задачи в браузере, для чтения страницы Notion он не нужен.

Для удалённого подключения используйте HTTP там, где он доступен. SSE устаревает. После добавления настройки проверьте работу сервера.

Добавлен - ещё не работает: как проверить вход, права и данные?

Даем интеграциям только нужные права. Сначала проверьте сохранённую запись, затем вход, соединение и инструменты, после этого прочитайте выбранную страницу.

  1. Проверьте запись в той же папке проекта:
bash
claude mcp list
claude mcp get notion

Откройте /mcp внутри Code. Проверьте имя, адрес, параметры и состояние сервера. Если проектная запись ожидает одобрения, проверьте её содержимое и одобрите доверенный сервер в интерактивной сессии.

  1. Пройдите вход в Notion через /mcp и браузер. Альтернатива в оболочке:
bash
claude mcp login notion

Прочитайте разрешения перед согласием. Если они шире допустимого для вашей задачи, остановитесь. После входа проверьте, что выбранная страница открывается у вас в самом Notion: вход в аккаунт не даёт доступа к каждой странице.

  1. До вызова инструмента откройте /permissions. Права аккаунта в сервисе и правила вызова инструментов Code проверяются отдельно. Для первого чтения настройте запрос подтверждения, чтобы видеть инструмент и его аргументы до запуска. Автоматическое согласие на изменение данных не выдавайте.

Правила Code проверяются в порядке deny, ask, allow: запрет, запрос подтверждения, разрешение. Просмотрите действующие правила. Фраза «ничего не меняй» в запросе или CLAUDE.md не заменяет правил в /permissions и ограничений у поставщика.

  1. В /mcp проверьте соединение и доступные инструменты. Панель показывает их количество и отмечает серверы, которые заявили инструменты, но не предоставили ни одного. Если инструмента чтения нет, одного успешного входа недостаточно.

  2. Выберите несекретную страницу, содержимое которой вам известно. Дайте Code её ссылку или название и задание на чтение. Например:

Через инструменты сервера notion найдите и прочитайте страницу по этой ссылке. Верните её название и содержимое. Ничего не меняйте.

Подставьте ссылку на свою страницу. Проверьте имя инструмента и аргументы предложенного вызова. Если действие меняет данные или обращается к другой странице, не разрешайте его.

  1. Сверьте название и содержимое ответа с открытой страницей Notion. Вы должны увидеть вызов инструмента чтения и получить знакомые данные. Фразы агента «готово» недостаточно.

Sentry, например, позволяет ограничить подключение организацией и проектом через адрес сервера. У других поставщиков проверяйте, как ограничить доступ: дописывать похожие части пути к адресу Notion нельзя.

Если запись видна в нужном проекте, вход и соединение работают, а инструмент прочитал выбранную страницу, подключение проверено. Если нет - переходите к диагностике.

Кстати, я снял ролик «Полный гайд - Связка для первого агента Hermes Agent», обязательно посмотрите. В нём показываю подключения в Hermes; команды для Claude Code даны выше.

Видео загрузится при скролле
Полный гайд - Связка для первого агента Hermes Agent

Внутри - какие права давать агенту, где искать MCP и как не поставить вредный MCP. Это поможет проверить поставщика и разрешения перед следующим подключением.

Как защитить проект через разрешения Claude Code, посмотрите в отдельной статье.

Если после подключения хотите собрать свой проект с ИИ-агентами, посмотрите программу практикума СмыслоКода.

Практикум по вайб-кодингу
+Твой второй мозг
3 вечера - инструменты, метод, первый проект
Старт 24–26 ноября  ·  2 000 ₽
Записаться →

Не подключается: что проверить по сообщению сервера?

Начните с 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-доступ, сначала выполните:

bash
claude mcp logout notion

Затем удалите запись выбранной области:

bash
claude mcp remove notion --scope local
claude mcp list

Если имя осталось в списке, проверьте одноимённое подключение в другой области. Для project или user в команде удаления укажите соответствующую область.

remove убирает настройку и локально сохранённые OAuth-данные удалённого сервера. Уже выданные сервисом токены эта команда сама не отзывает. logout запрашивает отзыв там, где он поддерживается. Чтобы прекратить доступ, проверьте его состояние и на стороне сервиса. Выключенный переключатель в Code тоже не отзывает разрешения у поставщика.

Отключайте лишнее, чтобы контролировать доступ. Гарантированной экономии токенов это не обещает: поиск инструментов, tool search, откладывает загрузку их описаний до запроса. Нельзя считать, что все описания всегда целиком отправляются при каждом обращении.

Подробнее о том, как tool search находит нужный MCP-инструмент, - в отдельной статье.

Частые вопросы

Какую задачу хотите дать агенту: читать страницы, работать в браузере или что-то другое? Напишите в комментариях в канале, какое подключение выбираете и на какой проверке остановились.

Источники

Практикум по вайб-кодингу
+Твой второй мозг
3 вечера - инструменты, метод, первый проект
Старт 24–26 ноября  ·  2 000 ₽
Записаться →

Новые материалы - дайджестом, без спама

Гайды выходят регулярно. Подпишись, чтобы не пропускать: пришлю подборку в Telegram или на email. Раз в неделю или каждый день - выбираешь сам.

Была инструкция полезна?
Артемий Миллер
Автор
Артемий Миллер
Предприниматель и вайб-кодер

Артемий Миллер - предприниматель и вайб-кодер. Бывший программист, собирает продукты исключительно вместе с ИИ-агентами, без найма разработчиков.

Связанные инструкции

Claude in Chrome: как установить и дать первую задачу

Установите Claude in Chrome из официального магазина и выберите ручное одобрение действий. Начните с пересказа публичной страницы и сверьте ответ с её текстом.

9 мин

OpenCode Agents: исполнитель делает, проверяющий принимает

В OpenCode исполнитель готовит результат, отдельный reviewer принимает его по брифу и эталону. Задайте ему модель, разрешите чтение нужных файлов и проверьте запреты до работы с реальными данными.

7 мин

Как сделать ИИ-мультик: первый ролик с навыком «Мультик»

Первый ИИ-мультик можно собрать с навыком «Мультик» для Claude Code: от темы и постоянного героя до вертикального MP4. Сам навык открытый; доступ к модели, разборы и клон голоса оплачиваются отдельно.

9 мин

Как собрать продукт с помощью ИИ за 2 дня: навык «Сделай мне функцию»

Собрать продукт с помощью ИИ можно одним промптом: так Артемий собрал Viralex AI за 2 дня и Гамбитик, шахматы для детей. Делает это бесплатный навык «Сделай мне функцию»: обсуждает идею, ищет готовые решения на GitHub, выбирает лучшее, пишет архитектуру и план, запускает субагентов, проверяет тестами и выкладывает.

9 мин

Связанные термины