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

1. Введение

Что такое MCPB?

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

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

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

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

Репозиторий MCPB — полная спецификация и архитектура
Блог о расширениях для рабочего стола — обзор и варианты использования

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

macOS (darwin)
Windows (win32)

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

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

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

Как создать мой первый 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 — полное руководство по началу работы, использование CLI и спецификации
Примеры MCPB — рабочие эталонные реализации, включая "Hello World"
MCP SDK — реализация основного протокола

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

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

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

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

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

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

Спецификация манифеста MCPB — полная схема со всеми полями
Примеры манифестов — реальные реализации
Документация CLI — справочник команд

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

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

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

Требования:

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

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

Детали реализации: См. Спецификация манифеста MCPB — значки для:

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

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

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

См. Спецификация манифеста MCPB — конфигурация пользователя для полной реализации:

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

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

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

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

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

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

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

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

Начало работы с локальными MCP-серверами на Claude Desktop — полное руководство пользователя, охватывающее просмотр каталога, пользовательский интерфейс установки, устранение неполадок и элементы управления администратора.

4. Ресурсы

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

Фреймворк MCPB:

Репозиторий MCPB — полная спецификация и инструменты
Спецификация манифеста MCPB — полная схема манифеста
Документация MCPB CLI — справочник инструмента командной строки
Примеры MCPB — эталонные реализации

Протокол MCP:

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

Claude Desktop:

Примечания к выпуску — обновления версий
Блог о расширениях для рабочего стола — обзор архитектуры

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

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

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

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

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

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

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

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