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