Добавить собственный MCP-server
С собственным MCP-server вы подключаете AI-School к собственному приложению, источнику данных или специализированному сервису. Сначала выберите транспорт, подходящий для места использования.
Выберите подходящий транспорт
| Транспорт | Web | Мобильный | Desktop | Использование |
|---|---|---|---|---|
| Streamable HTTP | Да | Да | Да | Рекомендуется для размещённых серверов |
| stdio | Нет | Нет | Да | Локальные процессы и desktop-интеграции |
| SSE | Только существующие конфигурации | Только существующие конфигурации | Да | Устаревший транспорт; для новых серверов выбирайте Streamable HTTP |
Требования для Streamable HTTP
Используйте полный публичный endpoint, включая MCP-путь, например:
https://mcp.example.nl/mcp
Endpoint должен:
- использовать HTTPS;
- работать без имени пользователя и пароля в URL;
- не требовать redirect;
- быть доступным через публичный DNS;
- отвечать на корректный MCP
initialize-handshake; - иметь явный набор разрешённых tools.
Локальные адреса, private network-адреса и cloudmetadata-endpoints блокируются. Поэтому вы не можете зарегистрировать сервер на localhost из веб-приложения.
Добавить сервер
- Откройте Настройки → Tools.
- Выберите Добавить tools или Добавить MCP-server. Эта кнопка видна только при наличии доступа к MCP.
- Сначала просмотрите доступные presets.
- Выберите Добавить собственный MCP-server.
- Укажите имя, полный endpoint и метод аутентификации.
- Сохраните конфигурацию и дождитесь проверки соединения.
- Включите сервер для вашего стандартного набора tools.
Администратор также может зарегистрировать сервер для всей среды через Управление → AI-настройки → Tools → MCP.
Аутентификация и secrets
AI-School поддерживает connector-OAuth и статические secrets. OAuth-токены, refresh tokens, API-keys и пароли хранятся в server-only storage. Чат получает только зарегистрированный connectorId, но никогда не получает секретную конфигурацию.
При изменении URL или аутентификации новая конфигурация сначала проходит повторную проверку. Если эта проверка не удаётся, ранее одобренная конфигурация может оставаться активной, пока проблема не будет устранена.
Права на tools
Разрешайте только те tools, которые действительно нужны пользователям. MCP-server может предоставлять как операции чтения, так и записи, например удаление файлов, отправку e-mail или изменение records. AI-School фильтрует обнаруженные tools через серверный allowlist, но администратор сервера по-прежнему отвечает за соответствующие scopes и авторизацию.
Локальное тестирование
Локальный stdio-server тестируется в desktop-app. Renderer не может запускать произвольные shell-команды: установка выполняется через одобренный preset или безопасный desktop-flow. Command, аргументы, environmentkeys и запрашиваемый доступ показываются до установки.
Устранение проблем
- Endpoint недоступен: проверьте HTTPS, DNS, firewall и полный путь
/mcp. - Требуется повторное подключение: обновите OAuth-разрешение или сохранённый secret.
- Относится к другой среде: зарегистрируйте connector заново в текущей среде.
- Не видно tools: проверьте tool-allowlist, ваш доступ к MCP и активен ли сервер.
- Работает только на desktop: вероятно, сервер использует stdio или локальный адрес.
Ресурсы для разработки
См. также
При редактировании загружается зарегистрированная конфигурация сервера. Сохранённый ключ остаётся скрытым: оставьте поле ключа пустым, чтобы сохранить его. При другом URL или методе аутентификации требуется повторное подключение. Ошибка в одном MCP-tool не означает, что все tools этого сервера недоступны.