Агент может показать карточку подключения для пользовательского сервера MCP, в том числе отсутствующего в стандартном каталоге приложений. Карточка открывает настройку Clero, где вы можете проверить сервер и пройти авторизацию, не помещая учётные данные в чат.
Используйте этот вариант, когда внешний сервис предоставляет общедоступную конечную точку Streamable HTTP MCP по HTTPS. Руководство описывает этот способ подключения, а не локальный процесс stdio. Само подключение не определяет, какими инструментами может пользоваться агент, и не разрешает все действия, которые они поддерживают.
Требования к запросам подключения также действуют: текущий исходный код требует принятого членства в организации в роли admin/champion с разрешением на управление интеграциями и агента с соответствующими включёнными возможностями.
Подготовьте правильную конечную точку
Вам нужны фактическая конечная точка MCP по HTTPS сервера, его владелец и ожидаемый метод аутентификации. Главная страница продукта не обязательно является его конечной точкой MCP. Используйте официальную документацию сервиса по настройке или сведения, предоставленные владельцем сервера.
Агент может искать в доступном каталоге подключений и находить нужную информацию по настройке. Он не должен придумывать URL, идентификатор клиента, токен или значение заголовка для заполнения карточки. Если конечная точка отсутствует, предоставьте или подтвердите её перед продолжением. Одного названия в каталоге не всегда достаточно для получения конечной точки, необходимой для пользовательской настройки.
Запросите у агента карточку пользовательского подключения
Пример ограниченного запроса:
Я хочу использовать пользовательский сервер MCP от [сервис или владелец сервера] для [задача]. Его документированная конечная точка MCP по HTTPS — [конечная точка]. Покажи карточку подключения и объясни, какая аутентификация ему нужна. Я введу учётные данные в форме настройки. Пока не запускай инструменты сервера.
Если вы не знаете конечную точку:
Найди официальные инструкции по настройке MCP для [сервис]. Определи поддерживаемую конечную точку и метод аутентификации, затем покажи карточку подключения, если необходимые сведения доступны. Спроси меня обо всём, что не удаётся проверить.
Агент может подготовить запрос; вы всё равно проверяете место назначения и решаете, разрешать ли авторизацию. Карточка не доказывает надёжность сервера или то, что доступ уже предоставлен.
Проверьте карточку и настройки подключения
- Проверьте название подключения на карточке, причину запроса, конечную точку, если она показана, и обозначение аутентификации.
- Выберите Connect (Подключить).
- Изучите предварительно заполненную форму настройки. Разверните Review connection settings (Проверить настройки подключения), чтобы проверить Endpoint URL (URL конечной точки) и необязательное Connection Name (Название подключения) или исправить конфигурацию.
- Убедитесь, что конечная точка и аутентификация соответствуют нужному серверу.
- Для OAuth выберите Continue to Provider (Перейти к провайдеру) и изучите процесс у провайдера. Для ручной аутентификации заполните соответствующие поля и выберите Connect (Подключить), только когда готовы отправить конфигурацию.
- Вернитесь в разговор и проверьте сохранённое подключение и необходимый доступ к инструментам.
Не одобряйте другой сервер только из-за сходства его названия с нужным сервисом. Если место назначения неверное или запрос не нужен, выберите Cancel (Отмена) на карточке для ненужного запроса либо попросите агента исправить конфигурацию. Само закрытие окна настройки не разрешает запрос.
Выберите аутентификацию, необходимую серверу
Форма предлагает процесс OAuth и ручную аутентификацию через Auth Type (Тип аутентификации). Поддерживаются следующие варианты:
| Вариант | Что вы предоставляете или проверяете |
|---|---|
| OAuth | Процесс входа и согласия сервера; перед одобрением проверьте учётную запись и доступ |
| None (Нет) | Учётные данные для аутентификации не требуются; используйте, только если сервер намеренно настроен на доступ без аутентификации |
| Bearer token (Токен Bearer) | Необходимый токен в поле Bearer Token (Токен Bearer) |
| Custom header (Пользовательский заголовок) | Необходимые Auth Header Name (Имя заголовка аутентификации) и Header Value (Значение заголовка) |
Вариант «None» (Нет) не позволяет обойти аутентификацию защищённого сервера. Используйте метод, описанный его владельцем. Токен Bearer или пользовательский заголовок могут предоставлять широкие возможности; используйте предназначенные для задачи учётные данные и область доступа, а не полномочия широкого действия по умолчанию.
Никогда не помещайте токены, пароли, секреты клиентов или секретные значения заголовков в разговор, снимок экрана или пример документа. Агент может помочь определить нужное поле, не получая его секретное значение в чате.
Проверяйте расширенные настройки только при необходимости
Текущая форма может показывать Protocol Version (Версия протокола), External ID (Внешний идентификатор) и Extra Headers (Дополнительные заголовки). Раздел Advanced OAuth settings (Расширенные настройки OAuth) включает Client ID (Идентификатор клиента), Client Secret (Секрет клиента), Authorization Server URL (URL сервера авторизации), Resource Metadata URL (URL метаданных ресурса), Authorize URL (URL авторизации), Token URL (URL токена) и Scopes (Области разрешений). Заполняйте их только тогда, когда этого требует документированная настройка сервера; не угадывайте значения и не копируйте конфигурацию OAuth постороннего приложения.
Необязательные Context Parameters (Параметры контекста) передают выбранный контекст вместе с вызовами сервера. Перед включением проверьте, чем вы намерены делиться. Если доступна опция Test connection before saving (Проверить подключение перед сохранением), она выполняет поиск инструментов и обращается к серверу; это не только локальная проверка формы. Её исходное состояние может зависеть от предустановки. Подключение, сохранённое без успешной проверки, не доказывает работоспособность нужной операции.
Вернитесь и проверьте нужную возможность
После настройки карточка обновляется, и агент может продолжить, когда запросы подключения и вопросы из ответа разрешены. Вы также можете попросить проверить доступность конкретного нужного инструмента. Начните с ограниченной операции только на чтение, если сервер её поддерживает:
Проверь, готово ли это подключение MCP и есть ли у тебя возможность, необходимая для [конкретная задача только на чтение]. Сообщи о недостающих разрешениях на инструменты. Ничего не создавай, не изменяй, не публикуй и не удаляй.
Clero подтверждает сохранённое подключение, но агенту всё ещё может требоваться доступ к его инструментам. Успешное пользовательское подключение MCP создаёт отдельный пункт инструментов этого подключения; оно не выдаёт автоматически разрешение на этот пункт запрашивающему агенту. См. Возможности. Обнаружение инструмента не означает, что вы запросили все действия, которые он может выполнять.
Устраните конкретную проблему настройки
- Нет карточки: Уточните точный сервис или пользовательское подключение MCP и подтвердите наличие реальной конечной точки HTTPS.
- Неверные настройки: Проверьте конечную точку и вариант аутентификации перед отправкой; не исправляйте неверный URL добавлением более широких учётных данных.
- Настройка не удалась: Прочитайте ошибку. После сбоя карточка может предложить Try again (Повторить); повторите исправленную настройку, а не внешнюю операцию с неясным результатом.
- Подключено, но инструменты недоступны: Спросите, какого разрешения на инструмент или возможности не хватает. Новое подключение само по себе не решает любую ошибку разрешений.
- Нужно повторное подключение или учётная запись изменилась: Снова запросите карточку для этого подключения. Подтверждённое исходным кодом повторное подключение может использовать сохранённую конечную точку, название и другие несекретные настройки, но никогда не подставляет секреты. Проверьте учётную запись и запрашиваемый доступ; вводите заменяющие учётные данные только в форме настройки. Отсутствующую сохранённую конечную точку нужно исправить, а не угадывать.
Общий процесс от карточки до авторизации описан в статье Подключение приложений через агента, а диагностический список — в статье Устранение неполадок подключения.
Что проверено для документации
Контракт карточки и формы, а также варианты аутентификации подтверждены исходным кодом. В изолированной демонстрации пользовательская карточка не отображалась: инициатор запроса и агент не соответствовали требованиям к запросам подключения, а фактическая конечная точка не была предоставлена. Для этого руководства пользовательский сервер MCP не подключали, учётные данные не отправляли и инструменты сервера не запускали. Точное поведение развёрнутой системы может зависеть от аутентификации сервера и доступных возможностей.