Додавання власного 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-endpoint-и блокуються. Через це сервер на localhost не можна зареєструвати з вебдодатку.
Додавання сервера
- Відкрийте Налаштування → Інструменти.
- Оберіть Додати інструмент або Додати MCP-сервер.
- Спочатку перегляньте доступні пресети.
- Оберіть Додати власний MCP-сервер.
- Введіть назву, повний endpoint та метод автентифікації.
- Збережіть конфігурацію та дочекайтеся перевірки з’єднання.
- Увімкніть сервер для вашого стандартного набору інструментів.
Адміністратор може також зареєструвати сервер для всієї системи через Адміністрування → AI-налаштування → Інструменти → MCP.
Автентифікація та секрети
AI-School підтримує connector-OAuth та статичні секрети. OAuth-токени, refresh-токени, API-ключі та паролі зберігаються лише на сервері. Чат отримує лише зареєстрований connectorId, ніколи секретну конфігурацію.
При зміні URL або автентифікації нова конфігурація спочатку перевіряється повторно. Якщо перевірка не вдається, раніше затверджена конфігурація може залишатися активною, доки проблему не вирішать.
Права на інструменти
Дозволяйте лише ті інструменти, які користувачам дійсно потрібні. MCP-сервер може пропонувати дії на читання і запис, наприклад, видалення файлів, відправлення електронної пошти або зміну записів. AI-School фільтрує виявлені інструменти за allowlist на стороні сервера, але адміністратор сервера відповідає за відповідні scopes та авторизацію.
Локальне тестування
Локальний stdio-сервер тестується у десктоп-додатку. Рендерер не може запускати довільні shell-команди: інсталяція проходить через затверджений пресет або захищений десктоп-флоу. Команда, аргументи, environment keys та запитуваний доступ показуються перед інсталяцією.
Усунення проблем
- Endpoint недоступний: перевірте HTTPS, DNS, firewall та повний шлях
/mcp. - Потрібне повторне підключення: оновіть дозвіл OAuth або збережений секрет.
- Належить до іншого середовища: зареєструйте конектор заново в поточному середовищі.
- Інструменти не відображаються: перевірте allowlist інструментів, доступ MCP та чи активний сервер.
- Працює лише на десктопі: ймовірно, сервер використовує stdio або локальну адресу.
