Добавление собственного 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. Локальные адреса, адреса частных сетей и endpoints метаданных облака блокируются.
Добавление сервера
- Откройте Настройки → Инструменты.
- Выберите Добавить инструмент или Добавить MCP-сервер.
- Просмотрите доступные пресеты.
- Выберите Добавить собственный MCP-сервер.
- Введите имя, полный endpoint и метод аутентификации.
- Сохраните конфигурацию и дождитесь проверки соединения.
- Включите сервер для вашего стандартного набора инструментов.
Администратор может зарегистрировать сервер для всей среды через Управление → Инструменты → MCP.
Аутентификация и секреты
AI-Public поддерживает connector-OAuth и статические секреты. OAuth-токены, refresh-токены, API-ключи и пароли хранятся только на сервере. Чат получает только зарегистрированный connectorId, никогда не передаются секретные данные конфигурации.
При изменении URL или аутентификации новая конфигурация сначала проверяется заново. Если проверка неудачна, ранее одобренная конфигурация может оставаться активной до устранения проблемы.
Права инструментов и информационная безопасность
Разрешайте только те инструменты, которые действительно нужны пользователям. MCP-сервер может предоставлять действия на чтение и запись. AI-Public фильтрует обнаруженные инструменты по серверному allowlist и проверяет окружение, владельца и роль при каждом использовании. Организация остаётся ответственной за соответствующие области доступа, ведение логов, сроки хранения и авторизацию в исходной системе.
Локальные десктоп-серверы
Локальный stdio-сервер устанавливается в десктоп-приложении. Команды, аргументы, переменные окружения и запрашиваемый доступ ограничены и показываются перед одобрением. Секреты шифруются локально.
Устранение неполадок
- Endpoint недоступен: проверьте HTTPS, DNS, файрвол и полный путь
/mcp. - Требуется повторное подключение: обновите разрешение OAuth или сохранённый секрет.
- Относится к другой среде: зарегистрируйте коннектор заново в текущей среде.
- Инструменты не отображаются: проверьте allowlist, доступ по ролям и активный статус.
- Работает только на десктопе: вероятно, сервер использует stdio или локальный адрес.
