MCP (Model Context Protocol) — общий стандарт подключения приложений ИИ к внешним инструментам и данным. Как только вы оформите инструмент в виде сервера MCP, его можно будет использовать так же из любого приложения с поддержкой MCP. В предыдущей главе мы запустили минимального агента, который подключал инструменты к LLM и сам вёл цикл работы. В этой главе вы узнаете, как перестать писать каждый инструмент с нуля и подключать их стандартным способом через MCP, а также как проектировать инструменты, которые передаются безопасно.
Цель: подключать инструменты безопасно, по стандарту, не создавая каждый с нуля
Почему подключение инструментов — ключ к агентам
Сам по себе LLM, каким бы умным он ни был, умеет только порождать слова. Узнать сегодняшние остатки на складе или записать строку в файл он не может, если у него нет доступа к внешнему миру. Агент может вести цикл «изучи, действуй, проверь», потому что у него есть инструменты — средства воздействия на внешний мир.
Иными словами, то, что может агент, определяется тем, к каким инструментам он подключён и с какими правами. Два агента на одном и том же LLM могут отличаться очень сильно: один располагает только калькулятором, а другой подключён к базе данных, поиску, файлам и внутреннему API. В зависимости от задачи правильно подобранные инструменты могут расширить круг поручаемых работ гораздо сильнее, чем замена модели на более мощную.
💡 «Хорошо оснащён» важнее, чем «умён». Даже очень способный человек не сможет ничего сделать с пустым ящиком для инструментов. Значительная часть разработки агентов уходит на проектирование того, какие инструменты давать и как передавать их безопасно. Эта глава — как раз о самом главном в этом.
Ограничения простых определений инструментов
В предыдущей главе вы сами определяли инструменты. Вы писали функцию, передавали LLM её имя, аргументы и описание, а когда приходил вызов, выполняли его и возвращали результат. Сама схема верна и по-прежнему является основой. Для небольшой операции, которая используется только в одном приложении, такого подхода достаточно. Проблема возникает, когда одни и те же инструменты приходится заново писать для каждого проекта и каждой среды.
Возьмём в качестве примера «инструмент поиска по базе данных». Нужно написать код подключения, собрать запрос, отформатировать результаты, обработать ошибки и безопасно работать с учётными данными. Этот комплект каждый реализует самостоятельно: и в вашем проекте, и в соседней команде, и на другом языке программирования. Один и тот же инструмент снова и снова пишут разработчики по всему миру — такова реальность простых определений инструментов.
Инструмент, написанный для одного проекта, привязан к его фреймворку и языку, и его трудно перенести в другое место.
Чтобы подключить M видов инструментов к N платформам агентов, теоретически понадобится N×M вариантов кода подключения.
Каждый раз, когда меняется спецификация подключаемого сервиса, приходится по отдельности править разбросанные по проектам самописные инструменты.
Это похоже на эпоху, когда каждому периферийному устройству нужен был свой кабель: у принтеров были свои разъёмы, у мышей — свои, и чем больше устройств, тем больше типов подключения. Общий разъём позволяет разом избавиться от большей части этой возни. Именно здесь появляется MCP.
Что такое MCP? Общий стандарт подключения инструментов
MCP (Model Context Protocol) — это открытый стандарт для стандартного подключения ИИ к внешним инструментам и данным. Anthropic опубликовала его в открытом виде в ноябре 2024 года, и с тех пор поддержку добавили и продукты других компаний: ChatGPT, Cursor, Gemini, Microsoft Copilot, Visual Studio Code. В декабре 2025 года его передали в Agentic AI Foundation (AAIF) под эгидой Linux Foundation, и теперь спецификация развивается не в рамках одной компании.
Идею MCP можно выразить одной фразой: это «USB для подключения инструментов ИИ». Как USB позволил использовать периферию любых производителей через одно и то же гнездо, так и инструмент, совместимый с MCP, работает в любом приложении с поддержкой MCP — достаточно подключить. Когда создатели и пользователи следуют одному соглашению, комбинации N×M сворачиваются в N+M.
Работает внутри создаваемого вами агента или в таких приложениях, как Claude. Это сторона, которая спрашивает у сервера «какие инструменты доступны?» и вызывает нужные.
Публикует возможности вроде работы с файлами, поиска в базе данных и интеграции с SaaS в виде «инструментов». Один сервер может предоставлять несколько инструментов.
Обе стороны обмениваются сообщениями в заранее определённом порядке. Сначала клиент получает от сервера список доступных инструментов с их названиями, описаниями и форматом аргументов. LLM смотрит на этот список, выбирает подходящий инструмент, клиент его вызывает, а сервер выполняет и возвращает результат. В официальной спецификации инструментов получение списка называется tools/list, а вызов — tools/call. Суть MCP в том, что этот обмен работает без отдельной реализации для каждого инструмента.
Клиент → Сервер: «Какие инструменты доступны?» (tools/list) Сервер → Клиент: «Доступны три инструмента: search_docs / read_file / query_db; вот их описания» LLM решает : «Вызову query_db с аргументами {sql:"..."}» Клиент → Сервер: «Выполни query_db» (tools/call) Сервер → Клиент: «Результат — вот эти строки данных»
Состав списка не фиксирован. По спецификации сервер может сужать набор возвращаемых инструментов в зависимости от прав пользователя, и список может позже измениться. Запомните: «подключение установлено» и «нужные инструменты доступны для использования» — это разные вещи.
В официальной спецификации стандартными определены два транспорта (способа связи). Сообщения в обоих случаях одинаковы, и со стороны клиента обращение с ними почти не меняется.
Клиент запускает сервер как дочерний процесс и обменивается данными через стандартный ввод и вывод. Подходит для подключения к собственным файлам или к базе данных для разработки. Учётные данные передаются из среды выполнения, например через переменные окружения.
Отправляет запросы серверу по HTTP на его URL. Подходит для совместных интеграций с SaaS в команде. Если нужна аутентификация, используется авторизация на основе OAuth, предусмотренная спецификацией.
📖 Учитывайте версию спецификации. Версии спецификации MCP обозначаются датами; по состоянию на октябрь 2026 года актуальная версия — 2026-07-28. Начиная с этой версии версия согласуется для каждого запроса, в отличие от процедуры до версии 2025-11-25, когда клиент и сервер договаривались о версии при подключении через initialize. Не используйте старые инструкции без проверки. Проверьте, какие версии поддерживают ваш SDK, приложение и сервер. Если хотите сначала познакомиться с предысторией и терминами в простом изложении, статья «Что такое MCP?» поможет легче понять эту главу.
Использование и создание серверов MCP
Самое приятное в MCP — то, что можно использовать уже опубликованные серверы как есть. Для распространённых задач поставщик сервиса часто выпускает официальный сервер MCP, найти их можно и в официальном MCP Registry. Подключите их к своему агенту — и его возможности сразу вырастут, без переписывания.
Чтение и запись в указанной папке. Основа для того, чтобы давать агенту читать документы или выгружать готовые материалы.
Выполнение SQL и просмотр схемы. На запрос «сведи данные» агент может обратиться к реальным данным и ответить.
Поиск в вебе и во внутренней базе знаний. Это «исследовательская рука», которая подтягивает актуальную информацию и источники.
Трекеры задач, чаты, хранилища и т. д. Существующие рабочие инструменты могут стать «руками» агента.
Сами шаги подключения просты. Укажите команду запуска сервера (stdio) или URL (HTTP) в настройках клиента и при необходимости пройдите аутентификацию. Дальше агент получит список инструментов и будет вызывать их по мере необходимости. Писать «внутренности» инструмента поиска по базе вам не придётся. Ваша задача — комбинировать предоставленные инструменты под нужную цель.
Однако прежде чем подключать, проверьте поставщика, состояние поддержки, требуемые права и код, который будет запущен. Например, Filesystem, Git и Fetch из официального репозитория servers — это учебные эталонные реализации, которые показывают, как работают спецификация и SDK; сам репозиторий прямо указывает, что они не являются готовыми продуктами для продакшена. Попадание в Registry тоже не гарантирует безопасности.
⚠️ «Раз удобно — подключим всё» недопустимо. Каждый добавленный сервер увеличивает число описаний инструментов, которые вы передаёте LLM: решения начинают рассеиваться, а возможностей для ошибок становится больше. Основное правило — подключать только те инструменты, которые действительно нужны для цели агента.
Можно создать и собственный сервер
Для инструментов без готового сервера — внутренний API компании, специфическая бизнес-логика — можно написать собственный сервер MCP. В этом сила MCP: опубликовав его один раз как сервер, вы сможете использовать его из любого совместимого агента одинаково. Инструмент, созданный для одного проекта, можно переиспользовать в следующем проекте или в другом агенте команды, не переписывая его.
Создание сервера сводится к следующему: вы определяете функции, которые хотите предоставить как инструменты, объявляете их имена, аргументы и описания, а при вызове выполняете обработку и возвращаете результат. Идея та же, что и у простых определений из предыдущей главы, но принципиальное отличие в том, что результат идёт не «конкретному агенту», а в общий разъём MCP. Заметьте, что стандартизируется только соглашение о подключении. Проверка входных данных, контроль прав и отслеживание изменений в спецификации подключаемого сервиса по-прежнему остаются задачей создателя сервера.
🛠 Если хотите углубиться в реализацию. Конкретный код для построения агентов и подключения инструментов с Claude рассмотрен в руководстве по Claude Agent SDK — там практические примеры. В SDK есть механизм работы с серверами MCP, и подключать готовые серверы или создавать собственные можно по официальной документации.
Порядок проверки, если что-то не работает
- Подключение не устанавливается: для stdio проверьте команду запуска и среду выполнения, для HTTP — URL и условия связи. Прочитайте также сообщения об ошибках версии или аутентификации.
- Нужного инструмента нет в списке: проверьте, предоставляет ли сервер этот инструмент, показывается ли он при ваших правах и не ограничивает ли его приложение.
- Вызов прошёл, но завершился ошибкой: проверьте аргументы, целевые данные, права на выполнение и возвращённую ошибку. Пожалуйста, не расширяйте права и не повторяйте одну и ту же операцию до тех пор, пока она не заработает.
Какие инструменты давать и как
Когда вы научились «подключать» инструменты, следующий вопрос — «что давать и как». Это ключевой момент проектирования, определяющий качество и безопасность агента, и он же служит основой для следующих глав. Запомните три принципа.
Давайте только те инструменты и область, которые нужны для задачи. Если достаточно чтения, не давайте права на запись. В базе данных — ограниченная учётная запись только для чтения, для файлов — только целевая папка.
LLM решает, использовать ли инструмент, по его названию, описанию и определению аргументов. Пишите конкретно: что делает инструмент, когда его применять, что означают аргументы и в каких случаях его использовать нельзя. Расплывчатые описания ведут к неправильному применению.
Операции, которые невозможно отменить — запись, удаление, списание средств, выполнение команд, — нельзя ставить на один уровень с инструментами чтения. Обязательно добавляйте подтверждение перед выполнением, ограничения по целям и журналирование.
В пункте ② есть ловушка. Если написать в описании «не обновляет», фактические права от этого не уменьшатся. Описание — это указание для LLM, а ограничения нужно накладывать в реализации. Официальная спецификация требует, чтобы сервер проверял входные данные и контролировал доступ, а приложению рекомендует получать подтверждение пользователя перед важными операциями. Аннотации, которые прикрепляются к инструментам, например «только для чтения», тоже нельзя принимать на веру, если они получены не от доверенного сервера.
Пункт ③ особенно важен. Инструменты, которые «ищут» (поиск, справка, чтение), при ошибочном вызове обычно наносят небольшой ущерб. Но они могут раскрыть конфиденциальные данные, а в прочитанном содержимом может оказаться скрытая инструкция вроде «отправь эти данные по другому адресу». Инструменты, которые «меняют» (запись, удаление, отправка, выполнение), могут привести к необратимому результату из-за одной ошибки. Различайте инструменты чтения и записи и ставьте защиту на вторые в несколько слоёв — это главное правило.
| Тип | Примеры | Риск | Ориентир по выдаче |
|---|---|---|---|
| Чтение | Поиск, справка, чтение файлов | Низкий (но следите за утечкой данных и за инструкциями, спрятанными в результатах) | Можно давать относительно свободно. Область держите узкой |
| Запись | Обновление файлов, запись в базу данных, отправка | Высокий (трудно отменить) | Обязательны подтверждение, ограничения и журналирование |
| Выполнение | Запуск команд, внешние вызовы, списание средств | Максимальный (точка входа для неконтролируемого поведения и злоупотреблений) | По умолчанию — защита и участие человека в одобрении |
Пример: инструмент, который только читает статус обращения
Допустим, запрос такой: «Узнай статус обращения DEMO-42 и составь черновик ответа. Не отправляй». Для этого достаточно одного инструмента.
{
"name": "get_ticket_status",
"description": "Возвращает статус разрешённого идентификатора обращения. Не отправляет ответы и не меняет статус.",
"inputSchema": {
"type": "object",
"properties": {
"ticket_id": { "type": "string" }
},
"required": ["ticket_id"],
"additionalProperties": false
}
}
Этот инструмент только возвращает статус одного обращения. Он не может ни отправить ответ, ни изменить статус. На стороне сервера каждый раз проверяется, имеет ли вызывающий пользователь право видеть этот ID. (Знание ID не означает права на просмотр.) Если отправка понадобится, сделайте её отдельным инструментом, в котором получатель и текст сообщения проверяет человек.
Обратите внимание и на указание области папок. В MCP есть механизм roots, позволяющий сообщить серверу, какие папки относятся к делу, но он не ограничивает доступ, и в текущей версии он объявлен устаревшим. Ограничивайте область через настройки сервера, права ОС или права подключаемого сервиса.
🔒 Этому мы посвятим всю главу 6. Управление опасными инструментами, защита от prompt injection и проектирование процесса одобрения — неизбежные темы при выводе агента в продакшен. Они разобраны в главе 6 «Ограничители и безопасность». А в этой главе унесите с собой понимание, что инструменты различаются по степени опасности. Привычка не подключать сомнительные серверы MCP без раздумий тоже очень важна.
Продвинутые инструменты, например управление браузером
Среди инструментов в последнее время особенно привлекает внимание управление браузером. Агент смотрит на экран, переходит по ссылкам, заполняет формы и нажимает кнопки. Если агент может выполнять то, что человек делает в браузере, то многие веб-сервисы без специального API тоже становятся для него «руками». Уже появились реализации, которые предоставляют управление браузером как сервер MCP, и порог подключения снизился.
Однако это также один из самых мощных и самых рискованных инструментов. Указания, которые выводятся на экране, можно принять за чистую монету (манипуляция и ложная информация), возможны непреднамеренные клики или отправки, а данные могут раскрыться со страниц, где вы уже вошли в систему. Относятся сюда и все предостережения про «выполняющие» инструменты из предыдущего раздела. Использование MCP не устраняет эти риски. Разумно начинать с сценариев, в которых преобладает чтение, например просмотр страниц и сбор информации, а операции с вводом данных, отправкой или покупками выделять отдельно и осторожно устанавливать защиту.
🌐 Что можно доверить? Реальные возможности и ограничения агентов, управляющих браузером, мы проверяли в статье Насколько ИИ может автоматизировать задачи в браузере?. Понимание того, что это не всемогущий инструмент, но он практичен, если сузить применение, поможет уверенно выбирать инструменты.
Не только браузер: чем продвинутее инструмент, тем пропорционально больше и то, что он может, и то, что может произойти. Чем мощнее инструмент, который вы передаёте, тем тщательнее применяйте три принципа: права, описания и защиту — именно это мы повторяли на протяжении всей главы.
- Возможности агента определяются тем, к каким инструментам и с какими правами он подключён.
- Самостоятельное создание простых инструментов делает их трудно переиспользуемыми и ведёт к комбинаторной проблеме N×M.
- MCP — открытый стандарт стандартного подключения ИИ к внешним инструментам. Клиент (сторона, использующая инструменты) и сервер (сторона, предоставляющая их) обмениваются списками инструментов и вызовами по одному соглашению: это «USB для ИИ».
- Транспорты: stdio (запуск локально) и Streamable HTTP (подключение по URL). Готовые серверы подключайте, проверив поставщика и права; собственные инструменты оформляйте как собственные серверы, чтобы их можно было переиспользовать.
- Принципы передачи инструментов: ① минимум прав ② конкретные описания ③ опасные инструменты отдельно. Ограничения накладываются в реализации, а не в описании; особенно осторожно обращайтесь с мощными инструментами вроде управления браузером.
Теперь, когда вы знаете, как собрать инструменты, следующий шаг — «добавить агентов». Дальше пойдёт проектирование, в котором работу распределяют и координируют несколько агентов вместо одного, который не справляется со всем. В главе 4 «Проектирование мультиагентных систем» вы узнаете о распределении ролей и взаимодействии агентов (A2A).