用途:把 MCP 服务器(Keboola 或自建)托管到自己的 Keboola 计算上,获得公开 HTTPS 地址、独立 URL 与独立令牌作用域,无需自行管理基础设施,供 Claude、Cursor 或其他客户端连接。适合需要专用隔离实例、想自托管或 fork Keboola MCP 发布自定义工具、以及已在 Keboola 上开发并希望有可被智能体调用的 MCP 端点的场景;若共享托管端点已满足需求,或客户端可本地 stdio 运行,则不必使用。
主要流程:1) 选择服务器,Keboola MCP 直接用模板,其他 FastMCP/HTTP 服务器需应用模板中标记的两处替换点,仅 stdio 服务器参考 bridging 方案;2) 脚手架:bash <skill>/scripts/scaffold.sh <target-dir>,或复制 template/;3) 配置密钥:#KBC_STORAGE_API_URL、#KBC_STORAGE_TOKEN、#MCP_API_KEY(openssl rand -hex 32),公开 URL 来自平台的 KBC_APP_PUBLIC_URL;4) 推送到 git 并部署,选一种驱动(kbagent / keboola-git / 托管 MCP 工具 / 手动 UI),应用级认证设为 None,自动挂起 ≥ 24h;5) 验证:先看日志,再 curl /healthz、两个 .well-known/oauth-* 文档,以及 /mcp 返回 401;6) 连接客户端,可用 bearer、claude.ai OAuth 形态或 Kai。
硬性限制:应用级认证必须为 None(平台 OIDC 会剥离 Authorization);不得提交 git 推送凭证或 #MCP_API_KEY;每次会话只选一种部署驱动;只推送源码,uv sync 在部署时安装,不提交构建产物。具体错误排查与 secrets 细节参见 reference 文档。