Додавання власного MCP-сервера
За допомогою власного MCP-сервера ви підключаєте AI-Public до системи обліку справ, архіву, джерела даних або іншої спеціалізованої служби. Спочатку виберіть транспорт, який підходить для місця використання.
Оберіть правильний транспорт
| Транспорт | Веб | Мобільний | Desktop | Використання |
|---|---|---|---|---|
| Streamable HTTP | Так | Так | Так | Рекомендовано для розміщених серверів |
| stdio | Ні | Ні | Так | Локальні процеси та інтеграції для desktop |
| SSE | Лише наявні конфігурації | Лише наявні конфігурації | Так | Застарілий транспорт; для нових серверів обирайте Streamable HTTP |
Вимоги до Streamable HTTP
Використовуйте повний публічний endpoint, включно з MCP-шляхом, наприклад:
https://mcp.organisatie.nl/mcp
Endpoint має використовувати HTTPS, бути доступним через публічний DNS без redirect і відповідати дійсному MCP initialize-handshake. Імена користувачів і паролі не повинні бути в URL. Локальні адреси, адреси приватної мережі та cloud metadata endpoints блокуються.
Додавання сервера
- Відкрийте Налаштування → Tools.
- Виберіть Додати tools або Додати MCP-сервер. Цю кнопку ви бачите лише якщо маєте доступ до MCP.
- Перегляньте доступні preset-и.
- Виберіть Додати власний MCP-сервер.
- Вкажіть назву, повний endpoint і метод автентифікації.
- Збережіть конфігурацію та дочекайтеся перевірки підключення.
- Увімкніть сервер для вашого стандартного набору tools.
Адміністратор може через Адміністрування → Tools → MCP зареєструвати сервер для всієї середовища.
Автентифікація та secrets
AI-Public підтримує connector-OAuth і статичні secrets. OAuth-токени, refresh tokens, API-ключі та паролі зберігаються у server-only storage. Чат отримує лише зареєстрований connectorId, ніколи — секретну конфігурацію.
Після зміни URL або автентифікації нова конфігурація спочатку перевіряється повторно. Якщо ця перевірка не вдається, раніше схвалена конфігурація може залишатися активною, доки проблему не буде усунено.
Права на tools та інформаційна безпека
Надавайте доступ лише до тих tools, які користувачам справді потрібні. MCP-сервер може пропонувати як операції читання, так і запису. AI-Public фільтрує виявлені tools через server-side allowlist і перевіряє середовище, власника та роль під час кожного використання. Організація відповідає за належні scopes, logging, строки зберігання та авторизацію в системі-джерелі.
Локальні desktop-сервери
Локальний stdio-сервер ви встановлюєте в desktop app. Command, аргументи, environmentkeys і запитуваний доступ обмежуються та показуються до схвалення. Secrets шифруються локально.
Усунення проблем
- Endpoint недоступний: перевірте HTTPS, DNS, firewall і повний шлях
/mcp. - Потрібне повторне підключення: оновіть OAuth-дозвіл або збережений secret.
- Належить до іншого середовища: зареєструйте connector повторно в поточному середовищі.
- Немає видимих tools: перевірте allowlist, доступ за роллю та активний статус.
- Працює лише на desktop: імовірно, сервер використовує stdio або локальну адресу.
Ресурси для розробки
Див. також
Під час редагування завантажується зареєстрована конфігурація сервера. Збережений ключ залишається прихованим: залиште поле ключа порожнім, щоб його зберегти. За іншого URL або методу автентифікації потрібне повторне підключення. Помилка в одному MCP-tool не означає, що всі tools цього сервера недоступні.