Honeydew Semantic Layer
官方Honeydew 語意層提供一個受治理且對業務友善的資料模型，統一跨來源的指標、維度與關係，實現一致的自助式分析與 AI 驅動的資料存取。
你可以用 Honeydew Semantic Layer MCP 做什麼？
- 探索倉庫表格與結構 — 透過自然對話了解您的資料倉儲結構與語意模型定義。
- 建立與維護語意模型 — 使用
create_workspace_branch及其他工作階段工具來建立或更新語意模型定義。 - 以自然語言查詢資料 — 針對您的資料提出問題，無需撰寫 SQL 即可獲得答案。
- 搜尋 Honeydew 文件 — 直接從任何支援 MCP 的助理中查閱產品文件。
文件
MCP 伺服器
什麼是 MCP？
模型上下文協定 (MCP) 是一個開放原始碼標準，用於安全地將 AI 應用程式連接到外部系統和工具。 Honeydew 提供一個 MCP 伺服器，可將 您的 AI 編碼助理連接到 Honeydew Semantic Layer。
使用時機
- 探索您的倉庫資料表、 結構描述和語意模型定義
- 透過自然對話 建立和維護您的語意模型
- 從任何與 MCP 相容的助理 使用自然語言查詢您的資料
- 搜尋和閱讀 Honeydew 文件
安裝
伺服器 URL
Honeydew 在以下位置公開 MCP 伺服器 API：
https://mcp.honeydew.cloud/mcp
驗證
有兩種方式可以驗證 Honeydew MCP 伺服器： OAuth 或 HTTP 基本驗證。
OAuth 驗證（建議）
大多數用戶端支援 OAuth 驗證。 首次連線時，系統會提示您：
- 使用您的 Honeydew 帳戶登入
- 接受 OAuth 授權
然後，用戶端會安全地提供存取權杖，用於後續請求。
HTTP 基本驗證
處於 HTTP 基本驗證模式的 MCP 伺服器 需要一個 API 金鑰 進行驗證。
您需要提供一個 Base64 編碼的字串，
其中包含您的 API 金鑰和 API 密鑰，
格式為 API_KEY:API_SECRET。
您可以使用以下指令 來產生 Base64 編碼的字串：
```bash theme={null} echo -n ':' | base64 ``` 使用 PowerShell：```powershell theme={null}
[Convert]::ToBase64String(
[Text.Encoding]::UTF8.GetBytes(
"<API_KEY>:<API_SECRET>"
)
)
```
在 Authorization 標頭中提供編碼後的字串，如下所示：
Authorization: Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET>
設定
工作區和分支是在工作階段層級設定，
使用 list_workspaces、
list_workspace_branches
和 set_session_workspace_and_branch
工具。您也可以使用
create_workspace_branch 建立新分支。
在連接到 MCP 伺服器後，
從您的 AI 助理呼叫這些工具。
您可以選擇在 MCP 伺服器設定中提供以下標頭：
Workspace：為所有請求固定工作區（選用）Branch：為所有請求固定特定的工作區分支（選用，如果設定了工作區，則預設為prod）Honeydew-Client：識別 MCP 用戶端（選用， 從連接的工具自動偵測）。 傳遞此標頭以提供特定的用戶端識別碼。ReadonlyToolsOnly：設定為true以僅公開唯讀工具（選用）
支援的用戶端
Claude Code CLI
#### 外掛程式安裝 **需要 Git。** 從 GitHub 安裝外掛程式會將儲存庫 複製到本機，因此必須安裝 [Git](https://git-scm.com/downloads) 並將其 放在您的 `PATH` 中。如果缺少 Git，外掛程式安裝會失敗。請安裝 Git，或 使用用戶端的手動 MCP 設定步驟直接設定伺服器， 而不是使用外掛程式。Honeydew 提供一個 外掛程式儲存庫， 其中包含用於建立語意模型 和透過自然對話分析資料的技能和工具。 安裝外掛程式會自動設定 Honeydew MCP 伺服器。
使用 claude 啟動 Claude Code，然後新增市集：
/plugin marketplace add honeydew-ai/honeydew-ai-coding-agents-plugins
然後從市集安裝 Honeydew 外掛程式：
/plugin install honeydew-ai@honeydew-ai-claude-plugins
然後重新載入外掛程式以啟用：
/reload-plugins
更新外掛程式
若要更新 Honeydew 市集外掛程式，請使用 claude 啟動 Claude Code，然後：
- 輸入
/plugin，然後在頂部的選擇器中選取 市集 - 選取
honeydew-ai-coding-agents-plugins - 點擊 更新市集
若要自動接收更新，請在市集設定中選取 啟用自動更新。
MCP 設定
如果您的組織使用自訂的 Honeydew 端點， 或者您偏好在不安裝外掛程式的情況下設定 MCP 伺服器，請使用此章節。 停用由外掛程式新增的 Honeydew MCP 連線，然後使用以下說明 新增您的自訂端點。
Honeydew MCP 伺服器將 Claude Code 連接到 Honeydew Semantic Layer， 以進行模型探索、資料查詢、模型管理 和文件存取。
使用以下其中一種方法來新增 Honeydew MCP 伺服器：
如果您的組織使用自訂的 Honeydew 主機名稱， 請將 `https://mcp.honeydew.cloud/mcp` 替換為您的租用戶主機名稱。 您可以在 Honeydew Studio 的 **設定 > MCP 伺服器** 中找到主機名稱。 ```bash theme={null} claude mcp add --transport http honeydew \ https://mcp.honeydew.cloud/mcp ``` 使用 `claude` 啟動 Claude Code。
系統會提示您使用 OAuth 向 Honeydew 進行驗證。
</Tab>
<Tab title="API Key">
```bash theme={null}
claude mcp add --transport http honeydew \
https://mcp.honeydew.cloud/mcp \
--header "Authorization: Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET>"
```
</Tab>
</Tabs>
</Tab>
<Tab title="JSON configuration">
將以下內容儲存到 `honeydew-mcp.json`：
<Tabs>
<Tab title="OAuth (recommended)">
```json theme={null}
{
"type": "http",
"url": "https://mcp.honeydew.cloud/mcp"
}
```
然後使用以下指令註冊它：
```bash theme={null}
claude mcp add honeydew ./honeydew-mcp.json
```
使用 `claude` 啟動 Claude Code。
系統會提示您使用 OAuth 向 Honeydew 進行驗證。
</Tab>
<Tab title="API Key">
```json theme={null}
{
"type": "http",
"url": "https://mcp.honeydew.cloud/mcp",
"headers": {
"Authorization": "Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET>"
}
}
```
然後使用以下指令註冊它：
```bash theme={null}
claude mcp add honeydew ./honeydew-mcp.json
```
</Tab>
</Tabs>
</Tab>
<Tab title=".mcp.json">
將以下內容新增到您的 `.mcp.json` 檔案：
<Tabs>
<Tab title="OAuth (recommended)">
```json theme={null}
{
"mcpServers": {
"honeydew": {
"type": "http",
"url": "https://mcp.honeydew.cloud/mcp"
}
}
}
```
使用 `claude` 啟動 Claude Code。
系統會提示您使用 OAuth 向 Honeydew 進行驗證。
</Tab>
<Tab title="API Key">
```json theme={null}
{
"mcpServers": {
"honeydew": {
"type": "http",
"url": "https://mcp.honeydew.cloud/mcp",
"headers": {
"Authorization": "Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET>"
}
}
}
}
```
</Tab>
</Tabs>
</Tab>
為了避免將敏感值直接儲存在設定檔中，
Claude Code 支援
[環境變數擴展](https://code.claude.com/docs/en/mcp#environment-variable-expansion-in-mcp-json)，
使用 `${VAR_NAME}` 語法。
設定 `HONEYDEW_API_KEY` 環境變數，
然後在您的設定中參考它：
```bash theme={null}
claude mcp add --transport http honeydew \
https://mcp.honeydew.cloud/mcp \
--header "Authorization: Basic ${HONEYDEW_API_KEY}"
```
Claude Code 會在執行階段從您的環境中
解析 `${VAR_NAME}` 參考。
Honeydew 文件 MCP（選用）
Honeydew MCP 伺服器已包含文件存取工具， 因此不需要單獨的文件伺服器。 只有在您想要在不連接到 Honeydew 的情況下存取文件時， 才新增 Honeydew 文件 MCP。無需驗證。
claude mcp add --transport http honeydew-docs \
https://honeydew.ai/docs/mcp
移除 MCP 伺服器
若要移除 Honeydew MCP 伺服器：
claude mcp remove honeydew
若要移除 Honeydew 文件 MCP 伺服器：
claude mcp remove honeydew-docs
Claude Desktop
#### 外掛程式安裝 **需要 Git。** 從 GitHub 安裝外掛程式會將儲存庫 複製到本機，因此必須安裝 [Git](https://git-scm.com/downloads) 並將其 放在您的 `PATH` 中。如果缺少 Git，外掛程式安裝會失敗。請安裝 Git，或 使用用戶端的手動 MCP 設定步驟直接設定伺服器， 而不是使用外掛程式。Honeydew 提供一個 外掛程式儲存庫， 其中包含用於建立語意模型 和透過自然對話分析資料的技能和工具。 安裝外掛程式會自動設定 Honeydew MCP 伺服器。
- 前往 設定 -> 自訂
- 點擊 瀏覽外掛程式
- 前往 個人 分頁
- 點擊 + 圖示 並選擇 從 GitHub 新增市集
- 在輸入框中輸入
honeydew-ai/honeydew-ai-coding-agents-plugins - Honeydew AI 外掛程式會出現。安裝它。
MCP 設定
如果您的組織使用自訂的 Honeydew 端點， 或者您偏好在不安裝外掛程式的情況下設定 MCP 伺服器，請使用此章節。 停用由外掛程式新增的 Honeydew MCP 連線，然後使用以下說明 新增您的自訂端點。
Honeydew MCP 伺服器將 Claude Desktop 連接到 Honeydew Semantic Layer， 以進行模型探索、資料查詢、模型管理 和文件存取。
Claude Code 模式
在 Claude Desktop 中使用 Claude Code 模式時， 請改為遵循 Claude Code CLI 的說明。
如果您的組織使用自訂的 Honeydew 主機名稱， 請將 `https://mcp.honeydew.cloud/mcp` 替換為您的租用戶主機名稱。 您可以在 Honeydew Studio 的 **設定 > MCP 伺服器** 中找到主機名稱。若要在 Cowork 模式中新增 Honeydew MCP：
- 前往 設定 -> 連接器 -> 新增自訂連接器
- 在 名稱 欄位中輸入
honeydew - 在 遠端 MCP 伺服器 URL 欄位中輸入
https://mcp.honeydew.cloud/mcp - 點擊 新增
首次連線時，系統會提示您使用 OAuth 向 Honeydew 進行驗證。
Honeydew 文件 MCP（選用）
Honeydew MCP 伺服器已包含文件存取工具， 因此不需要單獨的文件伺服器。 只有在您想要在不連接到 Honeydew 的情況下存取文件時， 才新增 Honeydew 文件 MCP。無需驗證。
- 前往 設定 -> 連接器 -> 新增自訂連接器
- 在 名稱 欄位中輸入
honeydew-docs - 在 遠端 MCP 伺服器 URL 欄位中輸入
https://honeydew.ai/docs/mcp - 點擊 新增
移除 MCP 伺服器
若要在 Cowork 模式中移除 Honeydew MCP 伺服器：
- 前往 設定 -> 連接器
- 找到
honeydew連接器，然後點擊刪除圖示
若要移除 Honeydew 文件 MCP 伺服器：
- 前往 設定 -> 連接器
- 找到
honeydew-docs連接器，然後點擊刪除圖示
Claude.ai
#### 外掛程式安裝Honeydew 提供一個 外掛程式儲存庫， 其中包含用於建立語意模型 和透過自然對話分析資料的技能和工具。 安裝外掛程式會自動設定 Honeydew MCP 伺服器和 Honeydew 文件 MCP 伺服器。
- 下載外掛程式 zip 檔案： honeydew-ai-claude.zip
- 在 Claude.ai 中，前往 設定 -> 外掛程式 -> 新增外掛程式 -> 上傳 zip
- 上傳 zip 檔案 — 外掛程式會出現在您的私人市集中
MCP 設定
如果您的組織使用自訂的 Honeydew 端點， 或者您偏好在不安裝外掛程式的情況下設定 MCP 伺服器，請使用此章節。 移除由外掛程式新增的 Honeydew MCP 連接器，然後使用以下說明 新增您的自訂端點。
Honeydew MCP 伺服器將 Claude.ai 連接到 Honeydew Semantic Layer， 以進行模型探索、資料查詢、模型管理 和文件存取。
如果您的組織使用自訂的 Honeydew 主機名稱， 請將 `https://mcp.honeydew.cloud/mcp` 替換為您的租用戶主機名稱。 您可以在 Honeydew Studio 的 **設定 > MCP 伺服器** 中找到主機名稱。若要新增 Honeydew MCP 伺服器：
- 前往 Settings -> Connectors -> Add custom connector
- 在 Name 欄位中輸入
honeydew - 在 Remote MCP server URL 欄位中輸入
https://mcp.honeydew.cloud/mcp - 點擊 Add
首次連線時，系統會提示您透過 OAuth 向 Honeydew 進行驗證。
Honeydew Documentation MCP（選用）
Honeydew MCP 伺服器已包含文件存取工具， 因此不需要單獨的文件伺服器。 只有在您想不連線至 Honeydew 的情況下存取文件時，才需要新增 Honeydew Documentation MCP。無需驗證。
- 前往 Settings -> Connectors -> Add custom connector
- 在 Name 欄位中輸入
honeydew-docs - 在 Remote MCP server URL 欄位中輸入
https://honeydew.ai/docs/mcp - 點擊 Add
移除 MCP 伺服器
若要移除 Honeydew MCP 伺服器：
- 前往 Settings -> Connectors
- 找到
honeydew連接器，然後點擊刪除圖示
若要移除 Honeydew Documentation MCP 伺服器：
- 前往 Settings -> Connectors
- 找到
honeydew-docs連接器，然後點擊刪除圖示
Cortex Code CLI
#### 外掛程式安裝 **需要 Git。** 從 GitHub 安裝外掛程式會將儲存庫複製到本機， 因此必須安裝 [Git](https://git-scm.com/downloads) 並將其加入您的 `PATH`。如果缺少 Git，外掛程式安裝將會失敗。請安裝 Git，或 改用您客戶端的手動 MCP 設定步驟來直接設定伺服器，而非使用外掛程式。Honeydew 提供一個 外掛程式儲存庫， 其中包含用於建立語意模型和透過自然對話分析資料的技能與工具。 安裝外掛程式會自動設定 Honeydew MCP 伺服器。
使用 cortex 啟動 Cortex Code CLI，然後安裝外掛程式：
/plugin install honeydew-ai/honeydew-ai-coding-agents-plugins
MCP 設定
如果您的組織使用自訂的 Honeydew 端點，或者您偏好不安裝外掛程式來設定 MCP 伺服器，請使用此章節。 停用由外掛程式新增的 Honeydew MCP 連線，然後使用以下說明新增您的自訂端點。
Honeydew MCP 伺服器將 Cortex Code CLI 連線至 Honeydew Semantic Layer， 以進行模型探索、資料查詢、模型管理和文件存取。
如果您的組織使用自訂的 Honeydew 主機名稱， 請將 `https://mcp.honeydew.cloud/mcp` 替換為您的租戶主機名稱。 您可以在 Honeydew Studio 的 **Settings > MCP Server** 中找到主機名稱。 ```bash theme={null} cortex mcp add honeydew \ https://mcp.honeydew.cloud/mcp \ --type http ``` 使用 `cortex` 啟動 Cortex Code CLI。
系統會提示您透過 OAuth 向 Honeydew 進行驗證。
</Tab>
<Tab title="API Key">
```bash theme={null}
cortex mcp add honeydew \
https://mcp.honeydew.cloud/mcp \
--type http \
-H "Authorization: Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET>"
```
</Tab>
</Tabs>
</Tab>
<Tab title="JSON configuration">
將以下內容儲存至 `honeydew-mcp.json`：
<Tabs>
<Tab title="OAuth (recommended)">
```json theme={null}
{
"type": "http",
"url": "https://mcp.honeydew.cloud/mcp"
}
```
然後使用以下指令註冊它：
```bash theme={null}
cortex mcp add honeydew ./honeydew-mcp.json --type http
```
使用 `cortex` 啟動 Cortex Code CLI。
系統會提示您透過 OAuth 向 Honeydew 進行驗證。
</Tab>
<Tab title="API Key">
```json theme={null}
{
"type": "http",
"url": "https://mcp.honeydew.cloud/mcp",
"headers": {
"Authorization": "Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET>"
}
}
```
然後使用以下指令註冊它：
```bash theme={null}
cortex mcp add honeydew ./honeydew-mcp.json --type http
```
</Tab>
</Tabs>
</Tab>
<Tab title="mcp.json">
將以下內容新增至
`~/.snowflake/cortex/mcp.json`：
<Tabs>
<Tab title="OAuth (recommended)">
```json theme={null}
{
"mcpServers": {
"honeydew": {
"type": "http",
"url": "https://mcp.honeydew.cloud/mcp"
}
}
}
```
使用 `cortex` 啟動 Cortex Code CLI。
系統會提示您透過 OAuth 向 Honeydew 進行驗證。
</Tab>
<Tab title="API Key">
```json theme={null}
{
"mcpServers": {
"honeydew": {
"type": "http",
"url": "https://mcp.honeydew.cloud/mcp",
"headers": {
"Authorization": "Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET>"
}
}
}
}
```
</Tab>
</Tabs>
</Tab>
Honeydew Documentation MCP（選用）
Honeydew MCP 伺服器已包含文件存取工具， 因此不需要單獨的文件伺服器。 只有在您想不連線至 Honeydew 的情況下存取文件時，才需要新增 Honeydew Documentation MCP。無需驗證。
cortex mcp add honeydew-docs \
https://honeydew.ai/docs/mcp \
--type http
移除 MCP 伺服器
若要移除 Honeydew MCP 伺服器：
cortex mcp remove honeydew
若要移除 Honeydew Documentation MCP 伺服器：
cortex mcp remove honeydew-docs
Cortex Code Desktop
#### 外掛程式安裝 **需要 Git。** 從 GitHub 安裝外掛程式會將儲存庫複製到本機， 因此必須安裝 [Git](https://git-scm.com/downloads) 並將其加入您的 `PATH`。如果缺少 Git，外掛程式安裝將會失敗。請安裝 Git，或 改用您客戶端的手動 MCP 設定步驟來直接設定伺服器，而非使用外掛程式。Honeydew 提供一個 外掛程式儲存庫， 其中包含用於建立語意模型和透過自然對話分析資料的技能與工具。 安裝外掛程式會自動設定 Honeydew MCP 伺服器。
- 前往 Settings -> Plugins
- 點擊 Add Plugin，選擇 Add from GitHub，然後貼上
Honeydew 外掛程式儲存庫：
honeydew-ai/honeydew-ai-coding-agents-plugins - 按照流程操作，並在 GitHub Plugin Installer Setup 中核准步驟
MCP 設定
如果您的組織使用自訂的 Honeydew 端點，或者您偏好不安裝外掛程式來設定 MCP 伺服器，請使用此章節。 停用由外掛程式新增的 Honeydew MCP 連線，然後使用以下說明新增您的自訂端點。
Honeydew MCP 伺服器將 Cortex Code Desktop 連線至 Honeydew Semantic Layer， 以進行模型探索、資料查詢、模型管理和文件存取。
若要新增伺服器，請前往 MCP -> New，選擇一個 Configuration Scope
（例如，Global 為 ~/.snowflake/cortex/mcp.json），填寫表單，
然後點擊 Save。使用 Form 或 JSON 分頁來輸入設定。
新增 Honeydew MCP 伺服器：
1. **Server Name**：`honeydew` 2. **Server Type**：**Remote (HTTP)** 3. **Server URL**：`https://mcp.honeydew.cloud/mcp` 4. 點擊 **Save** 首次連線時，系統會提示您透過 OAuth 向 Honeydew 進行驗證。
</Tab>
<Tab title="API Key">
1. **Server Name**：`honeydew`
2. **Server Type**：**Remote (HTTP)**
3. **Server URL**：`https://mcp.honeydew.cloud/mcp`
4. 在 **Headers** 下方，點擊 **Add Header**，並將名稱設為
`Authorization`，值設為
`Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET>`
5. 點擊 **Save**
</Tab>
</Tabs>
</Tab>
<Tab title="JSON">
切換到 **JSON** 分頁並貼上設定：
<Tabs>
<Tab title="OAuth (recommended)">
```json theme={null}
{
"honeydew": {
"type": "http",
"url": "https://mcp.honeydew.cloud/mcp"
}
}
```
首次連線時，系統會提示您透過 OAuth 向 Honeydew 進行驗證。
</Tab>
<Tab title="API Key">
```json theme={null}
{
"honeydew": {
"type": "http",
"url": "https://mcp.honeydew.cloud/mcp",
"headers": {
"Authorization": "Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET>"
}
}
}
```
</Tab>
</Tabs>
</Tab>
Honeydew Documentation MCP（選用）
Honeydew MCP 伺服器已包含文件存取工具，
因此不需要單獨的文件伺服器。
如果您想在不連線至 Honeydew 的情況下存取文件，
請以相同方式新增 Honeydew Documentation MCP 伺服器，使用 Server Name
honeydew-docs、Server Type Remote (HTTP) 和 Server URL
https://honeydew.ai/docs/mcp。無需驗證。
移除 MCP 伺服器
若要移除伺服器，請前往 MCP，找到 honeydew（或 honeydew-docs）
伺服器，然後將其移除。
Cursor
#### 外掛程式安裝Honeydew 提供一個 外掛程式儲存庫， 其中包含用於建立語意模型和透過自然對話分析資料的技能與工具。 安裝外掛程式會自動設定 Honeydew MCP 伺服器。
- 在您的團隊或組織設定中， 前往 cursor.com/dashboard/plugins （或點擊左側選單中的 Plugins）
- 向下捲動至 Team Marketplaces，然後點擊現有的 Marketplace， 或點擊 Add Marketplace 來建立新的 Marketplace。 如果要建立新的，請輸入名稱並建立它。
- 在 Marketplace 中，點擊 Add Plugin，
貼上 Honeydew 外掛程式的 GitHub 儲存庫路徑：
https://github.com/honeydew-ai/honeydew-ai-coding-agents-plugins然後點擊 Add 1 plugin - （可選）在 Marketplace 頁面中啟用 auto-refresh， 以便在新版本發佈時自動更新外掛程式。
- 返回外掛程式頁面 (cursor.com/dashboard/plugins)， 搜尋 Honeydew 外掛程式，然後點擊 Add
MCP 設定
如果您的組織使用自訂的 Honeydew 端點，或者您偏好不安裝外掛程式來設定 MCP 伺服器，請使用此章節。 停用由外掛程式新增的 Honeydew MCP 連線，然後使用以下說明新增您的自訂端點。
Honeydew MCP 伺服器將 Cursor 連線至 Honeydew Semantic Layer， 以進行模型探索、資料查詢、模型管理和文件存取。
如果您的組織使用自訂的 Honeydew 主機名稱， 請將 `https://mcp.honeydew.cloud/mcp` 替換為您的租戶主機名稱。 您可以在 Honeydew Studio 的 **Settings > MCP Server** 中找到主機名稱。若要新增 Honeydew MCP：
-
開啟 Cursor 應用程式
-
前往 Settings -> Cursor Settings -> Tools & MCP
-
點擊 New MCP Server
-
新增以下設定：
```json theme={null} { "name": "honeydew", "type": "http", "url": "https://mcp.honeydew.cloud/mcp" } ```<Tab title="API Key"> ```json theme={null} { "name": "honeydew", "type": "http", "url": "https://mcp.honeydew.cloud/mcp", "headers": { "Authorization": "Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET>" } } ``` </Tab> -
點擊 Save
Honeydew Documentation MCP（選用）
Honeydew MCP 伺服器已包含文件存取工具， 因此不需要單獨的文件伺服器。 只有在您想不連線至 Honeydew 的情況下存取文件時，才需要新增 Honeydew Documentation MCP。無需驗證。
- 前往 Settings -> Cursor Settings -> Tools & MCP
- 點擊 New MCP Server
- 新增以下設定：
{ "name": "honeydew-docs", "type": "http", "url": "https://honeydew.ai/docs/mcp" } - 點擊 Save
移除 MCP 伺服器
若要移除 Honeydew MCP 伺服器：
- 前往 Settings -> Cursor Settings -> Tools & MCP
- 在清單中找到
honeydew，然後點擊刪除圖示
若要移除 Honeydew Documentation MCP 伺服器：
- 前往 Settings -> Cursor Settings -> Tools & MCP
- 在清單中找到
honeydew-docs，然後點擊刪除圖示
Databricks Genie Code
MCP 伺服器僅在 Genie Code Agent 模式下支援。 如需更多詳細資訊，請參閱 [Databricks MCP 文件](https://docs.databricks.com/aws/en/generative-ai/mcp/)。先決條件：
-
已在您的 Databricks 工作區中啟用 Genie Code
-
擁有 Unity Catalog 中繼存放區的
1. 導覽至 **目錄** → **連線** → **建立連線** 2. 在 **連線基本資訊** 畫面中： * 將 **連線名稱** 設為 `honeydew-mcp` * 將 **連線類型** 設為 **HTTP** * 將 **驗證類型** 設為 **動態用戶端註冊** * 點擊 **下一步** 3. 在 **驗證** 畫面中： * 將 **主機** 設為 `https://mcp.honeydew.cloud` * 將 **連接埠** 保留為 `443` * 將 **OAuth 範圍** 設為 `openid` * 點擊 **下一步** 4. 在 **連線詳細資料** 畫面中： * 勾選 **為 MCP 連線** * 將 **基礎路徑** 設為 `/mcp` * 點擊 **建立連線**CREATE CONNECTION權限
如果您的組織使用自訂的 Honeydew 主機名稱，請將 `https://mcp.honeydew.cloud` 替換為您的租用戶主機名稱。 您可以在 Honeydew Studio 的 **設定 > MCP 伺服器** 中找到您的主機名稱。 導覽至 **目錄** → **連線** → `honeydew-mcp` 然後點擊右上角的 **登入** 以進行驗證並確認連線。 將 `USE CONNECTION` 權限授予任何需要存取 Honeydew MCP 伺服器的使用者或角色：<Tab title="SQL"> 在 Databricks 筆記本或 SQL 編輯器中執行以下 SQL： ```sql theme={null} CREATE OR REPLACE CONNECTION `honeydew-mcp` TYPE HTTP OPTIONS ( host 'https://mcp.honeydew.cloud', base_path '/mcp', is_mcp_connection 'true', oauth_scope 'openid' ); DESCRIBE CONNECTION `honeydew-mcp`; ``` </Tab>
1. 開啟 Genie Code 並點擊齒輪圖示 2. 導覽至 **MCP 伺服器** → **新增伺服器** 3. 選取 **外部 MCP 伺服器** 4. 選擇您建立的 `honeydew-mcp` 連線 5. 出現提示時登入該連線 6. 點擊 **儲存** Databricks 將所有已設定伺服器的 MCP 工具限制為 20 個。 如果您需要調整可用的 Honeydew 工具， 請使用 Genie Code MCP 設定來啟用或停用特定工具。GRANT USE CONNECTION ON CONNECTION `honeydew-mcp` TO <user-or-role>;
移除 MCP 伺服器
若要從 Genie Code 移除 Honeydew MCP 伺服器：
- 開啟 Genie Code 並點擊齒輪圖示
- 導覽至 MCP 伺服器
- 找到
honeydew-mcp並點擊 移除
若要一併移除底層的 Unity Catalog 連線， 請執行以下 SQL：
DROP CONNECTION `honeydew-mcp`;
Devin
#### MCP 伺服器Devin 透過其 MCP 市集 連線至遠端 MCP 伺服器。
如果您的組織使用自訂的 Honeydew 主機名稱， 請將 `https://mcp.honeydew.cloud/mcp` 替換為您的租用戶主機名稱。 您可以在 Honeydew Studio 的 **設定 > MCP 伺服器** 中找到主機名稱。若要新增 Honeydew MCP 伺服器：
-
前往 設定 -> 連線 -> MCP 伺服器
-
點擊 新增自訂 MCP
-
在 伺服器名稱 欄位中輸入
honeydew -
可選擇性地新增圖示和 簡短說明
-
選擇 HTTP 作為傳輸類型
-
在 伺服器 URL 欄位中輸入
https://mcp.honeydew.cloud/mcp -
設定驗證：
選取 **OAuth** 作為驗證方法。 Devin 會在第一次工作階段期間提示您向 Honeydew 進行驗證。<Tab title="API Key"> 選取 **驗證標頭** 作為驗證方法。 將標頭金鑰保留為 `Authorization`，並將值設為 `Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET>` （請參閱[驗證](#authentication)）。 </Tab> -
點擊 儲存，然後點擊 測試列出工具 以驗證連線
Honeydew 文件 MCP（選用）
Honeydew MCP 伺服器已包含文件存取工具， 因此不需要單獨的文件伺服器。 僅在您希望無需連線至 Honeydew 即可存取文件時， 才新增 Honeydew 文件 MCP。無需驗證。
- 前往 設定 -> 連線 -> MCP 伺服器
- 點擊 新增自訂 MCP
- 在 伺服器名稱 欄位中輸入
honeydew-docs - 選擇 HTTP 作為傳輸類型
- 在 伺服器 URL 欄位中輸入
https://honeydew.ai/docs/mcp - 將驗證方法設為 無
- 點擊 儲存
移除 MCP 伺服器
若要移除 Honeydew MCP 伺服器：
- 前往 設定 -> 連線 -> MCP 伺服器
- 找到
honeydew伺服器並將其移除
若要移除 Honeydew 文件 MCP 伺服器：
- 前往 設定 -> 連線 -> MCP 伺服器
- 找到
honeydew-docs伺服器並將其移除
GitHub Copilot CLI
#### MCP 伺服器 如果您的組織使用自訂的 Honeydew 主機名稱， 請將 `https://mcp.honeydew.cloud/mcp` 替換為您的租用戶主機名稱。 您可以在 Honeydew Studio 的 **設定 > MCP 伺服器** 中找到主機名稱。-
使用
copilot啟動 GitHub Copilot CLI -
輸入
/mcp add以開啟伺服器設定表單 -
填寫以下欄位：
-
名稱：
honeydew -
類型：
http -
URL：
https://mcp.honeydew.cloud/mcp -
HTTP 標頭：
OAuth 不需要額外的標頭。 ```json theme={null} { "Authorization": "Basic " } ```
-
-
按下
Ctrl+S以儲存
使用 /mcp show 來驗證伺服器是否已連線。
AI 編碼代理程式外掛程式
**需要 Git。** 從 GitHub 安裝外掛程式會將儲存庫複製到本機， 因此必須安裝 [Git](https://git-scm.com/downloads) 並將其加入 您的 `PATH`。如果缺少 Git，外掛程式安裝將會失敗。請安裝 Git，或 使用您用戶端的手動 MCP 設定步驟來直接設定伺服器， 而非使用外掛程式。Honeydew 提供一個 外掛程式儲存庫， 其中包含用於建立語意模型 和透過自然對話分析資料的技能和工具。
將市集新增至 Copilot CLI：
/plugin marketplace add honeydew-ai/honeydew-ai-coding-agents-plugins
然後從市集安裝 Honeydew 外掛程式：
/plugin install honeydew-ai@honeydew-ai-github-copilot-plugins
Honeydew 文件 MCP（選用）
Honeydew MCP 伺服器已包含文件存取工具， 因此不需要單獨的文件伺服器。 僅在您希望無需連線至 Honeydew 即可存取文件時， 才新增 Honeydew 文件 MCP。無需驗證。
- 使用
copilot啟動 GitHub Copilot CLI - 輸入
/mcp add以開啟伺服器設定表單 - 填寫以下欄位：
- 名稱：
honeydew-docs - 類型：
http - URL：
https://honeydew.ai/docs/mcp
- 名稱：
- 按下
Ctrl+S以儲存
移除 MCP 伺服器
若要移除 Honeydew MCP 伺服器，
請使用 copilot 啟動 GitHub Copilot CLI，然後輸入：
/mcp remove honeydew
若要移除 Honeydew 文件 MCP 伺服器：
/mcp remove honeydew-docs
Gemini CLI
#### 擴充功能安裝 **需要 Git。** 從 GitHub 安裝外掛程式會將儲存庫複製到本機， 因此必須安裝 [Git](https://git-scm.com/downloads) 並將其加入 您的 `PATH`。如果缺少 Git，外掛程式安裝將會失敗。請安裝 Git，或 使用您用戶端的手動 MCP 設定步驟來直接設定伺服器， 而非使用外掛程式。Honeydew 提供一個 外掛程式儲存庫， 其中包含用於建立語意模型 和透過自然對話分析資料的技能和工具。 安裝擴充功能會自動設定 Honeydew MCP 伺服器。
執行以下命令來安裝 Honeydew 擴充功能：
gemini extensions install \
https://github.com/honeydew-ai/honeydew-ai-coding-agents-plugins \
--auto-update
--auto-update 旗標會自動保持擴充功能更新。
MCP 設定
如果您的組織使用自訂的 Honeydew 端點， 或者您偏好不安裝擴充功能來設定 MCP 伺服器，請使用此章節。 停用由擴充功能新增的 Honeydew MCP 連線，然後使用以下說明 新增您的自訂端點。
Honeydew MCP 伺服器將 Gemini CLI 連線至 Honeydew 語意層， 以進行模型探索、資料查詢、模型管理 和文件存取。
如果您的組織使用自訂的 Honeydew 主機名稱， 請將 `https://mcp.honeydew.cloud/mcp` 替換為您的租用戶主機名稱。 您可以在 Honeydew Studio 的 **設定 > MCP 伺服器** 中找到主機名稱。執行以下命令來新增 Honeydew MCP 伺服器：
```bash theme={null} gemini mcp add --transport http honeydew \ https://mcp.honeydew.cloud/mcp ``` 使用 `gemini` 啟動 Gemini CLI。
系統會提示您使用 OAuth 向 Honeydew 進行驗證。
</Tab>
<Tab title="API Key">
```bash theme={null}
gemini mcp add --transport http honeydew \
https://mcp.honeydew.cloud/mcp \
--header "Authorization: Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET>"
```
</Tab>
Honeydew 文件 MCP（選用）
Honeydew MCP 伺服器已包含文件存取工具， 因此不需要單獨的文件伺服器。 僅在您希望無需連線至 Honeydew 即可存取文件時， 才新增 Honeydew 文件 MCP。無需驗證。
gemini mcp add --transport http honeydew-docs \
https://honeydew.ai/docs/mcp
移除 MCP 伺服器
若要移除 Honeydew MCP 伺服器：
gemini mcp remove honeydew
若要移除 Honeydew 文件 MCP 伺服器：
gemini mcp remove honeydew-docs
VS Code 和 GitHub Copilot
#### 外掛程式安裝Honeydew 提供一個 外掛程式儲存庫， 其中包含用於建立語意模型 和透過自然對話分析資料的技能和工具。 安裝外掛程式會自動設定 Honeydew MCP 伺服器。
新增 Honeydew 市集
- 開啟您的 VS Code
settings.json（在 macOS 上使用CMD+Shift+P開啟命令選擇區， 或在 Windows/Linux 上使用Ctrl+Shift+P， 然後選取 喜好設定：開啟使用者設定 (JSON)） - 將 Honeydew 市集新增至
chat.plugins.marketplaces設定："chat.plugins.marketplaces": [ "honeydew-ai/honeydew-ai-coding-agents-plugins" ]
安裝外掛程式
- 開啟擴充功能檢視
（macOS 上為
CMD+Shift+X，或 Windows/Linux 上為Ctrl+Shift+X） - 在搜尋欄位中輸入
@agentPlugins - 找到 Honeydew AI 外掛程式並點擊 安裝
首次從新市集安裝外掛程式時， VS Code 會顯示信任提示 — 請在確認前檢視市集來源。
更新外掛程式
如果在 VS Code 設定中啟用了 extensions.autoUpdate，
外掛程式會自動更新。
若要手動更新，請開啟命令選擇區並執行
擴充功能：檢查擴充功能更新。
MCP 伺服器
如果您的組織使用自訂的 Honeydew 端點， 或者您偏好不安裝外掛程式來設定 MCP 伺服器，請使用此章節。 停用由外掛程式新增的 Honeydew MCP 連線，然後使用以下說明 新增您的自訂端點。
Honeydew MCP 伺服器將 VS Code 連線至 Honeydew 語意層， 以進行模型探索、資料查詢、模型管理 和文件存取。
如果您的組織使用自訂的 Honeydew 主機名稱， 請將 `https://mcp.honeydew.cloud/mcp` 替換為您的租用戶主機名稱。 您可以在 Honeydew Studio 的 **設定 > MCP 伺服器** 中找到主機名稱。 1. 使用 `CMD+Shift+P`（macOS） 或 `Ctrl+Shift+P`（Windows/Linux）開啟命令面板 2. 選擇 **MCP: Add Server...** 3. 選擇 **HTTP（HTTP 或伺服器傳送事件）** 4. 輸入 Honeydew MCP 伺服器 URL： `https://mcp.honeydew.cloud/mcp` 5. 輸入 `honeydew` 作為伺服器名稱這會將伺服器新增到您的 .vscode/mcp.json 檔案中。
開啟該檔案並視需要新增標頭：
<Tab title="API Key">
```json theme={null}
{
"servers": {
"honeydew": {
"type": "http",
"url": "https://mcp.honeydew.cloud/mcp",
"headers": {
"Authorization": "Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET>"
}
}
}
}
```
</Tab>
Honeydew 文件 MCP（選用）
Honeydew MCP 伺服器已包含文件存取工具， 因此不需要單獨的文件伺服器。 僅在您希望無需連線至 Honeydew 即可存取文件時， 才新增 Honeydew 文件 MCP。無需驗證。
將以下內容新增到您的 .vscode/mcp.json：
{
"servers": {
"honeydew-docs": {
"type": "http",
"url": "https://honeydew.ai/docs/mcp"
}
}
}
移除 MCP 伺服器
若要移除 Honeydew MCP 伺服器，
請開啟 .vscode/mcp.json 並從 servers 物件中
刪除 honeydew 項目。
若要移除 Honeydew 文件 MCP 伺服器，
請從同一個檔案中刪除 honeydew-docs 項目。
Codex CLI
#### 外掛程式安裝 **需要 Git。** 從 GitHub 安裝外掛程式會在本機複製儲存庫， 因此必須安裝 [Git](https://git-scm.com/downloads) 並將其加入 您的 `PATH`。如果缺少 Git，外掛程式安裝將會失敗。請安裝 Git， 或使用您客戶端的手動 MCP 設定步驟，直接設定伺服器而非使用外掛程式。Honeydew 提供一個 外掛程式儲存庫， 其中包含用於建置語意模型 以及透過自然對話分析資料的技能和工具。 安裝外掛程式會自動設定 Honeydew MCP 伺服器。
將市集新增到 Codex：
codex plugin marketplace add honeydew-ai/honeydew-ai-coding-agents-plugins
然後使用 codex 啟動 Codex，並輸入 /plugins
來瀏覽並安裝 Honeydew AI 外掛程式。
更新外掛程式
若要更新 Honeydew 市集，請執行：
codex plugin marketplace upgrade honeydew-ai-coding-agents-plugins
然後啟動 Codex 並輸入 /plugins 來套用更新。
MCP 設定
如果您的組織使用自訂的 Honeydew 端點， 或者您偏好不安裝外掛程式來設定 MCP 伺服器，請使用此章節。 停用由外掛程式新增的 Honeydew MCP 連線，然後使用以下指示 新增您的自訂端點。
Honeydew MCP 伺服器將 Codex 連線至 Honeydew 語意層， 以進行模型探索、資料查詢、模型管理 和文件存取。
如果您的組織使用自訂的 Honeydew 主機名稱， 請將 `https://mcp.honeydew.cloud/mcp` 替換為您的租戶主機名稱。 您可以在 Honeydew Studio 的 **設定 > MCP 伺服器** 中找到主機名稱。命令列
codex mcp add honeydew \
--url https://mcp.honeydew.cloud/mcp
然後使用 codex 啟動 Codex。
系統會提示您使用 OAuth 向 Honeydew 進行驗證。
新增伺服器後，
請開啟位於
~/.codex/config.toml 的設定檔，並視需要將標頭
新增到 [mcp_servers.honeydew] 區段。
TOML 設定
將以下內容新增到 ~/.codex/config.toml
（或在受信任的專案中新增到 .codex/config.toml）：
[mcp_servers.honeydew]
url = "https://mcp.honeydew.cloud/mcp"
[mcp_servers.honeydew.env_http_headers]
Authorization = "HONEYDEW_AUTH"
將 HONEYDEW_AUTH 環境變數設定為
Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET>
（請參閱驗證）。
Honeydew 文件 MCP（選用）
Honeydew MCP 伺服器已包含文件存取工具， 因此不需要單獨的文件伺服器。 僅在您希望無需連線至 Honeydew 即可存取文件時， 才新增 Honeydew 文件 MCP。無需驗證。
codex mcp add honeydew-docs \
--url https://honeydew.ai/docs/mcp
移除 MCP 伺服器
若要移除 Honeydew MCP 伺服器：
codex mcp remove honeydew
若要移除 Honeydew 文件 MCP 伺服器：
codex mcp remove honeydew-docs
Codex
#### 外掛程式安裝 **需要 Git。** 從 GitHub 安裝外掛程式會在本機複製儲存庫， 因此必須安裝 [Git](https://git-scm.com/downloads) 並將其加入 您的 `PATH`。如果缺少 Git，外掛程式安裝將會失敗。請安裝 Git， 或使用您客戶端的手動 MCP 設定步驟，直接設定伺服器而非使用外掛程式。Honeydew 提供一個 外掛程式儲存庫， 其中包含用於建置語意模型 以及透過自然對話分析資料的技能和工具。 安裝外掛程式會自動設定 Honeydew MCP 伺服器。
在 Codex 中新增市集：
- 開啟 外掛程式
- 點擊下拉箭頭並選擇 新增市集
- 新增
honeydew-ai/honeydew-ai-coding-agents-plugins
```
codex plugin marketplace add honeydew-ai/honeydew-ai-coding-agents-plugins
```
然後安裝外掛程式：
- 開啟 外掛程式
- 選擇 Honeydew AI 市集
- 安裝 Honeydew 外掛程式
MCP 設定
如果您的組織使用自訂的 Honeydew 端點， 或者您偏好不安裝外掛程式來設定 MCP 伺服器，請使用此章節。 停用由外掛程式新增的 Honeydew MCP 連線，然後使用以下指示 新增您的自訂端點。
如果您的組織使用自訂的 Honeydew 主機名稱， 請將 `https://mcp.honeydew.cloud/mcp` 替換為您的租戶主機名稱。 您可以在 Honeydew Studio 的 **設定 > MCP 伺服器** 中找到主機名稱。Honeydew MCP
-
開啟 Codex 應用程式
-
前往 設定 -> MCP 伺服器
-
在 自訂伺服器 下，點擊 新增伺服器
-
將伺服器名稱設定為
honeydew -
選擇 Streamable HTTP 作為傳輸類型
-
將 URL 設定為
https://mcp.honeydew.cloud/mcp -
將 Bearer 權杖環境變數 欄位留空
-
如下設定驗證：
OAuth 驗證
Codex 會在連線時將您重新導向至 Honeydew 進行驗證。 無需額外設定。
HTTP 基本驗證
在上方的標頭清單中新增一個
Authorization標頭， 其值為Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET>（請參閱驗證）。
MCP 驗證疑難排解
如果 Honeydew MCP 伺服器在 Codex 中未通過驗證， 且未出現「驗證」選項：
- 安裝 Codex CLI
- 執行
codex mcp login honeydew
Honeydew 文件 MCP（選用）
Honeydew MCP 伺服器已包含文件存取工具， 因此不需要單獨的文件伺服器。 僅在您希望無需連線至 Honeydew 即可存取文件時， 才新增 Honeydew 文件 MCP。無需驗證。
- 前往 設定 -> MCP 伺服器
- 在 自訂伺服器 下，點擊 新增伺服器
- 將伺服器名稱設定為
honeydew-docs - 選擇 Streamable HTTP 作為傳輸類型
- 將 URL 設定為
https://honeydew.ai/docs/mcp
移除 MCP 伺服器
若要移除 Honeydew MCP 伺服器：
- 前往 設定 -> MCP 伺服器
- 在 自訂伺服器 下找到
honeydew並點擊 移除
若要移除 Honeydew 文件 MCP 伺服器：
- 前往 設定 -> MCP 伺服器
- 在 自訂伺服器 下找到
honeydew-docs並點擊 移除
Antigravity
#### MCP 伺服器 如果您的組織使用自訂的 Honeydew 主機名稱， 請將 `https://mcp.honeydew.cloud/mcp` 替換為您的租戶主機名稱。 您可以在 Honeydew Studio 的 **設定 > MCP 伺服器** 中找到主機名稱。-
開啟 Antigravity 編輯器
-
點擊代理面板頂端的 ... 下拉選單
-
點擊 管理 MCP 伺服器
-
點擊 檢視原始設定
-
將以下內容新增到
```json theme={null} { "name": "honeydew", "type": "http", "url": "https://mcp.honeydew.cloud/mcp" } ```mcp_config.json：<Tab title="API Key"> ```json theme={null} { "name": "honeydew", "type": "http", "url": "https://mcp.honeydew.cloud/mcp", "headers": { "Authorization": "Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET>" } } ``` </Tab> -
儲存檔案
Honeydew 文件 MCP（選用）
Honeydew MCP 伺服器已包含文件存取工具， 因此不需要單獨的文件伺服器。 僅在您希望無需連線至 Honeydew 即可存取文件時， 才新增 Honeydew 文件 MCP。無需驗證。
- 開啟 Antigravity 編輯器
- 點擊代理面板頂端的 ... 下拉選單
- 點擊 管理 MCP 伺服器
- 點擊 檢視原始設定
- 將以下內容新增到
mcp_config.json：{ "name": "honeydew-docs", "type": "http", "url": "https://honeydew.ai/docs/mcp" } - 儲存檔案
移除 MCP 伺服器
若要移除 Honeydew MCP 伺服器：
- 開啟 Antigravity 編輯器
- 點擊代理面板頂端的 ... 下拉選單
- 點擊 管理 MCP 伺服器
- 點擊 檢視原始設定
- 從
mcp_config.json中移除honeydew和honeydew-docs項目 - 儲存檔案
OpenCode
#### MCP 伺服器 如果您的組織使用自訂的 Honeydew 主機名稱， 請將 `https://mcp.honeydew.cloud/mcp` 替換為您的租戶主機名稱。 您可以在 Honeydew Studio 的 **設定 > MCP 伺服器** 中找到主機名稱。 執行以下命令 並遵循互動式提示： ```bash theme={null}
opencode mcp add
```
出現提示時，輸入以下值：
1. **位置**：選擇您偏好的範圍（目前專案或全域）
2. **MCP 伺服器名稱**：`honeydew`
3. **MCP 伺服器類型**：`Remote`
4. **MCP 伺服器 URL**：`https://mcp.honeydew.cloud/mcp`
5. **OAuth 驗證**：`Yes`
6. **預先註冊的客戶端 ID**：`No`
</Tab>
<Tab title="JSON configuration">
將以下內容新增到您的 `opencode.jsonc` 檔案：
<Tabs>
<Tab title="OAuth (recommended)">
```json theme={null}
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"honeydew": {
"type": "remote",
"url": "https://mcp.honeydew.cloud/mcp",
"oauth": {}
}
}
}
```
然後向 Honeydew 進行驗證：
```bash theme={null}
opencode mcp auth honeydew
```
這會開啟一個瀏覽器視窗以完成 OAuth 驗證流程。
</Tab>
<Tab title="API Key">
```json theme={null}
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"honeydew": {
"type": "remote",
"url": "https://mcp.honeydew.cloud/mcp",
"headers": {
"Authorization": "Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET>"
}
}
}
}
```
</Tab>
</Tabs>
</Tab>
重新驗證
若要重新驗證，請先檢查您的狀態並登出：
opencode mcp auth list
opencode mcp logout honeydew
opencode mcp auth honeydew
Honeydew 文件 MCP（選用）
Honeydew MCP 伺服器已包含文件存取工具， 因此不需要單獨的文件伺服器。 僅在您希望無需連線至 Honeydew 即可存取文件時， 才新增 Honeydew 文件 MCP。無需驗證。
執行 `opencode mcp add` 並輸入以下值： 1. **MCP 伺服器名稱**：`honeydew-docs`
2. **MCP 伺服器類型**：`Remote`
3. **MCP 伺服器 URL**：`https://honeydew.ai/docs/mcp`
4. **OAuth 驗證**：`No`
</Tab>
<Tab title="JSON configuration">
將以下內容新增到您的 `opencode.jsonc` 檔案：
```json theme={null}
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"honeydew-docs": {
"type": "remote",
"url": "https://honeydew.ai/docs/mcp"
}
}
}
```
</Tab>
移除 MCP 伺服器
若要移除 Honeydew MCP 伺服器，
請從您的 opencode.jsonc 檔案中移除 honeydew 項目。
若要移除 Honeydew 文件 MCP 伺服器，
請從同一個檔案中移除 honeydew-docs 項目。
Kiro
Kiro IDE 和 Kiro CLI 共用相同的 MCP 設定檔， 因此以下步驟適用於兩者。MCP 伺服器
Kiro 從兩個設定檔讀取 MCP 伺服器：
- 工作區：
.kiro/settings/mcp.json（特定於目前專案） - 使用者：
~/.kiro/settings/mcp.json（適用於所有工作區）
如果兩個檔案都存在，則以工作區設定為優先。
如果您的組織使用自訂的 Honeydew 主機名稱，
請將 https://mcp.honeydew.cloud/mcp 替換為您的租戶主機名稱。
您可以在 Honeydew Studio 的 設定 > MCP 伺服器 中找到主機名稱。
將 Honeydew MCP 伺服器新增到以下其中一個
mcp.json 檔案（工作區或使用者）：
首次連線到 Honeydew 時，Kiro 會提供一個驗證 URL。
在瀏覽器中開啟該 URL 以完成 OAuth 驗證流程。
</Tab>
<Tab title="API Key">
```json theme={null}
{
"mcpServers": {
"honeydew": {
"url": "https://mcp.honeydew.cloud/mcp",
"headers": {
"Authorization": "Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET>"
}
}
}
}
```
</Tab>
在 Kiro CLI 中，執行 /mcp 以驗證伺服器是否已連線。
在 Kiro IDE 中，伺服器會顯示在 MCP 面板下。
Honeydew 文件 MCP（選用）
Honeydew MCP 伺服器已包含文件存取工具， 因此不需要單獨的文件伺服器。 只有在您希望無需連線到 Honeydew 就能存取文件時，才新增 Honeydew 文件 MCP。無需驗證。
將以下內容新增到您的 mcp.json：
{
"mcpServers": {
"honeydew-docs": {
"url": "https://honeydew.ai/docs/mcp"
}
}
}
移除 MCP 伺服器
若要移除 Honeydew MCP 伺服器，
請從您的 mcp.json 中刪除 honeydew 條目。
若要移除 Honeydew 文件 MCP 伺服器，
請從同一個檔案中刪除 honeydew-docs 條目。
Snowflake Intelligence
Snowflake 透過 [MCP 連接器](https://docs.snowflake.com/en/user-guide/snowflake-cortex/cortex-agents-mcp-connectors) 連線到外部 MCP 伺服器， 讓 Snowflake Intelligence 和 Cortex Agents 可以使用 Honeydew 工具。先決條件：
- 在帳戶上具有
CREATE INTEGRATION權限的角色 - 在目標結構描述上具有
CREATE MCP SERVER權限的角色
預設情況下，只有 ACCOUNTADMIN 角色擁有這些權限。
<Step title="Create the external MCP server">
外部 MCP 伺服器是一個結構描述層級的物件，
它參考了 API 整合：
```sql theme={null}
CREATE EXTERNAL MCP SERVER honeydew
WITH DISPLAY_NAME = 'Honeydew MCP Server'
URL = 'https://mcp.honeydew.cloud/mcp'
API_INTEGRATION = honeydew_mcp_integration;
```
</Step>
<Step title="Grant access">
將整合和 MCP 伺服器的使用權限授予
任何需要存取 Honeydew 的角色：
```sql theme={null}
GRANT USAGE ON INTEGRATION honeydew_mcp_integration TO ROLE <role>;
GRANT USAGE ON EXTERNAL MCP SERVER honeydew TO ROLE <role>;
```
</Step>
<Step title="Add the MCP server to an agent">
將 `honeydew` MCP 伺服器作為工具新增到 Cortex Agent
或 Snowflake Intelligence agent。
使用者在首次使用時會收到提示，透過 OAuth 向 Honeydew 進行驗證。
</Step>
移除 MCP 伺服器
先卸除 MCP 伺服器，然後再卸除 API 整合：
DROP MCP SERVER honeydew;
DROP INTEGRATION honeydew_mcp_integration;
其他客戶端
任何與 MCP 相容的客戶端都可以 使用標準 HTTP 傳輸 連線到 Honeydew MCP 伺服器。
使用以下 JSON 設定 作為起點：
如果您的組織使用自訂的 Honeydew 主機名稱， 請將 `https://mcp.honeydew.cloud/mcp` 替換為您的租戶主機名稱。 您可以在 Honeydew Studio 的 **設定 > MCP 伺服器** 中找到主機名稱。 ```json theme={null} { "name": "honeydew", "type": "http", "url": "https://mcp.honeydew.cloud/mcp" } ``` ```json theme={null} { "name": "honeydew", "type": "http", "url": "https://mcp.honeydew.cloud/mcp", "headers": { "Authorization": "Basic " } } ```有關每個參數的詳細資訊，請參閱 伺服器 URL、 驗證 和 設定。
使用範例
連線後，您可以向 AI 助理提出以下問題：
- "語意模型中有哪些可用的實體？"
- "顯示
orders實體的屬性和指標" - "模型中定義了哪些領域？"
- "
analytics結構描述中有哪些資料表？" - "上個月有多少筆訂單？"
- "為
orders實體建立一個總收入的新指標" - "上一季按區域劃分的平均訂單價值是多少？"
疑難排解
OAuth 驗證問題
確認您的客戶端支援 OAuth，確保您擁有必要的 Honeydew 工作區權限，並嘗試透過客戶端的 MCP 管理介面重新驗證。
在 Claude Code 中重新驗證
輸入 /mcp，從清單中選取 Honeydew MCP，
選擇「清除驗證」或「驗證」，
然後按照瀏覽器中的 OAuth 提示重新連線到 Honeydew。
連線問題
確認 MCP 伺服器 URL 與 https://mcp.honeydew.cloud/mcp 相符，
並驗證您客戶端的 MCP 設定語法是否正確。
如果您的組織使用自訂主機名稱，請檢查 URL 是否與
Honeydew Studio 中 設定 > MCP 伺服器 顯示的租戶主機名稱相符。
缺少工具
確認驗證是否成功，檢查您的 Honeydew 工作區存取權限， 並查看客戶端主控台中的錯誤訊息。
輸出超出允許的最大 Token 數 (Claude)
在 Claude Code、Claude Desktop 和 Claude.ai 中，工具呼叫可能會因輸出超出允許的最大 Token 數而失敗。Honeydew 分析工具，例如
monitor_analysis 和
get_analysis_step_details，可能會傳回超過 Claude MCP 輸出限制的大型結果。
當 MCP 工具輸出超過 10,000 個 Token 時，Claude 會發出警告，並拒絕超過
25,000 個 Token 預設限制的輸出。若要提高限制，請在啟動 Claude 之前設定 MAX_MCP_OUTPUT_TOKENS
環境變數：
export MAX_MCP_OUTPUT_TOKENS=50000
claude
有關詳細資訊，請參閱 Claude 文件中的 MCP 輸出限制和警告。
如需其他支援，請透過 support@honeydew.ai 聯絡 Honeydew 支援團隊。
可用工具
標記為 唯讀 的工具不會修改 語意模型或資料倉儲。
若只要公開唯讀工具，請在您的 MCP 伺服器設定中設定 `ReadonlyToolsOnly: true` 標頭。 啟用後，伺服器只會傳回不會修改語意模型或資料倉儲的工具。工作階段與工作區
list_workspaces
唯讀
列出所有可用的工作區。
傳回工作區名稱和資料倉儲類型（snowflake、databricks 或 bigquery）。
使用資料倉儲類型來輔助語意模型的實作。
list_workspace_branches
唯讀
列出工作區可用的所有分支。
工作區的名稱。get_session_workspace_and_branch
唯讀
取得目前工作階段所設定的工作區和分支。
set_session_workspace_and_branch
唯讀
設定目前工作階段要使用的工作區和分支。 工作階段中所有後續的工具呼叫都將使用此工作區和分支。
工作區的名稱。 要使用的分支。create_workspace_branch
為現有工作區建立一個新分支。
該分支是從工作區的 prod 分支的目前狀態建立的。
如果沒有透過標頭固定工作區，工作階段會自動切換到新分支。
delete_workspace_branch
從工作區刪除一個分支。
這是一個破壞性、不可逆的操作。
在呼叫此工具之前，務必與使用者確認工作區名稱和分支名稱。
無法刪除 prod 分支。
如果刪除的分支是目前的工作階段分支，
工作階段會自動切換到 prod。
get_branch_history
唯讀
取得目前工作階段分支的變更歷史記錄。 傳回一個變更清單，顯示修改了哪些語意物件、 由誰修改以及何時修改。
要傳回的變更數量上限。create_pr_for_working_branch
為目前工作階段的工作分支建立一個拉取請求。 成功時傳回 PR URL。
拉取請求的標題。 拉取請求的描述。提問與分析
initiate_analysis
唯讀
開始或繼續資料分析。傳回一個 conversation_id —
使用 monitor_analysis 來輪詢進度和結果，
並使用 abort_analysis 來提前停止。
有關更多詳細資訊，請參閱 深度分析。
monitor_analysis
唯讀
從進行中的分析輪詢新的進度訊息。
每次呼叫僅傳回自上次呼叫以來的訊息。
重複輪詢，直到 status 為 DONE 或 NO_CHAT_CURRENTLY_RUNNING。
get_analysis_step_details
唯讀
擷取特定分析步驟的完整詳細資訊， 包括語意查詢、SQL 陳述式、使用的上下文， 以及在該步驟中擷取的資料。
由 `initiate_analysis` 傳回的對話 ID。 來自 `monitor_analysis` 的步驟 ID（例如 `STEP/0`）。abort_analysis
唯讀
中止進行中的分析。
可以使用 initiate_analysis 從中止點恢復。
list_analysis_chats
唯讀
傳回目前工作區的分析對話分頁清單， 按建立時間排序（最新的在前）。 管理員可以看到所有對話；非管理員只能看到自己的對話。 每個條目包含對話 ID、標題、使用者回饋、領域、代理程式、 建立時間以及建立者的顯示名稱。
要傳回的對話數量上限。 用於分頁的要跳過的對話數量。provide_analysis_feedback
設定或清除特定分析對話的回饋。 每個對話只有一個回饋條目（而非每個問題一個）— 它應反映整個對話流程的整體品質。
在 monitor_analysis 完成且使用者對結果表達
滿意或不滿意後呼叫此工具。
對於正面回饋，使用簡短的肯定字串（例如 Good），
對於負面回饋，使用格式 <Reason>: <details>，
其中 Reason 是 Chart Issue、Data Issue、Wrong Judgement 或 Other 之一。
get_stored_conversation
唯讀
返回現有分析對話中的所有訊息。
使用此功能來檢視先前對話的完整內容。
回應中的 is_complete 會指出對話是否已達到終止狀態。
瀏覽與探索
list_entities
唯讀
列出語意模型中所有實體的名稱、描述和鍵值。
get_entity
唯讀
取得實體的詳細資訊，包括其屬性、指標、資料集、關聯和 YAML 定義。
實體的名稱。get_field
唯讀
取得實體內特定欄位（屬性或指標）的詳細資訊，包括其 YAML 定義。
包含該欄位的實體名稱。 欄位的名稱。list_domains
唯讀
列出語意模型中所有領域的名稱、描述和實體。
get_domain
唯讀
取得領域的詳細資訊，包括其實體、篩選器、參數和 YAML 定義。
領域的名稱。search_model
唯讀
在語意模型中搜尋與查詢字串相符的實體、屬性、指標、資料集、動態資料集、領域和全域參數。
使用 entity.field 語法將搜尋範圍限定在特定實體內的欄位。
例如，customers.balance 會在符合 customers 的實體上尋找 balance 欄位；customers. 則會回傳符合實體的所有欄位。在 OR/AND 模式下，部分匹配會同時套用至實體和欄位部分 — cust.bal 會匹配 customers.balance。
OR— 以空白字元分割，回傳符合任一詞彙的物件。AND— 以空白字元分割，僅回傳符合所有詞彙的物件。EXACT— 使用完整字串，回傳名稱或顯示名稱完全相符的物件。
倉庫探索
list_databases
唯讀
列出已連線資料倉庫中所有可用的資料庫。
list_schemas
唯讀
列出已連線資料倉庫中特定資料庫內的所有結構描述。
資料庫名稱。list_tables
唯讀
列出已連線資料倉庫中特定資料庫和結構描述內的資料表/檢視表。
資料庫名稱。 結構描述名稱。get_table_info
唯讀
取得倉庫資料表/檢視表的詳細資訊，包括其欄位和中繼資料。
資料庫名稱。 結構描述名稱。 資料表名稱。語意模型
import_tables
將已連線資料倉庫中的資料表匯入語意模型。 每個資料表會成為一個實體，其欄位則成為屬性。
格式為 `database.schema.table` 的完整資料表名稱清單。create_entity
從 YAML 定義在語意模型中建立一個新實體。
實體的 YAML 定義。 資料集的 YAML 定義。create_object
從 YAML 定義建立一個新的語意模型物件。 支援的類型：屬性、指標、動態資料集、領域和全域參數。
物件的 YAML 定義。 即使驗證產生錯誤，仍建立該物件。update_object
從 YAML 定義更新一個現有的語意模型物件。 支援的類型：實體、屬性、指標、資料集、動態資料集、領域和全域參數。
物件的 YAML 定義。 要更新的物件鍵值。 即使驗證產生錯誤，仍更新該物件。validate_object
唯讀
驗證語意模型物件的 YAML 定義，而不建立或更新它。 支援的類型：實體、屬性、指標、資料集、動態資料集、領域和全域參數。
要驗證的 YAML 定義。 要據以驗證的物件鍵值。delete_object
依其鍵值刪除一個語意模型物件。
要刪除的物件鍵值。 即使驗證產生錯誤，仍刪除該物件。代理程式
list_agents
唯讀
列出所有代理程式及其名稱、描述、領域和上下文參考。
get_agent
唯讀
取得代理程式的詳細資訊，包括其 YAML 前言定義。
要擷取的代理程式名稱。create_agent
建立一個新的代理程式。
新代理程式的中繼資料。 階層式名稱（例如 `growth-analyst`、`finance/budget-analyst`）。<ParamField body="display_name" type="string" required>
在 UI 中顯示的人類可讀名稱。
</ParamField>
<ParamField body="description" type="string" required>
代理程式目的和功能的描述。
</ParamField>
<ParamField body="domain" type="string" required>
此代理程式運作的領域。
</ParamField>
<ParamField body="welcome_message" type="string">
使用者開始工作階段時顯示的介紹訊息。
</ParamField>
<ParamField body="sample_questions" type="string[]">
向使用者顯示的範例問題。
</ParamField>
<ParamField body="context" type="string[]">
要載入工作階段的上下文項目名稱或 glob 模式
（例如 `skills/**`、`knowledge/marketing/**`）。
</ParamField>
<ParamField body="owner" type="string">
代理程式的擁有者識別碼。
</ParamField>
update_agent
更新一個現有的代理程式。
要更新的代理程式名稱。 完整的更新後代理程式定義。必須提供 `create_agent` 中的所有必要欄位 — 這是完整取代，而非部分更新。 代理程式的更新後 Markdown 內文。 即使驗證產生錯誤，仍更新該代理程式。delete_agent
依名稱刪除代理程式。
要刪除的代理程式名稱。上下文項目
list_context_items
唯讀
列出所有上下文項目及其類型、名稱、標題和子類型值。
get_context_item
唯讀
依名稱取得上下文項目。
要擷取的上下文項目名稱。create_context_item
建立一個新的上下文項目。支援指示和記憶體類型。
新上下文項目的中繼資料。 必須是 `instruction`。<ParamField body="name" type="string" required>
階層式名稱
（例如 `knowledge/customer/churn-analysis`、`skills/reporting`）。
</ParamField>
<ParamField body="subtype" type="string" required>
下列之一：`knowledge`、`skill` 或 `instruction`。
</ParamField>
<ParamField body="title" type="string" required>
上下文項目的人類可讀標題。
</ParamField>
<ParamField body="apply" type="string" required>
何時套用上下文：`always` 或 `on_demand`。
</ParamField>
<ParamField body="description" type="string">
AI 用來決定何時載入此項目的描述
（當 `apply` 為 `on_demand` 時為必要項）。
</ParamField>
<ParamField body="owner" type="string">
擁有者識別碼。
</ParamField>
<ParamField body="labels" type="string[]">
用於組織上下文項目的標籤。
</ParamField>
<ParamField body="related_objects" type="object[]">
此上下文項目相關的語意物件。
每個物件都有一個 `name`（字串）和 `type`（`domain`、`entity` 或 `field`）。
</ParamField>
<ParamField body="external_source" type="object">
要從中擷取內容的外部來源（針對 `knowledge` 子類型）。
具有 `tool`（MCP 工具名稱）、`resource_id`（外部工具中的識別碼），
以及選用的 `cache_max_age_in_seconds`（預設值：`3600`）。
</ParamField>
<ParamField body="name" type="string" required>
階層式名稱（例如 `events/q4-launch`、`2024/pricing-decision`）。
</ParamField>
<ParamField body="subtype" type="string" required>
下列之一：`event` 或 `decision_trace`。
</ParamField>
<ParamField body="title" type="string" required>
上下文項目的人類可讀標題。
</ParamField>
<ParamField body="apply" type="string" required>
何時套用上下文：`always` 或 `on_demand`。
</ParamField>
<ParamField body="from_date" type="string" required>
記憶體期間的開始日期，ISO 格式（例如 `2024-01-01`）。
</ParamField>
<ParamField body="to_date" type="string">
記憶體期間的結束日期，ISO 格式。
</ParamField>
<ParamField body="description" type="string">
AI 用來決定何時載入此項目的描述
（當 `apply` 為 `on_demand` 時為必要項）。
</ParamField>
<ParamField body="owner" type="string">
擁有者識別碼。
</ParamField>
<ParamField body="labels" type="string[]">
用於組織上下文項目的標籤。
</ParamField>
<ParamField body="related_objects" type="object[]">
此上下文項目相關的語意物件。
每個物件都有一個 `name`（字串）和 `type`（`domain`、`entity` 或 `field`）。
</ParamField>
<ParamField body="external_source" type="object">
要從中擷取內容的外部來源。
具有 `tool`（MCP 工具名稱）、`resource_id`（外部工具中的識別碼），
以及選用的 `cache_max_age_in_seconds`（預設值：`3600`）。
</ParamField>
update_context_item
更新一個現有的上下文項目。
要更新的上下文項目名稱。 完整的更新後上下文項目定義。必須提供 `create_context_item` 中的所有必要欄位 — 這是完整取代，而非部分更新。 上下文項目的更新後 Markdown 內文。 即使驗證產生錯誤，仍更新該上下文項目。delete_context_item
依名稱刪除上下文項目。
要刪除的上下文項目名稱。查詢與預覽
get_sql_from_fields
唯讀
為由屬性、指標和篩選器定義的語意層查詢產生 SQL 查詢。回傳 SQL 而不執行它。
完整屬性名稱（`entity.attribute_name`）。 支援別名：`entity.attribute_name as alias_name`。 完整限定指標名稱 (`entity.metric_name`) 或 SQL 表達式 (例如 `SUM(entity.field)`)。支援別名：`SUM(entity.field) as total`。 篩選條件 (例如 `entity.field = 'value'`, `entity.date_field > '2024-01-01'`)。 排序依據的欄位清單。 格式：`entity.field_name` 或 `entity.field_name DESC`。 預設方向為 ASC。 使用別名時，請以別名名稱排序。 要查詢的領域。 要回傳的最大列數。 用於分頁的略過列數。get_data_from_fields
唯讀
執行由屬性、指標和篩選條件定義的語意層查詢， 並回傳結果資料。
完整限定屬性名稱 (`entity.attribute_name`)。 支援別名：`entity.attribute_name as alias_name`。 完整限定指標名稱 (`entity.metric_name`) 或 SQL 表達式 (例如 `SUM(entity.field)`)。支援別名：`SUM(entity.field) as total`。 篩選條件 (例如 `entity.field = 'value'`, `entity.date_field > '2024-01-01'`)。 排序依據的欄位清單。 格式：`entity.field_name` 或 `entity.field_name DESC`。 預設方向為 ASC。 使用別名時，請以別名名稱排序。 要查詢的領域。 要回傳的最大列數。 用於分頁的略過列數。list_query_history
唯讀
列出先前透過 Honeydew 語意層執行的查詢， 最新的排在最前面。用於尋找和分類失敗的查詢，並了解 其失敗原因。非管理員呼叫者只會看到自己的查詢。
每個查詢包含其狀態、錯誤訊息、擁有者、客戶端、領域、 原始輸入 SQL（SQL 介面查詢的使用者提交 SQL）、 編譯和資料倉儲執行的時間戳記、資料倉儲 查詢 ID，以及在 Honeydew 應用程式中開啟的連結。
依查詢狀態篩選 (`FAILED`、`SUCCESS`、`RUNNING` 或 `CANCELED`)。 依執行查詢的客戶端篩選 (例如 `Snowflake`、`MCP`)。 依領域名稱篩選。 依查詢擁有者篩選（使用者的電子郵件或 API 金鑰的名稱）。 僅對管理員呼叫者有效；非管理員僅限於自己的查詢。 僅回傳在此時間或之後執行的查詢 (ISO 8601)。 僅回傳在此時間或之前執行的查詢 (ISO 8601)。 一併回傳每個查詢的語意 YAML 定義 （屬性、指標、篩選條件）。啟用以重現或修改查詢。 一併回傳每個查詢編譯後的倉儲 SQL（可能很大）。 啟用以對特定查詢進行倉儲端除錯。 要回傳的最大查詢數。 用於分頁的略過查詢數。文件
search_docs
唯讀
搜尋 Honeydew 文件知識庫以獲取相關資訊、
程式碼範例、API 參考和指南。
回傳包含標題和文件頁面連結的上下文內容。
要閱讀頁面的完整內容，請使用 query_docs_filesystem。
query_docs_filesystem
唯讀
對包含 Honeydew 文件頁面和 OpenAPI 規格的虛擬化記憶體內
檔案系統執行唯讀的類 shell 指令。
支援的指令如 rg、grep、find、tree、ls、cat、
head 和 tail。
用於精確的關鍵字或正則表達式匹配、結構化探索，
或按路徑閱讀特定頁面的完整內容。