CVCodeVibers Telegram

Практические разборы l3_builders

MCP-агент: tools, state и human input без хаоса

Практический разбор CodeVibers: как собрать минимальный MCP-agent workflow, где MCP servers не превращаются в хаотичный набор tool calls.

Обсудить внедрение Все темы Академии

Видео по теме

Практический разбор CodeVibers: как собрать минимальный MCP-agent workflow, где MCP servers не превращаются в хаотичный набор tool calls.

Таймкоды

  • 00:00 Что собираем
  • 00:39 Что получит зритель
  • 00:50 Почему MCP - это не вся агентная система
  • 01:08 Repo и docs walkthrough
  • 01:27 Workflow skeleton
  • 01:49 Server config и права
  • 02:10 Human approval gate
  • 02:29 Eval checklist
  • 02:49 Граница пилота

Shorts

Источники выпуска

  • lastmile-ai/mcp-agent on GitHub
  • mcp-agent documentation

Суть темы

Практический разбор CodeVibers: как собрать минимальный MCP-agent workflow, где MCP servers не превращаются в хаотичный набор tool calls.

Что важно забрать

  • После просмотра зритель сможет набросать минимальный workflow: описать MCP servers, выбрать tools, добавить state object, human approval gate, action log и eval checks.
  • Дать разработчику практический скелет MCP-agent workflow без иллюзии, что MCP сам решает orchestration, состояние и подтверждения.
  • Выпуск не продает MCP как магическую шину для агентов. Он показывает, где заканчивается подключение инструментов и начинается инженерная ответственность: состояние, разрешения, человек в цикле, логи и тесты.
  • После browser-agent выпуска дать следующий инженерный слой: не браузер как инструмент, а workflow вокруг набора инструментов и человеческих решений.

Как применять на практике

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

Практические шаги

  1. Открыть lastmile-ai/mcp-agent repository и docs, проверить examples, workflows, human input и server configuration.
  2. Собрать минимальный workflow skeleton: goal, state, tools, policy, human gate, action log.
  3. Показать code/config example с approve_before_side_effect.
  4. Разобрать failure case: tool доступен, но нет state или approval.
  5. Прогнать eval checklist: correct tool choice, missing field, denied human approval, retry, log completeness.

Рекомендации

  • Начинайте MCP-agent прототип с workflow state schema, а не с выбора самой сильной модели.
  • Описывайте tool scope рядом с server config: какие директории, endpoints и действия разрешены.
  • Все side-effect действия переводите в pending_approval до вызова tool.
  • Логируйте reason для выбора tool, input summary, output summary и итог approval branch.
  • Пишите evals на denied approval и missing state, а не только на happy path.

Требования и ограничения

  • У каждого MCP server должен быть scope: allowed roots, allowed tools, forbidden secrets.
  • Workflow обязан останавливаться, если обязательные state поля отсутствуют.
  • Human approval должен быть явной веткой workflow, а не внешним ручным процессом.
  • Повторный запуск после ошибки не должен повторять side effect без нового подтверждения.
  • Action log должен позволять восстановить, почему был выбран tool и что вернулось.

Примеры

  • filesystem MCP server разрешен только на чтение docs/** и запись drafts/**, но не secrets/**.
  • Перед отправкой сообщения клиенту workflow создает approval request с diff и risk label.
  • Если пользователь отказал, workflow возвращает stopped_by_policy и пишет это в log, вместо поиска обходного tool.

Антипримеры

  • Подключить filesystem, CRM и Telegram MCP servers, а затем попросить модель 'действуй аккуратно' без state schema, approval gate и evals.

Как проверить готовность

  • В eval report минимум 5 сценариев: tool choice, missing state, approval required, denied approval, retry idempotency.
  • 100% side-effect actions в тестовом логе имеют approval_request_id.
  • 0 tool calls получают доступ к paths/endpoints вне declared scope.
  • Каждая ошибка workflow имеет explicit stop reason.

Навигация по выпуску

  • 00:00 Что собираем
  • 00:39 Что получит зритель
  • 00:50 Почему MCP - это не вся агентная система
  • 01:08 Repo и docs walkthrough
  • 01:27 Workflow skeleton
  • 01:49 Server config и права
  • 02:10 Human approval gate
  • 02:29 Eval checklist
  • 02:49 Граница пилота

Связанные темы