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

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

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

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

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

Примечание: Если вы разработчик и хотите добавить расширение для рабочего стола (локальный сервер MCP для Claude Desktop) в каталог, отправьте его через форму отправки расширения для рабочего стола. Чтобы отправить плагин или удалённый соединитель, используйте портал разработчика. Информацию о том, что принимает каждый маршрут, см. в разделе Отправка вашего плагина.

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

  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 и Linux убедитесь, что 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 и менеджер ключей вашего дистрибутива на Linux).

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

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

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

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

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

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

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

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

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

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