MCP для Claude Code: как добавить первый сервер и проверить, какие данные видит агент
MCP-сервер добавляет Claude Code новые инструменты: например, чтение страниц из рабочего пространства или запросы к внешнему сервису. Это удобно, но меняет границу доступа. Первая интеграция должна быть тестовой, с минимальными правами и данными, которые не жалко показать модели.
Начните не с рабочего пространства
Создайте отдельную тестовую страницу в сервисе, который хотите подключить. Добавьте туда вымышленные данные: описание учебного проекта, три задачи и одну дату. Не используйте документы клиентов, пароли, финансовые таблицы и внутреннюю переписку.
Для примера подойдет официальный удаленный MCP-сервер Notion. Он поддерживает авторизацию через браузер. Перед подключением проверьте текущий адрес сервера в документации Anthropic или поставщика.
Добавьте сервер в Claude Code
Из папки учебного проекта выполните команду добавления удаленного сервера:
claude mcp add --transport http notion https://mcp.notion.com/mcp
Затем откройте Claude Code и выполните /mcp. Интерфейс предложит авторизоваться. На экране согласия внимательно прочитайте, к какому пространству и каким действиям предоставляется доступ.
Не передавайте токен в аргументе командной строки, если сервер поддерживает OAuth. Аргументы могут сохраняться в истории оболочки и журналах.
Выберите правильную область настройки
Claude Code различает области подключения. Локальная настройка относится только к текущему проекту и пользователю. Проектная может быть записана в файл и попасть в репозиторий. Пользовательская действует шире.
Для первого опыта используйте локальную область. Общую конфигурацию стоит добавлять только после командного согласования. В ней не должно быть секретов, даже если репозиторий закрытый.
Посмотрите список инструментов
Через /mcp проверьте статус сервера и доступные инструменты. Названия операций показывают больше, чем рекламное описание. Если среди них есть создание, обновление или удаление страниц, считайте подключение потенциально пишущим, даже если планируете только чтение.
Дайте Claude Code ограниченный запрос:
Используй только сервер notion. Найди тестовую страницу «MCP sandbox», прочитай ее и перечисли заголовки. Ничего не создавай и не изменяй. Перед вызовом инструмента назови его и объясни, какие данные будут отправлены.
Сравните ответ с содержимым страницы. Затем спросите, какие еще страницы доступны через поиск, но запретите открывать результаты. Так можно заметить слишком широкую область доступа без чтения самих документов.
Проверьте журнал действий
Claude Code показывает вызовы инструментов и запрашивает разрешения в зависимости от настроек. Прочитайте аргументы вызова: поисковый запрос, идентификатор страницы и запрошенную операцию. Не подтверждайте действие записи ради проверки соединения.
После теста откройте настройки интеграции в самом сервисе. Убедитесь, что разрешение относится к ожидаемому аккаунту. Если доступ оказался шире, отзовите его и создайте отдельное пространство или учетную запись.
Когда MCP действительно нужен
Не подключайте сервер, если достаточно скопировать один абзац в задачу. MCP оправдан, когда агент регулярно обращается к меняющимся данным или выполняет повторяемую операцию. Каждая интеграция добавляет зависимость, права и еще одно место для утечки.
В полноценной разработке такие подключения нужно сочетать с Git, тестами и безопасной работой с секретами. На курсе «Вайбкодинг на максималках» "Вайбкодинг на максималках" эти основы проходят в рамках собственного проекта. Отдельного обещания научить конкретному Notion MCP здесь нет; связь состоит в управлении доступами и проверяемом цикле работы.
Первый MCP-сервер настроен корректно, если вы знаете его область, видите список доступных действий, проверили чтение на искусственных данных и умеете отозвать разрешение после эксперимента.