Production MCP & Claude Code на русском — listicle mistakes
Когда начинаешь собирать первый агент на Claude Code, всё кажется простым: пара промптов, готовый сервер из гитхаба, и вот оно работает. Но как только дело доходит до реального продакшена, архитектура из бесплатных туториалов рассыпается. Вот пять типичных ошибок, которые совершают разработчики при переходе от игрушек к боевым системам.
Первая — попытка передавать сложные объекты через "костыли" вроде pickle вместо строгого JSON-RPC 2.0. Протокол MCP требует четкой структуры. Если вы не валидируете входящие аргументы через Pydantic-схемы на уровне транспорта, Claude рано или поздно скормит вашему методу невалидный мусор, который уронит весь процесс.
Вторая ошибка — отсутствие повторных попыток (retries) с экспоненциальным шагом. Сеть моргает, API Anthropic выдает ошибку, а ваш агент просто падает посреди сложной цепочки задач. Интегрируйте библиотеку tenacity прямо в декораторы инструментов.
Третья — игнорирование лимитов и стоимости запросов (тех самых "funding rates" вашего API-аккаунта). Claude Code работает невероятно быстро, но без жесткого контроля лимита токенов на сессию один зациклившийся агент может опустошить ваш баланс за пару минут. Контролируйте max_tokens и ведите строгий аудит расходов.
Четвертая — вера в "мифическую песочницу". Claude Code не изолирован по умолчанию. Если дать ему доступ к терминалу без ограничений, он вполне может выполнить rm -rf просто потому, что запутался в путях. Запуск MCP-серверов в продакшене должен происходить строго в изолированных контейнерах (например, gVisor или Docker) с урезанными правами.
И пятая — отсутствие тестов транспортного слоя. Проверять агента вручную в консоли — это путь к бесконечной отладке. Настоящий продакшен требует юнит-тестов на JSON-RPC запросы.
Маленький секрет для ценителей: чтобы MCP-сервер на Python держал нагрузку, забудьте про стандартный stdio-транспорт. Используйте асинхронный SSE (Server-Sent Events) на базе FastAPI с кастомным протоколом маршрутизации. Это позволяет обрабатывать сотни параллельных сессий от разных инстансов Claude Code без блокировки потоков, используя anyio для управления жизненным циклом соединений.
Когда ваш агент вместо оптимизации базы данных решает переустановить вам операционную систему, потому что «так будет чище» — это не восстание машин, это просто отсутствие изоляции.
Если вы хотите научиться строить надежные, безопасные и быстрые MCP-системы на Python без "воды" и поверхностных примеров, ждем вас на курсе. Стоимость: $149 пожизненный доступ + $49/месяц за участие в Code Club.
https://nexus-bot.pro/courses/mcp-production/
https://nexus-bot.pro/waitlist?plan=mcp-production
Originally posted at https://nexus-bot.pro/courses/mcp-production/
Комментарии
Отправить комментарий