MCP для новичка: что это и как подключить к ИИ-агенту

MCP (Model Context Protocol) – это открытый стандарт, по которому ИИ-приложение подключается к внешним сервисам: файлам, базам данных, почте, трекеру задач. Вместо того чтобы писать отдельную связку под каждого агента и каждый сервис, вы подключаете один раз «сервер MCP», и любой клиент с поддержкой протокола получает его инструменты. Ниже: как это устроено, чем отличаются два способа подключения (stdio и Streamable HTTP), как добавить сервер в Claude Code, Codex и n8n и что нужно сделать, чтобы агент не получил лишних прав. Все данные взяты из официальной документации по состоянию на октябрь 2026.

Что такое MCP простыми словами

Официальное введение на modelcontextprotocol.io сравнивает MCP с портом USB-C: один стандартный разъём вместо набора разных кабелей. ИИ-приложения вроде Claude или ChatGPT могут через него подключаться к источникам данных (локальные файлы, базы), инструментам (поиск, калькуляторы) и готовым сценариям (специальные промпты).

Протокол сам по себе не «умный». Он только договаривается о том, как приложение спрашивает у сервера «что ты умеешь?» и как вызывает его функции. Решение, какой инструмент вызвать и с какими параметрами, принимает модель, а вы (или настройки прав) решаете, разрешён ли вызов.

Если вы ещё не знакомы с самим понятием агента, начните со статьи «Что такое ИИ-агент простыми словами»: MCP отвечает на вопрос, как дать такому агенту руки.

Как MCP устроен: хост, клиент, сервер

Спецификация (актуальная версия на сайте протокола: 2026-07-28) описывает обмен сообщениями в формате JSON-RPC 2.0 между тремя участниками:

• Хост: приложение с моделью, которое инициирует подключения. Например, Claude Code, приложение ChatGPT или редактор кода.
• Клиент: коннектор внутри хоста, который держит связь с одним сервером.
• Сервер: сервис, который предоставляет контекст и возможности.

Сервер может предложить три вида возможностей:

Возможность	Что это	Пример
Tools (инструменты)	Функции, которые вызывает модель	«создать задачу», «найти письма», «выполнить SQL-запрос»
Resources (ресурсы)	Данные и контекст для модели или пользователя	файл, страница документации, строка таблицы
Prompts (промпты)	Готовые шаблоны сообщений и сценариев для пользователя	шаблон «разбери обращение клиента»

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

Два способа подключения: stdio и Streamable HTTP

Спецификация определяет два стандартных транспорта. От выбора зависит, где работает сервер и как он проверяет, что вы это вы.

	stdio	Streamable HTTP
Где работает сервер	На вашем компьютере, его запускает сам клиент как отдельный процесс	Удалённо, по адресу (URL)
Как идёт обмен	Сообщения через стандартные потоки процесса	Каждое сообщение – HTTP-запрос POST на один адрес сервера, ответ приходит как JSON или потоком SSE
Авторизация	Данные берутся из переменных окружения	Если нужна авторизация, спецификация описывает вход по OAuth; на практике клиенты также принимают токены в заголовках
Когда выбирать	Доступ к локальным файлам, скриптам, базе на вашей машине	Облачные сервисы: трекеры, CRM, документы

Старый транспорт SSE в документации Claude Code помечен как устаревший: там рекомендуют HTTP-серверы, а SSE оставляют для сервисов, которые пока не перешли.

Как подключить сервер в Claude Code

Документация Claude Code на code.claude.com описывает три формы команды claude mcp add.

Удалённый HTTP-сервер (рекомендуемый вариант для облачных сервисов), пример из документации с Notion:

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

Тот же сервер с токеном в заголовке:

claude mcp add --transport http secure-api https://api.example.com/mcp --header "Authorization: Bearer your-token"

Локальный stdio-сервер. Двойной дефис отделяет параметры самого Claude Code от команды запуска сервера:

claude mcp add --env AIRTABLE_API_KEY=YOUR_KEY --transport stdio airtable -- npx -y airtable-mcp-server

Для управления серверами есть команды claude mcp list (список и статус подключения), claude mcp get <имя> (детали) и claude mcp remove <имя>. Внутри сессии команда /mcp показывает состояние серверов и позволяет пройти вход через OAuth.

Три области действия

Область	Где загружается	Видна команде	Где хранится
local (по умолчанию)	Только в текущем проекте	Нет	~/.claude.json
project	Только в текущем проекте	Да, через систему контроля версий	.mcp.json в корне проекта
user	Во всех ваших проектах	Нет	~/.claude.json

Область выбирается флагом --scope. Для серверов с личными ключами берите local или user, для общих командных настроек project. Серверы из .mcp.json Claude Code в интерактивном режиме сначала просит одобрить: чужой репозиторий не может подключить вам сервер молча.

Как подключить сервер в Codex

В документации Codex (learn.chatgpt.com) конфигурация MCP хранится в файле ~/.codex/config.toml, а для отдельного проекта в .codex/config.toml (только для доверенных проектов). Приложение ChatGPT для компьютера, консольный Codex и расширение для IDE используют одну и ту же конфигурацию.

Через консоль:

codex mcp add context7 -- npx -y @upstash/context7-mcp

Этот пример из документации добавляет Context7 – бесплатный сервер с документацией для разработчиков. Список серверов показывает codex mcp list, вход в сервер с OAuth выполняется командой codex mcp login <имя>, а в интерактивном режиме состояние видно по команде /mcp.

В приложении: Settings, затем MCP servers, Add server, укажите имя, выберите STDIO или Streamable HTTP, впишите команду или адрес и нажмите Restart. Для серверов с OAuth после этого появится кнопка Authenticate. Для тонкой настройки используется таблица [mcp_servers.<имя>] с полями command, args и env для stdio или url и bearer_token_env_var для HTTP. Токен лучше передавать через переменную окружения, а не вписывать в файл.

Какой из двух агентов выбрать, мы разбирали в статье «Claude Code или Codex».

MCP в n8n

В документации n8n есть два узла для работы с протоколом:

• MCP Client Tool подключает ИИ-агента n8n к внешнему MCP-серверу. Поддерживаются авторизация Bearer, по заголовку, по нескольким заголовкам и OAuth2. Поле «Tools to Include» позволяет отдать агенту все инструменты сервера, только выбранные или все, кроме перечисленных.
• MCP Server Trigger делает наоборот: превращает n8n в MCP-сервер, и внешние клиенты получают доступ к вашим инструментам и воркфлоу. Узел поддерживает SSE и Streamable HTTP, но не поддерживает stdio. Доступ можно закрыть Bearer-токеном или заголовком.

Пошаговую настройку агента с инструментами мы описали в статье «ИИ-агент в n8n пошагово».

Пример: подключаем один сервер за пять шагов

Возьмём Claude Code и удалённый HTTP-сервер вашего таск-трекера или документов.

1. Выберите один сервер и одну задачу. Например, «читать задачи и готовить сводку». Не подключайте сразу пять сервисов.
2. Найдите официальную инструкцию сервиса. Ищите адрес вида https://…/mcp. Серверы из каталога Anthropic Directory проверены, но доверие всё равно нужно оценить самому.
3. Добавьте сервер. claude mcp add --transport http имя адрес. Область по умолчанию local: сервер виден только вам и только в этом проекте.
4. Пройдите вход. Откройте /mcp, выберите сервер и авторизуйтесь через OAuth. В статусе, который показывает claude mcp list, должно быть «Connected».
5. Проверьте на безопасной задаче. Попросите агента только прочитать данные и показать результат. Запись и удаление включайте позже.

Каталог готовых серверов под типовые задачи мы собрали в обзоре «Лучшие MCP-серверы для ИИ-агентов».

Безопасность: права, токены, доверие

В спецификации прямо сказано, что MCP открывает доступ к данным и выполнению кода, а инструменты нужно считать потенциально опасными. Требования к приложениям такие: получать явное согласие пользователя на вызов инструмента и на передачу его данных серверу, а описаниям инструментов не доверять, если сервер не доверенный. Из этого следуют практические правила.

• Доверяйте только проверенным серверам. Сервер stdio запускается как программа на вашем компьютере с вашими правами. Это то же самое, что установить стороннюю программу. Документация Claude Code отдельно предупреждает: серверы, которые подтягивают внешний контент, открывают риск prompt injection, когда в письме или на странице спрятаны команды для агента. Пример такой атаки мы разбирали в новости о взломе агента Manus через письмо.
• Минимум прав. Создавайте для агента отдельный токен или учётную запись с доступом только к нужным данным. Если сервис умеет «только чтение», начинайте с него. В n8n ограничивайте список инструментов через «Tools to Include».
• Не храните токены в репозитории. Передавайте их переменными окружения (--env в Claude Code, bearer_token_env_var в Codex). Файл .mcp.json попадает в систему контроля версий, поэтому секреты в него вписывать нельзя.
• Оставляйте подтверждение действий. Для записи, отправки писем и удаления включайте ручное подтверждение, пока не убедитесь в поведении агента.
• Ведите журнал и имейте запасной путь. Если агент или сервер недоступны, процесс должен продолжаться вручную.
• Отзывайте доступ. Команда claude mcp remove удаляет сервер вместе с сохранёнными для него OAuth-токенами. Для сервисов без такой очистки отзывайте токен на стороне самого сервиса.

Частые ошибки новичков

• Слишком много серверов сразу. Каждый добавляет инструменты в контекст модели, агент хуже выбирает нужный. Начните с одного-двух.
• Ссылка без type. В файле конфигурации Claude Code запись с url, но без поля type считается ошибкой: добавьте "type": "http".
• Забытый двойной дефис. В команде для stdio без -- Claude Code попытается прочитать параметры сервера как собственные.
• Широкие права «на всякий случай». Токен администратора вместо токена только для чтения. Исправляйте сразу.
• Нет критерия успеха. Заранее решите, как поймёте, что подключение даёт пользу: время на задачу, число ошибок, доля ручной проверки.

Практические схемы работы с MCP и ИИ-агентами публикуем в Telegram: @aaakalsin.

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

MCP и API – это одно и то же?

Нет. API – это интерфейс конкретного сервиса. MCP – единый способ, которым ИИ-приложение узнаёт, какие функции есть у сервера, и вызывает их. Многие MCP-серверы внутри как раз обращаются к обычному API сервиса.

Нужно ли уметь программировать, чтобы подключить MCP?

Для готового сервера достаточно одной команды или формы в настройках приложения. Программирование нужно, если вы пишете собственный сервер. В документации Claude Code для этого есть плагин mcp-server-dev, который создаёт заготовку.

MCP работает только с Claude?

Нет. Официальное введение называет поддержку в Claude и ChatGPT, а также в редакторах вроде Visual Studio Code и Cursor. Один и тот же сервер можно подключать в разные клиенты.

Чем stdio отличается от HTTP, что выбрать новичку?

Если сервис облачный и у него есть адрес MCP, берите HTTP: вход через OAuth, ничего не нужно устанавливать. Если нужен доступ к файлам или программам на вашем компьютере, берите stdio.

Безопасно ли подключать чужие MCP-серверы?

Безопасность зависит от сервера. Локальный сервер выполняется с вашими правами, удалённый получает те данные, к которым вы дали доступ. Используйте серверы известных компаний, читайте запрашиваемые права и начинайте с режима «только чтение».

Можно ли использовать MCP в n8n без кода?

Да. Узел MCP Client Tool подключается к агенту n8n как обычный инструмент, а настройка сводится к адресу сервера и выбору способа авторизации.

Что делать, если сервер не подключается?

Проверьте статус командой claude mcp list или codex mcp list. Частые причины: неверный адрес, отсутствие входа через OAuth, не одобренный сервер из .mcp.json, опечатка в команде запуска stdio.