Как создать MCP-сервер для Claude за четыре шага: пошаговый гайд по официальному скиллу mcp-builder
Официальный скилл от Anthropic задаёт Claude строгий порядок разработки сервера от изучения API до тестирования и исключает генерацию кода вслепую.
Разработка собственных серверов Model Context Protocol (MCP) часто упирается в одну проблему: при свободной генерации языковая модель сразу пишет код отдельных функций, пропуская изучение ограничений API, пагинацию, валидацию схем и обработку сетевых сбоев. В результате интеграция падает на первой же нестандартной ошибке удалённого сервиса.
Для решения этой задачи Anthropic выложила в официальный репозиторий anthropics/skills специализированный скилл mcp-builder. Он подчиняет Claude пошаговому инженерному процессу из четырёх фаз: сначала сбор требований и протокола, затем реализация с типами, после чего обязательное локальное тестирование и автоматическая оценка на контрольных вопросах.
Установка скилла через маркетплейс Claude Code
В репозитории anthropics/skills, насчитывающем 193 285 звёзд на GitHub на 12 ноября 2026 года, собраны готовые наборы инструкций. Скилл mcp-builder входит в пакет примеров example-skills. Подключение выполняется штатным менеджером плагинов Claude Code:
Первая команда регистрирует репозиторий как источник плагинов, вторая скачивает пакет и активирует входящие в него навыки. После установки скилл подгружается автоматически при запросах на разработку или доработку MCP-сервера.
Фаза 1. Исследование протокола и планирование архитектуры
Первое правило mcp-builder — запрет на написание кода до фиксации требований. На этой фазе Claude выполняет подготовительные шаги:
- Изучение протокола: модель обращается к спецификации на modelcontextprotocol.io и проверяет соглашения об именовании инструментов, структуре ответов и безопасности.
- Выбор SDK: для TypeScript стандартом стал пакет @modelcontextprotocol/server (v2). Первая версия библиотеки @modelcontextprotocol/sdk переведена в режим поддержки только критических исправлений. Если проект уже написан на v1, скилл предлагает миграцию командой npx @modelcontextprotocol/codemod@latest v1-to-v2 .. Для проектов на Python используется FastMCP.
- Анализ целевого API: сбор эндпоинтов, схем аутентификации, форматов пагинации и ограничений по частоте вызовов (rate limits).
- Формирование списка инструментов: приоритизация базовых операций чтения перед методами изменения данных.
Фаза 2. Реализация инфраструктуры и инструментов
На этапе реализации скилл запрещает сваливать весь код в один файл и требует разделения на транспортный слой, клиент API и сами инструменты.
- Базовый клиент: создаются единый модуль отправки запросов с авторизацией, обработчики ошибок и утилиты разбора постраничных ответов.
- Строгая типизация параметров: входные аргументы каждого инструмента описываются через схемы Zod (в TypeScript) или Pydantic (в Python) с подробными комментариями и примерами к каждому полю.
- Схемы вывода: для предсказуемой обработки результатов клиентами задаётся outputSchema, а ответы возвращаются в виде структурированных данных (structuredContent).
- Поведенческие аннотации: каждый инструмент помечается подсказками readOnlyHint, destructiveHint, idempotentHint и openWorldHint. Они сообщают модели, несёт ли вызов деструктивные последствия или требует подтверждения человека.
Фаза 3. Сборка и тестирование в MCP Inspector
После написания файлов проект проходит статический контроль и локальную проверку без подключения к боевому приложению.
- Проверка компиляции: в проектах на TypeScript запускается npm run build и прогоняется проверочный скрипт из руководства v2. В Python-проектах проверяется синтаксис через python -m py_compile server.py.
- Тестирование через официальный инспектор: запуск утилиты npx @modelcontextprotocol/inspector позволяет открыть веб-интерфейс, просмотреть список зарегистрированных инструментов, протестировать отправку аргументов и проверить валидацию граничных значений.
Фаза 4. Автоматическая оценка качества через XML-набор
Четвёртая фаза — ключевое отличие mcp-builder от типовых инструкций. Скилл обязывает составить тестовый набор из 10 контрольных вопросов для проверки того, как агент справляется с сервером на реальных сценариях.
- Только операции чтения: все вопросы должны опираться на безопасные запросы без модификации данных.
- Комплексность: ответ должен требовать цепочки из нескольких последовательных вызовов инструментов и сопоставления информации.
- Однозначная проверка: у каждого вопроса должен быть стабильный строковый ответ, который можно верифицировать точным сравнением строк.
Результат формируется в XML-структуре, пригодной для автоматического прогона в тестовых конвейерах:
Практические ограничения и безопасность
- Скилл рассчитан на создание серверов под внешние API. Для простого подключения уже готовых сторонних интеграций он избыточен.
- Примеры в anthropics/skills помечены как демонстрационные. Разрабатываемый сервер получает прямой доступ к сетевым эндпоинтам, поэтому секретные токены и права на запись в базу необходимо проверять до запуска в рабочий контур.
- Поддержка версий протокола: в ноябре 2026 года основной акцент в репозитории сделан на переходе на TypeScript SDK v2, поэтому старые примеры из сети на базе @modelcontextprotocol/sdk требуют адаптации импортов.
Всё самое интересное — в нашем Telegram-канале «Claude без воды».