К основному содержимому

Начало работы с локальными MCP серверами на Claude Desktop

Обновлено больше недели назад

Model Context Protocol (MCP) — это открытый протокол, который обеспечивает беспрепятственную интеграцию между приложениями LLM и внешними источниками данных и инструментами. С введением расширений для рабочего стола установка и управление локальными серверами MCP стали значительно проще.

Расширения для рабочего стола

Расширения для рабочего стола предоставляют упрощенный способ установки и управления локальными серверами MCP через устанавливаемые одним щелчком пакеты. Вместо ручной настройки файлов JSON и управления зависимостями вы теперь можете устанавливать локальные серверы MCP на свой компьютер так же легко, как расширения браузера.

Примечание: Мы создаем каталог расширений для рабочего стола — если вы разработчик и хотите добавить созданное вами расширение в каталог, заполните нашу форму интереса к расширениям для рабочего стола, чтобы поделиться с нами дополнительной информацией.

Установка расширений для рабочего стола из каталога

  1. Перейдите в Параметры > Расширения в Claude Desktop.

  2. Нажмите «Обзор расширений», чтобы просмотреть наш каталог, и нажмите на любые проверенные Anthropic инструменты, которые вы хотите использовать. Нажмите «Установить» на нужном расширении.

  3. Настройте необходимые параметры (например, ключи API) через удобный интерфейс.

  4. Расширение автоматически станет доступным в ваших беседах.

Установка пользовательских расширений для рабочего стола

  1. Перейдите в Параметры > Расширения в Claude Desktop.

  2. Нажмите «Дополнительные параметры» и найдите раздел Разработчик расширений.

  3. Нажмите «Установить расширение…»

  4. Выберите файл .mcpb и следуйте подсказкам для установки.

Элементы управления администратора для расширений рабочего стола

Владельцы и основные владельцы планов Team и Enterprise могут управлять доступом команды к расширениям рабочего стола, используя два элемента управления:

  1. Включение или отключение общедоступных расширений рабочего стола в зависимости от стандартов безопасности вашей организации.

  2. Загрузка пользовательских расширений рабочего стола и предоставление их команде для установки одним щелчком.

Эти элементы управления позволяют организациям полностью настраивать свои реестры, добавляя только необходимые команде расширения и удаляя все остальные.

Включение/отключение определенных расширений в планах Team и Enterprise

Владельцы и основные владельцы организаций Team и Enterprise могут управлять тем, какие расширения рабочего стола включены для вашей организации и доступны другим членам через Claude Desktop. См. Включение и использование списка разрешений расширений рабочего стола

для получения конкретных инструкций.

Создание и загрузка пользовательских расширений для вашей организации

Загрузка пользовательских расширений рабочего стола позволяет планам Team и Enterprise использовать рабочие процессы, специфичные для организации, которые недоступны в общедоступном каталоге. После создания пользовательского расширения рабочего стола владельцы и основные владельцы могут перейти в Параметры > Расширения в Claude Desktop и нажать «Дополнительные параметры» для доступа к разделу Разработчик расширений:

Нажмите «Установить расширение…» и выберите файл .mcpb. Следуйте подсказкам для установки и настройки пользовательского расширения рабочего стола. Для получения более подробной информации обратитесь к нашей документации разработчика расширений рабочего стола.

Элементы управления политикой Enterprise

Примечание: Элементы управления политикой Enterprise на уровне пользователя и машины переопределяют любые элементы управления в приложении (список блокировки и список разрешений). Если вы хотите использовать элемент управления в приложении, убедитесь, что isDesktopExtensionEnabled и isDesktopExtensionDirectoryEnabled не установлены на «false», чтобы список разрешений мог заполнить доступный реестр.

Для управления расширениями рабочего стола через системные политики обратитесь к нашей документации по конфигурации Enterprise рабочего стола.

Устранение неполадок при установке расширений рабочего стола

Расширение не устанавливается

  • Убедитесь, что вы используете последнюю версию Claude Desktop.

  • Проверьте, что файл расширения не поврежден, повторно загрузив его.

  • Убедитесь, что у вас достаточно свободного места на диске для установки.

Расширение кажется установленным, но инструменты недоступны

  • Перезагрузите Claude Desktop, чтобы обновить реестр расширений.

  • Проверьте параметры конфигурации расширения на предмет отсутствующих обязательных полей.

  • Убедитесь, что ключи API или учетные данные аутентификации введены правильно.

Проблемы с конфигурацией расширения

  • Перейдите в Параметры > Расширения и нажмите на расширение, чтобы просмотреть его параметры.

  • Убедитесь, что все обязательные поля конфигурации заполнены.

  • Проверьте, что пути к файлам (если применимо) указывают на существующие каталоги, к которым у вас есть доступ.

Ошибки разрешений или безопасности

  • На macOS проверьте Системные параметры > Безопасность и конфиденциальность, если вы получаете предупреждения безопасности.

  • На Windows убедитесь, что Claude Desktop имеет необходимые разрешения для доступа к требуемым каталогам.

  • Для корпоративных сред убедитесь, что расширения рабочего стола включены через политики вашей организации.

Часто задаваемые вопросы разработчика

Как проверить, правильно ли подключены мои серверы MCP в Claude Desktop?

Нажмите кнопку «+» в нижней части поля чата в Claude Desktop, затем выберите «Соединители». Это покажет вам подключенные серверы MCP и их инструменты. Кроме того, вы можете посетить параметры разработчика (в разделе Приложение рабочего стола), чтобы увидеть статус подключения и просмотреть журналы для любых серверов MCP.

Как преобразовать мой существующий сервер MCP в расширение рабочего стола?

  1. Добавьте файл manifest.json в каталог вашего сервера MCP с необходимыми метаданными.

  2. Упакуйте его с помощью команды mcpb pack.

  3. См. документацию MCPB для получения подробных инструкций.

Какие языки программирования поддерживаются для расширений рабочего стола?

Расширения рабочего стола поддерживают Node.js, Python и двоичные серверы MCP. Claude Desktop включает встроенную среду Node.js, поэтому установка Node.js не требуется.

Как обрабатывать конфиденциальную конфигурацию, такую как ключи API?

Отметьте поля конфигурации как «sensitive»: true в вашем manifest.json. Claude Desktop автоматически зашифрует эти значения, используя безопасное хранилище операционной системы (Keychain на macOS, Credential Manager на Windows).

Могу ли я распространять свое пользовательское расширение рабочего стола в частном порядке?

Да, вы можете делиться файлами .mcpb непосредственно с конкретными пользователями или командами. Для более широкого распространения вы можете отправить расширения в официальный каталог.

Как отладить проблемы с моим расширением рабочего стола?

Включите отладочное логирование в параметрах Claude Desktop, проверьте журналы расширений на панели параметров расширений и обратитесь к руководству по отладке MCP для устранения неполадок, специфичных для протокола.

Что происходит, когда мое расширение требует обновления?

Расширения из официального каталога обновляются автоматически по умолчанию. Для частно распространяемых расширений пользователям потребуется вручную установить обновленные файлы .mcpb.

Хотите узнать больше о MCP?

Для получения более подробной информации о создании собственных клиентов и серверов MCP мы рекомендуем ознакомиться со следующими ресурсами:

Если вам нужна дополнительная помощь, посетите наше руководство Как получить поддержку для получения дополнительных вариантов поддержки.

Нашли ответ на свой вопрос?