Ваш MCP-сервер плох — и вам должно быть стыдно
Your MCP Server is Bad and You Should Feel Bad
MCP-сервер стоит проектировать как продукт для агента, а не как обёртку над REST API: меньше инструментов, готовые результаты и плоские аргументы.
- Результат вместо операций — инструмент должен закрывать задачу агента целиком, например «последний заказ по email», а не набор атомарных вызовов. Склейку нескольких вызовов лучше делать в коде сервера: по словам спикера, оркестрация через LLM дорогая, медленная и трудно отлаживается.
- Плоские аргументы и понятные ошибки — вместо dict передавайте примитивы, для выбора из набора используйте Literal или enum. Текст ошибки попадает в контекст агента как следующая подсказка, поэтому в нём стоит написать, как исправить вызов.
- Бюджет контекста — при 200 тысячах токенов и 800 эндпоинтах на каждый инструмент остаётся меньше 250 токенов. По мнению спикера, около 50 инструментов на агента уже дают деградацию, поэтому конвертированный REST API в продакшен выкатывать не стоит.
- Клиенты ведут себя по-разному — Claude Desktop кэширует инструменты в SQLite и игнорирует часть механизмов спецификации. Автоконвертер FastMCP из REST API спикер советует использовать только для старта, а потом урезать сервер.
Кому полезно: тем, кто пишет MCP-серверы для внешних клиентов, которые не контролируют.
Доклад цитируется в статьях
Главы
Ещё доклады: Jeremiah Lowin
Страница спикера →Похожие доклады
Как предоставлять agents в виде MCP-серверов с помощью mcp-agent
AI Engineer World's Fair 2025
Близко по содержанию
ACP: универсальный пульт управления для AI-агентов
Близко по содержанию
Создание агентов с Model Context Protocol
AI Engineer Summit 2025
Близко по содержанию

