Custom MCP Server

Подключите свой самохостный сервер Model Context Protocol (MCP) по HTTP.

Как подключить

1. Откройте раздел Интеграции → карточку Custom MCP Server.
2. Укажите URL MCP-эндпоинта (обязательно должен заканчиваться на /mcp).
3. (Опционально) добавьте заголовки HTTP, например Authorization: Bearer ....
4. После подключения Worken загружает актуальный снимок MCP-возможностей и показывает найденные тулы, промпты и ресурсы из списка сервера.

Требования

• Только HTTP-транспорт. Локальный stdio и запуск MCP через CLI обрабатываются отдельной командой worken mcp.
• В рантайме бота в v1 используются только тулы. Промпты и ресурсы показываются на странице интеграции, но не передаются модели в рантайм.
• Интерактивные workflows, которым нужен elicitation, не входят в v1 scope.
• В прод-средах URL должен быть доступен из Worken и использовать https://.
• Инструменты получают provider-safe идентификаторы вида mcp_custom__<integrationSlug>__<toolSlug>__<hash>. Формат сохраняет читаемый слаг по исходному имени и остается в лимитах провайдеров, чтобы избежать коллизий между разными серверами.

Безопасность

• URL проходит защиту от SSRF: запрещены localhost, приватные диапазоны IP и link-local адреса (169.254.x.x).
• Перенаправления на уровне HTTP-транспорта отключены.
• Встроенные учетные данные в URL запрещены; секреты нужно передавать через headers.
• Заголовки (например токены) не логируются и сохраняются в зашифрованном или внешнем secret-store виде, а не как plaintext в auth_data.

Когда использовать

• У вас есть собственный MCP-сервер с набором инструментов, который нужно подключить к нескольким виртсам.
• Вы хотите экспериментировать с внутренними MCP-инструментами без выпуска отдельной интеграции-вендора.

Для локальной разработки и MCP-серверов, не доступных по HTTPS, используйте CLI worken mcp, а не эту интеграцию.