Это руководство поможет вам создать 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 и браузера, без управления токенами
Соответствие zero-trust — работает в границах корпоративной сети без открытого доступа к внутренним ресурсам

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

Прямой доступ к файловой системе для редактирования кода и операций 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