Уклон в сторону «счастливого пути»
Прочитайте README большинства MCP-серверов, и вы узнаете, как именно настроить сервер и что он умеет в идеальных условиях. «Запросы к любой SQL-базе данных». «Чтение и запись файлов». «Поиск в интернете». Эти описания возможностей точны, но неполны. Они не говорят, что произойдёт, когда что-то пойдёт не так.
Что случится, если выполнить запрос к таблице с 10 миллионами строк? Что произойдёт, если соединение с базой оборвётся в середине запроса? Какие размеры файлов слишком велики для обработки? Какие диалекты SQL действительно поддерживаются? Ответы на эти вопросы обычно обнаруживаются методом мучительных проб и ошибок.
Что должна включать документация по отказам
Известные ограничения: «Максимальный размер результирующего набора — 10 000 строк. Более крупные запросы будут усечены». «Бинарные файлы не поддерживаются и вернут ошибку». Это задаёт ожидания, чтобы пользователи не тратили время на обнаружение пределов через сбои.
Типичные сценарии ошибок: «Если вы видите ‘connection timeout’, сервер базы данных может быть недоступен. Проверьте, что хост и порт в конфигурации указаны верно». Это экономит время отладки, предлагая наиболее вероятное объяснение распространённых ошибок.
Граничные случаи: «Запросы со столбцами BLOB не выполнятся, потому что бинарные данные нельзя сериализовать в JSON». «Пути файлов с символами Unicode могут не работать в Windows». Это предотвращает именно те неожиданности, которые вызывают наибольшее раздражение.
Эффект доверия
Парадоксально, но документирование отказов формирует доверие. Когда README честно сообщает: «этот сервер отлично работает с запросами до 10 000 строк, но испытывает трудности с большими наборами результатов», вы доверяете автору больше, чем тому, кто заявляет о неограниченных возможностях. Вы также принимаете более информированное решение о внедрении.
Хорошая документация по отказам — это инвестиция в опыт разработчика. Пользователи, которые понимают пределы инструмента, используют его в этих рамках и получают хороший опыт. Пользователи, которые обнаруживают пределы через сбой, получают плохой опыт и могут перейти на альтернативу.
Связанные материалы
- Почему обнаружение MCP-серверов сложнее, чем кажется
- Как сообщения об ошибках от MCP-серверов влияют на поведение агента
- Почему опыт разработчика важен для внедрения AI-инструментов
Просмотр MCP-серверов на Skillful.sh. Поиск по 137 000+ AI-инструментам.