MCP-сервер простыми словами
Агент для кода умеет работать с файлами в твоей папке и запускать команды. Всё, что за пределами папки - база знаний, задачи в трекере, дизайн в Figma, таблица с заявками, - ему недоступно, пока ты не скопируешь это руками в разговор. MCP-сервер убирает ручное копирование: он стоит между агентом и внешним сервисом и даёт агенту готовые инструменты - «найти в базе», «прочитать задачу», «открыть страницу».
Протокол MCP (Model Context Protocol) Anthropic представила 25 ноября 2024 года как открытый стандарт. На сайте протокола его сравнивают с разъёмом USB-C: как USB-C даёт один способ подключать разные устройства, так MCP даёт один способ подключать к агенту разные внешние системы. Сейчас протокол понимают Claude Code, Codex, Cursor, VS Code и многие другие программы.
Кто есть кто: агент, клиент, сервер, источник
- Агент (в терминах протокола - хост) - программа, с которой ты работаешь: Claude Code, Codex.
- Клиент - часть агента, которая держит соединение с одним сервером. На каждый подключённый сервер - свой клиент.
- MCP-сервер - программа, которая знает, как работать с конкретным сервисом, и отдаёт агенту его возможности по общему протоколу.
- Источник - сам сервис или данные: база, трекер, файлы, браузер.
Сервер бывает локальным - запускается на твоём компьютере как отдельная программа - и удалённым: работает в интернете, а агент обращается к нему по адресу.
Что сервер отдаёт агенту
По спецификации MCP сервер может отдавать три вида вещей.
- Инструменты - действия: найти, создать задачу, отправить сообщение, открыть страницу. Агент решает сам, когда их вызвать.
- Ресурсы - данные для чтения: документы, записи из базы, файлы.
- Промпты - готовые заготовки запросов под типовые задачи сервиса.
Сервер сам объявляет, что у него есть. Агент читает этот список при подключении, поэтому когда на сервере появляется новый инструмент, он появляется у всех подключённых агентов без переустановки.
MCP-сервер, API и плагин - в чём разница
| API сервиса | MCP-сервер | Плагин | |
|---|---|---|---|
| Что это | адреса и форматы запросов сервиса | программа-переходник по общему протоколу | пакет для конкретной программы |
| Для кого | для программиста | для агента | для пользователя одной программы |
| Как агент узнаёт возможности | читает документацию | сервер сам присылает список инструментов | зависит от программы |
| Работает в разных агентах | нет, под каждого пишут своё | да, если агент понимает MCP | нет, только в своей программе |
Плагин и MCP-сервер не конкуренты: плагин Claude Code может нести в себе настройку MCP-сервера вместе со скиллами и командами. Подробнее про плагины - в статье плагины для Claude Code.
Пример: что происходит, когда агент идёт в базу
Допустим, к агенту подключён сервер базы знаний, а ты пишешь: «найди в базе, как мы настраивали оплату, и повтори то же в этом проекте».
- Агент видит в своём списке инструмент поиска по базе - сервер объявил его при подключении.
- Агент вызывает инструмент с запросом «настройка оплаты».
- Сервер ищет в базе и возвращает найденные записи.
- Агент читает их, открывает файлы проекта и вносит правки по образцу.
Ты не копировал ни строчки: агент сам сходил за данными, когда они понадобились. В Claude Code схемы инструментов MCP по умолчанию подгружаются отложенно - в контексте лежат только имена, а полное описание агент берёт в момент вызова, поэтому подключённый сервер почти не занимает место, пока им не пользуются.
Как подключают MCP-сервер
Сама пошаговая инструкция с разбором ошибок - в статье MCP в Claude Code. Здесь - как это выглядит в общих чертах.
В Claude Code удалённый сервер подключается командой:
claude mcp add --transport http <имя> <адрес MCP-сервера>Если сервер требует ключ, его передают заголовком через --header. Для всей команды проекта настройку кладут в файл .mcp.json в корне проекта:
{
"mcpServers": {
"example": {
"type": "http",
"url": "<адрес MCP-сервера>",
"headers": { "Authorization": "Bearer ${EXAMPLE_TOKEN}" }
}
}
}Это общий образец, а не рабочая конфигурация: подставлять можно только адрес реально существующего сервера, полученный от его владельца. Обрати внимание на поле "type": "http" - документация Claude Code предупреждает, что запись с адресом, но без типа, считается ошибкой, и такой сервер будет пропущен.
В Codex удалённый сервер подключается командой codex mcp add <имя> --url <адрес>, а настройки хранятся в файле ~/.codex/config.toml.
Подключение базы ClaudeBase
Сервер подключения ClaudeBase работает: agent.claudebase.ru. Адрес, код доступа и страницу с инструкцией подписчик получает вместе с оплаченной подпиской - искать руками ничего не нужно. Каталог на сервере сейчас наполняется, поэтому часть материалов по-прежнему ставится в проект файлами: AGENTS.md, SKILL.md и связанные инструкции. Адреса с названием ClaudeBase, пришедшие не от нас, считай неподтверждёнными.
Какие MCP-серверы бывают
Серверы пишут и сами компании под свои сервисы, и сообщество. Примеры, которые приводит сама документация: на сайте протокола - календарь Google, Notion и Figma, из макета в которой Claude Code собирает веб-приложение; в документации Claude Code - команды подключения для Notion, Asana и Sentry. По смыслу серверы делятся на несколько групп.
- Рабочие сервисы - трекеры задач, базы знаний, календари, почта. Агент читает задачу и отчитывается о сделанном там же.
- Данные - базы данных и хранилища файлов. Агент ищет и читает записи, не выгружая их тебе в чат.
- Браузер - агент открывает страницы, нажимает кнопки и смотрит, что получилось. Полезно, чтобы проверить свою же вёрстку.
- Разработка - репозитории, сборки, мониторинг ошибок.
Прежде чем ставить сервер, спроси себя, какую ручную работу он уберёт. Если такой нет, сервер будет просто лишней строкой в настройках.
Частые ошибки
Ставить сервер из непроверенного источника. Сервер выполняет действия от твоего имени. Смотри, кто автор, есть ли исходный код, что именно сервер умеет.
Ключ в тексте промпта. Промпт уходит в модель и остаётся в истории. Ключ - только в настройках сервера или в переменной окружения.
Слишком широкие права. Серверу базы на чтение не нужны права на удаление. Давай минимум, который нужен под задачу.
Путать MCP-сервер с плагином или скиллом. Скилл - это инструкция, как делать задачу. MCP-сервер - это доступ к данным и действиям. Часто нужны оба: скилл объясняет порядок, сервер даёт инструменты.
Отключать все серверы «ради экономии». В Claude Code схемы инструментов и так подгружаются отложенно. Отключать стоит то, чем не пользуешься, - список смотрится командой /mcp.
Что почитать дальше
- MCP в Claude Code - подключение пошагово и частые ошибки.
- Агент для кода - зачем агенту инструменты вообще.
- Плагины для Claude Code - чем плагин отличается от сервера.
- Codex skills - как в Codex устроены плагины и скиллы.