透過 Unity Gateway 使用游標搭配模型、MCP 工具和技能。 在游標 IDE 的設定中設定模型存取權限。 使用 Unity Gateway CLI(ug)來新增 MCP 工具和技能,或手動設定。
Prerequisites
你需要 Azure Databricks workspace 網址,以及你想使用的模型、MCP 和技能的存取權。 安裝 游標。 若要使用 ug MCP 整合功能,也請安裝 cursor-agent,它提供 指令。
如果你的管理員已經設定好你的裝置,請依照組織的設定說明操作。
游標 IDE
1. 設定基礎 URL 與 API 金鑰
開啟 游標 > 設定 > 游標設定 > 模型 > API 金鑰。
啟用 覆蓋 OpenAI 基礎網址 並輸入:
https://<workspace-hostname>/ai-gateway/cursor/v1
將 <workspace-hostname> 取代為您的 Azure Databricks 工作區主機名稱。 將你的 Azure Databricks 個人存取權杖貼到 OpenAI API Key。
2. 新增自訂模型
在游標設定中點擊 + 新增自訂模型 。 輸入你工作區中可用的基礎模型的全名,然後啟用其切換功能。 對你想使用的每個模型重複這個步驟。
範例車型名稱:
| Provider | 型號名稱 |
|---|---|
| OpenAI | system.ai.gpt-5-5 |
| Gemini | system.ai.gemini-3-5-flash |
| Claude | system.ai.claude-opus-4-6 |
可用型號依據你的工作空間和權限而定。 此連線使用 Azure Databricks 提供的模型。
3. 測試連線
在 macOS 或 Ctrl+L Windows/Linux 上開啟詢問模式Cmd+L。 選擇你的型號並發送訊息。 使用該自訂模型的請求會經過 Unity Gateway 路由。
終端機中的游標代理
使用 Unity Gateway CLI
安裝 ug,然後從你的專案目錄執行這個指令:
ug cursor
這會在你的終端機開啟游標代理。 開始使用你已經使用的相同提示詞和指令。 模型會透過你的游標帳號執行; ug 但不會為游標代理設定模型路由。
新增 MCP 工具
system.ai.dbsql、system.ai.sandbox 和 system.ai.web_search 都處於測試階段。 要使用這些預覽功能,帳號管理員必須從帳號主控台的 Previews 頁面啟用 Enhanced Unity Gateway 預覽。 Unity Gateway 本身已正式可用。 請參閱 管理帳戶預覽功能。
使用 Unity Gateway CLI
安裝游標代理後,執行:
ug mcp add --agents cursor
選擇你想新增的 MCP。
ug 在 ~/.cursor/mcp.json 中註冊,IDE 與終端代理會使用它。 重新啟動 Cursor 或你的代理程式工作階段,然後要求它使用已連線的工具。
手動設定 MCPs
使用 OAuth 作為可自動重新整理權杖的連線,或用個人存取權杖進行本地測試。
若要在沒有管理員建立的 OAuth 應用程式的情況下登入,請使用預設的 Cursor 用戶端 ID,https://cursor.com/oauth/mcp-client.json 以下 OAuth 指示可作為搭配 mcp-remote 的自訂應用程式的替代方案。
使用自訂的 OAuth 應用程式
此配置使用 mcp-remote,並需要具備 npx 的 Node.js。
請一位帳號管理員 建立一個公開的 OAuth 客戶端,其重新導向 URL 為
http://localhost:3334/oauth/callback,範圍為ai-gateway。將此條目合併至
~/.cursor/mcp.json,保留現有伺服器:{ "mcpServers": { "databricks-tools": { "command": "npx", "args": [ "-y", "mcp-remote", "https://<workspace-hostname>/ai-gateway/mcp-services/<catalog>.<schema>.<service>?o=<workspace-id>", "3334", "--static-oauth-client-info", "{\"client_id\":\"<client-id>\"}", "--static-oauth-client-metadata", "{\"scope\":\"ai-gateway offline_access\"}" ] } } }替換主機名稱、 工作區 ID、MCP 名稱和客戶端 ID。 重新啟動 Cursor 並在瀏覽器中完成登入。
若需額外同時連線,請為每個連線使用不同的回調埠,並註冊其相符的重定向 URL。 如果您的組織需要機密用戶端,請參閱 mcp-remote 的靜態 OAuth 憑證。
使用個人存取令牌
建立 個人存取令牌,並將此條目合併到 ~/.cursor/mcp.json:
{
"mcpServers": {
"dbsql": {
"url": "https://<workspace-hostname>/ai-gateway/mcp-services/system.ai.dbsql?o=<workspace-id>",
"headers": {
"Authorization": "Bearer <databricks-pat>"
}
}
}
}
替換主機名稱、工作區 ID 和令牌。 對於另一個服務,請使用唯一的伺服器名稱,並將 system.ai.dbsql 替換為其 Unity Catalog 三部分名稱。 保留無關的伺服器條目,並避免讓代幣進入版本控制。
重新啟動 Cursor,檢查其 MCP 設定中的伺服器,並請代理呼叫唯讀工具。 對於 system.ai.dbsql,嘗試 SELECT 1 AS result。 確認代理是否執行工具呼叫並回傳結果。 如果 MCP 要求提供者同意,請打開登入連結,完成登入,然後重試該呼叫。 請參閱 MCP 認證 以了解權限與連線錯誤。
新增技能
使用 Unity Gateway CLI
執行選擇器下載已發表的技能:
ug skills add
Cursor 從 ~/.agents/skills/ 讀取已下載的技能。 開始新的工作階段才能使用它們。 下載是本地快照;重新執行指令以取得更新。
手動連線技能登錄檔
要透過 MCP 載入已發表技能,請將此條目合併為 ~/.cursor/mcp.json:
{
"mcpServers": {
"databricks-skill-registry": {
"url": "https://<workspace-hostname>/ai-gateway/skills/",
"headers": {
"Authorization": "Bearer <databricks-pat>"
}
}
}
}
替換主機名稱和標記,保留網址後斜線。 重新啟動游標並要求它使用技能,例如 Use <catalog>.<schema>.<skill-name> to review this query.
註冊中心透過 MCP 對外提供技能。 要安裝你已有的技能檔案,請將完整的 SKILL.md 資料夾,包括捆綁的檔案,放入 ~/.agents/skills/ 或你專案的 .cursor/skills/。 請參閱 Cursor 的技能文件。
Unity Gateway 技能還在測試階段。 請參見 治理技能 以了解啟用與權限。
Troubleshooting
ug cursor 找不到 Cursor Agent: 安裝 Cursor Agent,並檢查是否可在終端機中使用 cursor-agent。
自訂模型在 IDE 中失敗: 檢查閘道 URL、權杖到期日、模型名稱以及你的模型權限。 在對話中選擇自訂模型。
MCP 或技能連線失敗: 檢查 URL、MCP 權限及連接器錯誤訊息。 手動連線時,也要檢查令牌過期。 遇到 ug 設定問題時,請執行 ug doctor。
缺少一個已下載的技能:檢查其資料夾是否包含SKILL.md且位於支援的技能目錄中。 使用者層級的下載僅適用於你的本機;雲端代理程式不會自動取得這些下載。