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

Начало работы с локальными серверами 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 и 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 мы рекомендуем ознакомиться со следующими ресурсами:

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

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