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