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.aiDùng thử MCP nàyĐược tài trợ

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

  • Khám phá siêu dữ liệu kho dữ liệu — Yêu cầu trợ lý của bạn khám phá các bảng, lược đồ và định nghĩa mô hình ngữ nghĩa trên toàn bộ kho dữ liệu của bạn.
  • Quản lý mô hình ngữ nghĩa — Xây dựng và duy trì mô hình ngữ nghĩa của bạn thông qua hội thoại tự nhiên, bao gồm tạo nhánh không gian làm việc bằng create_workspace_branch.
  • Truy vấn dữ liệu bằng hội thoại — Sử dụng ngôn ngữ tự nhiên để truy vấn dữ liệu của bạn từ bất kỳ trợ lý tương thích MCP nào.
  • Cấu hình ngữ cảnh phiên — Đặt không gian làm việc và nhánh đang hoạt động của bạn bằng set_session_workspace_and_branch sau khi liệt kê các tùy chọn có sẵn bằng list_workspaces và list_workspace_branches.
  • Truy cập tài liệu Honeydew — Tìm kiếm và đọc tài liệu Honeydew trực tiếp thông qua các công cụ tài liệu tích hợp sẵn của máy chủ MCP.

Tài liệu

Máy chủ MCP

MCP là gì?

Giao thức Ngữ cảnh Mô hình (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 Tầng ngữ nghĩa Honeydew.

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

  • Khám phá và khai thác các bảng, 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 của bạn 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

Lư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ế URL mặc định bằng tên máy chủ của đối tác thuê bao 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 > Máy chủ MCP.

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 cơ bản HTTP.

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

Hầu hết các máy khách 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

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

Xác thực cơ bản HTTP

Máy chủ MCP ở chế độ xác thực cơ bản HTTP 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.

Mẹo

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 đặt ở cấp phiên 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. 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 đặt)
  • 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)

Lưu ý

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 để biết chi tiết.

Máy khách được hỗ trợ

Claude Code CLI

#### Cài đặt plugin

Lưu ý

Yêu cầu Git. Cài đặt plugin từ GitHub sao chép kho lưu trữ cục bộ, vì vậy Git phải được cài đặt và nằm trên PATH của bạn. Nếu thiếu Git, cài đặt plugin sẽ thất bại. 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ì 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. 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 ở đầu trang
  2. Chọn honeydew-ai-coding-agents-plugins
  3. Nhấp Cập nhật marketplace

Để nhận cập nhật tự động, chọn Bật cập nhật tự động 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 các máy chủ MCP mà không 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ác hướng dẫn dưới đây.

Máy chủ MCP Honeydew kết nối Claude Code với Tầng 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.

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

Lư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 đối tác 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.

```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 với OAuth đến 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ó với:

      ```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 với OAuth đến 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ó với:

      ```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 với OAuth đến 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>

Mẹo

Sử dụng biến môi trường để 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 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:

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} tại thời điểm 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ột máy chủ tài liệu riêng. 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 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

Xóa máy chủ MCP

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

claude mcp remove honeydew

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

claude mcp remove honeydew-docs

Claude Desktop

#### Cài đặt plugin

Lưu ý

Yêu cầu Git. Cài đặt plugin từ GitHub sao chép kho lưu trữ cục bộ, vì vậy Git phải được cài đặt và nằm trên PATH của bạn. Nếu thiếu Git, cài đặt plugin sẽ thất bại. 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ì 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. 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. Đi tới tab Cá nhân
  4. Nhấp 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 các máy chủ MCP mà không 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ác hướng dẫn dưới đây.

Máy chủ MCP Honeydew kết nối Claude Desktop với Tầng 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.

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ế.

Lư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 đối tác 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.

Để thêm MCP Honeydew ở 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 với OAuth đến 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ột máy chủ tài liệu riêng. 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 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

Xóa máy chủ MCP

Để xóa máy chủ MCP Honeydew ở 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 biểu tượng xóa

Để xóa 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 biểu tượng xóa

Claude.ai

#### Cài đặt 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. 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 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 zip — plugin xuất hiện trong marketplace riêng 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 các máy chủ MCP mà không cài đặt plugin. Xóa 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ác hướng dẫn dưới đây.

Máy chủ MCP Honeydew kết nối Claude.ai với Tầng 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.

Lư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 đối tác 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.

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

  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 vào 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.

Honeydew Documentation MCP (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ột 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 cần 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 vào Thêm

Xóa máy chủ MCP

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

  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

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

  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

Cortex Code CLI

#### Cài đặt plugin

Lưu ý

Yêu cầu Git. Cài đặt plugin từ GitHub sẽ sao chép kho lưu trữ cục bộ, vì vậy Git phải được cài đặt và nằm 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 ứng dụng 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. Cài đặt plugin sẽ tự động thiết lập các máy chủ MCP Honeydew.

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 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ác hướng dẫn bên dưới.

Máy chủ MCP Honeydew 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.

Lư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 đối tượng thuê 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.

```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ủ 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ột 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 cần 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ủ MCP Honeydew:

cortex mcp remove honeydew

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

cortex mcp remove honeydew-docs

Cortex Code Desktop

#### Cài đặt plugin

Lưu ý

Yêu cầu Git. Cài đặt plugin từ GitHub sẽ sao chép kho lưu trữ cục bộ, vì vậy Git phải được cài đặt và nằm 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 ứng dụng 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. 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 -> Plugin
  2. Nhấp vào Thêm Plugin, chọn Thêm từ GitHub, và dán kho plugin Honeydew: honeydew-ai/honeydew-ai-coding-agents-plugins
  3. Làm theo luồng và phê duyệt các bước trong Thiết lập Trình cài đặt Plugin GitHub

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 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ác hướng dẫn bên dưới.

Máy chủ MCP Honeydew 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ột máy chủ, đi tới MCP -> Mới, chọn một Phạm vi cấu hình (ví dụ: ~/.snowflake/cortex/mcp.json cho Toàn cục), điền vào biểu mẫu, sau đó nhấp vào Lưu. Sử dụng tab Biểu mẫu hoặc JSON để nhập cấu hình.

Lư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 đối tượng thuê 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.

Thêm máy chủ Honeydew MCP:

1. **Tên máy chủ**: `honeydew` 2. **Loại máy chủ**: **Từ xa (HTTP)** 3. **URL máy chủ**: `https://mcp.honeydew.cloud/mcp` 4. Nhấp vào **Lưu** 
      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. **Tên máy chủ**: `honeydew`
      2. **Loại máy chủ**: **Từ xa (HTTP)**
      3. **URL máy chủ**: `https://mcp.honeydew.cloud/mcp`
      4. Trong **Tiêu đề**, nhấp vào **Thêm tiêu đề** và đặt tên là
         `Authorization` và giá trị là
         `Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET>`
      5. Nhấp vào **Lưu**
    </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ủ 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ột 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 Tên máy chủ honeydew-docs, Loại máy chủ Từ xa (HTTP), và URL máy chủ https://honeydew.ai/docs/mcp. Không cần xác thực.

Xóa máy chủ MCP

Để xóa một máy chủ, đi tới 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 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. Cài đặt plugin sẽ tự động thiết lập các máy chủ MCP Honeydew.

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

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 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ác hướng dẫn bên dưới.

Máy chủ MCP Honeydew 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.

Lư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 đối tượng thuê 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.

Để thêm Honeydew MCP:

  1. Mở ứng dụng Cursor

  2. Đi tới Cài đặt -> Cài đặt Cursor -> Công cụ & MCP

  3. Nhấp vào Máy chủ MCP mới

  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 vào Lưu

Honeydew Documentation MCP (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ột 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 cần xác thực.

  1. Đi tới Cài đặt -> Cài đặt Cursor -> Công cụ & MCP
  2. Nhấp vào Máy chủ MCP mới
  3. Thêm cấu hình sau: 
    {
  "name": "honeydew-docs",
  "type": "http",
  "url": "https://honeydew.ai/docs/mcp"
}
  4. Nhấp vào Lưu

Xóa máy chủ MCP

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

  1. Đi tới Cài đặt -> Cài đặt Cursor -> Công cụ & 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. Đi tới Cài đặt -> Cài đặt Cursor -> Công cụ & MCP
  2. Tìm honeydew-docs trong danh sách và nhấp vào biểu tượng xóa

Databricks Genie Code

> **Lưu ý** > > 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 MCP của Databricks](https://docs.databricks.com/aws/en/generative-ai/mcp/).

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

  • Genie Code được bật trong không gian làm việc Databricks của bạn
  • Đặc 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** ở giá trị `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 Databricks hoặc trình soạn thảo 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>

Lư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 bằng tên máy chủ của đối tượng thuê của bạn. Bạn có thể tìm thấy tên máy chủ của mình trong Settings > MCP Server trong Honeydew Studio. 

<Step title="Log in to the connection">
  Đ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à kiểm tra kết nối.
</Step>

<Step title="Grant connection access">
  Cấp đặc quyền `USE CONNECTION` cho bất kỳ người dùng hoặc vai trò nào
  cần quyền truy cập vào máy chủ MCP Honeydew:

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

Lưu ý

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 các 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ủ MCP Honeydew 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 bên dưới, hãy chạy SQL sau:

DROP CONNECTION `honeydew-mcp`;

Devin

#### MCP Server

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

Lư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 đối tượng thuê 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ủ MCP Honeydew:

  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 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 đề ở giá trị `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ủ 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. Chỉ thêm Honeydew Documentation MCP nếu bạn muốn truy cập tài liệu mà không kết nối với Honeydew. Không cần 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ủ MCP Honeydew:

  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

#### MCP Server

Lư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 đối tượng thuê của bạn. 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. Nhập /mcp add để mở biểu mẫu cấu hình máy chủ

  3. Điền 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ủ đã kết nối.

Plugin AI Coding Agent

Lưu ý

Yêu cầu Git. Cài đặt plugin từ GitHub sẽ sao chép kho lưu trữ cục bộ, vì vậy Git phải được cài đặt và nằm trong PATH của bạn. Nếu thiếu Git, cài đặt plugin sẽ thất bại. Cài đặt Git, hoặc sử dụng các bước thiết lập MCP thủ công của ứng dụng khách để cấu hình máy chủ trực tiếp thay vì 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.

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ủ 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. Chỉ thêm Honeydew Documentation MCP nếu bạn muốn truy cập tài liệu mà không kết nối với Honeydew. Không cần xác thực.

  1. Khởi chạy GitHub Copilot CLI với copilot
  2. Nhập /mcp add để mở biểu mẫu cấu hình máy chủ
  3. Điền 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ủ MCP Honeydew, khởi chạy GitHub Copilot CLI với copilot, sau đó nhập:

/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

Lưu ý

Yêu cầu Git. Cài đặt plugin từ GitHub sẽ sao chép kho lưu trữ cục bộ, vì vậy Git phải được cài đặt và nằm trong PATH của bạn. Nếu thiếu Git, cài đặt plugin sẽ thất bại. Cài đặt Git, hoặc sử dụng các bước thiết lập MCP thủ công của ứng dụng khách để cấu hình máy chủ trực tiếp thay vì 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. Cài đặt tiện ích mở rộng sẽ tự động thiết lập các máy chủ MCP Honeydew.

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ữ cho tiện ích mở rộng được cập nhật tự động.

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ài đặt tiện ích mở rộng. Vô hiệu hóa kết nối MCP Honeydew được thêm bởi tiện ích mở rộng, sau đó thêm điểm cuối tùy chỉnh của bạn bằng các hướng dẫn bên dưới.

Máy chủ MCP Honeydew 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.

Lư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 đối tượng thuê của bạn. 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ủ MCP Honeydew:

```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ủ 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. Chỉ thêm Honeydew Documentation MCP nếu bạn muốn truy cập tài liệu mà không kết nối với Honeydew. Không cần 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ủ MCP Honeydew:

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 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. Cài đặt plugin sẽ tự động thiết lập các máy chủ MCP Honeydew.

Thêm marketplace Honeydew

  1. Mở settings.json của VS Code (mở Command Palette bằng 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ừ marketplace mới, VS Code 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.

MCP Server

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à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ác hướng dẫn bên dưới.

Máy chủ MCP Honeydew 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.

Lư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 đối tượng thuê của bạn. Bạn có thể tìm thấy tên máy chủ trong Settings > MCP Server trong Honeydew Studio.

  1. Mở Command Palette bằng CMD+Shift+P (macOS) hoặc Ctrl+Shift+P (Windows/Linux)
  2. Chọn MCP: Add Server...
  3. Chọn HTTP (HTTP or Server-Sent Events)
  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 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>

Honeydew Documentation MCP (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ột máy chủ tài liệu riêng. 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 nội dung sau vào .vscode/mcp.json của bạn:

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

Gỡ bỏ máy chủ MCP

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

Codex CLI

#### Cài đặt Plugin

Lưu ý

Yêu cầu Git. Cài đặt plugin từ GitHub sẽ sao chép kho lưu trữ cục bộ, vì vậy Git phải được cài đặt và nằm 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 ứng dụng 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. 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 dùng một endpoint 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ài đặt plugin. Vô hiệu hóa kết nối MCP Honeydew do plugin thêm vào, sau đó thêm endpoint tùy chỉnh của bạn bằng các hướng dẫn bên dưới.

Máy chủ MCP Honeydew kết nối Codex 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.

Lưu ý

Nếu tổ chức của bạn dùng một hostname Honeydew tùy chỉnh, hãy thay https://mcp.honeydew.cloud/mcp bằng hostname của đối tượng thuê của bạn. Bạn có thể tìm hostname 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ủ, hãy mở tệp cấu hình tại ~/.codex/config.toml và thêm các header vào phần [mcp_servers.honeydew] nếu cần.

Cấu hình TOML

Thêm nội dung 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).

Honeydew Documentation MCP (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ột máy chủ tài liệu riêng. 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.

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

Gỡ bỏ máy chủ MCP

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

codex mcp remove honeydew

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

codex mcp remove honeydew-docs

Codex

#### Cài đặt Plugin

Lưu ý

Yêu cầu Git. Cài đặt plugin từ GitHub sẽ sao chép kho lưu trữ cục bộ, vì vậy Git phải được cài đặt và nằm 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 ứng dụng 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. 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ở Plugins
  2. Nhấp vào mũi tên thả xuống và chọn Add marketplace
  3. Thêm honeydew-ai/honeydew-ai-coding-agents-plugins

Lưu ý

Bạn cũng có thể thêm marketplace từ Codex CLI:

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

Sau đó cài đặt plugin:

  1. Mở Plugins
  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 dùng một endpoint 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ài đặt plugin. Vô hiệu hóa kết nối MCP Honeydew do plugin thêm vào, sau đó thêm endpoint tùy chỉnh của bạn bằng các hướng dẫn bên dưới.

Lưu ý

Nếu tổ chức của bạn dùng một hostname Honeydew tùy chỉnh, hãy thay https://mcp.honeydew.cloud/mcp bằng hostname của đối tượng thuê của bạn. Bạn có thể tìm hostname 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 Thêm máy chủ

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

  5. Chọn Streamable HTTP 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 sẽ 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 bổ sung.

    Xác thực HTTP Basic

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

Xử lý sự cố xác thực MCP

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

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

Honeydew Documentation MCP (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ột máy chủ tài liệu riêng. 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 Cài đặt -> Máy chủ MCP
  2. Trong Máy chủ tùy chỉnh, nhấp Thêm máy chủ
  3. Đặt tên máy chủ thành honeydew-docs
  4. Chọn Streamable HTTP làm loại truyền tải
  5. Đặt URL thành https://honeydew.ai/docs/mcp

Gỡ bỏ máy chủ MCP

Để gỡ bỏ 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 Gỡ bỏ

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

  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 Gỡ bỏ

Antigravity

#### Máy chủ MCP

Lưu ý

Nếu tổ chức của bạn dùng một hostname Honeydew tùy chỉnh, hãy thay https://mcp.honeydew.cloud/mcp bằng hostname của đối tượng thuê của bạn. Bạn có thể tìm hostname 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 điều khiển tác nhân

  3. Nhấp Quản lý máy chủ MCP

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

  5. Thêm nội dung 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

Honeydew Documentation MCP (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ột máy chủ tài liệu riêng. 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. Mở trình soạn thảo Antigravity
  2. Nhấp vào menu thả xuống ... ở đầu bảng điều khiển tác nhân
  3. Nhấp Quản lý máy chủ MCP
  4. Nhấp Xem cấu hình thô
  5. Thêm nội dung sau vào mcp_config.json: 
    {
  "name": "honeydew-docs",
  "type": "http",
  "url": "https://honeydew.ai/docs/mcp"
}
  6. Lưu tệp

Gỡ bỏ máy chủ MCP

Để gỡ bỏ 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 điều khiển tác nhân
  3. Nhấp Quản lý máy chủ MCP
  4. Nhấp 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

Lưu ý

Nếu tổ chức của bạn dùng một hostname Honeydew tùy chỉnh, hãy thay https://mcp.honeydew.cloud/mcp bằng hostname của đối tượng thuê của bạn. Bạn có thể tìm hostname 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 bạn muố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 ứng dụng khách đã đăng ký trước**: `No`
</Tab>

<Tab title="JSON configuration">
  Thêm nội dung 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 của bạn và đăng xuất trước:

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

Honeydew Documentation MCP (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ột máy chủ tài liệu riêng. 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.

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 nội dung 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>

Gỡ bỏ máy chủ MCP

Để gỡ bỏ máy chủ MCP Honeydew, hãy xóa mục honeydew khỏi tệp opencode.jsonc 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 đó.

Kiro

Kiro IDE và Kiro CLI dùng chung các tệp cấu hình MCP, vì vậy các bước bên dưới á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ả cá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.

Lưu ý

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

Thêm máy chủ MCP Honeydew vào một trong các tệp mcp.json này (không gian làm việc hoặc người dùng):

```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.
  Hãy mở nó trong trình duyệt của bạn để hoàn tất quy trình xác thực OAuth.
</Tab>

json theme={null} { "mcpServers": { "honeydew": { "url": "https://mcp.honeydew.cloud/mcp", "headers": { "Authorization": "Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET>" } } } }

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

Honeydew Documentation MCP (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ột máy chủ tài liệu riêng. 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 nội dung sau vào mcp.json của bạn:

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

Xóa máy chủ MCP

Để xóa máy chủ MCP Honeydew, hãy xóa mục honeydew khỏi mcp.json của bạn. Để xóa 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 [bộ kết nối MCP](https://docs.snowflake.com/en/user-guide/snowflake-cortex/cortex-agents-mcp-connectors), giúp các công cụ Honeydew có sẵn 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 mục tiêu

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

Lư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 đối tượng 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.

```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 cho cả tích hợp và máy chủ MCP
  cho bất kỳ vai trò nào cần truy cập 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` làm công cụ cho Cortex Agent
  hoặc đại lý Snowflake Intelligence.
  Người dùng được nhắc xác thực bằng OAuth với Honeydew khi sử dụng lần đầu.
</Step>

Lưu ý

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 không có xác thực. Quyền truy cập tài liệu có sẵn thông qua các công cụ tài liệu của máy chủ MCP Honeydew.

Xóa máy chủ MCP

Hãy xóa máy chủ MCP trước, sau đó xóa tích hợp API:

DROP MCP SERVER honeydew;
DROP INTEGRATION honeydew_mcp_integration;

Các máy khách khác

Bất kỳ máy khách tương thích MCP nào cũng có thể kết nối với Máy chủ MCP Honeydew bằng cách sử dụng giao thức truyền tải HTTP tiêu chuẩn.

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

Lư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 đối tượng 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.

```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 URL máy chủ, Xác thực, và Cấu hình để biết chi tiết về từng tham số.

Ví dụ về cách sử dụng

Sau khi kết nối, bạn có thể nhắc trợ lý AI của mình bằng các 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 miền nào được xác định trong mô hình?"
  • "Những bảng nào trong schema analytics?"
  • "Có bao nhiêu đơn hàng được đặt trong 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?"

Xử lý sự cố

Sự cố xác thực OAuth

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

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

Nhập /mcp, chọn Honeydew MCP từ danh sách, chọn "Xóa xác thực" hoặc "Xác thực", sau đó làm theo các bước OAuth trong 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 máy khách 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 URL khớp với tên máy chủ của đối tượng thuê bao xuất hiện trong Cài đặt > Máy chủ MCP trong Honeydew Studio.

Thiếu công cụ

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

Đầu ra vượt quá số 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ể không thành công với lỗi rằng đầu ra vượt quá số token tối đa cho phép. Các công cụ phân tích 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 Giới hạn đầu ra MCP và cảnh báo 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ợ Honeydew tại support@honeydew.ai.

Các 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.

Mẹo

Để chỉ hiển thị các công cụ chỉ đọc, hãy đặt tiêu đề 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 & Không gian làm việc

list_workspaces

chỉ đọc

Liệt kê tất cả các không gian làm việc có sẵn. Trả về tên không gian làm việc 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 không gian làm việc.

Tên của không gian làm việc.

get_session_workspace_and_branch

chỉ đọc

Lấy không gian làm việc và nhánh được đặt cho phiên hiện tại.

set_session_workspace_and_branch

chỉ đọc

Đặt không gian làm việc 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ử dụng không gian làm việc và nhánh này.

Tên của không gian làm việc. Nhánh để sử dụng.

create_workspace_branch

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

Tên của không gian làm việc để tạo nhánh. Tên của nhánh mới để tạo.

delete_workspace_branch

Xóa một nhánh khỏi không gian làm việc. Đây là thao tác phá hủy, không thể hoàn tác. Luôn xác nhận tên không gian làm việc 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 phiên hiện tại, phiên sẽ tự động chuyển sang prod.

Tên của không gian làm việc 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 yêu cầu kéo 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 yêu cầu kéo. Mô tả cho yêu cầu kéo.

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

initiate_analysis

chỉ đọc

Bắt đầu hoặc tiếp tục 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 Phân tích sâu để biết thêm chi tiết.

Câu hỏi ngôn ngữ tự nhiên để hỏi. Tên đại lý cho một cuộc trò chuyện mới. Bỏ qua cho các câu hỏi tiếp theo — đại lý được kế thừa từ cuộc trò chuyện hiện có. ID cuộc trò chuyện hiện có để tiếp tục, hoặc bỏ qua để bắt đầu một cuộc trò chuyện 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 trò chuyện được trả về bởi `initiate_analysis`. Số lượng thông báo tối đa để trả về cho 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 được sử dụng và dữ liệu được truy xuất trong bước đó.

ID cuộc trò chuyện đượ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ể tiếp tục từ điểm đã hủy bằng initiate_analysis.

ID cuộc trò chuyện được trả về bởi `initiate_analysis`.

list_analysis_chats

chỉ đọc

Trả về danh sách phân trang các cuộc trò chuyện phân tích cho không gian làm việc 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 trò chuyện; người không phải quản trị viên chỉ thấy cuộc trò chuyện của chính họ. Mỗi mục bao gồm ID cuộc trò chuyện, tiêu đề, phản hồi của người dùng, miền, đại lý, thời gian tạo và tên hiển thị của người dùng đã tạo.

Số lượng cuộc trò chuyện tối đa để trả về. Số lượng cuộc trò chuyện để bỏ qua cho phân trang.

provide_analysis_feedback

Đặt hoặc xóa phản hồi trên một cuộc trò chuyện phân tích cụ thể. Chỉ có một mục phản hồi cho mỗi cuộc trò chuyện (không phải cho mỗi câu hỏi) — phản hồi phải phản ánh chất lượng tổng thể của toàn bộ luồng cuộc trò chuyện.

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 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 các giá trị Chart Issue, Data Issue, Wrong Judgement hoặc Other.

ID cuộc trò chuyện của cuộc trò chuyện 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ả các thông báo từ một cuộc trò chuyện phân tích hiện có. Sử dụng công cụ này để 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ề các phản hồi cuối cùng và thông báo kế hoạch/giải thích.

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 với tên, mô tả và khóa của chúng.

get_entity

chỉ đọc

Lấy 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

Lấy 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 trường đó.

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 kèm tên, mô tả và các thực thể của chúng.

get_domain

chỉ đọc

Lấy 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 miề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 chuỗi truy vấn.

Sử dụng cú pháp entity.field để giới hạn phạm vi tìm kiếm trong các trường của 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, 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 khớp truy vấn:
  • 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 nguyên trạng, trả về các đối tượng có tên, tên hiển thị hoặc nhãn 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 đã 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ể của kho dữ liệu đã kết nối.

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

list_tables

chỉ đọc

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

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

get_table_info

chỉ đọc

Lấy thông tin chi tiết về một bảng/chế độ xem trong kho dữ liệu, bao gồm các cột và siêu dữ liệu.

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 đã 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 là thuộc tính.

Danh sách tên bảng đủ định danh 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ừ đị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ừ định nghĩa YAML. Các loại được hỗ trợ: thuộc tính tính toán, 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ừ định nghĩa YAML. Các loại được hỗ trợ: thực thể, thuộc tính tính toán, 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 đố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 tính toán, 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 đối chiếu.

delete_object

Xóa một đối tượng mô hình ngữ nghĩa theo 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 kèm tên, mô tả, miền và tham chiếu ngữ cảnh của chúng.

get_agent

chỉ đọc

Lấy 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 lấy.

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 hiển thị cho con người trong giao diện người dùng.
</ParamField>

<ParamField body="description" type="string" required>
  Mô tả 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">
  Thông điệp giới thiệu hiển thị khi người dùng bắt đầu phiên làm việc.
</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 phiên làm việc
  (ví dụ: `skills/**`, `knowledge/marketing/**`).
</ParamField>

<ParamField body="owner" type="string">
  Định danh chủ sở hữu của tác nhân.
</ParamField>
Nội dung Markdown được nối sau frontmatter. Văn bản này được chèn 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ậ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à thay thế toàn bộ, không phải cập nhật một phần. Nội dung Markdown 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 kèm loại, tên, tiêu đề và giá trị phân loại con của chúng.

get_context_item

chỉ đọc

Lấy một mục ngữ cảnh theo tên.

Tên của mục ngữ cảnh cần lấy.

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à ghi 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 các giá trị `knowledge`, `skill` hoặc `instruction`.
</ParamField>

<ParamField body="title" type="string" required>
  Tiêu đề hiển thị cho con người của mục ngữ cảnh.
</ParamField>

<ParamField body="apply" type="string" required>
  Thời điểm á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.
  Mỗi đối tượng có `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 phân loại con `knowledge`).
  Có `tool` (tên công cụ MCP), `resource_id` (định danh trong công cụ bên ngoài)
  và tùy chọn `cache_max_age_in_seconds` (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 các giá trị `event` hoặc `decision_trace`.
</ParamField>

<ParamField body="title" type="string" required>
  Tiêu đề hiển thị cho con người của mục ngữ cảnh.
</ParamField>

<ParamField body="apply" type="string" required>
  Thời điểm á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 ghi nhớ theo đị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 ghi nhớ theo đị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.
  Mỗi đối tượng có `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à tùy chọn `cache_max_age_in_seconds` (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ậ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à thay thế toàn bộ, không phải cập nhật một phần. Nội dung Markdown 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 đủ định danh (`entity.attribute_name`). Hỗ trợ bí danh: `entity.attribute_name as alias_name`. Tên chỉ số đủ định danh (`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, hãy 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 cho phân trang. Thêm một [báo cáo tiền tổng hợp](/docs/performance/aggregate-awareness#debugging-aggregate-matching) vào đầu SQL được trả về, nêu rõ cho mọi tiền tổng hợp trong không gian làm việc CTE nào đã sử dụng nó hoặc lý do tại sao nó không thể được sử dụng.

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, chỉ số và bộ lọc, và trả về dữ liệu kết quả.

Tên thuộc tính đủ định danh (`entity.attribute_name`). Hỗ trợ bí danh: `entity.attribute_name as alias_name`. Tên chỉ số đủ định danh (`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, hãy sắp xếp theo tên bí danh. Miền cần truy vấn. Số hàng tối đa được trả về. Số hàng cần bỏ qua để phân trang.

list_query_history

chỉ đọc

Liệt kê các truy vấn đã thực thi trước đó thông qua lớp ngữ nghĩa Honeydew, mới 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 tại sao chúng thất bại. Người gọi không phải quản trị viên chỉ thấy các 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 ban đầu (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à 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 của người dùng hoặc tên của khóa API). Chỉ được tôn trọng đối với 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 các 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 điểm này (ISO 8601). Chỉ các truy vấn được thực thi tại hoặc trước thời điểm 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, chỉ số, bộ lọc). Bậ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). Bật để gỡ lỗi phía kho dữ liệu của một truy vấn cụ thể. Số truy vấn tối đa được trả về. Số truy vấn cầ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 để biết thông tin liên quan, ví dụ mã, tham chiếu API và hướng dẫn. Trả về nội dung 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, hãy 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 cần chạy (ví dụ: `rg -il "keyword" /`, `tree / -L 2`, `head -80 /path/page.mdx`).

Câu hỏi thường gặp

Những công cụ nào cần thiết cho phân tích sâu?

Chạy Phân tích sâu yêu cầu:

Để xem lại các cuộc trò chuyện phân tích trước đây, cũng bật list_analysis_chats và get_stored_conversation.

Giới hạn tác nhân trong các công cụ này hữu ích khi:

  • Người dùng dự kiến của bạn chỉ chạy các quy trình phân tích sâu
  • Bạn muốn giữ tác nhân tập trung vào các nhiệm vụ phân tích
  • Máy khách của bạn giới hạn số lượng công cụ có thể bật (ví dụ: Databricks Genie Code)

Đối với các trường hợp sử dụng khác, hãy hiển thị nhiều công cụ hơn được liệt kê trong Công cụ khả dụng — tác nhân chọn công cụ phù hợp cho từng nhiệm vụ.