Honeydew Semantic Layer

chính thức

Lớp ngữ nghĩa Honeydew cung cấp mô hình dữ liệu được quản lý, thân thiện với doanh nghiệp, thống nhất các chỉ số, khía cạnh và mối quan hệ giữa các nguồn, cho phép phân tích tự phục vụ nhất quán và truy cập dữ liệu hỗ trợ bởi AI.

Xem trên honeydew.ai

Bạn có thể làm gì với Honeydew Semantic Layer MCP?

  • Khám phá các bảng và lược đồ trong kho dữ liệu — khám phá cấu trúc kho dữ liệu và định nghĩa mô hình ngữ nghĩa của bạn thông qua hội thoại tự nhiên.
  • Xây dựng và duy trì các mô hình ngữ nghĩa — tạo hoặc cập nhật định nghĩa mô hình ngữ nghĩa bằng cách sử dụng create_workspace_branch và các công cụ phiên khác.
  • Truy vấn dữ liệu bằng ngôn ngữ tự nhiên — đặt câu hỏi về dữ liệu của bạn và nhận câu trả lời mà không cần viết SQL.
  • Tìm kiếm tài liệu Honeydew — tra cứu tài liệu sản phẩm trực tiếp từ bất kỳ trợ lý tương thích MCP nào.

Tài liệu

MCP Server

MCP là gì?

Model Context Protocol (MCP) là một tiêu chuẩn mã nguồn mở để kết nối an toàn các ứng dụng AI với các hệ thống và công cụ bên ngoài. Honeydew cung cấp một máy chủ MCP kết nối trợ lý lập trình AI của bạn với Honeydew Semantic Layer.

Khi nào nên sử dụng

  • Khám phá và tìm hiểu các bảng dữ liệu, lược đồ và định nghĩa mô hình ngữ nghĩa trong kho dữ liệu của bạn
  • Xây dựng và duy trì mô hình ngữ nghĩa thông qua hội thoại tự nhiên
  • Truy vấn dữ liệu bằng ngôn ngữ tự nhiên từ bất kỳ trợ lý tương thích MCP nào
  • Tìm kiếm và đọc tài liệu Honeydew

Cài đặt

URL Máy chủ

Honeydew cung cấp API Máy chủ MCP tại https://mcp.honeydew.cloud/mcp

Nếu tổ chức của bạn sử dụng tên máy chủ Honeydew tùy chỉnh, hãy thay thế URL mặc định bằng tên máy chủ của bạn. Bạn có thể tìm thấy tên máy chủ trong giao diện Honeydew tại **Cài đặt > MCP Server**.

Xác thực

Có hai cách để xác thực với Máy chủ MCP Honeydew: OAuth hoặc Xác thực HTTP Basic.

Xác thực OAuth (khuyến nghị)

Hầu hết các máy khách đều hỗ trợ xác thực OAuth. Khi bạn kết nối lần đầu, bạn sẽ được nhắc:

  1. Đăng nhập bằng tài khoản Honeydew của bạn
  2. Chấp nhận ủy quyền OAuth

Sau đó, máy khách sẽ cung cấp mã truy cập một cách an toàn cho các yêu cầu tiếp theo.

Xác thực HTTP Basic

Máy chủ MCP ở chế độ xác thực HTTP Basic yêu cầu một Khóa API để xác thực.

Bạn cần cung cấp một chuỗi mã hóa Base64 của Khóa API và Bí mật API theo định dạng API_KEY:API_SECRET.

Nếu tạo Khóa API mới để truy cập Máy chủ MCP, bạn có thể sao chép chuỗi mã hóa Base64 từ giao diện Honeydew Studio tại thời điểm tạo.

Bạn có thể sử dụng lệnh sau để tạo chuỗi mã hóa Base64:

```bash theme={null} echo -n ':' | base64 ``` Sử dụng PowerShell: 
```powershell theme={null}
[Convert]::ToBase64String(
  [Text.Encoding]::UTF8.GetBytes(
    "<API_KEY>:<API_SECRET>"
  )
)
```

Cung cấp chuỗi đã mã hóa trong tiêu đề Authorization như sau:

Authorization: Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET>

Cấu hình

Không gian làm việc và nhánh được thiết lập ở cấp phiên bằng cách sử dụng các công cụ list_workspaces, list_workspace_branches và set_session_workspace_and_branch. Bạn cũng có thể tạo nhánh mới bằng create_workspace_branch. Hãy gọi các công cụ này từ trợ lý AI của bạn sau khi kết nối với máy chủ MCP.

Bạn có thể tùy chọn cung cấp các tiêu đề này trong cấu hình máy chủ MCP của mình:

  • Workspace: Ghim không gian làm việc cho tất cả các yêu cầu (tùy chọn)
  • Branch: Ghim một nhánh không gian làm việc cụ thể cho tất cả các yêu cầu (tùy chọn, mặc định là prod nếu không gian làm việc được thiết lập)
  • Honeydew-Client: Xác định máy khách MCP (tùy chọn, tự động phát hiện từ công cụ được kết nối). Truyền tiêu đề này để cung cấp một định danh máy khách cụ thể.
  • ReadonlyToolsOnly: Đặt thành true để chỉ hiển thị các công cụ chỉ đọc (tùy chọn)
Máy chủ MCP sử dụng tiêu đề phản hồi `Mcp-Session-Id` để duy trì trạng thái phiên, bao gồm không gian làm việc và nhánh đang hoạt động. Xem [đặc tả quản lý phiên MCP](https://modelcontextprotocol.io/specification/2025-06-18/basic/transports#session-management) để biết chi tiết.

Các Máy khách được Hỗ trợ

Claude Code CLI

#### Cài đặt Plugin **Yêu cầu Git.** Việc cài đặt plugin từ GitHub sẽ sao chép kho lưu trữ cục bộ, vì vậy [Git](https://git-scm.com/downloads) phải được cài đặt và có trong `PATH` của bạn. Nếu thiếu Git, việc cài đặt plugin sẽ thất bại. Hãy cài đặt Git, hoặc sử dụng các bước thiết lập MCP thủ công của máy khách để cấu hình máy chủ trực tiếp thay vì dùng plugin.

Honeydew cung cấp một kho lưu trữ plugin với các kỹ năng và công cụ để xây dựng mô hình ngữ nghĩa và phân tích dữ liệu thông qua hội thoại tự nhiên. Việc cài đặt plugin sẽ tự động thiết lập các máy chủ MCP Honeydew.

Khởi chạy Claude Code với claude, sau đó thêm marketplace:

/plugin marketplace add honeydew-ai/honeydew-ai-coding-agents-plugins

Sau đó cài đặt plugin Honeydew từ marketplace:

/plugin install honeydew-ai@honeydew-ai-claude-plugins

Sau đó tải lại plugin để kích hoạt:

/reload-plugins

Cập nhật plugin

Để cập nhật các plugin marketplace Honeydew, khởi chạy Claude Code với claude, sau đó:

  1. Viết /plugin và chọn Marketplaces trong bộ chọn ở trên cùng
  2. Chọn honeydew-ai-coding-agents-plugins
  3. Nhấp Update marketplace

Để tự động nhận cập nhật, chọn Enable auto-update trong cài đặt marketplace.

Thiết lập MCP

Sử dụng phần này nếu tổ chức của bạn sử dụng điểm cuối Honeydew tùy chỉnh, hoặc nếu bạn muốn cấu hình máy chủ MCP mà không cần cài đặt plugin. Vô hiệu hóa kết nối MCP Honeydew được thêm bởi plugin, sau đó thêm điểm cuối tùy chỉnh của bạn bằng cách sử dụng hướng dẫn bên dưới.

Máy chủ MCP Honeydew kết nối Claude Code với Honeydew Semantic Layer để khám phá mô hình, truy vấn dữ liệu, quản lý mô hình, và truy cập tài liệu.

Sử dụng một trong các phương pháp sau để thêm máy chủ MCP Honeydew:

Nếu tổ chức của bạn sử dụng tên máy chủ Honeydew tùy chỉnh, hãy thay thế `https://mcp.honeydew.cloud/mcp` bằng tên máy chủ của bạn. Bạn có thể tìm thấy tên máy chủ trong **Cài đặt > MCP Server** trong Honeydew Studio. ```bash theme={null} claude mcp add --transport http honeydew \ https://mcp.honeydew.cloud/mcp ``` 
      Khởi chạy Claude Code với `claude`.
      Bạn sẽ được nhắc xác thực bằng OAuth với 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">
  Lưu nội dung sau vào `honeydew-mcp.json`:

  <Tabs>
    <Tab title="OAuth (recommended)">
      ```json theme={null}
      {
        "type": "http",
        "url": "https://mcp.honeydew.cloud/mcp"
      }
      ```

      Sau đó đăng ký nó bằng:

      ```bash theme={null}
      claude mcp add honeydew ./honeydew-mcp.json
      ```

      Khởi chạy Claude Code với `claude`.
      Bạn sẽ được nhắc xác thực bằng OAuth với 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>"
        }
      }
      ```

      Sau đó đăng ký nó bằng:

      ```bash theme={null}
      claude mcp add honeydew ./honeydew-mcp.json
      ```
    </Tab>
  </Tabs>
</Tab>

<Tab title=".mcp.json">
  Thêm nội dung sau vào tệp `.mcp.json` của bạn:

  <Tabs>
    <Tab title="OAuth (recommended)">
      ```json theme={null}
      {
        "mcpServers": {
          "honeydew": {
            "type": "http",
            "url": "https://mcp.honeydew.cloud/mcp"
          }
        }
      }
      ```

      Khởi chạy Claude Code với `claude`.
      Bạn sẽ được nhắc xác thực bằng OAuth với 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>
**Sử dụng biến môi trường cho xác thực Khóa API** 
Để tránh lưu trữ các giá trị nhạy cảm trực tiếp trong tệp cấu hình,
Claude Code hỗ trợ
[mở rộng biến môi trường](https://code.claude.com/docs/en/mcp#environment-variable-expansion-in-mcp-json)
sử dụng cú pháp `${VAR_NAME}`.

Đặt biến môi trường `HONEYDEW_API_KEY`,
sau đó tham chiếu nó trong cấu hình của bạn:

```bash theme={null}
claude mcp add --transport http honeydew \
    https://mcp.honeydew.cloud/mcp \
    --header "Authorization: Basic ${HONEYDEW_API_KEY}"
```

Claude Code giải quyết các tham chiếu `${VAR_NAME}`
trong thời gian chạy từ môi trường của bạn.

MCP Tài liệu Honeydew (tùy chọn)

Máy chủ MCP Honeydew đã bao gồm các công cụ truy cập tài liệu, vì vậy không cần máy chủ tài liệu riêng biệt. Chỉ thêm MCP Tài liệu Honeydew nếu bạn muốn truy cập tài liệu mà không cần kết nối với Honeydew. Không yêu cầu xác thực.

claude mcp add --transport http honeydew-docs \
    https://honeydew.ai/docs/mcp

Gỡ bỏ máy chủ MCP

Để gỡ bỏ máy chủ MCP Honeydew:

claude mcp remove honeydew

Để gỡ bỏ máy chủ MCP Tài liệu Honeydew:

claude mcp remove honeydew-docs

Claude Desktop

#### Cài đặt Plugin **Yêu cầu Git.** Việc cài đặt plugin từ GitHub sẽ sao chép kho lưu trữ cục bộ, vì vậy [Git](https://git-scm.com/downloads) phải được cài đặt và có trong `PATH` của bạn. Nếu thiếu Git, việc cài đặt plugin sẽ thất bại. Hãy cài đặt Git, hoặc sử dụng các bước thiết lập MCP thủ công của máy khách để cấu hình máy chủ trực tiếp thay vì dùng plugin.

Honeydew cung cấp một kho lưu trữ plugin với các kỹ năng và công cụ để xây dựng mô hình ngữ nghĩa và phân tích dữ liệu thông qua hội thoại tự nhiên. Việc cài đặt plugin sẽ tự động thiết lập các máy chủ MCP Honeydew.

  1. Đi tới Cài đặt -> Tùy chỉnh
  2. Nhấp Duyệt Plugin
  3. Chuyển đến tab Cá nhân
  4. Nhấp vào biểu tượng + và chọn Thêm marketplace từ GitHub
  5. Nhập honeydew-ai/honeydew-ai-coding-agents-plugins vào ô nhập liệu
  6. Plugin Honeydew AI xuất hiện. Cài đặt nó.

Thiết lập MCP

Sử dụng phần này nếu tổ chức của bạn sử dụng điểm cuối Honeydew tùy chỉnh, hoặc nếu bạn muốn cấu hình máy chủ MCP mà không cần cài đặt plugin. Vô hiệu hóa kết nối MCP Honeydew được thêm bởi plugin, sau đó thêm điểm cuối tùy chỉnh của bạn bằng cách sử dụng hướng dẫn bên dưới.

Máy chủ MCP Honeydew kết nối Claude Desktop với Honeydew Semantic Layer để khám phá mô hình, truy vấn dữ liệu, quản lý mô hình, và truy cập tài liệu.

Chế độ Claude Code

Khi sử dụng Claude Desktop ở chế độ Claude Code, hãy làm theo hướng dẫn Claude Code CLI thay thế.

Nếu tổ chức của bạn sử dụng tên máy chủ Honeydew tùy chỉnh, hãy thay thế `https://mcp.honeydew.cloud/mcp` bằng tên máy chủ của bạn. Bạn có thể tìm thấy tên máy chủ trong **Cài đặt > MCP Server** trong Honeydew Studio.

Để thêm MCP Honeydew trong chế độ Cowork:

  1. Đi tới Cài đặt -> Trình kết nối -> Thêm trình kết nối tùy chỉnh
  2. Nhập honeydew vào trường Tên
  3. Nhập https://mcp.honeydew.cloud/mcp vào trường URL máy chủ MCP từ xa
  4. Nhấp Thêm

Bạn sẽ được nhắc xác thực bằng OAuth với Honeydew khi kết nối lần đầu.

MCP Tài liệu Honeydew (tùy chọn)

Máy chủ MCP Honeydew đã bao gồm các công cụ truy cập tài liệu, vì vậy không cần máy chủ tài liệu riêng biệt. Chỉ thêm MCP Tài liệu Honeydew nếu bạn muốn truy cập tài liệu mà không cần kết nối với Honeydew. Không yêu cầu xác thực.

  1. Đi tới Cài đặt -> Trình kết nối -> Thêm trình kết nối tùy chỉnh
  2. Nhập honeydew-docs vào trường Tên
  3. Nhập https://honeydew.ai/docs/mcp vào trường URL máy chủ MCP từ xa
  4. Nhấp Thêm

Gỡ bỏ máy chủ MCP

Để gỡ bỏ máy chủ MCP Honeydew trong chế độ Cowork:

  1. Đi tới Cài đặt -> Trình kết nối
  2. Tìm trình kết nối honeydew và nhấp vào biểu tượng xóa

Để gỡ bỏ máy chủ MCP Tài liệu Honeydew:

  1. Đi tới Cài đặt -> Trình kết nối
  2. Tìm trình kết nối honeydew-docs và nhấp vào biểu tượng xóa

Claude.ai

#### Cài đặt Plugin

Honeydew cung cấp một kho lưu trữ plugin với các kỹ năng và công cụ để xây dựng mô hình ngữ nghĩa và phân tích dữ liệu thông qua hội thoại tự nhiên. Việc cài đặt plugin sẽ tự động thiết lập cả máy chủ MCP Honeydew và máy chủ MCP Tài liệu Honeydew.

  1. Tải xuống tệp zip plugin: honeydew-ai-claude.zip
  2. Trong Claude.ai, đi tới Cài đặt -> Plugin -> Thêm plugin -> Tải lên zip
  3. Tải lên tệp zip — plugin sẽ xuất hiện trong marketplace riêng tư của bạn

Thiết lập MCP

Sử dụng phần này nếu tổ chức của bạn sử dụng điểm cuối Honeydew tùy chỉnh, hoặc nếu bạn muốn cấu hình máy chủ MCP mà không cần cài đặt plugin. Gỡ bỏ trình kết nối MCP Honeydew được thêm bởi plugin, sau đó thêm điểm cuối tùy chỉnh của bạn bằng cách sử dụng hướng dẫn bên dưới.

Máy chủ MCP Honeydew kết nối Claude.ai với Honeydew Semantic Layer để khám phá mô hình, truy vấn dữ liệu, quản lý mô hình, và truy cập tài liệu.

Nếu tổ chức của bạn sử dụng tên máy chủ Honeydew tùy chỉnh, hãy thay thế `https://mcp.honeydew.cloud/mcp` bằng tên máy chủ của bạn. Bạn có thể tìm thấy tên máy chủ trong **Cài đặt > MCP Server** trong Honeydew Studio.

Để thêm máy chủ MCP Honeydew:

  1. Vào Settings -> Connectors -> Add custom connector
  2. Nhập honeydew vào trường Name
  3. Nhập https://mcp.honeydew.cloud/mcp vào trường Remote MCP server URL
  4. Nhấp Add

Bạn sẽ được nhắc xác thực bằng OAuth với Honeydew khi kết nối lần đầu.

Honeydew Documentation MCP (tùy chọn)

Máy chủ Honeydew MCP đã bao gồm các công cụ truy cập tài liệu, vì vậy không cần máy chủ tài liệu riêng biệt. Chỉ thêm Honeydew Documentation MCP nếu bạn muốn truy cập tài liệu mà không cần kết nối với Honeydew. Không yêu cầu xác thực.

  1. Vào Settings -> Connectors -> Add custom connector
  2. Nhập honeydew-docs vào trường Name
  3. Nhập https://honeydew.ai/docs/mcp vào trường Remote MCP server URL
  4. Nhấp Add

Xóa máy chủ MCP

Để xóa máy chủ Honeydew MCP:

  1. Vào Settings -> Connectors
  2. Tìm connector honeydew và nhấp vào biểu tượng xóa

Để xóa máy chủ Honeydew Documentation MCP:

  1. Vào Settings -> Connectors
  2. Tìm connector honeydew-docs và nhấp vào biểu tượng xóa

Cortex Code CLI

#### Cài đặt Plugin **Yêu cầu Git.** Việc cài đặt plugin từ GitHub sẽ sao chép kho lưu trữ cục bộ, vì vậy [Git](https://git-scm.com/downloads) phải được cài đặt và có trong `PATH` của bạn. Nếu thiếu Git, việc cài đặt plugin sẽ thất bại. Hãy cài đặt Git, hoặc sử dụng các bước thiết lập MCP thủ công của client để cấu hình máy chủ trực tiếp thay vì dùng plugin.

Honeydew cung cấp một kho lưu trữ plugin với các kỹ năng và công cụ để xây dựng mô hình ngữ nghĩa và phân tích dữ liệu thông qua hội thoại tự nhiên. Việc cài đặt plugin sẽ tự động thiết lập các máy chủ Honeydew MCP.

Khởi chạy Cortex Code CLI với cortex, sau đó cài đặt plugin:

/plugin install honeydew-ai/honeydew-ai-coding-agents-plugins

Thiết lập MCP

Sử dụng phần này nếu tổ chức của bạn sử dụng một điểm cuối Honeydew tùy chỉnh, hoặc nếu bạn muốn cấu hình các máy chủ MCP mà không cần cài đặt plugin. Vô hiệu hóa kết nối Honeydew MCP được thêm bởi plugin, sau đó thêm điểm cuối tùy chỉnh của bạn bằng cách sử dụng hướng dẫn bên dưới.

Máy chủ Honeydew MCP kết nối Cortex Code CLI với Honeydew Semantic Layer để khám phá mô hình, truy vấn dữ liệu, quản lý mô hình, và truy cập tài liệu.

Nếu tổ chức của bạn sử dụng tên máy chủ Honeydew tùy chỉnh, hãy thay thế `https://mcp.honeydew.cloud/mcp` bằng tên máy chủ tenant của bạn. Bạn có thể tìm thấy tên máy chủ trong **Settings > MCP Server** trong Honeydew Studio. ```bash theme={null} cortex mcp add honeydew \ https://mcp.honeydew.cloud/mcp \ --type http ``` 
      Khởi chạy Cortex Code CLI với `cortex`.
      Bạn sẽ được nhắc xác thực
      bằng OAuth với 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">
  Lưu nội dung sau vào `honeydew-mcp.json`:

  <Tabs>
    <Tab title="OAuth (recommended)">
      ```json theme={null}
      {
        "type": "http",
        "url": "https://mcp.honeydew.cloud/mcp"
      }
      ```

      Sau đó đăng ký nó bằng:

      ```bash theme={null}
      cortex mcp add honeydew ./honeydew-mcp.json --type http
      ```

      Khởi chạy Cortex Code CLI với `cortex`.
      Bạn sẽ được nhắc xác thực
      bằng OAuth với 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>"
        }
      }
      ```

      Sau đó đăng ký nó bằng:

      ```bash theme={null}
      cortex mcp add honeydew ./honeydew-mcp.json --type http
      ```
    </Tab>
  </Tabs>
</Tab>

<Tab title="mcp.json">
  Thêm nội dung sau vào
  `~/.snowflake/cortex/mcp.json`:

  <Tabs>
    <Tab title="OAuth (recommended)">
      ```json theme={null}
      {
        "mcpServers": {
          "honeydew": {
            "type": "http",
            "url": "https://mcp.honeydew.cloud/mcp"
          }
        }
      }
      ```

      Khởi chạy Cortex Code CLI với `cortex`.
      Bạn sẽ được nhắc xác thực
      bằng OAuth với 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 (tùy chọn)

Máy chủ Honeydew MCP đã bao gồm các công cụ truy cập tài liệu, vì vậy không cần máy chủ tài liệu riêng biệt. Chỉ thêm Honeydew Documentation MCP nếu bạn muốn truy cập tài liệu mà không cần kết nối với Honeydew. Không yêu cầu xác thực.

cortex mcp add honeydew-docs \
    https://honeydew.ai/docs/mcp \
    --type http

Xóa máy chủ MCP

Để xóa máy chủ Honeydew MCP:

cortex mcp remove honeydew

Để xóa máy chủ Honeydew Documentation MCP:

cortex mcp remove honeydew-docs

Cortex Code Desktop

#### Cài đặt Plugin **Yêu cầu Git.** Việc cài đặt plugin từ GitHub sẽ sao chép kho lưu trữ cục bộ, vì vậy [Git](https://git-scm.com/downloads) phải được cài đặt và có trong `PATH` của bạn. Nếu thiếu Git, việc cài đặt plugin sẽ thất bại. Hãy cài đặt Git, hoặc sử dụng các bước thiết lập MCP thủ công của client để cấu hình máy chủ trực tiếp thay vì dùng plugin.

Honeydew cung cấp một kho lưu trữ plugin với các kỹ năng và công cụ để xây dựng mô hình ngữ nghĩa và phân tích dữ liệu thông qua hội thoại tự nhiên. Việc cài đặt plugin sẽ tự động thiết lập các máy chủ Honeydew MCP.

  1. Vào Settings -> Plugins
  2. Nhấp Add Plugin, chọn Add from GitHub, và dán đường dẫn kho lưu trữ plugin Honeydew: honeydew-ai/honeydew-ai-coding-agents-plugins
  3. Làm theo quy trình và phê duyệt các bước trong GitHub Plugin Installer Setup

Thiết lập MCP

Sử dụng phần này nếu tổ chức của bạn sử dụng một điểm cuối Honeydew tùy chỉnh, hoặc nếu bạn muốn cấu hình các máy chủ MCP mà không cần cài đặt plugin. Vô hiệu hóa kết nối Honeydew MCP được thêm bởi plugin, sau đó thêm điểm cuối tùy chỉnh của bạn bằng cách sử dụng hướng dẫn bên dưới.

Máy chủ Honeydew MCP kết nối Cortex Code Desktop với Honeydew Semantic Layer để khám phá mô hình, truy vấn dữ liệu, quản lý mô hình, và truy cập tài liệu.

Để thêm máy chủ, vào MCP -> New, chọn Configuration Scope (ví dụ: ~/.snowflake/cortex/mcp.json cho Global), điền vào biểu mẫu, sau đó nhấp Save. Sử dụng tab Form hoặc JSON để nhập cấu hình.

Nếu tổ chức của bạn sử dụng tên máy chủ Honeydew tùy chỉnh, hãy thay thế `https://mcp.honeydew.cloud/mcp` bằng tên máy chủ tenant của bạn. Bạn có thể tìm thấy tên máy chủ trong **Settings > MCP Server** trong Honeydew Studio.

Thêm máy chủ Honeydew MCP:

1. **Server Name**: `honeydew` 2. **Server Type**: **Remote (HTTP)** 3. **Server URL**: `https://mcp.honeydew.cloud/mcp` 4. Nhấp **Save** 
      Bạn sẽ được nhắc xác thực bằng OAuth với Honeydew
      khi kết nối lần đầu.
    </Tab>

    <Tab title="API Key">
      1. **Server Name**: `honeydew`
      2. **Server Type**: **Remote (HTTP)**
      3. **Server URL**: `https://mcp.honeydew.cloud/mcp`
      4. Trong **Headers**, nhấp **Add Header** và đặt tên là
         `Authorization` và giá trị là
         `Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET>`
      5. Nhấp **Save**
    </Tab>
  </Tabs>
</Tab>

<Tab title="JSON">
  Chuyển sang tab **JSON** và dán cấu hình:

  <Tabs>
    <Tab title="OAuth (recommended)">
      ```json theme={null}
      {
        "honeydew": {
          "type": "http",
          "url": "https://mcp.honeydew.cloud/mcp"
        }
      }
      ```

      Bạn sẽ được nhắc xác thực bằng OAuth với Honeydew
      khi kết nối lần đầu.
    </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 (tùy chọn)

Máy chủ Honeydew MCP đã bao gồm các công cụ truy cập tài liệu, vì vậy không cần máy chủ tài liệu riêng biệt. Nếu bạn muốn truy cập tài liệu mà không cần kết nối với Honeydew, hãy thêm máy chủ Honeydew Documentation MCP theo cách tương tự, sử dụng Server Name honeydew-docs, Server Type Remote (HTTP), và Server URL https://honeydew.ai/docs/mcp. Không yêu cầu xác thực.

Xóa máy chủ MCP

Để xóa máy chủ, vào MCP, tìm máy chủ honeydew (hoặc honeydew-docs) và xóa nó.

Cursor

#### Cài đặt Plugin

Honeydew cung cấp một kho lưu trữ plugin với các kỹ năng và công cụ để xây dựng mô hình ngữ nghĩa và phân tích dữ liệu thông qua hội thoại tự nhiên. Việc cài đặt plugin sẽ tự động thiết lập các máy chủ Honeydew MCP.

  1. Trong cài đặt nhóm hoặc tổ chức của bạn, vào cursor.com/dashboard/plugins (hoặc nhấp Plugins ở menu bên trái)
  2. Cuộn xuống Team Marketplaces và nhấp vào một Marketplace hiện có, hoặc nhấp Add Marketplace để tạo mới. Nếu tạo mới, hãy nhập tên và tạo nó.
  3. Trong Marketplace, nhấp Add Plugin, dán đường dẫn kho lưu trữ GitHub của plugin Honeydew: https://github.com/honeydew-ai/honeydew-ai-coding-agents-plugins và nhấp Add 1 plugin
  4. Tùy chọn, bật auto-refresh trong trang Marketplace để plugin tự động cập nhật khi có phiên bản mới.
  5. Quay lại trang plugins (cursor.com/dashboard/plugins), tìm kiếm plugin Honeydew, và nhấp Add

Thiết lập MCP

Sử dụng phần này nếu tổ chức của bạn sử dụng một điểm cuối Honeydew tùy chỉnh, hoặc nếu bạn muốn cấu hình các máy chủ MCP mà không cần cài đặt plugin. Vô hiệu hóa kết nối Honeydew MCP được thêm bởi plugin, sau đó thêm điểm cuối tùy chỉnh của bạn bằng cách sử dụng hướng dẫn bên dưới.

Máy chủ Honeydew MCP kết nối Cursor với Honeydew Semantic Layer để khám phá mô hình, truy vấn dữ liệu, quản lý mô hình, và truy cập tài liệu.

Nếu tổ chức của bạn sử dụng tên máy chủ Honeydew tùy chỉnh, hãy thay thế `https://mcp.honeydew.cloud/mcp` bằng tên máy chủ tenant của bạn. Bạn có thể tìm thấy tên máy chủ trong **Settings > MCP Server** trong Honeydew Studio.

Để thêm Honeydew MCP:

  1. Mở ứng dụng Cursor

  2. Vào Settings -> Cursor Settings -> Tools & MCP

  3. Nhấp New MCP Server

  4. Thêm cấu hình sau:

    ```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>

  5. Nhấp Save

Honeydew Documentation MCP (tùy chọn)

Máy chủ Honeydew MCP đã bao gồm các công cụ truy cập tài liệu, vì vậy không cần máy chủ tài liệu riêng biệt. Chỉ thêm Honeydew Documentation MCP nếu bạn muốn truy cập tài liệu mà không cần kết nối với Honeydew. Không yêu cầu xác thực.

  1. Vào Settings -> Cursor Settings -> Tools & MCP
  2. Nhấp New MCP Server
  3. Thêm cấu hình sau: 
    {
  "name": "honeydew-docs",
  "type": "http",
  "url": "https://honeydew.ai/docs/mcp"
}
  4. Nhấp Save

Xóa máy chủ MCP

Để xóa máy chủ Honeydew MCP:

  1. Vào Settings -> Cursor Settings -> Tools & MCP
  2. Tìm honeydew trong danh sách và nhấp vào biểu tượng xóa

Để xóa máy chủ Honeydew Documentation MCP:

  1. Vào Settings -> Cursor Settings -> Tools & MCP
  2. Tìm honeydew-docs trong danh sách và nhấp vào biểu tượng xóa

Databricks Genie Code

Máy chủ MCP chỉ được hỗ trợ trong chế độ Genie Code Agent. Để biết thêm chi tiết, hãy xem [tài liệu Databricks MCP](https://docs.databricks.com/aws/en/generative-ai/mcp/).

Điều kiện tiên quyết:

  • Genie Code được kích hoạt trong không gian làm việc Databricks của bạn

  • Quyền CREATE CONNECTION trên metastore Unity Catalog

    1. Điều hướng đến **Catalog** → **Connections** → **Create a connection** 2. Trên màn hình **Connection basics**: * Đặt **Connection name** thành `honeydew-mcp` * Đặt **Connection type** thành **HTTP** * Đặt **Auth type** thành **Dynamic Client Registration** * Nhấp **Next** 3. Trên màn hình **Authentication**: * Đặt **Host** thành `https://mcp.honeydew.cloud` * Để **Port** là `443` * Đặt **OAuth scope** thành `openid` * Nhấp **Next** 4. Trên màn hình **Connection details**: * Chọn **Is MCP connection** * Đặt **Base path** thành `/mcp` * Nhấp **Create connection** 
    <Tab title="SQL">
  Chạy SQL sau trong notebook hoặc trình soạn thảo SQL của Databricks:

  ```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>
    Nếu tổ chức của bạn sử dụng tên máy chủ Honeydew tùy chỉnh, hãy thay thế `https://mcp.honeydew.cloud` bằng tên máy chủ của tenant. Bạn có thể tìm thấy tên máy chủ của mình trong **Settings > MCP Server** trong Honeydew Studio. Điều hướng đến **Catalog** → **Connections** → `honeydew-mcp` và nhấp **Login** ở góc trên bên phải để xác thực và xác minh kết nối. Cấp quyền `USE CONNECTION` cho bất kỳ người dùng hoặc vai trò nào cần truy cập vào máy chủ Honeydew MCP: 
    GRANT USE CONNECTION ON CONNECTION `honeydew-mcp` TO <user-or-role>;
    1. Mở Genie Code và nhấp vào biểu tượng bánh răng 2. Điều hướng đến **MCP Servers** → **Add Server** 3. Chọn **External MCP server** 4. Chọn kết nối `honeydew-mcp` bạn đã tạo 5. Đăng nhập vào kết nối khi được nhắc 6. Nhấp **Save** Databricks giới hạn MCP ở 20 công cụ trên tất cả các máy chủ đã cấu hình. Nếu bạn cần điều chỉnh những công cụ Honeydew nào khả dụng, hãy sử dụng cài đặt MCP của Genie Code để bật hoặc tắt các công cụ cụ thể.

Xóa máy chủ MCP

Để xóa máy chủ Honeydew MCP khỏi Genie Code:

  1. Mở Genie Code và nhấp vào biểu tượng bánh răng
  2. Điều hướng đến MCP Servers
  3. Tìm honeydew-mcp và nhấp Remove

Để cũng xóa kết nối Unity Catalog cơ bản, hãy chạy SQL sau:

DROP CONNECTION `honeydew-mcp`;

Devin

#### Máy chủ MCP

Devin kết nối với các máy chủ MCP từ xa thông qua MCP Marketplace của nó.

Nếu tổ chức của bạn sử dụng tên máy chủ Honeydew tùy chỉnh, hãy thay thế `https://mcp.honeydew.cloud/mcp` bằng tên máy chủ của tenant. Bạn có thể tìm thấy tên máy chủ trong **Settings > MCP Server** trong Honeydew Studio.

Để thêm máy chủ Honeydew MCP:

  1. Đi tới Settings -> Connections -> MCP servers

  2. Nhấp Add a custom MCP

  3. Nhập honeydew vào trường Server Name

  4. Tùy chọn thêm biểu tượng và Short Description

  5. Chọn HTTP làm loại truyền tải

  6. Nhập https://mcp.honeydew.cloud/mcp vào trường Server URL

  7. Cấu hình xác thực:

    Chọn **OAuth** làm phương thức xác thực. Devin sẽ nhắc bạn xác thực với Honeydew trong phiên đầu tiên. 
    <Tab title="API Key">
  Chọn **Auth Header** làm phương thức xác thực.
  Để khóa tiêu đề là `Authorization` và đặt giá trị thành
  `Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET>`
  (xem [Authentication](#authentication)).
</Tab>

  8. Nhấp Save, sau đó nhấp Test listing tools để xác minh kết nối

Honeydew Documentation MCP (tùy chọn)

Máy chủ Honeydew MCP đã bao gồm các công cụ truy cập tài liệu, vì vậy không cần máy chủ tài liệu riêng biệt. Chỉ thêm Honeydew Documentation MCP nếu bạn muốn truy cập tài liệu mà không cần kết nối với Honeydew. Không yêu cầu xác thực.

  1. Đi tới Settings -> Connections -> MCP servers
  2. Nhấp Add a custom MCP
  3. Nhập honeydew-docs vào trường Server Name
  4. Chọn HTTP làm loại truyền tải
  5. Nhập https://honeydew.ai/docs/mcp vào trường Server URL
  6. Đặt phương thức xác thực thành None
  7. Nhấp Save

Xóa máy chủ MCP

Để xóa máy chủ Honeydew MCP:

  1. Đi tới Settings -> Connections -> MCP servers
  2. Tìm máy chủ honeydew và xóa nó

Để xóa máy chủ Honeydew Documentation MCP:

  1. Đi tới Settings -> Connections -> MCP servers
  2. Tìm máy chủ honeydew-docs và xóa nó

GitHub Copilot CLI

#### Máy chủ MCP Nếu tổ chức của bạn sử dụng tên máy chủ Honeydew tùy chỉnh, hãy thay thế `https://mcp.honeydew.cloud/mcp` bằng tên máy chủ của tenant. Bạn có thể tìm thấy tên máy chủ trong **Settings > MCP Server** trong Honeydew Studio.

  1. Khởi chạy GitHub Copilot CLI với copilot

  2. Gõ /mcp add để mở biểu mẫu cấu hình máy chủ

  3. Điền vào các trường sau:

    • Name: honeydew

    • Type: http

    • URL: https://mcp.honeydew.cloud/mcp

    • HTTP Headers:

      Không cần tiêu đề bổ sung cho OAuth. ```json theme={null} { "Authorization": "Basic " } ```

  4. Nhấn Ctrl+S để lưu

Sử dụng /mcp show để xác minh máy chủ đã được kết nối.

Plugin AI Coding Agent

**Yêu cầu Git.** Việc cài đặt plugin từ GitHub sẽ sao chép kho lưu trữ cục bộ, vì vậy [Git](https://git-scm.com/downloads) phải được cài đặt và có trong `PATH` của bạn. Nếu thiếu Git, quá trình cài đặt plugin sẽ thất bại. Hãy cài đặt Git, hoặc sử dụng các bước thiết lập MCP thủ công của máy khách để cấu hình máy chủ trực tiếp thay vì dùng plugin.

Honeydew cung cấp một kho lưu trữ plugin với các kỹ năng và công cụ để xây dựng mô hình ngữ nghĩa và phân tích dữ liệu thông qua hội thoại tự nhiên.

Thêm marketplace vào Copilot CLI:

/plugin marketplace add honeydew-ai/honeydew-ai-coding-agents-plugins

Sau đó cài đặt plugin Honeydew từ marketplace:

/plugin install honeydew-ai@honeydew-ai-github-copilot-plugins

Honeydew Documentation MCP (tùy chọn)

Máy chủ Honeydew MCP đã bao gồm các công cụ truy cập tài liệu, vì vậy không cần máy chủ tài liệu riêng biệt. Chỉ thêm Honeydew Documentation MCP nếu bạn muốn truy cập tài liệu mà không cần kết nối với Honeydew. Không yêu cầu xác thực.

  1. Khởi chạy GitHub Copilot CLI với copilot
  2. Gõ /mcp add để mở biểu mẫu cấu hình máy chủ
  3. Điền vào các trường sau:
    • Name: honeydew-docs
    • Type: http
    • URL: https://honeydew.ai/docs/mcp
  4. Nhấn Ctrl+S để lưu

Xóa máy chủ MCP

Để xóa máy chủ Honeydew MCP, khởi chạy GitHub Copilot CLI với copilot, sau đó gõ:

/mcp remove honeydew

Để xóa máy chủ Honeydew Documentation MCP:

/mcp remove honeydew-docs

Gemini CLI

#### Cài đặt Tiện ích mở rộng **Yêu cầu Git.** Việc cài đặt plugin từ GitHub sẽ sao chép kho lưu trữ cục bộ, vì vậy [Git](https://git-scm.com/downloads) phải được cài đặt và có trong `PATH` của bạn. Nếu thiếu Git, quá trình cài đặt plugin sẽ thất bại. Hãy cài đặt Git, hoặc sử dụng các bước thiết lập MCP thủ công của máy khách để cấu hình máy chủ trực tiếp thay vì dùng plugin.

Honeydew cung cấp một kho lưu trữ plugin với các kỹ năng và công cụ để xây dựng mô hình ngữ nghĩa và phân tích dữ liệu thông qua hội thoại tự nhiên. Việc cài đặt tiện ích mở rộng sẽ tự động thiết lập các máy chủ Honeydew MCP.

Chạy lệnh sau để cài đặt tiện ích mở rộng Honeydew:

gemini extensions install \
    https://github.com/honeydew-ai/honeydew-ai-coding-agents-plugins \
    --auto-update

Cờ --auto-update giúp tiện ích mở rộng tự động cập nhật.

Thiết lập MCP

Sử dụng phần này nếu tổ chức của bạn sử dụng điểm cuối Honeydew tùy chỉnh, hoặc nếu bạn muốn cấu hình các máy chủ MCP mà không cần cài đặt tiện ích mở rộng. Tắt kết nối Honeydew MCP do tiện ích mở rộng thêm vào, sau đó thêm điểm cuối tùy chỉnh của bạn bằng cách sử dụng hướng dẫn bên dưới.

Máy chủ Honeydew MCP kết nối Gemini CLI với Honeydew Semantic Layer để khám phá mô hình, truy vấn dữ liệu, quản lý mô hình, và truy cập tài liệu.

Nếu tổ chức của bạn sử dụng tên máy chủ Honeydew tùy chỉnh, hãy thay thế `https://mcp.honeydew.cloud/mcp` bằng tên máy chủ của tenant. Bạn có thể tìm thấy tên máy chủ trong **Settings > MCP Server** trong Honeydew Studio.

Chạy lệnh sau để thêm máy chủ Honeydew MCP:

```bash theme={null} gemini mcp add --transport http honeydew \ https://mcp.honeydew.cloud/mcp ``` 
  Khởi chạy Gemini CLI với `gemini`.
  Bạn sẽ được nhắc xác thực bằng OAuth với 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 Documentation MCP (tùy chọn)

Máy chủ Honeydew MCP đã bao gồm các công cụ truy cập tài liệu, vì vậy không cần máy chủ tài liệu riêng biệt. Chỉ thêm Honeydew Documentation MCP nếu bạn muốn truy cập tài liệu mà không cần kết nối với Honeydew. Không yêu cầu xác thực.

gemini mcp add --transport http honeydew-docs \
    https://honeydew.ai/docs/mcp

Xóa máy chủ MCP

Để xóa máy chủ Honeydew MCP:

gemini mcp remove honeydew

Để xóa máy chủ Honeydew Documentation MCP:

gemini mcp remove honeydew-docs

VS Code và GitHub Copilot

#### Cài đặt Plugin

Honeydew cung cấp một kho lưu trữ plugin với các kỹ năng và công cụ để xây dựng mô hình ngữ nghĩa và phân tích dữ liệu thông qua hội thoại tự nhiên. Việc cài đặt plugin sẽ tự động thiết lập các máy chủ Honeydew MCP.

Thêm marketplace Honeydew

  1. Mở settings.json VS Code của bạn (mở Command Palette với CMD+Shift+P trên macOS hoặc Ctrl+Shift+P trên Windows/Linux, sau đó chọn Preferences: Open User Settings (JSON))
  2. Thêm marketplace Honeydew vào cài đặt chat.plugins.marketplaces: 
    "chat.plugins.marketplaces": [
  "honeydew-ai/honeydew-ai-coding-agents-plugins"
]

Cài đặt plugin

  1. Mở chế độ xem Extensions (CMD+Shift+X trên macOS hoặc Ctrl+Shift+X trên Windows/Linux)
  2. Nhập @agentPlugins vào trường tìm kiếm
  3. Tìm plugin Honeydew AI và nhấp Install

Lần đầu tiên bạn cài đặt plugin từ một marketplace mới, VS Code sẽ hiển thị lời nhắc tin cậy — hãy xem xét nguồn marketplace trước khi xác nhận.

Cập nhật plugin

Nếu extensions.autoUpdate được bật trong cài đặt VS Code, plugin sẽ tự động cập nhật. Để cập nhật thủ công, hãy mở Command Palette và chạy Extensions: Check for Extension Updates.

Máy chủ MCP

Sử dụng phần này nếu tổ chức của bạn sử dụng điểm cuối Honeydew tùy chỉnh, hoặc nếu bạn muốn cấu hình các máy chủ MCP mà không cần cài đặt plugin. Tắt kết nối Honeydew MCP do plugin thêm vào, sau đó thêm điểm cuối tùy chỉnh của bạn bằng cách sử dụng hướng dẫn bên dưới.

Máy chủ Honeydew MCP kết nối VS Code với Honeydew Semantic Layer để khám phá mô hình, truy vấn dữ liệu, quản lý mô hình, và truy cập tài liệu.

Nếu tổ chức của bạn sử dụng tên máy chủ Honeydew tùy chỉnh, hãy thay thế `https://mcp.honeydew.cloud/mcp` bằng tên máy chủ của tenant. Bạn có thể tìm thấy tên máy chủ trong **Settings > MCP Server** trong Honeydew Studio. 1. Mở Bảng lệnh bằng `CMD+Shift+P` (macOS) hoặc `Ctrl+Shift+P` (Windows/Linux) 2. Chọn **MCP: Thêm máy chủ...** 3. Chọn **HTTP (HTTP hoặc Sự kiện do máy chủ gửi)** 4. Nhập URL máy chủ MCP Honeydew: `https://mcp.honeydew.cloud/mcp` 5. Nhập `honeydew` làm tên máy chủ

Thao tác này sẽ thêm máy chủ vào tệp .vscode/mcp.json của bạn. Mở tệp và thêm tiêu đề nếu cần:

```json theme={null} { "servers": { "honeydew": { "type": "http", "url": "https://mcp.honeydew.cloud/mcp" } } } ``` 
<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>

MCP Tài liệu Honeydew (tùy chọn)

Máy chủ MCP Honeydew đã bao gồm các công cụ truy cập tài liệu, vì vậy không cần máy chủ tài liệu riêng biệt. Chỉ thêm MCP Tài liệu Honeydew nếu bạn muốn truy cập tài liệu mà không cần kết nối với Honeydew. Không yêu cầu xác thực.

Thêm phần sau vào .vscode/mcp.json của bạn:

{
  "servers": {
    "honeydew-docs": {
      "type": "http",
      "url": "https://honeydew.ai/docs/mcp"
    }
  }
}

Xóa máy chủ MCP

Để xóa máy chủ MCP Honeydew, mở .vscode/mcp.json và xóa mục honeydew khỏi đối tượng servers. Để xóa máy chủ MCP Tài liệu Honeydew, xóa mục honeydew-docs khỏi cùng tệp đó.

Codex CLI

#### Cài đặt Plugin **Yêu cầu Git.** Việc cài đặt plugin từ GitHub sẽ sao chép kho lưu trữ cục bộ, vì vậy [Git](https://git-scm.com/downloads) phải được cài đặt và có trong `PATH` của bạn. Nếu thiếu Git, quá trình cài đặt plugin sẽ thất bại. Hãy cài đặt Git, hoặc sử dụng các bước thiết lập MCP thủ công của máy khách để cấu hình máy chủ trực tiếp thay vì dùng plugin.

Honeydew cung cấp một kho plugin với các kỹ năng và công cụ để xây dựng mô hình ngữ nghĩa và phân tích dữ liệu thông qua hội thoại tự nhiên. Việc cài đặt plugin sẽ tự động thiết lập các máy chủ MCP Honeydew.

Thêm marketplace vào Codex:

codex plugin marketplace add honeydew-ai/honeydew-ai-coding-agents-plugins

Sau đó khởi chạy Codex với codex và gõ /plugins để duyệt và cài đặt plugin Honeydew AI.

Cập nhật plugin

Để cập nhật marketplace Honeydew, chạy:

codex plugin marketplace upgrade honeydew-ai-coding-agents-plugins

Sau đó khởi chạy Codex và gõ /plugins để áp dụng các bản cập nhật.

Thiết lập MCP

Sử dụng phần này nếu tổ chức của bạn sử dụng điểm cuối Honeydew tùy chỉnh, hoặc nếu bạn muốn cấu hình máy chủ MCP mà không cần cài đặt plugin. Vô hiệu hóa kết nối MCP Honeydew được thêm bởi plugin, sau đó thêm điểm cuối tùy chỉnh của bạn bằng cách làm theo hướng dẫn bên dưới.

Máy chủ MCP Honeydew kết nối Codex với Lớp Ngữ nghĩa Honeydew để khám phá mô hình, truy vấn dữ liệu, quản lý mô hình, và truy cập tài liệu.

Nếu tổ chức của bạn sử dụng tên máy chủ Honeydew tùy chỉnh, hãy thay thế `https://mcp.honeydew.cloud/mcp` bằng tên máy chủ thuê bao của bạn. Bạn có thể tìm thấy tên máy chủ trong **Cài đặt > Máy chủ MCP** trong Honeydew Studio.

Dòng lệnh

codex mcp add honeydew \
    --url https://mcp.honeydew.cloud/mcp

Sau đó khởi chạy Codex với codex. Bạn sẽ được nhắc xác thực bằng OAuth với Honeydew.

Sau khi thêm máy chủ, mở tệp cấu hình tại ~/.codex/config.toml và thêm tiêu đề vào phần [mcp_servers.honeydew] nếu cần.

Cấu hình TOML

Thêm phần sau vào ~/.codex/config.toml (hoặc .codex/config.toml trong một dự án đáng tin cậy):

[mcp_servers.honeydew]
url = "https://mcp.honeydew.cloud/mcp"

[mcp_servers.honeydew.env_http_headers]
Authorization = "HONEYDEW_AUTH"

Đặt biến môi trường HONEYDEW_AUTH thành Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET> (xem Xác thực).

MCP Tài liệu Honeydew (tùy chọn)

Máy chủ MCP Honeydew đã bao gồm các công cụ truy cập tài liệu, vì vậy không cần máy chủ tài liệu riêng biệt. Chỉ thêm MCP Tài liệu Honeydew nếu bạn muốn truy cập tài liệu mà không cần kết nối với Honeydew. Không yêu cầu xác thực.

codex mcp add honeydew-docs \
    --url https://honeydew.ai/docs/mcp

Xóa máy chủ MCP

Để xóa máy chủ MCP Honeydew:

codex mcp remove honeydew

Để xóa máy chủ MCP Tài liệu Honeydew:

codex mcp remove honeydew-docs

Codex

#### Cài đặt Plugin **Yêu cầu Git.** Việc cài đặt plugin từ GitHub sẽ sao chép kho lưu trữ cục bộ, vì vậy [Git](https://git-scm.com/downloads) phải được cài đặt và có trong `PATH` của bạn. Nếu thiếu Git, quá trình cài đặt plugin sẽ thất bại. Hãy cài đặt Git, hoặc sử dụng các bước thiết lập MCP thủ công của máy khách để cấu hình máy chủ trực tiếp thay vì dùng plugin.

Honeydew cung cấp một kho plugin với các kỹ năng và công cụ để xây dựng mô hình ngữ nghĩa và phân tích dữ liệu thông qua hội thoại tự nhiên. Việc cài đặt plugin sẽ tự động thiết lập các máy chủ MCP Honeydew.

Thêm marketplace trong Codex:

  1. Mở Plugin
  2. Nhấp vào mũi tên thả xuống và chọn Thêm marketplace
  3. Thêm honeydew-ai/honeydew-ai-coding-agents-plugins
Bạn cũng có thể thêm marketplace từ [Codex CLI](#codex-cli): 
```
codex plugin marketplace add honeydew-ai/honeydew-ai-coding-agents-plugins
```

Sau đó cài đặt plugin:

  1. Mở Plugin
  2. Chọn marketplace Honeydew AI
  3. Cài đặt plugin Honeydew

Thiết lập MCP

Sử dụng phần này nếu tổ chức của bạn sử dụng điểm cuối Honeydew tùy chỉnh, hoặc nếu bạn muốn cấu hình máy chủ MCP mà không cần cài đặt plugin. Vô hiệu hóa kết nối MCP Honeydew được thêm bởi plugin, sau đó thêm điểm cuối tùy chỉnh của bạn bằng cách làm theo hướng dẫn bên dưới.

Nếu tổ chức của bạn sử dụng tên máy chủ Honeydew tùy chỉnh, hãy thay thế `https://mcp.honeydew.cloud/mcp` bằng tên máy chủ thuê bao của bạn. Bạn có thể tìm thấy tên máy chủ trong **Cài đặt > Máy chủ MCP** trong Honeydew Studio.

Honeydew MCP

  1. Mở ứng dụng Codex

  2. Đi tới Cài đặt -> Máy chủ MCP

  3. Trong Máy chủ tùy chỉnh, nhấp vào Thêm máy chủ

  4. Đặt tên máy chủ thành honeydew

  5. Chọn HTTP có thể truyền phát làm loại truyền tải

  6. Đặt URL thành https://mcp.honeydew.cloud/mcp

  7. Để trống trường Biến môi trường mã thông báo Bearer

  8. Cấu hình xác thực như sau:

    Xác thực OAuth

    Codex chuyển hướng bạn để xác thực với Honeydew khi kết nối. Không cần cấu hình thêm.

    Xác thực HTTP Basic

    Thêm tiêu đề Authorization vào danh sách tiêu đề ở trên với giá trị Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET> (xem Xác thực).

Khắc phục sự cố xác thực MCP

Nếu máy chủ MCP Honeydew không được xác thực trong Codex và tùy chọn "Xác thực" không xuất hiện:

  1. Cài đặt Codex CLI
  2. Chạy codex mcp login honeydew

MCP Tài liệu Honeydew (tùy chọn)

Máy chủ MCP Honeydew đã bao gồm các công cụ truy cập tài liệu, vì vậy không cần máy chủ tài liệu riêng biệt. Chỉ thêm MCP Tài liệu Honeydew nếu bạn muốn truy cập tài liệu mà không cần kết nối với Honeydew. Không yêu cầu xác thực.

  1. Đi tới Cài đặt -> Máy chủ MCP
  2. Trong Máy chủ tùy chỉnh, nhấp vào Thêm máy chủ
  3. Đặt tên máy chủ thành honeydew-docs
  4. Chọn HTTP có thể truyền phát làm loại truyền tải
  5. Đặt URL thành https://honeydew.ai/docs/mcp

Xóa máy chủ MCP

Để xóa máy chủ MCP Honeydew:

  1. Đi tới Cài đặt -> Máy chủ MCP
  2. Tìm honeydew trong Máy chủ tùy chỉnh và nhấp vào Xóa

Để xóa máy chủ MCP Tài liệu Honeydew:

  1. Đi tới Cài đặt -> Máy chủ MCP
  2. Tìm honeydew-docs trong Máy chủ tùy chỉnh và nhấp vào Xóa

Antigravity

#### Máy chủ MCP Nếu tổ chức của bạn sử dụng tên máy chủ Honeydew tùy chỉnh, hãy thay thế `https://mcp.honeydew.cloud/mcp` bằng tên máy chủ thuê bao của bạn. Bạn có thể tìm thấy tên máy chủ trong **Cài đặt > Máy chủ MCP** trong Honeydew Studio.

  1. Mở trình soạn thảo Antigravity

  2. Nhấp vào menu thả xuống ... ở đầu bảng tác nhân

  3. Nhấp vào Quản lý Máy chủ MCP

  4. Nhấp vào Xem cấu hình thô

  5. Thêm phần sau vào mcp_config.json:

    ```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>

  6. Lưu tệp

MCP Tài liệu Honeydew (tùy chọn)

Máy chủ MCP Honeydew đã bao gồm các công cụ truy cập tài liệu, vì vậy không cần máy chủ tài liệu riêng biệt. Chỉ thêm MCP Tài liệu Honeydew nếu bạn muốn truy cập tài liệu mà không cần kết nối với Honeydew. Không yêu cầu xác thực.

  1. Mở trình soạn thảo Antigravity
  2. Nhấp vào menu thả xuống ... ở đầu bảng tác nhân
  3. Nhấp vào Quản lý Máy chủ MCP
  4. Nhấp vào Xem cấu hình thô
  5. Thêm phần sau vào mcp_config.json: 
    {
  "name": "honeydew-docs",
  "type": "http",
  "url": "https://honeydew.ai/docs/mcp"
}
  6. Lưu tệp

Xóa máy chủ MCP

Để xóa máy chủ MCP Honeydew:

  1. Mở trình soạn thảo Antigravity
  2. Nhấp vào menu thả xuống ... ở đầu bảng tác nhân
  3. Nhấp vào Quản lý Máy chủ MCP
  4. Nhấp vào Xem cấu hình thô
  5. Xóa các mục honeydew và honeydew-docs khỏi mcp_config.json
  6. Lưu tệp

OpenCode

#### Máy chủ MCP Nếu tổ chức của bạn sử dụng tên máy chủ Honeydew tùy chỉnh, hãy thay thế `https://mcp.honeydew.cloud/mcp` bằng tên máy chủ thuê bao của bạn. Bạn có thể tìm thấy tên máy chủ trong **Cài đặt > Máy chủ MCP** trong Honeydew Studio. Chạy lệnh sau và làm theo các lời nhắc tương tác: 
  ```bash theme={null}
  opencode mcp add
  ```

  Khi được nhắc, hãy nhập các giá trị sau:

  1. **Vị trí**: Chọn phạm vi ưa thích của bạn (dự án hiện tại hoặc toàn cục)
  2. **Tên máy chủ MCP**: `honeydew`
  3. **Loại máy chủ MCP**: `Remote`
  4. **URL máy chủ MCP**: `https://mcp.honeydew.cloud/mcp`
  5. **Xác thực OAuth**: `Yes`
  6. **ID khách hàng đã đăng ký trước**: `No`
</Tab>

<Tab title="JSON configuration">
  Thêm phần sau vào tệp `opencode.jsonc` của bạn:

  <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": {}
          }
        }
      }
      ```

      Sau đó xác thực với Honeydew:

      ```bash theme={null}
      opencode mcp auth honeydew
      ```

      Thao tác này sẽ mở một cửa sổ trình duyệt để hoàn tất quy trình xác thực 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>

Xác thực lại

Để xác thực lại, hãy kiểm tra trạng thái và đăng xuất trước:

opencode mcp auth list
opencode mcp logout honeydew
opencode mcp auth honeydew

MCP Tài liệu Honeydew (tùy chọn)

Máy chủ MCP Honeydew đã bao gồm các công cụ truy cập tài liệu, vì vậy không cần máy chủ tài liệu riêng biệt. Chỉ thêm MCP Tài liệu Honeydew nếu bạn muốn truy cập tài liệu mà không cần kết nối với Honeydew. Không yêu cầu xác thực.

Chạy `opencode mcp add` và nhập các giá trị sau: 
  1. **Tên máy chủ MCP**: `honeydew-docs`
  2. **Loại máy chủ MCP**: `Remote`
  3. **URL máy chủ MCP**: `https://honeydew.ai/docs/mcp`
  4. **Xác thực OAuth**: `No`
</Tab>

<Tab title="JSON configuration">
  Thêm phần sau vào tệp `opencode.jsonc` của bạn:

  ```json theme={null}
  {
    "$schema": "https://opencode.ai/config.json",
    "mcp": {
      "honeydew-docs": {
        "type": "remote",
        "url": "https://honeydew.ai/docs/mcp"
      }
    }
  }
  ```
</Tab>

Xóa máy chủ MCP

Để xóa máy chủ MCP Honeydew, xóa mục honeydew khỏi tệp opencode.jsonc của bạn. Để xóa máy chủ MCP Tài liệu Honeydew, xóa mục honeydew-docs khỏi cùng tệp đó.

Kiro

IDE Kiro và CLI Kiro chia sẻ cùng các tệp cấu hình MCP, vì vậy các bước dưới đây áp dụng cho cả hai.

Máy chủ MCP

Kiro đọc các máy chủ MCP từ hai tệp cấu hình:

  • Không gian làm việc: .kiro/settings/mcp.json (dành riêng cho dự án hiện tại)
  • Người dùng: ~/.kiro/settings/mcp.json (áp dụng cho tất cả không gian làm việc)

Nếu cả hai tệp tồn tại, cấu hình không gian làm việc sẽ được ưu tiên. Nếu tổ chức của bạn sử dụng tên máy chủ Honeydew tùy chỉnh, hãy thay thế https://mcp.honeydew.cloud/mcp bằng tên máy chủ của tenant. Bạn có thể tìm thấy tên máy chủ trong Settings > MCP Server trong Honeydew Studio.

Thêm máy chủ Honeydew MCP vào một trong các tệp mcp.json sau (workspace hoặc user):

```json theme={null} { "mcpServers": { "honeydew": { "url": "https://mcp.honeydew.cloud/mcp" } } } ``` 
  Khi kết nối lần đầu với Honeydew, Kiro cung cấp một URL xác thực.
  Mở URL đó trong trình duyệt của bạn để hoàn tất quy trình xác thực 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>

Trong Kiro CLI, chạy /mcp để xác minh máy chủ đã được kết nối. Trong Kiro IDE, máy chủ sẽ xuất hiện trong bảng MCP.

Honeydew Documentation MCP (tùy chọn)

Máy chủ Honeydew MCP đã bao gồm các công cụ truy cập tài liệu, vì vậy không cần máy chủ tài liệu riêng biệt. Chỉ thêm Honeydew Documentation MCP nếu bạn muốn truy cập tài liệu mà không cần kết nối với Honeydew. Không yêu cầu xác thực.

Thêm phần sau vào mcp.json của bạn:

{
  "mcpServers": {
    "honeydew-docs": {
      "url": "https://honeydew.ai/docs/mcp"
    }
  }
}

Gỡ bỏ máy chủ MCP

Để gỡ bỏ máy chủ Honeydew MCP, hãy xóa mục honeydew khỏi mcp.json của bạn. Để gỡ bỏ máy chủ Honeydew Documentation MCP, hãy xóa mục honeydew-docs khỏi cùng tệp đó.

Snowflake Intelligence

Snowflake kết nối với các máy chủ MCP bên ngoài thông qua [MCP connectors](https://docs.snowflake.com/en/user-guide/snowflake-cortex/cortex-agents-mcp-connectors), giúp các công cụ Honeydew khả dụng cho Snowflake Intelligence và Cortex Agents.

Điều kiện tiên quyết:

  • Một vai trò có đặc quyền CREATE INTEGRATION trên tài khoản
  • Một vai trò có đặc quyền CREATE MCP SERVER trên schema đích

Theo mặc định, chỉ vai trò ACCOUNTADMIN nắm giữ các đặc quyền này.

Nếu tổ chức của bạn sử dụng tên máy chủ Honeydew tùy chỉnh, hãy thay thế `https://mcp.honeydew.cloud/mcp` bằng tên máy chủ của tenant. Bạn có thể tìm thấy tên máy chủ trong **Settings > MCP Server** trong Honeydew Studio. ```sql theme={null} CREATE API INTEGRATION honeydew_mcp_integration API_PROVIDER = external_mcp API_ALLOWED_PREFIXES = ('https://mcp.honeydew.cloud/mcp') API_USER_AUTHENTICATION = ( TYPE = OAUTH_DYNAMIC_CLIENT OAUTH_RESOURCE_URL = 'https://mcp.honeydew.cloud/mcp' OAUTH_ALLOWED_SCOPES = ('openid') ) ENABLED = TRUE; ``` 
<Step title="Create the external MCP server">
  Máy chủ MCP bên ngoài là một đối tượng cấp schema
  tham chiếu đến tích hợp 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">
  Cấp quyền sử dụng trên cả tích hợp và máy chủ MCP
  cho bất kỳ vai trò nào cần truy cập vào 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">
  Thêm máy chủ MCP `honeydew` như một công cụ vào Cortex Agent
  hoặc Snowflake Intelligence agent.
  Người dùng sẽ được nhắc xác thực bằng OAuth với Honeydew trong lần sử dụng đầu tiên.
</Step>
Máy chủ Honeydew Documentation MCP độc lập không được hỗ trợ trong Snowflake, vì các máy chủ MCP bên ngoài của Snowflake yêu cầu xác thực OAuth và máy chủ tài liệu thì không xác thực. Có thể truy cập tài liệu thông qua các công cụ tài liệu của máy chủ Honeydew MCP.

Gỡ bỏ máy chủ MCP

Xóa máy chủ MCP trước, sau đó đến tích hợp API:

DROP MCP SERVER honeydew;
DROP INTEGRATION honeydew_mcp_integration;

Các Client Khác

Bất kỳ client nào tương thích MCP đều có thể kết nối với Honeydew MCP Server bằng cách sử dụng HTTP transport tiêu chuẩn.

Sử dụng cấu hình JSON sau làm điểm khởi đầu:

Nếu tổ chức của bạn sử dụng tên máy chủ Honeydew tùy chỉnh, hãy thay thế `https://mcp.honeydew.cloud/mcp` bằng tên máy chủ của tenant. Bạn có thể tìm thấy tên máy chủ trong **Settings > MCP Server** trong Honeydew Studio. ```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 " } } ```

Xem Server URL, Authentication, và Configuration để biết chi tiết về từng tham số.

Ví dụ Sử dụng

Sau khi kết nối, bạn có thể hỏi trợ lý AI của mình những câu hỏi như:

  • "Những thực thể nào có sẵn trong mô hình ngữ nghĩa?"
  • "Hiển thị cho tôi các thuộc tính và chỉ số cho thực thể orders"
  • "Những domain nào được định nghĩa trong mô hình?"
  • "Có những bảng nào trong schema analytics?"
  • "Có bao nhiêu đơn hàng đã được đặt vào tháng trước?"
  • "Tạo một chỉ số mới cho tổng doanh thu trên thực thể orders"
  • "Giá trị đơn hàng trung bình theo khu vực trong quý trước là bao nhiêu?"

Khắc phục sự cố

Sự cố Xác thực OAuth

Xác minh client của bạn có hỗ trợ OAuth không, đảm bảo bạn có các quyền workspace Honeydew cần thiết, và thử xác thực lại thông qua giao diện quản lý MCP của client.

Xác thực lại trong Claude Code

Gõ /mcp, chọn Honeydew MCP từ danh sách, chọn "Clear authentication" hoặc "Authenticate", sau đó làm theo lời nhắc OAuth trên trình duyệt để kết nối lại với Honeydew.

Sự cố Kết nối

Xác nhận URL máy chủ MCP khớp với https://mcp.honeydew.cloud/mcp và xác minh cú pháp cấu hình MCP của client là chính xác. Nếu tổ chức của bạn sử dụng tên máy chủ tùy chỉnh, hãy kiểm tra xem URL có khớp với tên máy chủ tenant xuất hiện trong Settings > MCP Server trong Honeydew Studio không.

Thiếu Công cụ

Xác minh xác thực đã thành công, kiểm tra quyền truy cập workspace Honeydew của bạn, và xem lại bảng điều khiển của client để tìm thông báo lỗi.

Đầu ra Vượt quá Token Tối đa Cho phép (Claude)

Trong Claude Code, Claude Desktop và Claude.ai, một lệnh gọi công cụ có thể thất bại với lỗi rằng đầu ra vượt quá token tối đa cho phép. Các công cụ phân tích của Honeydew như monitor_analysis và get_analysis_step_details có thể trả về kết quả lớn vượt qua giới hạn đầu ra MCP của Claude.

Claude cảnh báo khi đầu ra công cụ MCP vượt quá 10.000 token và từ chối đầu ra trên giới hạn mặc định là 25.000 token. Để tăng giới hạn, hãy đặt biến môi trường MAX_MCP_OUTPUT_TOKENS trước khi khởi chạy Claude:

export MAX_MCP_OUTPUT_TOKENS=50000
claude

Xem MCP output limits and warnings trong tài liệu Claude để biết chi tiết.

Để được hỗ trợ thêm, hãy liên hệ với bộ phận hỗ trợ của Honeydew tại support@honeydew.ai.

Công cụ Có sẵn

Các công cụ được đánh dấu là chỉ đọc không sửa đổi mô hình ngữ nghĩa hoặc kho dữ liệu.

Để chỉ hiển thị các công cụ chỉ đọc, hãy đặt header `ReadonlyToolsOnly: true` trong cấu hình máy chủ MCP của bạn. Khi được bật, máy chủ chỉ trả về các công cụ không sửa đổi mô hình ngữ nghĩa hoặc kho dữ liệu.

Phiên & Workspace

list_workspaces

chỉ đọc

Liệt kê tất cả các workspace có sẵn. Trả về tên workspace và loại kho dữ liệu (snowflake, databricks, hoặc bigquery). Sử dụng loại kho dữ liệu để cung cấp thông tin cho việc triển khai mô hình ngữ nghĩa.

list_workspace_branches

chỉ đọc

Liệt kê tất cả các nhánh có sẵn cho một workspace.

Tên của workspace.

get_session_workspace_and_branch

chỉ đọc

Lấy workspace và nhánh được đặt cho phiên hiện tại.

set_session_workspace_and_branch

chỉ đọc

Đặt workspace và nhánh để sử dụng cho phiên hiện tại. Tất cả các lệnh gọi công cụ tiếp theo trong phiên sẽ sử dụng workspace và nhánh này.

Tên của workspace. Nhánh để sử dụng.

create_workspace_branch

Tạo một nhánh mới cho một workspace hiện có. Nhánh được tạo từ trạng thái hiện tại của nhánh prod của workspace. Nếu không có workspace nào được ghim qua header, phiên sẽ tự động chuyển sang nhánh mới.

Tên của workspace để tạo nhánh. Tên của nhánh mới sẽ tạo.

delete_workspace_branch

Xóa một nhánh khỏi workspace. Đây là thao tác hủy, không thể đảo ngược. Luôn xác nhận tên workspace và tên nhánh với người dùng trước khi gọi công cụ này. Không thể xóa nhánh prod. Nếu nhánh bị xóa là nhánh của phiên hiện tại, phiên sẽ tự động chuyển sang prod.

Tên của workspace chứa nhánh cần xóa. Tên của nhánh cần xóa.

get_branch_history

chỉ đọc

Lấy lịch sử thay đổi cho nhánh của phiên hiện tại. Trả về danh sách các thay đổi hiển thị những đối tượng ngữ nghĩa nào đã được sửa đổi, bởi ai và khi nào.

Số lượng thay đổi tối đa để trả về.

create_pr_for_working_branch

Tạo một pull request cho nhánh làm việc của phiên hiện tại. Trả về URL PR khi thành công.

Tiêu đề cho pull request. Mô tả cho pull request.

Câu hỏi & Phân tích

initiate_analysis

chỉ đọc

Bắt đầu hoặc tiếp tục một phân tích dữ liệu. Trả về một conversation_id — sử dụng monitor_analysis để thăm dò tiến trình và kết quả, và abort_analysis để dừng sớm. Xem Deep Analysis để biết thêm chi tiết.

Câu hỏi ngôn ngữ tự nhiên cần hỏi. Tên agent cho một cuộc hội thoại mới. Bỏ qua đối với các câu hỏi tiếp theo — agent được kế thừa từ cuộc hội thoại hiện có. ID cuộc hội thoại hiện có để tiếp tục, hoặc bỏ qua để bắt đầu một cuộc hội thoại mới.

monitor_analysis

chỉ đọc

Thăm dò các thông báo tiến trình mới từ một phân tích đang diễn ra. Mỗi lần gọi chỉ trả về các thông báo kể từ lần gọi trước. Thăm dò lặp lại cho đến khi status là DONE hoặc NO_CHAT_CURRENTLY_RUNNING.

ID cuộc hội thoại được trả về bởi `initiate_analysis`. Số lượng thông báo tối đa để trả về mỗi lần gọi. ID thông báo để phát lại từ đó. Sử dụng `last_received_message_id` từ kết quả trước đó để khôi phục các thông báo bị bỏ lỡ.

get_analysis_step_details

chỉ đọc

Truy xuất chi tiết đầy đủ cho một bước phân tích cụ thể, bao gồm truy vấn ngữ nghĩa, câu lệnh SQL, ngữ cảnh đã sử dụng, và dữ liệu được truy xuất trong bước đó.

ID cuộc hội thoại được trả về bởi `initiate_analysis`. ID bước từ `monitor_analysis` (ví dụ: `STEP/0`).

abort_analysis

chỉ đọc

Hủy bỏ một phân tích đang diễn ra. Có thể được tiếp tục từ điểm đã hủy bỏ với initiate_analysis.

ID cuộc hội thoại được trả về bởi `initiate_analysis`.

list_analysis_chats

chỉ đọc

Trả về danh sách phân trang các cuộc hội thoại phân tích cho workspace hiện tại, được sắp xếp theo thời gian tạo (mới nhất trước). Quản trị viên thấy tất cả các cuộc hội thoại; người không phải quản trị viên chỉ thấy của riêng họ. Mỗi mục bao gồm ID cuộc hội thoại, tiêu đề, phản hồi của người dùng, domain, agent, thời gian tạo và tên hiển thị của người dùng đã tạo ra nó.

Số lượng cuộc hội thoại tối đa để trả về. Số lượng cuộc hội thoại cần bỏ qua để phân trang.

provide_analysis_feedback

Đặt hoặc xóa phản hồi về một cuộc hội thoại phân tích cụ thể. Có một mục phản hồi duy nhất cho mỗi cuộc hội thoại (không phải mỗi câu hỏi) — nó nên phản ánh chất lượng tổng thể của toàn bộ luồng hội thoại.

Gọi công cụ này sau khi monitor_analysis hoàn tất và người dùng bày tỏ sự hài lòng hoặc không hài lòng với kết quả. Sử dụng một chuỗi khẳng định ngắn cho phản hồi tích cực (ví dụ: Good), hoặc định dạng <Reason>: <details> cho phản hồi tiêu cực, trong đó Reason là một trong số Chart Issue, Data Issue, Wrong Judgement, hoặc Other.

ID cuộc hội thoại của cuộc hội thoại phân tích. Văn bản phản hồi để lưu trữ, hoặc `null` để xóa phản hồi hiện có.

get_stored_conversation

chỉ đọc Trả về tất cả tin nhắn từ một cuộc trò chuyện phân tích hiện có. Sử dụng để xem lại toàn bộ nội dung của một cuộc trò chuyện trước đó. is_complete trong phản hồi cho biết liệu cuộc trò chuyện đã đạt đến trạng thái kết thúc hay chưa.

ID cuộc trò chuyện từ `list_analysis_chats`. Nếu `true`, bao gồm các mục tiến trình `step_start` và `step_insight`. Nếu `false`, chỉ trả về phản hồi cuối cùng và các tin nhắn kế hoạch/diễn giải.

Duyệt & Khám phá

list_entities

chỉ đọc

Liệt kê tất cả các thực thể trong mô hình ngữ nghĩa cùng với tên, mô tả và khóa của chúng.

get_entity

chỉ đọc

Nhận thông tin chi tiết về một thực thể, bao gồm các thuộc tính, chỉ số, tập dữ liệu, quan hệ và định nghĩa YAML của nó.

Tên của thực thể.

get_field

chỉ đọc

Nhận thông tin chi tiết về một trường cụ thể (thuộc tính hoặc chỉ số) trong một thực thể, bao gồm định nghĩa YAML của nó.

Tên của thực thể chứa trường đó. Tên của trường.

list_domains

chỉ đọc

Liệt kê tất cả các miền trong mô hình ngữ nghĩa cùng với tên, mô tả và thực thể của chúng.

get_domain

chỉ đọc

Nhận thông tin chi tiết về một miền, bao gồm các thực thể, bộ lọc, tham số và định nghĩa YAML của nó.

Tên của miền.

search_model

chỉ đọc

Tìm kiếm trong mô hình ngữ nghĩa các thực thể, thuộc tính, chỉ số, tập dữ liệu, tập dữ liệu động, miền và tham số toàn cục khớp với một chuỗi truy vấn.

Sử dụng cú pháp entity.field để giới hạn phạm vi tìm kiếm vào các trường trong một thực thể cụ thể. Ví dụ: customers.balance tìm trường balance trên các thực thể khớp với customers; customers. trả về tất cả các trường của các thực thể khớp. Trong chế độ OR/AND, các kết quả khớp một phần áp dụng cho cả phần thực thể và phần trường — cust.bal khớp với customers.balance.

Chuỗi truy vấn tìm kiếm. Kiểm soát cách truy vấn được khớp:
  • OR — tách theo khoảng trắng, trả về các đối tượng khớp với bất kỳ từ nào.
  • AND — tách theo khoảng trắng, chỉ trả về các đối tượng khớp với tất cả các từ.
  • EXACT — sử dụng toàn bộ chuỗi như cũ, trả về các đối tượng có tên hoặc tên hiển thị khớp chính xác.

Khám phá Kho dữ liệu

list_databases

chỉ đọc

Liệt kê tất cả các cơ sở dữ liệu có sẵn trong kho dữ liệu được kết nối.

list_schemas

chỉ đọc

Liệt kê tất cả các lược đồ trong một cơ sở dữ liệu cụ thể trong kho dữ liệu được kết nối.

Tên cơ sở dữ liệu.

list_tables

chỉ đọc

Liệt kê các bảng/khung nhìn trong một cơ sở dữ liệu và lược đồ cụ thể trong kho dữ liệu được kết nối.

Tên cơ sở dữ liệu. Tên lược đồ.

get_table_info

chỉ đọc

Nhận thông tin chi tiết về một bảng/khung nhìn trong kho dữ liệu, bao gồm các cột và siêu dữ liệu của nó.

Tên cơ sở dữ liệu. Tên lược đồ. Tên bảng.

Mô hình Ngữ nghĩa

import_tables

Nhập các bảng từ kho dữ liệu được kết nối vào mô hình ngữ nghĩa. Mỗi bảng trở thành một thực thể với các cột của nó là các thuộc tính.

Danh sách các tên bảng đầy đủ theo định dạng `database.schema.table`.

create_entity

Tạo một thực thể mới trong mô hình ngữ nghĩa từ các định nghĩa YAML.

Định nghĩa YAML cho thực thể. Định nghĩa YAML cho tập dữ liệu.

create_object

Tạo một đối tượng mô hình ngữ nghĩa mới từ một định nghĩa YAML. Các loại được hỗ trợ: thuộc tính, chỉ số, tập dữ liệu động, miền và tham số toàn cục.

Định nghĩa YAML của đối tượng. Tạo đối tượng ngay cả khi xác thực tạo ra lỗi.

update_object

Cập nhật một đối tượng mô hình ngữ nghĩa hiện có từ một định nghĩa YAML. Các loại được hỗ trợ: thực thể, thuộc tính, chỉ số, tập dữ liệu, tập dữ liệu động, miền và tham số toàn cục.

Định nghĩa YAML của đối tượng. Khóa của đối tượng cần cập nhật. Cập nhật đối tượng ngay cả khi xác thực tạo ra lỗi.

validate_object

chỉ đọc

Xác thực định nghĩa YAML của một đối tượng mô hình ngữ nghĩa mà không tạo hoặc cập nhật nó. Các loại được hỗ trợ: thực thể, thuộc tính, chỉ số, tập dữ liệu, tập dữ liệu động, miền và tham số toàn cục.

Định nghĩa YAML cần xác thực. Khóa của đối tượng để xác thực dựa trên.

delete_object

Xóa một đối tượng mô hình ngữ nghĩa bằng khóa của nó.

Khóa của đối tượng cần xóa. Xóa đối tượng ngay cả khi xác thực tạo ra lỗi.

Tác nhân

list_agents

chỉ đọc

Liệt kê tất cả các tác nhân cùng với tên, mô tả, miền và tham chiếu ngữ cảnh của chúng.

get_agent

chỉ đọc

Nhận thông tin chi tiết về một tác nhân, bao gồm định nghĩa frontmatter YAML của nó.

Tên của tác nhân cần truy xuất.

create_agent

Tạo một tác nhân mới.

Siêu dữ liệu cho tác nhân mới. Tên phân cấp (ví dụ: `growth-analyst`, `finance/budget-analyst`). 
<ParamField body="display_name" type="string" required>
  Tên dễ đọc hiển thị trong giao diện người dùng.
</ParamField>

<ParamField body="description" type="string" required>
  Mô tả về mục đích và khả năng của tác nhân.
</ParamField>

<ParamField body="domain" type="string" required>
  Miền mà tác nhân này hoạt động.
</ParamField>

<ParamField body="welcome_message" type="string">
  Tin nhắn giới thiệu hiển thị khi người dùng bắt đầu một phiên.
</ParamField>

<ParamField body="sample_questions" type="string[]">
  Các câu hỏi ví dụ hiển thị cho người dùng.
</ParamField>

<ParamField body="context" type="string[]">
  Tên mục ngữ cảnh hoặc mẫu glob để tải vào các phiên
  (ví dụ: `skills/**`, `knowledge/marketing/**`).
</ParamField>

<ParamField body="owner" type="string">
  Định danh chủ sở hữu cho tác nhân.
</ParamField>
Nội dung Markdown được thêm vào sau frontmatter. Văn bản này được đưa vào lời nhắc trước mỗi phiên phân tích. Tạo tác nhân ngay cả khi xác thực tạo ra lỗi.

update_agent

Cập nhật một tác nhân hiện có.

Tên của tác nhân cần cập nhật. Định nghĩa tác nhân được cập nhật đầy đủ. Tất cả các trường bắt buộc từ `create_agent` phải được cung cấp — đây là sự thay thế toàn bộ, không phải cập nhật một phần. Nội dung Markdown được cập nhật cho tác nhân. Cập nhật tác nhân ngay cả khi xác thực tạo ra lỗi.

delete_agent

Xóa một tác nhân theo tên.

Tên của tác nhân cần xóa.

Mục Ngữ cảnh

list_context_items

chỉ đọc

Liệt kê tất cả các mục ngữ cảnh cùng với loại, tên, tiêu đề và giá trị loại phụ của chúng.

get_context_item

chỉ đọc

Nhận một mục ngữ cảnh theo tên.

Tên của mục ngữ cảnh cần truy xuất.

create_context_item

Tạo một mục ngữ cảnh mới. Hỗ trợ các loại hướng dẫn và bộ nhớ.

Siêu dữ liệu cho mục ngữ cảnh mới. Phải là `instruction`. 
<ParamField body="name" type="string" required>
  Tên phân cấp
  (ví dụ: `knowledge/customer/churn-analysis`, `skills/reporting`).
</ParamField>

<ParamField body="subtype" type="string" required>
  Một trong số `knowledge`, `skill`, hoặc `instruction`.
</ParamField>

<ParamField body="title" type="string" required>
  Tiêu đề dễ đọc cho mục ngữ cảnh.
</ParamField>

<ParamField body="apply" type="string" required>
  Khi nào áp dụng ngữ cảnh: `always` hoặc `on_demand`.
</ParamField>

<ParamField body="description" type="string">
  Mô tả được AI sử dụng để quyết định khi nào tải mục này
  (bắt buộc khi `apply` là `on_demand`).
</ParamField>

<ParamField body="owner" type="string">
  Định danh chủ sở hữu.
</ParamField>

<ParamField body="labels" type="string[]">
  Nhãn để tổ chức các mục ngữ cảnh.
</ParamField>

<ParamField body="related_objects" type="object[]">
  Các đối tượng ngữ nghĩa mà mục ngữ cảnh này liên quan đến.
  Mỗi đối tượng có một `name` (chuỗi) và `type` (`domain`, `entity`, hoặc `field`).
</ParamField>

<ParamField body="external_source" type="object">
  Nguồn bên ngoài để lấy nội dung (cho loại phụ `knowledge`).
  Có `tool` (tên công cụ MCP), `resource_id` (định danh trong công cụ bên ngoài),
  và `cache_max_age_in_seconds` tùy chọn (mặc định: `3600`).
</ParamField>
Phải là `memory`. 
<ParamField body="name" type="string" required>
  Tên phân cấp (ví dụ: `events/q4-launch`, `2024/pricing-decision`).
</ParamField>

<ParamField body="subtype" type="string" required>
  Một trong số `event` hoặc `decision_trace`.
</ParamField>

<ParamField body="title" type="string" required>
  Tiêu đề dễ đọc cho mục ngữ cảnh.
</ParamField>

<ParamField body="apply" type="string" required>
  Khi nào áp dụng ngữ cảnh: `always` hoặc `on_demand`.
</ParamField>

<ParamField body="from_date" type="string" required>
  Ngày bắt đầu của khoảng thời gian bộ nhớ ở định dạng ISO (ví dụ: `2024-01-01`).
</ParamField>

<ParamField body="to_date" type="string">
  Ngày kết thúc của khoảng thời gian bộ nhớ ở định dạng ISO.
</ParamField>

<ParamField body="description" type="string">
  Mô tả được AI sử dụng để quyết định khi nào tải mục này
  (bắt buộc khi `apply` là `on_demand`).
</ParamField>

<ParamField body="owner" type="string">
  Định danh chủ sở hữu.
</ParamField>

<ParamField body="labels" type="string[]">
  Nhãn để tổ chức các mục ngữ cảnh.
</ParamField>

<ParamField body="related_objects" type="object[]">
  Các đối tượng ngữ nghĩa mà mục ngữ cảnh này liên quan đến.
  Mỗi đối tượng có một `name` (chuỗi) và `type` (`domain`, `entity`, hoặc `field`).
</ParamField>

<ParamField body="external_source" type="object">
  Nguồn bên ngoài để lấy nội dung.
  Có `tool` (tên công cụ MCP), `resource_id` (định danh trong công cụ bên ngoài),
  và `cache_max_age_in_seconds` tùy chọn (mặc định: `3600`).
</ParamField>
Nội dung Markdown cho nội dung của mục ngữ cảnh. Tạo mục ngữ cảnh ngay cả khi xác thực tạo ra lỗi.

update_context_item

Cập nhật một mục ngữ cảnh hiện có.

Tên của mục ngữ cảnh cần cập nhật. Định nghĩa mục ngữ cảnh được cập nhật đầy đủ. Tất cả các trường bắt buộc từ `create_context_item` phải được cung cấp — đây là sự thay thế toàn bộ, không phải cập nhật một phần. Nội dung Markdown được cập nhật cho mục ngữ cảnh. Cập nhật mục ngữ cảnh ngay cả khi xác thực tạo ra lỗi.

delete_context_item

Xóa một mục ngữ cảnh theo tên.

Tên của mục ngữ cảnh cần xóa.

Truy vấn & Xem trước

get_sql_from_fields

chỉ đọc

Tạo truy vấn SQL cho một truy vấn lớp ngữ nghĩa được xác định bởi các thuộc tính, chỉ số và bộ lọc. Trả về SQL mà không thực thi nó.

Tên thuộc tính đầy đủ (`entity.attribute_name`). Hỗ trợ bí danh: `entity.attribute_name as alias_name`. Tên metric đầy đủ (`entity.metric_name`) hoặc biểu thức SQL (ví dụ: `SUM(entity.field)`). Hỗ trợ bí danh: `SUM(entity.field) as total`. Điều kiện lọc (ví dụ: `entity.field = 'value'`, `entity.date_field > '2024-01-01'`). Danh sách các trường để sắp xếp. Định dạng: `entity.field_name` hoặc `entity.field_name DESC`. Hướng mặc định là ASC. Khi sử dụng bí danh, sắp xếp theo tên bí danh. Miền để truy vấn. Số hàng tối đa trả về. Số hàng bỏ qua để phân trang.

get_data_from_fields

chỉ đọc

Thực thi một truy vấn lớp ngữ nghĩa được xác định bởi các thuộc tính, metric và bộ lọc, và trả về dữ liệu kết quả.

Tên thuộc tính đầy đủ (`entity.attribute_name`). Hỗ trợ bí danh: `entity.attribute_name as alias_name`. Tên metric đầy đủ (`entity.metric_name`) hoặc biểu thức SQL (ví dụ: `SUM(entity.field)`). Hỗ trợ bí danh: `SUM(entity.field) as total`. Điều kiện lọc (ví dụ: `entity.field = 'value'`, `entity.date_field > '2024-01-01'`). Danh sách các trường để sắp xếp. Định dạng: `entity.field_name` hoặc `entity.field_name DESC`. Hướng mặc định là ASC. Khi sử dụng bí danh, sắp xếp theo tên bí danh. Miền để truy vấn. Số hàng tối đa trả về. Số hàng bỏ qua để phân trang.

list_query_history

chỉ đọc

Liệt kê các truy vấn đã thực thi trước đó qua lớp ngữ nghĩa Honeydew, gần đây nhất trước. Sử dụng để tìm và phân loại các truy vấn thất bại và hiểu lý do chúng thất bại. Người gọi không phải quản trị viên chỉ thấy truy vấn của chính họ.

Mỗi truy vấn bao gồm trạng thái, thông báo lỗi, chủ sở hữu, máy khách, miền, SQL đầu vào gốc (SQL do người dùng gửi cho các truy vấn giao diện SQL), dấu thời gian cho biên dịch và thực thi kho dữ liệu, ID truy vấn kho dữ liệu, và một liên kết để mở nó trong ứng dụng Honeydew.

Lọc theo trạng thái truy vấn (`FAILED`, `SUCCESS`, `RUNNING`, hoặc `CANCELED`). Lọc theo máy khách đã chạy truy vấn (ví dụ: `Snowflake`, `MCP`). Lọc theo tên miền. Lọc theo chủ sở hữu truy vấn (email người dùng, hoặc tên khóa API). Chỉ được tôn trọng cho người gọi quản trị viên; người không phải quản trị viên bị giới hạn trong truy vấn của chính họ. Chỉ các truy vấn được thực thi tại hoặc sau thời gian này (ISO 8601). Chỉ các truy vấn được thực thi tại hoặc trước thời gian này (ISO 8601). Cũng trả về định nghĩa YAML ngữ nghĩa của mỗi truy vấn (thuộc tính, metric, bộ lọc). Kích hoạt để tái tạo hoặc thay đổi một truy vấn. Cũng trả về SQL kho dữ liệu đã biên dịch của mỗi truy vấn (lớn). Kích hoạt để gỡ lỗi phía kho dữ liệu cho một truy vấn cụ thể. Số lượng truy vấn tối đa trả về. Số lượng truy vấn bỏ qua để phân trang.

Tài liệu

search_docs

chỉ đọc

Tìm kiếm cơ sở kiến thức tài liệu Honeydew để lấy thông tin liên quan, ví dụ mã, tham chiếu API và hướng dẫn. Trả về nội dung theo ngữ cảnh với tiêu đề và liên kết đến các trang tài liệu. Để đọc toàn bộ nội dung của một trang, sử dụng query_docs_filesystem.

Truy vấn tìm kiếm.

query_docs_filesystem

chỉ đọc

Chạy một lệnh giống shell chỉ đọc trên một hệ thống tệp ảo hóa, trong bộ nhớ chứa các trang tài liệu Honeydew và đặc tả OpenAPI. Hỗ trợ các lệnh như rg, grep, find, tree, ls, cat, head, và tail. Sử dụng để khớp chính xác từ khóa hoặc regex, khám phá cấu trúc, hoặc đọc toàn bộ nội dung của một trang cụ thể theo đường dẫn.

Lệnh shell để chạy (ví dụ: `rg -il "keyword" /`, `tree / -L 2`, `head -80 /path/page.mdx`).