Додавання власного MCP-сервера
За допомогою власного MCP-сервера ви підключаєте AI-School до власної програми, джерела даних або спеціалізованої служби. Спочатку виберіть транспорт, який підходить для місця використання.
Виберіть правильний транспорт
| Транспорт | Веб | Мобільний | 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.
Локальні адреси, адреси приватної мережі та cloud metadata 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 може пропонувати як операції читання, так і запису, наприклад видалення файлів, надсилання електронної пошти або зміну записів. AI-School фільтрує виявлені tools через server-side allowlist, але адміністратор сервера все одно відповідає за належні scopes і авторизацію.
Локальне тестування
Локальний stdio-server тестують у desktop app. Renderer не може запускати довільні shell-команди: встановлення відбувається через схвалений preset або захищений desktop flow. Команда, аргументи, environment keys і запитаний доступ показуються перед встановленням.
Усунення проблем
- Endpoint недоступний: перевірте HTTPS, DNS, firewall і повний шлях
/mcp. - Потрібно повторно підключитися: оновіть OAuth-дозвіл або збережений secret.
- Належить до іншого середовища: зареєструйте connector повторно в поточному середовищі.
- Не видно tools: перевірте tool allowlist, ваш доступ до MCP і чи сервер активний.
- Працює лише на desktop: ймовірно, сервер використовує stdio або локальну адресу.
Ресурси для розробки
Див. також
Під час редагування завантажується зареєстрована конфігурація сервера. Збережений ключ залишається прихованим: залиште поле ключа порожнім, щоб зберегти його. За іншої URL або методу автентифікації потрібне повторне підключення. Помилка в одному MCP-tool не означає, що всі tools цього сервера недоступні.