Это руководство поможет вам создать MCP Bundle (.mcpb) для создания расширения рабочего стола для внутреннего использования, частного распространения или в качестве основы для отправки в Anthropic's Connectors Directory.

1. Введение

Что такое MCPB?

Файлы MCPB (.mcpb) — это zip-архивы, содержащие локальный MCP-сервер и manifest.json. Они обеспечивают установку в один клик в Claude Desktop, аналогично расширениям браузера.

Ключевые характеристики:

Работает локально на машине пользователя
Взаимодействует через транспорт stdio
Объединяет все зависимости
Работает в автономном режиме
OAuth не требуется

Дополнительная информация:

MCPB Repository — полная спецификация и архитектура
Desktop Extensions Blog Post — обзор и варианты использования

Когда следует использовать локальный сервер (MCPB) вместо удаленного?

Выберите локальный сервер (MCPB) для:

Внутренние системы и безопасность

Доступ к системам за вашим брандмауэром (JIRA, Confluence, внутренние вики, приватные базы данных)
Бесшовная аутентификация — автоматически использует существующие сеансы SSO и браузера, без управления токенами
Соответствие модели нулевого доверия — работает в границах корпоративной сети без раскрытия внутренних ресурсов публично

Локальные ресурсы

Прямой доступ к файловой системе для редактирования кода и операций Git
Интеграция с локально установленными инструментами (Docker, IDE, базы данных)
Интеграция оборудования и управление приложениями рабочего стола
Операции, чувствительные к конфиденциальности, которые не должны покидать машину пользователя

Развертывание в масштабах предприятия

Установка в один клик со встроенной средой выполнения Node.js (без управления зависимостями)
Не требуется облачная инфраструктура, конфигурации VPN или правила брандмауэра
Элементы управления на уровне организации — администраторы могут загружать пользовательские расширения и управлять доступом через списки разрешений
Полный контроль над аутентификацией, авторизацией и журналами аудита

Выберите удаленный коннектор для:

Облачных сервисов и публичных API, требующих централизованной инфраструктуры
Распространения на Claude в веб-версии, мобильной версии и на рабочем столе
Сервисов, требующих централизованных обновлений для всех пользователей
Потоков OAuth, требующих управления токенами на стороне сервера
Публичных интеграций, используемых несколькими организациями

Ключевое отличие: MCPB работают на машине пользователя через транспорт stdio с доступом к локальным и внутренним ресурсам. Удаленные коннекторы работают на ваших серверах через HTTPS и доступны через инфраструктуру Anthropic.

Использование в реальном мире: Организации создают MCPB как безопасные прокси для внутренних MCP-серверов, для доступа к внутренней документации и для подключения инструментов разработки при сохранении архитектуры безопасности.

Для руководства по удаленным коннекторам: См. MCP Partner FAQ для полной документации по удаленным коннекторам.

2. Начало работы

Какой язык программирования мне использовать?

Node.js настоятельно рекомендуется потому что:

Поставляется с Claude для macOS и Windows (нулевое трение при установке для пользователей)
Пользователям не нужна отдельная установка среды выполнения
Лучшая совместимость и надежность с Claude Desktop
Обширная поддержка MCP SDK

Какие платформы я должен поддерживать?

Claude Desktop работает на:

macOS (darwin)
Windows (win32)

Укажите поддерживаемые платформы в разделе совместимости вашего manifest.json.

Лучшая практика: Тестируйте на обеих платформах, даже если вы в основном разрабатываете на одной.

Детали совместимости платформ: См. MCPB Manifest Spec - Compatibility для спецификации платформы и требований среды выполнения.

Как создать мой первый MCPB?

Следуйте этому пятиэтапному процессу:

1. Установите MCPB CLI: npm install -g @anthropic-ai/mcpb

2. Создайте ваш MCP-сервер (см. MCP SDK)

3. Запустите mcpb init для создания manifest.json

4. Запустите mcpb pack для объединения

5. Установите и протестируйте в Claude Desktop

Для подробного руководства по реализации:

MCPB Repository — полное руководство по началу работы, использование CLI и спецификации
MCPB Examples — рабочие эталонные реализации, включая "Hello World"
MCP SDK — реализация основного протокола

Для комплексного руководства по разработке, тестированию и лучшим практикам, см. раздел "For Bundle Developers" в MCPB README.

Важно: Перед распространением вашего MCPB ознакомьтесь с руководством по тестированию и лучшим практикам в MCPB README, чтобы обеспечить качество.

3. Конфигурация

Что такое manifest.json?

Файл manifest.json — это обязательные метаданные, которые описывают ваш MCPB — что он делает, как его запустить, какие инструменты он предоставляет и какая конфигурация ему нужна.

Для получения наиболее актуальной информации обратитесь к официальной спецификации MCPB.

MCPB Manifest Spec — полная схема со всеми полями
Example Manifests — реальные реализации
CLI Documentation — справочник команд

Как добавить значок?

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

Базовый подход: Включите файл icon.png в корневой каталог вашего пакета и ссылайтесь на него в manifest.json.

Требования:

Имя файла: icon.png (или пользовательский путь)
Размер: рекомендуется 512×512px (минимум 256×256px)
Формат: PNG с поддержкой прозрачности
Расположение: корневой каталог пакета или указанный путь

Расширенные опции: Несколько вариантов значков для разных размеров и тем (поддержка светлого/темного режима).

Детали реализации: См. MCPB Manifest Spec - Icons для:

Конфигурация поля значка
Синтаксис нескольких вариантов значков
Спецификации размера и темы
Лучшие практики и требования

Как пользователи конфигурируют мой MCPB?

Определите раздел user_config в manifest.json. Claude Desktop автоматически создает пользовательский интерфейс настроек, где пользователи могут конфигурировать ваше расширение.

См. MCPB Manifest Spec - User Configuration для полной реализации:

Полная схема и примеры
Все типы конфигурации и свойства
Ограничения валидации
Обработка чувствительных данных
Шаблоны множественного выбора

Как пользователи устанавливают мой MCPB?

Существует три различных метода установки:

Двойной клик — загрузите файл .mcpb и дважды щелкните, чтобы открыть
Перетаскивание — перетащите файл .mcpb в окно Claude Desktop
Меню файла — Developer → Extensions → Install Extension → выберите файл .mcpb

Все методы открывают пользовательский интерфейс установки, где пользователи могут:

Просмотреть детали расширения и разрешения
Конфигурировать необходимые параметры
Предоставить необходимые разрешения
Завершить установку

Область установки: Установка для каждого пользователя — каждый пользователь должен установить отдельно на своей собственной системе.

Опыт пользователя и элементы управления администратора: Для подробной информации об опыте установки конечного пользователя и элементах управления администратора предприятия (включая управление организацией Team/Enterprise и конфигурацию политики), см.:

Getting Started with Local MCP Servers on Claude Desktop — полное руководство пользователя, охватывающее просмотр каталога, пользовательский интерфейс установки, устранение неполадок и элементы управления администратора.

4. Ресурсы

Официальная документация

Фреймворк MCPB:

MCPB Repository — полная спецификация и инструменты
MCPB Manifest Spec — полная схема манифеста
MCPB CLI Documentation — справочник инструмента командной строки
MCPB Examples — эталонные реализации

Протокол MCP:

MCP Specification — документация протокола
MCP Quickstart — руководство по началу работы
TypeScript SDK — реализация Node.js
Python SDK — реализация Python

Claude Desktop:

Release Notes — обновления версий
Desktop Extensions Blog — обзор архитектуры

Получение помощи

Каналы поддержки:

MCPB GitHub Issues — отчеты об ошибках и запросы функций
MCP Specification — вопросы протокола
Claude Support — общая поддержка Claude Desktop

Ресурсы сообщества:

Проверьте обсуждения репозитория для вопросов и ответов сообщества
Следите за примечаниями к выпуску для последних обновлений
Просмотрите примеры для шаблонов реализации

Готовы к публичному распространению?

Если вы создали рабочий MCPB и хотите отправить его в Anthropic Directory для более широкого распространения и обнаружения, см. наше сопроводительное руководство: Submitting to Anthropic Directory.

Руководство по каталогу охватывает дополнительные требования, включая: