通过 Unity Gateway 连接 Databricks MCP
安装 unity-gateway 后运行 ug mcp add --agents codex。连接使用 ug mcp-proxy stdio 桥,通过 ug codex 启动。
Databricks MCP 用 ug mcp add --agents codex,stdio 桥是 ug mcp-proxy。Connect clients 页给 Codex 的主路径不再是手写 url 再 mcp login,也不要自己建 OAuth app。先装 Unity Gateway CLI(主命令是 ug,ucode 只是别名):
uv tool install git+https://github.com/databricks/unity-gateway
databricks auth login
ug mcp add --agents codex --services CATALOG.SCHEMA.SERVICE
ug codex
CATALOG.SCHEMA.SERVICE 换成 Unity Catalog 里 MCP Service 的全名,例如 system.ai.slack。文档页把三行命令粘成一行,自己拆开跑。需要 Python 3.12+ 和 uv。先有 Databricks CLI 登录;不要在 Codex 里再 codex mcp login。
每台 Databricks MCP 在 Codex 里都是 stdio 子进程,command 是 ug,干的是 mcp-proxy:本机桥去打 workspace 的 Streamable HTTP,每次请求用 Databricks CLI profile 现签 OAuth。不要给它写 url,也
ug configure mcp 会整表替换,没选中的服务器会被拿掉。只加、不删用 ug mcp add。无参数 ug mcp add 会开选择器,已登记的标 already configured,关不掉。V2(Vector Search、UC Functions、外连、Genie、Apps)不在选择器里,要带类型前缀:
ug mcp add --services uc-functions:main.tools
ug mcp add --services vector-search:main.docs
ug mcp add --services genie-space:SPACE_ID
ug mcp add --services app:my-app
ug mcp add --services external:my-connection
ug 给 Codex 写的可能是 ~/.codex/ucode.config.toml,不一定是 config.toml。日常启动用 ug codex,不要以为裸 codex 一定能看见这些 MCP。配置后重新打开会话。核对:ug status,再在 ug codex 会话里 /mcp。默认 codex mcp get 不一定读 ucode.config.toml。
文档或旧仓名若仍写 ucode / databricks/ucode,那是别名和旧地址:现行主命令是 ug,安装 URL 是 unity-gateway。卸服务器用 ug mcp remove --agents codex,不要手改再 codex mcp remove。
这和「把 Codex 模型流量打进 Databricks AI Gateway」不是同一件事。模型路由是 ug configure --agents codex / ug codex;本条只登记 MCP。不要把 AI Gateway 的 model_providers.Databricks 块当成 MCP 表。
网页 Cloud 不读取本机 ug 配置。