← К техническим практикам

AIAgent

Полный разбор новых функций Claude 2026: Claude API, Tool Use, MCP, Structured Output и AI Agent

Около 3 мин чтения

Полный разбор новых функций Claude 2026: Claude API, Tool Use, MCP, Structured Output и AI Agent

На 19 августа 2026 года Claude Managed Agents допускает до 20 MCP-серверов в конфигурации одного агента, а запросы к Managed Agents требуют beta-заголовок managed-agents-2026-04-01 — это уже не косметическое обновление API, а переход к инфраструктуре для длительных задач. (документация MCP-коннектора Managed Agents)

Симптом: вы видите новые модели и инструменты Claude, но не понимаете, что именно менять в существующем проекте.
Быстрое решение: не переписывайте систему целиком — проверьте четыре слоя по отдельности: модель и Claude API, Tool Use со строгими схемами, MCP-подключения и среду выполнения AI Agent.

Эта статья для вас, если вы разрабатываете через Claude API и хотите определить объём миграции, строите платформу удалённых MCP-инструментов или выбираете между собственным циклом агента и Managed Agents. Если вам нужен только обычный чат без инструментов и длительных задач, достаточно ограниченного регрессионного тестирования.

Последняя проверка выполнена 19 августа 2026 года. Состояние функций сверено с официальными материалами Anthropic по моделям, Structured Outputs, Tool Use, MCP-коннектору и Managed Agents. Для beta-возможностей отдельно отмечены заголовки и ограничения.

Карта изменений Claude 2026 по ролям

Главный сдвиг Claude 2026 — одновременное развитие модели и окружающей инфраструктуры. Для принятия решения разделите изменения по ответственности вашей команды.

Команда интеграции моделей

Вам нужно проверить не рекламное название модели, а четыре технических параметра:

  • доступен ли нужный идентификатор через выбранный endpoint;
  • поддерживаются ли Tool Use и Structured Outputs;
  • совпадает ли формат ответа с текущим SDK;
  • нет ли различий между Claude API, AWS, Google Cloud и Microsoft Foundry.

Официальная документация прямо показывает, что доступность Structured Outputs зависит от конкретной модели и площадки. На Claude API функция указана как общедоступная для ряда моделей Claude 4.5 и новее, но списки для разных платформ не полностью совпадают. Поэтому универсальная строка «поддерживается Claude» недостаточна для закупки и миграции. (документация Structured Outputs)

Платформенная команда инструментов

Ваша зона риска — не сам вызов функции, а несовпадение типов, обязательных полей и поведения при ошибке. Tool Use отвечает за то, что Claude сформирует вызов инструмента. Параметр strict: true дополнительно ограничивает аргументы JSON Schema и помогает не передавать строку там, где сервис ожидает число или объект. (документация strict Tool Use)

Команда MCP

Для вас ключевой вопрос — не «подключается ли MCP», а «какой контроль остаётся у клиента». MCP-коннектор позволяет подключать удалённый сервер непосредственно через Messages API, без отдельного MCP-клиента. Но актуальная версия требует beta-заголовок mcp-client-2025-11-20, а старая версия mcp-client-2025-04-04 помечена как устаревшая. (документация MCP-коннектора Claude API)

Руководитель Agent-проекта

Вам нужно решить, где будет выполняться цикл действий: в вашем оркестраторе или внутри Claude Managed Agents. В первом случае вы получаете полный контроль над очередями, тайм-аутами, журналами и разрешениями. Во втором — готовую среду с сессиями, инструментами, файлами, MCP и сохранённой историей событий, но принимаете ограничения beta-интерфейса и правила управляемой среды. (обзор Managed Agents)

Команда безопасности

Ваши основные объекты проверки — OAuth-токены, удалённые MCP-серверы, побочные эффекты инструментов, политика подтверждения и хранение событий. Простое добавление MCP-сервера к агенту фактически расширяет доверенную вычислительную поверхность, поэтому подключение «по умолчанию разрешено» не должно считаться безопасным режимом.

Этап 1. Проверка моделей и Claude API

Начните миграцию не с изменения model ID, а с инвентаризации текущих запросов.

Соберите список:

  1. используемых моделей;
  2. endpoint и SDK;
  3. beta-заголовков;
  4. параметров tools, tool_choice, max_tokens и output_config;
  5. форматов логов и ошибок;
  6. мест, где приложение разбирает свободный текст регулярными выражениями.

Для простого диалога обычно достаточно проверить совместимость модели, лимиты токенов, потоковую выдачу и формат текстового ответа. Для инструментального приложения добавьте тесты на tool_use, повторную отправку tool_result, параллельные вызовы и отказ внешнего сервиса.

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

  • долю корректных вызовов инструментов;
  • количество повторных попыток;
  • частоту пропущенных обязательных параметров;
  • среднюю задержку полного цикла;
  • процент ручных подтверждений;
  • стоимость запроса в вашей реальной цепочке.

В 2026 году официальные материалы Anthropic перечисляют несколько актуальных классов моделей, включая Opus, Sonnet, Haiku и новые специализированные варианты. Доступность и функции могут отличаться по платформе, поэтому закрепляйте не только название семейства, но и точный идентификатор, дату проверки и набор поддерживаемых инструментов. (официальное объявление о Claude Sonnet 4.6)

Этап 2. Разделение Tool Use и Structured Output

Эти функции решают разные задачи, и смешивать их в архитектурном описании опасно.

Tool Use отвечает на вопрос: какое действие нужно вызвать и с какими аргументами?

Ваше приложение передаёт Claude список инструментов. Claude возвращает блок tool_use, где указаны имя функции и объект аргументов. Затем ваш код выполняет операцию и отправляет результат обратно в блоке tool_result. Сам Claude не запускает пользовательскую функцию автоматически — выполнение находится на стороне приложения, если вы не используете серверный инструмент или Managed Agents. (как работает Tool Use)

Structured Output отвечает на вопрос: в каком формате должен выглядеть прямой финальный ответ?

В актуальной форме используется output_config.format с типом json_schema. Старый параметр output_format и beta-заголовок для Structured Outputs сохраняются только на переходный период. Это значит, что миграцию лучше планировать сейчас: новый формат должен стать основным в коде, а старый — временным резервом для совместимости.

Используйте их отдельно в таких случаях:

  • только Structured Output — когда требуется JSON-результат без внешнего действия;
  • только strict Tool Use — когда важна корректность аргументов функции;
  • обе функции вместе — когда агент должен сначала безопасно вызвать инструменты, а затем вернуть итоговой системе строго заданный JSON.

Строгий JSON не означает истинность результата. Схема гарантирует типы и структуру, но не проверяет, что адрес существует, разрешение действительно или финансовая операция допустима. Бизнес-валидация, авторизация и контроль побочных эффектов остаются вашей обязанностью.

Учтите и технические пределы. В официальной документации указаны максимум 20 strict-инструментов в одном запросе, 24 необязательных параметра суммарно для strict-схем и лимит компиляции грамматики 180 секунд. Скомпилированные грамматики кэшируются на 24 часа с момента последнего использования, но изменение структуры JSON Schema или набора инструментов инвалидирует кэш. (ограничения Structured Outputs)

Этап 3. Подключение MCP и управление удалёнными инструментами

Model Context Protocol полезен, когда несколько приложений должны использовать одни и те же инструменты или источники данных. Вместо отдельного адаптера под каждый клиент вы публикуете MCP-сервер, а Claude API подключается к нему через удалённый URL.

Проверяйте подключение в следующем порядке:

  1. сервер доступен по HTTPS;
  2. транспорт соответствует поддерживаемому формату;
  3. OAuth-токен получается до вызова Claude API;
  4. токен обновляется до истечения срока;
  5. инструменты включаются через allowlist;
  6. ошибки MCP преобразуются в понятные tool_result;
  7. операции записи требуют отдельного подтверждения.

У текущего MCP-коннектора есть важная граница: через прямой API-коннектор удобно подключать удалённые серверы, когда вам нужны инструменты, но локальные stdio-серверы, MCP prompts и resources требуют собственного MCP-клиента и вспомогательных функций SDK. Это не дефект, а архитектурное разделение режима «быстро подключить удалённый tool» и режима «полностью управлять протоколом».

Для доступа используйте три уровня:

  • allowlist — включайте только инструменты, необходимые конкретному агенту;
  • permission policy — требуйте подтверждение перед вызовами с побочным эффектом;
  • credential isolation — храните токены вне описания агента и передавайте их на уровне сессии.

В Managed Agents это разделение реализовано особенно явно: MCP-сервер объявляется при создании агента, а секреты передаются при создании сессии через зарегистрированное хранилище. По умолчанию MCP toolset использует политику always_ask, то есть запрашивает подтверждение перед каждым вызовом.

Не переносите старую конфигурацию MCP без проверки. В документации Anthropic tool_configuration обозначен как устаревшее поле. Новая схема использует mcp_toolset, default_config и индивидуальные configs. Если оставить старую структуру как основную, следующая миграция станет сложнее, а контроль разрешений будет менее очевидным.

Этап 4. Выбор среды для AI Agent

Claude Agent в текущем смысле — это не просто модель с большим prompt. Managed Agents объединяет модель, системную инструкцию, инструменты, MCP-серверы и навыки в версионируемую конфигурацию. Затем вы создаёте среду и запускаете сессию, в которой агент получает события, выполняет действия и сохраняет историю. (настройка Managed Agents)

Выбирайте собственный цикл выполнения, если вам нужны:

  • строгий контроль над каждой итерацией;
  • собственная очередь заданий;
  • нестандартные лимиты времени;
  • размещение данных в конкретной инфраструктуре;
  • собственные правила трассировки;
  • детальное управление повторными попытками;
  • интеграция с уже существующим оркестратором.

Выбирайте Managed Agents, если вам важнее:

  • запуск задач на минуты или часы;
  • состояние между несколькими обращениями;
  • готовые файловые операции и Bash;
  • встроенная работа с вебом и кодом;
  • меньше собственного кода для agent loop;
  • облачная или self-hosted sandbox;
  • возможность остановить или перенаправить текущую сессию.

Managed Agents остаётся beta-функцией. Официальная документация требует beta-заголовок, а SDK устанавливает его автоматически. Поэтому для production-проекта закрепите версию SDK, добавьте контрактные тесты и подготовьте fallback на Messages API. Не рассчитывайте, что beta-интерфейс будет неизменным до конца жизненного цикла продукта.

Среда выполнения также влияет на безопасность. Файлы, shell-команды, MCP и сетевой доступ нужно рассматривать как отдельные разрешения. Агент, которому разрешено читать репозиторий, не обязательно должен иметь право менять файлы. Агент, способный менять файлы, не должен автоматически получать доступ к production-секретам.

Этап 5. Контроль безопасности и хранения данных

Сделайте четыре класса инструментов:

  1. только чтение — поиск, получение документа, просмотр статуса;
  2. обратимые изменения — создание черновика, открытие задачи, подготовка файла;
  3. операции с побочным эффектом — отправка сообщения, изменение записи, публикация;
  4. разрушающие действия — удаление, отзыв ключа, изменение production-конфигурации.

Для каждого класса задайте отдельную политику подтверждения. Не объединяйте чтение и удаление в одну универсальную функцию с параметром action, если это мешает аудиту и ограничению прав. Если объединение необходимо, сделайте action обязательным, перечислите допустимые значения и проверяйте уровень разрешения до выполнения.

Structured Outputs и strict Tool Use используют грамматику для ограничения ответа. Однако служебная схема тоже требует защиты. Документация отдельно предупреждает, что персональные медицинские данные нельзя помещать в названия свойств, значения enum, константы и регулярные выражения схемы. Такие данные должны находиться в содержимом сообщений, а не в определениях инструментов.

Для MCP учитывайте дополнительный риск доверия к удалённому серверу. Токен даёт серверу возможность действовать от имени пользователя в пределах выданных прав. Поэтому перед подключением проверьте:

  • владельца и журнал изменений сервера;
  • список реально доступных инструментов;
  • сетевые адреса, к которым он обращается;
  • формат ошибок;
  • срок жизни OAuth-токена;
  • правила отзыва доступа;
  • отсутствие секретов в логах.

Прямой MCP-коннектор также имеет отдельные условия хранения данных и не считается подходящим для Zero Data Retention в описании Anthropic. Это необходимо учитывать при выборе режима для регулируемых данных и при согласовании требований с юридическим отделом.

Контрольная точка перед обновлением

Используйте список как критерий перехода. Если пункт не выполнен, не включайте новый слой в production.

  • [ ] Зафиксирован точный model ID и endpoint для каждой среды.
  • [ ] Проверена совместимость Tool Use с выбранной моделью.
  • [ ] Свободный текст больше не разбирается регулярными выражениями там, где нужен инструмент.
  • [ ] Для критичных функций включён strict: true.
  • [ ] Схемы JSON Schema не содержат лишних необязательных полей.
  • [ ] Финальный JSON проверяется бизнес-валидатором после ответа Claude.
  • [ ] Используется актуальная версия MCP beta-заголовка.
  • [ ] Устаревшее поле tool_configuration удалено из новой конфигурации.
  • [ ] Для каждого MCP-сервера задан allowlist инструментов.
  • [ ] OAuth-токены не находятся в постоянной конфигурации агента.
  • [ ] Записывающие и разрушающие операции требуют подтверждения.
  • [ ] Есть тест отключённого MCP-сервера и истёкшего токена.
  • [ ] Сессия агента может быть остановлена вручную.
  • [ ] Для Managed Agents подготовлен fallback на собственный цикл.
  • [ ] Логи содержат идентификатор операции, результат и причину отказа.
  • [ ] Проверены требования к хранению данных для вашего региона и отрасли.

FAQ для команд внедрения

Какие новые возможности Claude API нужно проверить в проекте в первую очередь?

Сначала проверьте модель, endpoint и поддержку Structured Outputs на выбранной платформе. Затем протестируйте strict Tool Use, поскольку он меняет требования к JSON Schema и обработке аргументов. После этого проверьте MCP beta-заголовок, OAuth и ошибки удалённого сервера. Только затем оценивайте Managed Agents: это отдельная модель выполнения, а не простой параметр Messages API.

Как связаны Claude Tool Use и MCP?

Tool Use — это механизм вызова функций внутри диалога Claude. MCP — протокол, который публикует внешние инструменты и данные через стандартизированный сервер. MCP-коннектор преобразует эти удалённые инструменты в доступные Claude tool calls, но не отменяет необходимость проверять схемы, разрешения, токены и результаты. Для локальных серверов и MCP resources может потребоваться собственный клиент.

Поддерживает ли Claude Structured Output строгий JSON?

Да, Structured Outputs предназначен для выдачи JSON, соответствующего заданной схеме. В актуальной форме используется output_config.format, а не старый output_format. Но строгость относится к структуре: Claude не проверяет смысловые правила вашего бизнеса. У сложных схем есть ограничения по количеству strict-инструментов, необязательным полям и времени компиляции грамматики.

Есть ли у Claude Agent готовая среда для длительного выполнения задач?

Да, Claude Managed Agents предоставляет агентный цикл, сессии, события, файлы, Bash, веб-инструменты, код и MCP. Можно использовать облачную sandbox или self-hosted окружение. Однако функция находится в beta и требует специального заголовка. Для критичных систем вам всё равно нужны ограничения времени, ручное прерывание, резервный путь и независимый аудит действий.

Какие части существующего проекта Claude API действительно требуют обновления?

Обновляйте только затронутые слои. Чат без инструментов обычно требует проверки модели и регрессионных тестов. Tool-ориентированный проект дополнительно нуждается в strict-схемах и обработке ошибок. MCP-проект проверяет транспорт, OAuth и allowlist. Длинный агентный процесс требует отдельного решения по среде, состоянию, журналированию, секретам и восстановлению после прерывания.

Этап 6. Порядок внедрения по типу проекта

Простой чат

Если ваш продукт только принимает вопрос и возвращает текст, начните с проверки model ID, лимитов и стабильности формата ответа. Structured Output добавляйте только там, где downstream-сервис действительно требует JSON. Не подключайте MCP и Managed Agents ради самого факта обновления.

Инструментальный помощник

Если Claude вызывает поиск, базу данных, CRM или внутренний API, сначала формализуйте инструменты. Отдельно проверьте tool_choice, strict-параметры, повторную отправку результата и обработку отказа внешнего сервиса. MCP имеет смысл, когда один и тот же набор инструментов понадобится нескольким агентам или клиентам.

Длинная задача

Если процесс включает много шагов, файлы, команды, веб-поиск и сохранение состояния, сравните собственный цикл с Managed Agents. Собственная реализация предпочтительна при жёстких требованиях к контролю и данным. Managed Agents полезен, когда вы хотите быстрее получить рабочую среду и готовы принять beta-статус, серверную историю событий и заданную модель управления сессиями.

Роль Mac-среды в агентной архитектуре

Большинству Claude API-проектов Mac не нужен: модель, MCP-сервер и агентный цикл могут работать в обычной серверной инфраструктуре. Mac-среда становится оправданной, когда агент должен взаимодействовать с Xcode, iOS Simulator, macOS-автоматизацией, локальными Apple-инструментами или физически привязанным рабочим процессом.

В таком сценарии учитывайте реальные ограничения текущей схемы: обычный Linux-сервер не предоставляет macOS-инструменты, локальная машина разработчика плохо подходит для постоянных удалённых задач, а собственный Mac требует отдельной настройки доступа, обновлений, резервирования и изоляции секретов. Если вам нужна временная среда для проверки Claude Agent с Apple-инструментами, аренда Mac mini может быть рациональнее покупки оборудования до того, как сценарий пройдёт приёмочные тесты.

Для распределённых команд важна и география подключения. Перед выбором узла сравните задержку, допустимый способ удалённого доступа и требования к передаче файлов. Размещение Mac в подходящем регионе может упростить проверку Apple-зависимых сценариев, но не заменяет серверную политику безопасности Claude: права MCP и агентные разрешения всё равно нужно задавать на уровне приложения. Перед запуском пилота определите подходящую конфигурацию среды, требования к доступу и срок тестирования. Инфраструктурные варианты для удалённой работы с macOS можно дополнительно сопоставить в каталоге сред Kvmkit, а затем отдельно проверить совместимость выбранного контура с инструментами агента.

Решение на 30 дней

В первую неделю создайте инвентаризацию API, инструментов и MCP-серверов. Во вторую — перенесите критичные аргументы на strict Tool Use и финальные ответы на Structured Outputs. В третью — проведите тесты с истёкшими токенами, недоступными серверами, неполными результатами и запрещёнными действиями. В четвёртую — сравните собственный цикл с Managed Agents на ограниченной группе задач.

Такой порядок снижает риск дорогой миграции: вы сначала исправляете контракт данных, затем подключение инструментов, а уже потом меняете среду выполнения. Для простого чата обновление может закончиться регрессионными тестами. Для AI Agent потребуются отдельные правила доступа, журналирования и остановки.

Если текущая схема построена вокруг обычного серверного цикла, её слабые места обычно уже заметны: длительные задачи требуют собственного состояния, MCP-интеграции приходится сопровождать вручную, а macOS-сценарии невозможно полноценно проверить на стандартной Linux-машине. Временная среда на Mac имеет смысл именно как тестовый контур для Apple-зависимых задач, а не как универсальная замена production-инфраструктуре. Для постоянной тяжёлой нагрузки, физических устройств или строгого контроля над железом выгоднее рассматривать собственный Mac. Для короткого пилота, приёмки и удалённой проверки инструментов аренда обычно позволяет не покупать оборудование до подтверждения архитектуры.

Начните с той роли, где риск уже измерим: команда Claude API — с контрактов и схем, MCP-команда — с allowlist и OAuth, руководитель агента — с выбора среды и политики остановки.

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

Какие новые возможности Claude API нужно проверить в проекте в первую очередь?

Сначала проверьте идентификатор используемой модели, доступность Structured Output на вашем провайдере и форму параметра output_config.format. Затем отдельно протестируйте strict-инструменты, актуальный MCP-коннектор и обработку beta-заголовков. Такой порядок помогает отличить обязательную миграцию интерфейса от функций, которые пока зависят от платформы или находятся в предварительном доступе.

Как связаны Claude Tool Use и MCP?

Tool Use задаёт общий механизм, через который Claude формирует структурированный вызов функции. MCP поставляет такие инструменты через стандартизированный удалённый сервер. Поэтому MCP не заменяет Tool Use: он уменьшает объём клиентского кода и стандартизирует подключение, но вам всё равно нужны политики доступа, проверка схем, обработка ошибок и контроль побочных эффектов.

Поддерживает ли Claude Structured Output строгий JSON?

Да, Structured Outputs ограничивает прямой ответ Claude заданной JSON Schema и возвращает проверяемую структуру. Однако это не гарантирует правильность бизнес-решения, актуальность данных или безопасность действия. Кроме того, у схем есть ограничения сложности, а первая компиляция грамматики может увеличить задержку. Проверяйте доступность функции для конкретной модели и площадки.

Есть ли у Claude Agent готовая среда для длительного выполнения задач?

Claude Managed Agents предоставляет управляемую среду с сессиями, историей событий, файловыми операциями, Bash, веб-инструментами, MCP и кодом. Функция находится в beta, поэтому интерфейс и поведение могут меняться. Вы можете выбрать облачную среду Anthropic или self-hosted sandbox, но в обоих случаях остаются вопросы разрешений, секретов, журналирования и остановки опасных действий.

Какие части существующего проекта Claude API действительно требуют обновления?

Обычно не нужно переписывать весь проект из-за нового имени модели. Проверьте пять зон: модель и endpoint, обработку tool_use, валидацию JSON, MCP-транспорт с OAuth, а также цикл долгих задач. Если у вас только простой чат, достаточно регрессионных тестов. Если есть агент, добавьте аудит разрешений, идемпотентность инструментов, лимиты времени и восстановление после сбоев.

CI/CD на M4 Mac mini — без лишних хлопот

Xcode, Fastlane, CocoaPods, and SPM are first-class on macOS. Mac mini M4 unified memory keeps signing and archiving smooth; ~4W standby power suits 24/7 build nodes.

View Kvmkit plans

Нужна техническая поддержка или консультация?

При проблемах с Mac-инстансами или CI/CD сначала загляните в центр помощи.