Добавление собственного MCP-сервера
С помощью собственного MCP-сервера вы связываете AI-School с собственным приложением, источником данных или специализированной службой. Сначала выберите транспорт, подходящий для места использования.
Выберите правильный транспорт
| Транспорт | Веб | Мобильный | Десктоп | Использование |
|---|---|---|---|---|
| Streamable HTTP | Да | Да | Да | Рекомендуется для размещённых серверов |
| stdio | Нет | Нет | Да | Локальные процессы и интеграции на десктопе |
| SSE | Только существующие конфигурации | Только существующие конфигурации | Да | Устаревший транспорт; для новых серверов выбирайте Streamable HTTP |
Требования к Streamable HTTP
Используйте полный публичный endpoint, включая путь MCP, например:
https://mcp.example.nl/mcp
Endpoint должен:
- использовать HTTPS;
- работать без имени пользователя и пароля в URL;
- не требовать перенаправления;
- быть доступным через публичный DNS;
- отвечать на корректный MCP
initialize-handshake; - иметь явный набор разрешённых инструментов.
Локальные адреса, адреса частных сетей и cloudmetadata-endpoints блокируются. Поэтому сервер на localhost нельзя зарегистрировать из веб-приложения.
Добавление сервера
- Откройте Настройки → Инструменты.
- Выберите Добавить инструменты или Добавить MCP-сервер.
- Сначала ознакомьтесь с доступными пресетами.
- Выберите Добавить собственный MCP-сервер.
- Введите имя, полный endpoint и метод аутентификации.
- Сохраните конфигурацию и дождитесь проверки соединения.
- Включите сервер для вашего стандартного набора инструментов.
Администратор может зарегистрировать сервер для всей среды через Администрирование → AI-настройки → Инструменты → MCP.
Аутентификация и секреты
AI-School поддерживает connector-OAuth и статические секреты. OAuth-токены, refresh-токены, API-ключи и пароли хранятся только на сервере. Чат получает только зарегистрированный connectorId, никогда не получает секретную конфигурацию.
При изменении URL или аутентификации новая конфигурация сначала проверяется заново. Если проверка не проходит, ранее одобренная конфигурация может оставаться активной до устранения проблемы.
Права на инструменты
Разрешайте только те инструменты, которые действительно нужны пользователям. MCP-сервер может предоставлять действия на чтение и запись, например удаление файлов, отправку почты или изменение записей. AI-School фильтрует обнаруженные инструменты по серверной allowlist, но администратор сервера остаётся ответственным за корректные scopes и авторизацию.
Локальное тестирование
Локальный stdio-сервер тестируется в десктоп-приложении. Рендерер не может запускать произвольные shell-команды: установка происходит через одобренный пресет или защищённый десктоп-флоу. Команда, аргументы, переменные окружения и запрашиваемый доступ показываются перед установкой.
Устранение неполадок
- Endpoint недоступен: проверьте HTTPS, DNS, firewall и полный путь
/mcp. - Требуется повторное подключение: обновите OAuth-разрешение или сохранённый секрет.
- Принадлежит другой среде: зарегистрируйте коннектор заново в текущей среде.
- Инструменты не видны: проверьте allowlist инструментов, доступ MCP и активность сервера.
- Работает только на десктопе: вероятно, сервер использует stdio или локальный адрес.
