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