MCP простыми словами — как дать ИИ-агенту доступ к Notion, базе данных и другим сервисам
Содержание
MCP (Model Context Protocol) — это открытый стандарт, по которому ИИ-агент подключается к внешним сервисам: трекеру задач, базе данных, Notion, Figma, почте. Без MCP вы копируете данные из сервиса в чат и обратно. С MCP агент сам читает и меняет данные в подключённой системе. Удобно думать о MCP как о переходнике: один разъём, к которому можно подключить что угодно.
MCP поддерживают Claude Code, Codex, OpenCode, Cursor и другие инструменты.
Зачем это нужно — на примерах
Примеры задач из документации Claude Code, которые становятся возможны с MCP:
- «Сделай функцию из задачи в трекере и открой pull request на GitHub».
- «Посмотри в мониторинге, как используется эта функция».
- «Найди в базе 10 пользователей, которые пользовались этой функцией».
- «Обнови шаблон письма по новому макету из Figma».
- «Подготовь черновики писем этим пользователям».
Признак, что вам нужен MCP: вы постоянно копируете данные из другого сервиса в чат с ИИ. Подключите сервис — и агент возьмёт их сам.
Как подключить сервер в Claude Code
Облачный сервис, например Notion:
claude mcp add --transport http notion https://mcp.notion.com/mcp
Локальный сервер, который запускается на вашем компьютере:
claude mcp add --transport stdio имя -- команда-запуска
Всё после -- передаётся серверу как есть. Список подключённых серверов показывает claude mcp list, удаляет — claude mcp remove имя. Внутри сессии команда /mcp показывает состояние серверов и помогает войти в сервисы, которые требуют авторизации.
Где действует подключение
| Область | Где работает | Где хранится |
|---|---|---|
| Local (по умолчанию) | Только в текущем проекте, только у вас | ~/.claude.json |
| Project | В проекте, у всей команды | .mcp.json в корне проекта |
| User | Во всех ваших проектах | ~/.claude.json |
Область задаётся флагом --scope. Файл .mcp.json можно хранить в репозитории — тогда у всей команды будут одинаковые подключения. Перед первым использованием серверов из этого файла Claude Code спросит разрешение.
А в Codex и OpenCode?
Принцип тот же: сервер подключается в настройках агента, после чего агент видит его инструменты. В Codex MCP-подключения могут приходить и вместе с плагинами. Подробнее о том, как скиллы и плагины устроены в разных агентах, — в статье «Скиллы для Codex и OpenCode».
Безопасность: что проверить
- Подключайте только серверы, которым доверяете. MCP-сервер получает доступ к данным и действиям в вашем сервисе.
- Остерегайтесь серверов, которые тянут внешний контент: сайты, письма, документы. В таком контенте могут прятаться «инструкции» для ИИ — это называют prompt injection. Агент может принять их за ваши.
- Давайте минимальные права. Если агенту нужно только читать базу — дайте ключ только на чтение.
- Не храните токены в
.mcp.jsonоткрытым текстом, если файл попадает в репозиторий. Используйте переменные окружения: файл поддерживает подстановку вида${VAR}.
С чего начать
Подключите сервис, из которого чаще всего копируете данные в чат. Чаще всего это трекер задач или база заметок. Попросите агента что-то в нём найти и сравните, насколько быстрее стало.
Если вы ещё не работаете с ИИ-агентами — начните с Claude Code простыми словами или бесплатного OpenCode.
Больше практики
Какие MCP-серверы я подключаю к своим проектам и где они реально экономят время — рассказываю в Telegram-канале. Там же анонсы курсов по вайбкодингу.
Частые вопросы
Что такое MCP простыми словами?
Это стандартный способ подключить ИИ-агента к внешним сервисам — трекеру задач, базе данных, документам. Агент сам читает и меняет данные там, а не ждёт, пока вы их скопируете.
Как подключить MCP в Claude Code?
Командой claude mcp add. Для облачного сервиса: claude mcp add --transport http имя адрес. Проверить подключения — claude mcp list или /mcp внутри сессии.
Что такое .mcp.json?
Файл в корне проекта с подключениями MCP для всей команды. Его можно хранить в репозитории; перед первым использованием Claude Code спросит разрешение.
Безопасны ли MCP-серверы?
Настолько, насколько вы доверяете серверу. Подключайте проверенные, давайте минимальные права и будьте осторожны с серверами, которые загружают внешний контент.
Работает ли MCP в Codex и OpenCode?
Да, MCP — открытый стандарт, его поддерживают разные агенты. Подключение настраивается в настройках конкретного агента.