Что такое MCP: как приложение подключает инструменты и данные
Разбираем MCP на примере справочника: роли хоста, клиента и сервера, обнаружение инструмента, передача результата, совместимость и проверка ошибок. Код на Python.
Коротко
MCP (Model Context Protocol) — протокол обмена между AI-приложением и сервером, который предоставляет инструменты или данные. Например, один сервер справочника описывает функцию поиска, а редактор и рабочий чат вызывают её по общим правилам.
- Хост отвечает за интерфейс, выбор подключений и права. Клиент внутри хоста обменивается сообщениями с сервером.
- Инструмент выполняет операцию, ресурс адресует данные, шаблон предлагает готовый запрос.
- Сверяйте поддерживаемую редакцию протокола и транспорт. Похожий адрес ещё не означает совместимость.
- Разделяйте недоступность связи, ошибку запроса и отказ внешнего сервиса. Пользователю нужны разные объяснения этих случаев.
Два приложения и один справочник
Сотруднику нужен ответ «До какого времени можно попросить смену адреса у заказа?» Текст находится в разделе POL-18 внутреннего справочника. Команда хочет открывать этот раздел и из рабочего чата, и из редактора. Оба приложения уже умеют отправлять вопросы своим моделям. У каждого свой интерфейс и правила, а поиск по справочнику один.
Хост — это чат или редактор целиком. Он выбирает, кому доступен справочник и что показать пользователю. MCP-клиент — компонент внутри хоста, который общается с подключённым сервером. MCP-сервер представляет возможность поиска и получения документов. Он переводит запрос в вызов справочника, учитывает доступ и возвращает результат по протоколу. Наличие общего протокола не обязывает чат и редактор использовать одну языковую модель.
Разделите два обмена. Между моделью и приложением может работать tool calling. Модель просит функцию поиска, а хост преобразует её запрос в вызов MCP-клиента. Между клиентом и сервером действуют сообщения MCP. Хост также может открыть ресурс по нажатию кнопки и обойтись без модели. В обоих случаях сервер получает только явно переданные данные. Подключение справочника само по себе не отправляет в него историю разговора.
Что сервер предоставляет
| Возможность | Что получает хост | Пример справочника |
|---|---|---|
| Tool, инструмент | Именованное действие со схемой входа | find_policy ищет правило по теме и региону |
| Resource, ресурс | Данные с адресом URI | policy://ru/POL-18 открывает известный документ |
| Prompt, шаблон | Переиспользуемый шаблон взаимодействия | «Сравнить два раздела по номеру редакции» |
В описании инструментов MCP у инструмента есть имя, описание и схема аргументов. Хост использует их, чтобы представить действие модели или человеку. Ресурсы адресуются по URI. Их удобно применять, когда номер документа уже получен. Шаблоны задают текст и параметры повторяющегося запроса. В интерфейсе их можно показать как заготовки для сотрудника. Поддержка каждой возможности зависит от сервера и выбранной редакции.
Для нашего вопроса нужен поиск, потому что сотрудник не знает POL-18. После получения номера интерфейс может открыть точный ресурс. Если приложению доступна только функция поиска, верните ссылку в её результате. Третий вариант — передать найденный абзац генератору ответа, как в пайплайне RAG. Во всех трёх случаях смысл доступа одинаков: раздел должен быть открыт только для сотрудника, которому его разрешено читать.
Кто кому отправляет сообщения
| Шаг | Кто → кому | Данные в примере |
|---|---|---|
| 1. Подключение | Хост → клиент | Конфигурация справочника, транспорт и данные доступа |
| 2. Обнаружение | Клиент → сервер → клиент | Запрос tools/list и объявление find_policy |
| 3. Выбор | Модель → хост | Просьба найти правило о смене адреса для региона RU |
| 4. Вызов | Клиент → сервер | tools/call с именем, аргументами и ID 7 |
| 5. Чтение | Сервер → справочник → сервер | Проверенные параметры и разрешённый документ POL-18 |
| 6. Ответ | Сервер → клиент → хост | Результат с ID 7 и короткой выдержкой |
Протокол использует JSON-RPC для кодирования сообщений. Идентификатор связывает запрос и ответ. Если параллельно запрошены POL-18 и POL-19, клиент не принимает ответ на один вместо другого. Уведомление в JSON-RPC не ждёт коррелированного ответа. На практике различайте обнаружение схемы функции и запрос на её исполнение. Если был только tools/list, поиска документа ещё не произошло.
В описании транспортов MCP stdio передаёт сообщения через стандартные потоки дочернего процесса, а Streamable HTTP использует HTTP. Для локального сервера вывод диагностических сообщений отправляйте в stderr. Если написать в stdout строку «сервер запущен», она попадёт в поток, где клиент ждёт сообщение протокола. У удалённого сервера вместо запуска процесса появятся адрес, авторизация и сетевые таймауты. Точные правила упаковки сообщений проверяйте для выбранного транспорта и редакции.
Что проверить при несовместимости
Подключение начинается с трёх вопросов. Какой транспорт понимает клиент? Какие редакции понимают обе стороны? Как клиент проверяет доступ? В разделе совместимости MCP описаны редакции с обменом initialize и более новый режим, где сведения о версии передаются в каждом запросе. Если сервер ждёт метаданные запроса, а клиент присылает только старое рукопожатие, вызов поиска не состоится. Переустановка модели это не исправит.
В журнале запуска сохраните имя сервера, транспорт и выбранную редакцию. Если tools/list отработал, а tools/call падает, проверьте имя инструмента и аргументы. Если даже список инструментов не возвращается, проверьте запуск процесса или ответ HTTP прежде, чем изучать схему поиска. Для обновления сервера заведите тест, который открывает подключение из обоих хостов, обнаруживает функцию и вызывает её на известном публичном для теста документе.
Проверьте также смену схемы. Например, раньше find_policy принимал только тему, а теперь требует регион. Старый хост, который сохраняет описание на весь срок работы, пошлёт устаревшие аргументы. Обновите схему по правилам выбранной редакции или перезапустите подключение. При несовместимом изменении дайте потребителям время обновиться и протестируйте, как приложение объясняет старый контракт. Успешное соединение с процессом подтверждает только транспорт; его нужно дополнить проверкой самой функции.
Как выпустить сервер для редактора и чата
Допустим, редактор запускает дочерний процесс, а чат обращается к HTTP-серверу. Сохраните одну реализацию чтения POL-18 и проверьте обе точки входа. Для редактора имитируйте завершение процесса во время запроса. Пользователь должен увидеть, что чтение прервано, а при новом обращении клиент сможет запустить сервер и заново обнаружить инструменты. Для чата проверьте истечение сетевого дедлайна и отозванный доступ. Повторное чтение допустимо только при работающем соединении и действующем доступе.
Один и тот же сервер можно выпускать поэтапно. Сначала оставьте прежние параметры, затем добавьте поддержку нового поля, обновите оба хоста и проверьте журналы. Сделайте поле обязательным только после перехода потребителей, либо выпустите новый именованный контракт рядом со старым. Если регион влияет на доступ, безопасного значения по умолчанию из вопроса нет. В переходной версии берите регион из подтверждённого контекста пользователя либо возвращайте понятный отказ.
На приёмке сохраните три результата для каждого хоста. Первый подтверждает обнаружение функции и её схему. Второй подтверждает, что разрешённый сотрудник получает один и тот же POL-18. Третий проверяет отказ для учётной записи без доступа. После обновления сравните эти результаты с прежней версией и оставьте возможность вернуться к предыдущей конфигурации. Если расходится только один хост, изучите адаптер этого хоста прежде, чем менять бизнес-логику справочника.
Как разобрать результат на Python
Ниже нет сети или полноценного клиента. Код берёт заготовленные JSON-RPC ответы и проверяет ID, ошибка ли это протокола или ошибку вернул инструмент. В настоящем приложении за чтение потока, ожидание ответа и схему сообщения отвечает клиентская библиотека, а бизнес-код решает, что показать сотруднику.
import json def outcome(raw, expected_id): response = json.loads(raw) if response.get("jsonrpc") != "2.0" or response.get("id") != expected_id: return "unexpected_reply", None if "error" in response: return "protocol_error", response["error"]["code"] result = response["result"] text = result["content"][0]["text"] if result.get("isError", False): return "tool_error", text return "ok", text messages = [ '{"jsonrpc":"2.0","id":7,"result":{"content":[{"type":"text","text":"POL-18: адрес можно изменить до передачи перевозчику"}]}}', '{"jsonrpc":"2.0","id":8,"result":{"isError":true,"content":[{"type":"text","text":"Документ недоступен"}]}}', '{"jsonrpc":"2.0","id":9,"error":{"code":-32602,"message":"Invalid params"}}', ] for expected_id, raw in enumerate(messages, start=7): status, detail = outcome(raw, expected_id) print(f"{expected_id} {status} — {detail}") mismatch, _ = outcome(messages[0], 12) assert mismatch == "unexpected_reply" print("Ожидали ID 12:", mismatch)
Вывод программы.
7 ok — POL-18: адрес можно изменить до передачи перевозчику 8 tool_error — Документ недоступен 9 protocol_error — -32602 Ожидали ID 12: unexpected_reply
Код инструмента сообщил, что до POL-18 не удалось добраться. Протокол при этом благополучно доставил ответ. При ошибке параметров исправлять надо запрос. Если ID не совпал, приложение не должно использовать содержимое ответа для текущего вопроса. В полном клиенте параллельные ответы распределяются по таблице ожидающих запросов, а неизвестный ID обрабатывается отдельно. Учебный код показывает один элемент такой таблицы.
Где проверять права и границы передачи
Ограничьте доступ на двух уровнях. Хост предоставляет конкретному сценарию только нужные функции. Справочник принимает решение о чтении конкретного документа. Если чат показывает только поиск, сотрудник не должен получить право редактировать POL-18 через подключение. Если сервер видит две организации, передайте ему идентификацию, которую сервис может проверить, и примените её к чтению. Регион из текста вопроса годится как поисковый параметр, но не как доказательство доступа.
Результат сервера тоже требует границ. Для ответа сотруднику хватит номера правила и одного абзаца. Не передавайте модели целый документ с закрытой служебной частью. При получении ссылки открывайте её от имени текущего сотрудника. Проверка доступа в момент поиска не охватывает отзыв прав через минуту, когда он нажмёт на ссылку. Для журналов сохраняйте ID запроса, название инструмента, статус и задержку. Полный текст документа и токены подключения в общий журнал помещать не нужно.
Если появился инструмент, который меняет адрес, оформите это отдельным действием с подтверждением номера и новых параметров. Повтор запроса после сетевой ошибки должен учитывать идемпотентность. JSON-RPC ID служит для связи пакетов. Ключ бизнес-операции нужен, чтобы повторная доставка не изменила адрес второй раз. В случае чтения правила такой побочный эффект отсутствует, поэтому стратегия повторов проще.
Что замерять после подключения
Сравните цепочку с прямым API вызовом. Поиск POL-18 начинается со времени принятия вопроса, затем идёт интерпретация запроса, вызов инструмента, чтение справочника и отображение. Замеряйте эти интервалы отдельно. Если весь путь занимает две секунды, а поиск справочника десять миллисекунд, ускорение индекса не устранит задержку. Если первый запрос дольше из-за запуска локального процесса, проверьте сессию после простоя и повторный вызов отдельно.
Проведите тест с двумя приложениями и одним сервером. Чат ищет POL-18 по фразе, редактор открывает тот же номер, а учётная запись без прав получает отказ в обоих местах. Затем остановите сервер или нарушьте транспорт и убедитесь, что обе программы показывают ошибку соединения. Это дешевле, чем ждать, пока сотрудник увидит сообщение «документ не найден» при любом отказе. Такой тест проверяет главное обещание подключения: один контракт с предсказуемым поведением в разных приложениях.
Типичные ошибки
- Диагностику печатают в stdout. Клиент получает постороннюю строку вместо сообщения. Захватите первые строки потока и перенесите служебный вывод в stderr.
- Список инструментов принимают за право вызова. Чат видит функцию записи, хотя пользователь не может менять документы. Проверьте исполнение одной команды от двух ролей и ограничьте список хоста.
- Путают редакции. Соединение открывается, но сервер отклоняет первый запрос. Сверьте версию в журнале, транспорт и способ передачи метаданных.
- Принимают ответ от другого запроса. POL-19 показывается под заголовком POL-18. Верните ответы в обратном порядке и проверьте сопоставление по ID.
- Объединяют все сбои в «ничего не найдено». При обрыве пользователь ищет несуществующую ошибку в названии документа. Сымитируйте обрыв, ошибку параметров и отказ доступа по отдельности.
Когда достаточно собственного API
Если один чат всегда обращается к одному справочнику с известным методом, начните с прямой интеграции. Её проще диагностировать при сбое. MCP полезен, когда чат и редактор должны подключать одни и те же возможности, каталог инструментов меняется или несколько независимых сервисов поддерживают общий контракт. Сохраните простой сценарий поиска одного раздела как приёмочный тест. Он показывает, окупилась ли общая интеграция в обоих приложениях.
Что спрашивают на собеседовании
- Что такое MCP? Это протокол, через который приложение обнаруживает и использует внешние возможности. Для справочника чат и редактор получают схему одной функции поиска.
- Чем хост отличается от клиента? Хост отвечает за интерфейс и политику доступа, а клиент обменивается сообщениями с одним подключённым сервером. Если чат подключил два сервера, хост всё равно остаётся одним приложением.
- Чем ресурс отличается от инструмента? Ресурс даёт данные по известному адресу, а инструмент выполняет действие с аргументами. Для неизвестного раздела я запускаю поиск, а POL-18 открываю по URI.
- Почему ответ с корректным ID ещё не успех? ID связывает ответ с запросом, а внутри может быть ошибка инструмента. Если документ недоступен, я сообщу об отказе чтения и не объявлю правило найденным.
- Что проверить при несовместимости? Я сверю транспорт, редакцию и объявления возможностей. Если клиент не может получить список инструментов, разберу подключение до проверки текста prompt.