---
title: "通过 Unity Gateway 连接 Databricks MCP"
summary: "安装 unity-gateway 后运行 ug mcp add --agents codex。连接使用 ug mcp-proxy stdio 桥，通过 ug codex 启动。"
category: mcp
level: intermediate
surfaces: [cli, app]
tags: ["MCP", "Databricks", "ug", "stdio"]
canonical: /tips/ug-mcp-add-codex/
---

# 通过 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` 只是别名）：

```bash
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）不在选择器里，要带类型前缀：

```bash
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` 配置。

## 来源

- [Databricks · Connect MCPs to coding agents](https://docs.databricks.com/aws/en/agents/mcp-tools/connect-clients)
- [databricks/unity-gateway](https://github.com/databricks/unity-gateway)