Honeydew Semantic Layer
官方Honeydew语义层提供了一个受管控且对业务友好的数据模型，统一了跨数据源的指标、维度和关系，从而实现一致的自助分析以及基于AI的数据访问。
你可以用 Honeydew Semantic Layer MCP 做什么？
- 发现仓库表与模式 — 通过自然对话探索数据仓库结构与语义模型定义。
- 构建与维护语义模型 — 使用
create_workspace_branch及其他会话工具创建或更新语义模型定义。 - 用自然语言查询数据 — 无需编写 SQL 即可提问并获取数据答案。
- 搜索 Honeydew 文档 — 直接从任何兼容 MCP 的助手中查阅产品文档。
文档
MCP 服务器
什么是 MCP？
模型上下文协议 (MCP) 是一个开源标准，用于将 AI 应用程序安全地连接到外部系统和工具。 Honeydew 提供了一个 MCP 服务器，可将您的 AI 编码助手连接到 Honeydew 语义层。
何时使用
- 发现和探索您的仓库表、模式和语义模型定义
- 通过自然对话构建和维护您的语义模型
- 从任何兼容 MCP 的助手使用自然语言查询您的数据
- 搜索和阅读 Honeydew 文档
安装
服务器 URL
Honeydew 在以下地址公开 MCP 服务器 API：
https://mcp.honeydew.cloud/mcp
身份验证
有两种方式可以对 Honeydew MCP 服务器进行身份验证： OAuth 或 HTTP 基本身份验证。
OAuth 身份验证（推荐）
大多数客户端支持 OAuth 身份验证。 首次连接时，系统会提示您：
- 使用您的 Honeydew 账户登录
- 接受 OAuth 授权
然后，客户端会安全地为后续请求提供访问令牌。
HTTP 基本身份验证
处于 HTTP 基本身份验证模式的 MCP 服务器 需要一个 API 密钥 进行身份验证。
您需要提供 API 密钥和 API 密钥的
Base64 编码字符串，
格式为 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 语义层， 用于模型探索、数据查询、模型管理和文档访问。
使用以下方法之一添加 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 支持使用 `${VAR_NAME}` 语法进行
[环境变量扩展](https://code.claude.com/docs/en/mcp#environment-variable-expansion-in-mcp-json)。
设置 `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 语义层， 用于模型探索、数据查询、模型管理和文档访问。
Claude Code 模式
在 Claude Code 模式下使用 Claude Desktop 时， 请改为遵循 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 语义层， 用于模型探索、数据查询、模型管理和文档访问。
如果您的组织使用自定义的 Honeydew 主机名， 请将 `https://mcp.honeydew.cloud/mcp` 替换为您的租户主机名。 您可以在 Honeydew Studio 的 **设置 > MCP 服务器** 中找到主机名。要添加 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 服务器
要移除 Honeydew MCP 服务器：
- 前往 设置 -> 连接器
- 找到
honeydew连接器并点击删除图标
要移除 Honeydew 文档 MCP 服务器：
- 前往 设置 -> 连接器
- 找到
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 语义层， 用于模型探索、数据查询、模型管理 和文档访问。
如果您的组织使用自定义 Honeydew 主机名， 请将 `https://mcp.honeydew.cloud/mcp` 替换为您的租户主机名。 您可以在 Honeydew Studio 的 **设置 > MCP 服务器** 中找到主机名。 ```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 文档 MCP（可选）
Honeydew MCP 服务器已包含文档访问工具， 因此不需要单独的文档服务器。 仅当您希望在不连接 Honeydew 的情况下访问文档时，才添加 Honeydew 文档 MCP。无需身份验证。
cortex mcp add honeydew-docs \
https://honeydew.ai/docs/mcp \
--type http
移除 MCP 服务器
要移除 Honeydew MCP 服务器：
cortex mcp remove honeydew
要移除 Honeydew 文档 MCP 服务器：
cortex mcp remove honeydew-docs
Cortex Code Desktop
#### 插件安装 **需要 Git。** 从 GitHub 安装插件会在本地克隆仓库， 因此必须安装 [Git](https://git-scm.com/downloads) 并将其添加到 您的 `PATH` 中。如果缺少 Git，插件安装将失败。请安装 Git，或 使用客户端的 MCP 手动设置步骤直接配置服务器， 而不是使用插件。Honeydew 提供了一个 插件仓库， 其中包含用于构建语义模型 和通过自然对话分析数据的技能和工具。 安装插件会自动设置 Honeydew MCP 服务器。
- 前往 设置 -> 插件
- 点击 添加插件，选择 从 GitHub 添加，并粘贴
Honeydew 插件仓库：
honeydew-ai/honeydew-ai-coding-agents-plugins - 按照流程操作，并在 GitHub 插件安装程序设置 中批准相关步骤
MCP 设置
如果您的组织使用自定义 Honeydew 端点， 或者您希望在不安装插件的情况下配置 MCP 服务器，请使用此部分。 禁用由插件添加的 Honeydew MCP 连接，然后使用以下说明添加您的 自定义端点。
Honeydew MCP 服务器将 Cortex Code Desktop 连接到 Honeydew 语义层， 用于模型探索、数据查询、模型管理 和文档访问。
要添加服务器，请前往 MCP -> 新建，选择一个 配置范围
（例如，全局使用 ~/.snowflake/cortex/mcp.json），填写表单，
然后点击 保存。使用 表单 或 JSON 选项卡输入配置。
添加 Honeydew MCP 服务器：
1. **服务器名称**：`honeydew` 2. **服务器类型**：**远程 (HTTP)** 3. **服务器 URL**：`https://mcp.honeydew.cloud/mcp` 4. 点击 **保存** 首次连接时，系统会提示您通过 OAuth 向 Honeydew 进行身份验证。
</Tab>
<Tab title="API Key">
1. **服务器名称**：`honeydew`
2. **服务器类型**：**远程 (HTTP)**
3. **服务器 URL**：`https://mcp.honeydew.cloud/mcp`
4. 在 **标头** 下，点击 **添加标头**，将名称设置为
`Authorization`，值设置为
`Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET>`
5. 点击 **保存**
</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 文档 MCP（可选）
Honeydew MCP 服务器已包含文档访问工具，
因此不需要单独的文档服务器。
如果您希望在不连接 Honeydew 的情况下访问文档，
请以相同方式添加 Honeydew 文档 MCP 服务器，使用 服务器名称
honeydew-docs，服务器类型 远程 (HTTP)，以及 服务器 URL
https://honeydew.ai/docs/mcp。无需身份验证。
移除 MCP 服务器
要移除服务器，请前往 MCP，找到 honeydew（或 honeydew-docs）
服务器，并将其移除。
Cursor
#### 插件安装Honeydew 提供了一个 插件仓库， 其中包含用于构建语义模型 和通过自然对话分析数据的技能和工具。 安装插件会自动设置 Honeydew MCP 服务器。
- 在您的团队或组织设置中， 前往 cursor.com/dashboard/plugins （或点击左侧菜单中的 插件）
- 向下滚动到 团队市场，然后点击现有市场， 或点击 添加市场 创建一个新市场。 如果创建新市场，请输入名称并创建它。
- 在市场内，点击 添加插件，
粘贴 Honeydew 插件 GitHub 仓库路径：
https://github.com/honeydew-ai/honeydew-ai-coding-agents-plugins并点击 添加 1 个插件 - 可选地，在市场页面中启用 自动刷新， 以便在发布新版本时插件自动更新。
- 返回插件页面 (cursor.com/dashboard/plugins)， 搜索 Honeydew 插件，然后点击 添加
MCP 设置
如果您的组织使用自定义 Honeydew 端点， 或者您希望在不安装插件的情况下配置 MCP 服务器，请使用此部分。 禁用由插件添加的 Honeydew MCP 连接，然后使用以下说明添加您的 自定义端点。
Honeydew MCP 服务器将 Cursor 连接到 Honeydew 语义层， 用于模型探索、数据查询、模型管理 和文档访问。
如果您的组织使用自定义 Honeydew 主机名， 请将 `https://mcp.honeydew.cloud/mcp` 替换为您的租户主机名。 您可以在 Honeydew Studio 的 **设置 > MCP 服务器** 中找到主机名。要添加 Honeydew MCP：
-
打开 Cursor 应用程序
-
前往 设置 -> Cursor 设置 -> 工具与 MCP
-
点击 新建 MCP 服务器
-
添加以下配置：
```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> -
点击 保存
Honeydew 文档 MCP（可选）
Honeydew MCP 服务器已包含文档访问工具， 因此不需要单独的文档服务器。 仅当您希望在不连接 Honeydew 的情况下访问文档时，才添加 Honeydew 文档 MCP。无需身份验证。
- 前往 设置 -> Cursor 设置 -> 工具与 MCP
- 点击 新建 MCP 服务器
- 添加以下配置：
{ "name": "honeydew-docs", "type": "http", "url": "https://honeydew.ai/docs/mcp" } - 点击 保存
移除 MCP 服务器
要移除 Honeydew MCP 服务器：
- 前往 设置 -> Cursor 设置 -> 工具与 MCP
- 在列表中找到
honeydew并点击删除图标
要移除 Honeydew 文档 MCP 服务器：
- 前往 设置 -> Cursor 设置 -> 工具与 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 元存储的
CREATE CONNECTION权限
<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>
</Tabs>
<Note>
如果您的组织使用自定义的 Honeydew 主机名，请将
`https://mcp.honeydew.cloud` 替换为您的租户主机名。
您可以在 Honeydew Studio 的 **Settings > MCP Server** 中找到您的主机名。
</Note>
</Step>
<Step title="Log in to the connection">
导航至 **Catalog** → **Connections** → `honeydew-mcp`
并点击右上角的 **Login**
以进行身份验证并验证连接。
</Step>
<Step title="Grant connection access">
将 `USE CONNECTION` 权限授予需要访问 Honeydew MCP 服务器的
任何用户或角色：
```sql theme={null}
GRANT USE CONNECTION ON CONNECTION `honeydew-mcp` TO <user-or-role>;
```
</Step>
<Step title="Add the MCP server in Genie Code">
1. 打开 Genie Code 并点击齿轮图标
2. 导航至 **MCP Servers** → **Add Server**
3. 选择 **External MCP server**
4. 选择您创建的 `honeydew-mcp` 连接
5. 出现提示时登录该连接
6. 点击 **Save**
<Note>
Databricks 将所有已配置服务器的 MCP 工具限制为 20 个。
如果您需要调整可用的 Honeydew 工具，
请使用 Genie Code MCP 设置来启用或禁用特定工具。
</Note>
</Step>
移除 MCP 服务器
要从 Genie Code 中移除 Honeydew MCP 服务器：
- 打开 Genie Code 并点击齿轮图标
- 导航至 MCP Servers
- 找到
honeydew-mcp并点击 Remove
要同时移除底层的 Unity Catalog 连接， 请运行以下 SQL：
DROP CONNECTION `honeydew-mcp`;
Devin
#### MCP 服务器Devin 通过其 MCP Marketplace 连接到远程 MCP 服务器。
如果您的组织使用自定义的 Honeydew 主机名， 请将 `https://mcp.honeydew.cloud/mcp` 替换为您的租户主机名。 您可以在 Honeydew Studio 的 **Settings > MCP Server** 中找到主机名。要添加 Honeydew MCP 服务器：
-
前往 Settings -> Connections -> MCP servers
-
点击 Add a custom MCP
-
在 Server Name 字段中输入
honeydew -
（可选）添加图标和 Short Description
-
选择 HTTP 作为传输类型
-
在 Server URL 字段中输入
https://mcp.honeydew.cloud/mcp -
配置身份验证：
选择 **OAuth** 作为身份验证方法。 Devin 会在首次会话期间提示您向 Honeydew 进行身份验证。<Tab title="API Key"> 选择 **Auth Header** 作为身份验证方法。 将标头键保留为 `Authorization`，并将值设置为 `Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET>` （请参阅 [Authentication](#authentication)）。 </Tab> -
点击 Save，然后点击 Test listing tools 以验证连接
Honeydew 文档 MCP（可选）
Honeydew MCP 服务器已包含文档访问工具， 因此不需要单独的文档服务器。 仅当您希望在不连接 Honeydew 的情况下访问文档时，才添加 Honeydew 文档 MCP。无需身份验证。
- 前往 Settings -> Connections -> MCP servers
- 点击 Add a custom MCP
- 在 Server Name 字段中输入
honeydew-docs - 选择 HTTP 作为传输类型
- 在 Server URL 字段中输入
https://honeydew.ai/docs/mcp - 将身份验证方法设置为 None
- 点击 Save
移除 MCP 服务器
要移除 Honeydew MCP 服务器：
- 前往 Settings -> Connections -> MCP servers
- 找到
honeydew服务器并将其移除
要移除 Honeydew 文档 MCP 服务器：
- 前往 Settings -> Connections -> MCP servers
- 找到
honeydew-docs服务器并将其移除
GitHub Copilot CLI
#### MCP 服务器 如果您的组织使用自定义的 Honeydew 主机名， 请将 `https://mcp.honeydew.cloud/mcp` 替换为您的租户主机名。 您可以在 Honeydew Studio 的 **Settings > MCP Server** 中找到主机名。-
使用
copilot启动 GitHub Copilot CLI -
输入
/mcp add以打开服务器配置表单 -
填写以下字段：
-
Name:
honeydew -
Type:
http -
URL:
https://mcp.honeydew.cloud/mcp -
HTTP Headers:
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以打开服务器配置表单 - 填写以下字段：
- Name:
honeydew-docs - Type:
http - URL:
https://honeydew.ai/docs/mcp
- Name:
- 按
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 的 **Settings > MCP Server** 中找到主机名。运行以下命令添加 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， 然后选择 Preferences: Open User Settings (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 插件并点击 Install
首次从新市场安装插件时， VS Code 会显示信任提示 — 请在确认前审查市场来源。
更新插件
如果在 VS Code 设置中启用了 extensions.autoUpdate，
插件会自动更新。
要手动更新，请打开命令面板并运行
Extensions: Check for Extension Updates。
MCP 服务器
如果您的组织使用自定义的 Honeydew 端点， 或者您希望在不安装插件的情况下配置 MCP 服务器，请使用此部分。 禁用由插件添加的 Honeydew MCP 连接，然后使用以下说明添加您的 自定义端点。
Honeydew MCP 服务器将 VS Code 连接到 Honeydew 语义层， 用于模型探索、数据查询、模型管理 和文档访问。
如果您的组织使用自定义的 Honeydew 主机名， 请将 `https://mcp.honeydew.cloud/mcp` 替换为您的租户主机名。 您可以在 Honeydew Studio 的 **Settings > MCP Server** 中找到主机名。 1. 使用 `CMD+Shift+P`（macOS） 或 `Ctrl+Shift+P`（Windows/Linux）打开命令面板 2. 选择 **MCP: 添加服务器...** 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 -
选择 可流式传输的 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 - 选择 可流式传输的 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。
在浏览器中打开它以完成 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 服务器， 使 Honeydew 工具可用于 Snowflake Intelligence 和 Cortex Agent。先决条件：
- 拥有账户
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 代理。
用户在首次使用时会被提示通过 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 工作区访问权限， 并查看客户端控制台中的错误消息。
输出超出最大允许令牌数 (Claude)
在 Claude Code、Claude Desktop 和 Claude.ai 中，工具调用可能会因输出超出最大允许令牌数而失败。Honeydew 分析工具，例如
monitor_analysis 和
get_analysis_step_details，可能会返回超过 Claude MCP 输出限制的大型结果。
当 MCP 工具输出超过 10,000 个令牌时，Claude 会发出警告，并拒绝超过
默认限制 25,000 个令牌的输出。要提高限制，请在启动 Claude 之前设置 MAX_MCP_OUTPUT_TOKENS
环境变量：
export MAX_MCP_OUTPUT_TOKENS=50000
claude
有关详细信息，请参阅 Claude 文档中的 MCP 输出限制和警告。
如需其他支持，请联系 Honeydew 支持团队：support@honeydew.ai。
可用工具
标记为只读的工具不会修改 语义模型或数据仓库。
要仅公开只读工具，请在您的 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 等命令。
用于精确的关键字或正则表达式匹配、结构探索，
或按路径阅读特定页面的完整内容。