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

Создание пользовательских соединителей через удаленные MCP серверы

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

Пользовательские соединители с использованием удаленного MCP доступны в Claude и Claude Desktop для пользователей с планами Pro, Max, Team и Enterprise.

Создание удаленных серверов MCP

Чтобы начать работу с удаленными серверами, используйте следующие ресурсы:

Другие ресурсы (например, этот) также могут быть полезны для изучения аспектов при создании, развертывании и устранении неполадок удаленных серверов.

Кроме того, некоторые решения, такие как Cloudflare, предоставляют хостинг удаленных серверов MCP со встроенным автомасштабированием, управлением токенами OAuth и развертыванием.

Поддержка MCP

Платформы

  • Удаленные серверы MCP поддерживаются в Claude и Claude Desktop для планов Pro, Max, Team и Enterprise.

    • Чтобы настроить удаленные серверы MCP для использования в Claude Desktop, добавьте их через Параметры > Соединители. Claude Desktop не будет подключаться к удаленным серверам, которые настроены непосредственно через claude_desktop_config.json.

  • Начиная с июля, Claude для iOS и Android также поддерживают удаленные серверы MCP!

    • Пользователи могут использовать инструменты, подсказки и ресурсы с удаленных серверов, которые они уже добавили через claude.ai. Пользователи не могут добавлять новые серверы непосредственно из Claude Mobile.

Транспорт и аутентификация

  • Claude поддерживает как удаленные серверы на основе SSE, так и Streamable HTTP, хотя поддержка SSE может быть прекращена в ближайшие месяцы.

  • Claude поддерживает как удаленные серверы без аутентификации, так и на основе OAuth.

Поддержка аутентификации

    • Серверы OAuth могут сигнализировать Claude, что клиент DCR был удален и что Claude должен повторно зарегистрировать клиента, возвращая HTTP 401 с ошибкой invalid_client из конечной точки токена, как описано в RFC 6749.

    • Начиная с июля, пользователи также могут указать пользовательский идентификатор клиента и секрет клиента при настройке сервера, который не поддерживает DCR.

  • URL обратного вызова OAuth для Claude — https://claude.ai/api/mcp/auth_callback, а имя клиента OAuth — Claude.

    • Этот URL обратного вызова может измениться на https://claude.com/api/mcp/auth_callback в будущем — если вы решите добавить в белый список URL обратного вызова клиента MCP, пожалуйста, также добавьте этот URL обратного вызова в белый список, чтобы убедиться, что ваш сервер продолжит работать с Claude.

  • Claude поддерживает истечение и обновление токенов — серверы должны поддерживать эту функциональность, чтобы обеспечить лучший опыт для пользователей.

Смотрите здесь IP-адреса, используемые Claude для входящих и исходящих соединений с серверами MCP. Разработчики серверов, желающие запретить не-Claude MCP клиентов, могут добавить в белый список эти IP-адреса, URL обратного вызова OAuth Claude и/или имя клиента OAuth Claude.

Функции протокола

  • Claude поддерживает инструменты, подсказки и ресурсы.

    • Claude поддерживает результаты инструментов на основе текста и изображений.

    • Claude поддерживает ресурсы на основе текста и двоичных данных.

  • Claude пока не поддерживает подписки на ресурсы, выборку и другие более продвинутые или черновые возможности.

Тестирование удаленных серверов MCP

Лучший способ протестировать и проверить сервер — попробовать добавить его в Claude.

Альтернативно, используйте инструмент инспектора. Это позволит вам проверить:

  • что ваш сервер успешно инициирует и завершает поток аутентификации.

  • что ваш сервер правильно реализует различные части потока аутентификации.

  • какие инструменты, подсказки, ресурсы и другие функции MCP предоставляет ваш сервер.

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

Кроме того, другие решения, такие как AI Playground от Cloudflare, позволяют вам протестировать функциональность удаленного сервера MCP.

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