透過 Unity Gateway 使用游標搭配模型、MCP 工具和技能。 在游標 IDE 的設定中設定模型存取權限。 使用 Unity Gateway CLI（ug）來新增 MCP 工具和技能，或手動設定。
在你開始之前
你需要 Azure Databricks 工作區的 URL 以及你想使用的模型、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-2-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 工具
使用 Unity Gateway CLI
安裝游標代理後，執行：
ug mcp add --agents cursor
選擇你想新增的服務。
ug 會將它們註冊到 ~/.cursor/mcp.json 中，IDE 和終端代理程式會使用它們。 重新啟動 Cursor 或你的代理程式工作階段，然後要求它使用已連線的工具。
手動設定 MCP 服務
將此條目合併為 ~/.cursor/mcp.json：
{
"mcpServers": {
"dbsql": {
"url": "https://<workspace-hostname>/ai-gateway/mcp-services/system.ai.dbsql",
"headers": {
"Authorization": "Bearer <databricks-pat>"
}
}
}
}
替換主機名稱和標記。 對於另一個服務，請使用唯一的伺服器名稱，並將 system.ai.dbsql 替換為其 Unity Catalog 三部分名稱。 保留與伺服器無關的項目。
重新啟動游標，請代理使用工具。 關於 OAuth 設定，請參閱 游標的 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 終端機中是否有此功能。
自訂模型在 IDE 中失敗： 檢查閘道 URL、權杖到期日、模型名稱以及你的模型權限。 在對話中選擇自訂模型。
MCP 或技能連線失敗： 檢查 URL、服務權限及連接器錯誤。 手動連線時，也要檢查令牌過期。 遇到 ug 設定問題時，請執行 ug doctor。
缺少一個已下載的技能：檢查其資料夾是否包含SKILL.md且位於支援的技能目錄中。 使用者層級的下載僅適用於你的本機；雲端代理程式不會自動取得這些下載。