Добавить собственный MCP-сервер
С собственным MCP-сервером вы подключаете AI-Public к системе ведения дел, архиву, источнику данных или другой специализированной службе. Сначала выберите транспорт, который подходит для места использования.
Выберите подходящий транспорт
| Транспорт | Веб | Мобильный | Рабочий стол | Использование |
|---|---|---|---|---|
| Streamable HTTP | Да | Да | Да | Рекомендуется для размещённых серверов |
| stdio | Нет | Нет | Да | Локальные процессы и интеграции для рабочего стола |
| 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-server. Эта кнопка видна только если у вас есть доступ к MCP.
- Просмотрите доступные пресеты.
- Выберите Добавить собственный MCP-server.
- Укажите имя, полный 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 servers
Локальный stdio-server устанавливается в desktop app. Command, arguments, environment keys и запрашиваемый доступ ограничиваются и показываются до одобрения. Secrets шифруются локально.
Устранение проблем
- Endpoint недоступен: проверьте HTTPS, DNS, firewall и полный путь
/mcp. - Требуется повторное подключение: обновите OAuth-согласие или сохранённый secret.
- Относится к другой среде: зарегистрируйте connector заново в текущей среде.
- Tools не видны: проверьте allowlist, доступ по роли и активный статус.
- Работает только на desktop: вероятно, сервер использует stdio или локальный адрес.
Ресурсы для разработки
См. также
При редактировании загружается зарегистрированная конфигурация сервера. Сохранённый ключ остаётся скрытым: оставьте поле ключа пустым, чтобы сохранить его. При другом URL или методе аутентификации требуется повторное подключение. Ошибка в одном MCP-tool не означает, что все tools этого сервера недоступны.