Авторизация MCP-сервера

Авторизация собственного сервера

У собственного MCP-сервера режимы авторизации появляются после первого сохранения. На странице редактирования доступны четыре вкладки:

• «Без авторизации»;
• «Токен доступа»;
• «Свои заголовки»;
• «MCP OAuth».

Без авторизации

Выберите этот режим, если сервер принимает запросы без дополнительных заголовков авторизации. Секреты вводить не нужно.

Токен доступа

Кабинет формирует заголовок Authorization: Bearer <токен>. Заполните поле токена только самим значением, без слова Bearer.

Свои заголовки

Вкладка «Свои заголовки» нужна для пар имени и секретного значения при нестандартной схеме.

Нажмите «Добавить заголовок», затем заполните имя и значение каждой строки. Ненужную строку можно удалить.

MCP OAuth

Вкладка «MCP OAuth» запускает стандартный OAuth удалённого MCP-сервера.

При редактировании уже сохранённый секрет не выводится. Если форма сообщает, что секрет сохранён и скрыт, пустое поле сохраняет прежнее значение при том же режиме авторизации. Переход на другой режим требует данных, необходимых новому режиму.

При выборе MCP OAuth кнопка сохранения может называться «Сохранить и авторизоваться». После сохранения открывается внешнее окно OAuth; подключение считается завершённым только после успешного возврата из него.

Если MCP-сервер выдал refresh_token и время действия access token, Senler обновляет проектный токен незадолго до истечения. Если сервер раньше времени ответил ошибкой авторизации, Senler один раз принудительно обновит токен и повторит загрузку методов или вызов инструмента. Когда сервер отклоняет refresh token, данные доступа получают ошибочный статус: повторно пройдите MCP OAuth на странице подключения. Вводить новый access token вручную при штатном обновлении не нужно.

Авторизация готового сервера

Готовый сервер показывает только методы, разрешённые шаблоном. Если он использует единые данные проекта, откройте вкладку «Токен или заголовки». Шаблон покажет либо одно поле токена, либо свой набор заголовков. Подсказка поля может содержать обязательность и префикс; значение префикса добавляется формой по правилам шаблона.

Заполните ручные данные и нажмите «Сохранить». Если шаблон поддерживает OAuth, для смены способа подключения выберите вкладку «MCP OAuth».

На вкладке OAuth нажмите кнопку подключения и завершите внешний вход.

Данные подключения вводятся и заменяются только на этой странице или во внешнем окне OAuth. После сохранения авторизация применяется к методам MCP-сервера автоматически. Не передавайте токен в чате или инструкции агента. Чтобы выбрать другой аккаунт, повторно пройдите OAuth либо замените ручные данные здесь.

Проверка данных проекта

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

• «Активен» означает, что последняя проверка вернула действительные данные;
• «Неверный токен» означает неуспешную проверку;
• «Неизвестно» означает, что подтверждённого результата проверки нет;
• «Нет данных доступа» означает, что ручные данные или OAuth ещё не сохранены.

Проверка доступна только после появления проектных данных доступа.

Авторизация по лидам

Если шаблон поддерживает авторизацию пользователя, а не проекта, сервер получает режим «По лидам». В настройках проекта нет общего токена для такого подключения: внешний аккаунт связывается отдельно для конкретного пользователя, когда это требует инструмент.

Не заменяйте режим «По лидам» общим секретом в описании или инструкции агента. Секреты должны проходить через предусмотренный сервером поток авторизации.

Удаление подключения

Нажмите «Удалить» и подтвердите действие через кнопку в окне подтверждения. После удаления агенты, в которых было выбрано это подключение, не смогут использовать его инструменты, пока не будет выбрано другое подключение.

Перед удалением проверьте настройки агентов проекта.