Honeydew Semantic Layer

resmi

Lapisan semantik Honeydew menyediakan model data yang terkelola dan ramah bisnis yang menyatukan metrik, dimensi, serta hubungan antar sumber, memungkinkan analitik layanan mandiri yang konsisten dan akses data bertenaga AI.

Lihat di honeydew.aiCoba MCP iniDisponsori

Apa yang bisa Anda lakukan dengan Honeydew Semantic Layer MCP?

  • Jelajahi metadata gudang data — Minta asisten Anda untuk menemukan tabel, skema, dan definisi model semantik di seluruh gudang data Anda.
  • Kelola model semantik — Bangun dan pelihara model semantik Anda melalui percakapan alami, termasuk membuat cabang workspace dengan create_workspace_branch.
  • Kueri data secara percakapan — Gunakan bahasa alami untuk mengkueri data Anda dari asisten mana pun yang kompatibel dengan MCP.
  • Konfigurasi konteks sesi — Tetapkan workspace dan cabang aktif Anda menggunakan set_session_workspace_and_branch setelah mencantumkan opsi yang tersedia dengan list_workspaces dan list_workspace_branches.
  • Akses dokumentasi Honeydew — Cari dan baca dokumentasi Honeydew secara langsung melalui alat dokumentasi bawaan server MCP.

Dokumentasi

Server MCP

Apa itu MCP?

Model Context Protocol (MCP) adalah standar sumber terbuka untuk menghubungkan aplikasi AI secara aman ke sistem dan alat eksternal. Honeydew menyediakan server MCP yang menghubungkan asisten coding AI Anda ke Honeydew Semantic Layer.

Kapan menggunakannya

  • Menemukan dan menjelajahi tabel warehouse, skema, dan definisi model semantik Anda
  • Membangun dan memelihara model semantik Anda melalui percakapan alami
  • Mengkueri data Anda dengan bahasa alami dari asisten yang kompatibel dengan MCP
  • Mencari dan membaca dokumentasi Honeydew

Instalasi

URL Server

Honeydew mengekspos API Server MCP di https://mcp.honeydew.cloud/mcp

Catatan

Jika organisasi Anda menggunakan hostname Honeydew kustom, ganti URL default dengan hostname tenant Anda. Anda dapat menemukan hostname tersebut di UI Honeydew di bawah Settings > MCP Server.

Autentikasi

Ada dua cara untuk melakukan autentikasi dengan Server MCP Honeydew: OAuth atau Autentikasi Dasar HTTP.

Autentikasi OAuth (disarankan)

Sebagian besar klien mendukung autentikasi OAuth. Saat pertama kali terhubung, Anda akan diminta untuk:

  1. Masuk dengan akun Honeydew Anda
  2. Menerima otorisasi OAuth

Klien kemudian secara aman menyediakan token akses untuk permintaan berikutnya.

Autentikasi Dasar HTTP

Server MCP dalam mode autentikasi dasar HTTP memerlukan API Key untuk autentikasi.

Anda perlu memberikan string yang dienkode Base64 dari API Key dan API Secret Anda dalam format API_KEY:API_SECRET.

Tip

Jika membuat API Key baru untuk akses Server MCP, Anda dapat menyalin string yang dienkode Base64 dari UI Honeydew Studio pada saat pembuatan.

Anda dapat menggunakan perintah berikut untuk menghasilkan string yang dienkode Base64:

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

Berikan string yang dienkode di header Authorization sebagai berikut:

Authorization: Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET>

Konfigurasi

Workspace dan branch diatur pada tingkat sesi menggunakan alat list_workspaces, list_workspace_branches dan set_session_workspace_and_branch. Anda juga dapat membuat branch baru dengan create_workspace_branch. Panggil alat-alat ini dari asisten AI Anda setelah terhubung ke server MCP.

Anda dapat secara opsional memberikan header berikut dalam konfigurasi server MCP Anda:

  • Workspace: Sematkan workspace untuk semua permintaan (opsional)
  • Branch: Sematkan branch workspace tertentu untuk semua permintaan (opsional, default ke prod jika workspace diatur)
  • Honeydew-Client: Identifikasi klien MCP (opsional, terdeteksi otomatis dari alat yang terhubung). Berikan header ini untuk memberikan pengidentifikasi klien tertentu.
  • ReadonlyToolsOnly: Atur ke true untuk hanya mengekspos alat hanya-baca (opsional)

Catatan

Server MCP menggunakan header respons Mcp-Session-Id untuk mempertahankan status sesi, termasuk workspace dan branch aktif. Lihat spesifikasi manajemen sesi MCP untuk detailnya.

Klien yang Didukung

Claude Code CLI

#### Instalasi Plugin

Catatan

Memerlukan Git. Menginstal plugin dari GitHub mengkloning repositori secara lokal, jadi Git harus diinstal dan ada di PATH Anda. Jika Git tidak ada, instalasi plugin gagal. Instal Git, atau gunakan langkah pengaturan MCP manual klien Anda untuk mengonfigurasi server secara langsung alih-alih plugin.

Honeydew menyediakan repositori plugin dengan keterampilan dan alat untuk membangun model semantik dan menganalisis data melalui percakapan alami. Menginstal plugin akan menyiapkan server MCP Honeydew secara otomatis.

Luncurkan Claude Code dengan claude, lalu tambahkan marketplace:

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

Kemudian instal plugin Honeydew dari marketplace:

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

Kemudian muat ulang plugin untuk mengaktifkan:

/reload-plugins

Memperbarui plugin

Untuk memperbarui plugin marketplace Honeydew, luncurkan Claude Code dengan claude, lalu:

  1. Tulis /plugin dan pilih Marketplaces di pemilih di bagian atas
  2. Pilih honeydew-ai-coding-agents-plugins
  3. Klik Update marketplace

Untuk menerima pembaruan secara otomatis, pilih Enable auto-update di pengaturan marketplace.

Pengaturan MCP

Gunakan bagian ini jika organisasi Anda menggunakan endpoint Honeydew kustom, atau jika Anda lebih suka mengonfigurasi server MCP tanpa menginstal plugin. Nonaktifkan koneksi MCP Honeydew yang ditambahkan oleh plugin, lalu tambahkan endpoint kustom Anda menggunakan instruksi di bawah ini.

Server MCP Honeydew menghubungkan Claude Code ke Honeydew Semantic Layer untuk eksplorasi model, kueri data, manajemen model, dan akses dokumentasi.

Gunakan salah satu metode berikut untuk menambahkan server MCP Honeydew:

Catatan

Jika organisasi Anda menggunakan hostname Honeydew kustom, ganti https://mcp.honeydew.cloud/mcp dengan hostname tenant Anda. Anda dapat menemukan hostname tersebut di Settings > MCP Server di Honeydew Studio.

```bash theme={null} claude mcp add --transport http honeydew \ https://mcp.honeydew.cloud/mcp ``` 
      Luncurkan Claude Code dengan `claude`.
      Anda akan diminta untuk melakukan autentikasi dengan OAuth ke 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">
  Simpan berikut ke `honeydew-mcp.json`:

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

      Kemudian daftarkan dengan:

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

      Luncurkan Claude Code dengan `claude`.
      Anda akan diminta untuk melakukan autentikasi dengan OAuth ke 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>"
        }
      }
      ```

      Kemudian daftarkan dengan:

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

<Tab title=".mcp.json">
  Tambahkan berikut ke file `.mcp.json` Anda:

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

      Luncurkan Claude Code dengan `claude`.
      Anda akan diminta untuk melakukan autentikasi dengan OAuth ke 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>

Tip

Menggunakan variabel lingkungan untuk autentikasi API Key

Untuk menghindari penyimpanan nilai sensitif langsung di file konfigurasi, Claude Code mendukung ekspansi variabel lingkungan menggunakan sintaks ${VAR_NAME}.

Atur variabel lingkungan HONEYDEW_API_KEY, lalu referensikan dalam konfigurasi Anda:

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

Claude Code menyelesaikan referensi ${VAR_NAME} saat runtime dari lingkungan Anda.

MCP Dokumentasi Honeydew (opsional)

Server MCP Honeydew sudah menyertakan alat akses dokumentasi, jadi server dokumentasi terpisah tidak diperlukan. Tambahkan MCP Dokumentasi Honeydew hanya jika Anda ingin akses dokumentasi tanpa terhubung ke Honeydew. Tidak diperlukan autentikasi.

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

Menghapus server MCP

Untuk menghapus server MCP Honeydew:

claude mcp remove honeydew

Untuk menghapus server MCP Dokumentasi Honeydew:

claude mcp remove honeydew-docs

Claude Desktop

#### Instalasi Plugin

Catatan

Memerlukan Git. Menginstal plugin dari GitHub mengkloning repositori secara lokal, jadi Git harus diinstal dan ada di PATH Anda. Jika Git tidak ada, instalasi plugin gagal. Instal Git, atau gunakan langkah pengaturan MCP manual klien Anda untuk mengonfigurasi server secara langsung alih-alih plugin.

Honeydew menyediakan repositori plugin dengan keterampilan dan alat untuk membangun model semantik dan menganalisis data melalui percakapan alami. Menginstal plugin akan menyiapkan server MCP Honeydew secara otomatis.

  1. Buka Settings -> Customize
  2. Klik Browse Plugins
  3. Buka tab Personal
  4. Klik ikon + dan pilih Add marketplace from GitHub
  5. Masukkan honeydew-ai/honeydew-ai-coding-agents-plugins di kotak input
  6. Plugin Honeydew AI muncul. Instal.

Pengaturan MCP

Gunakan bagian ini jika organisasi Anda menggunakan endpoint Honeydew kustom, atau jika Anda lebih suka mengonfigurasi server MCP tanpa menginstal plugin. Nonaktifkan koneksi MCP Honeydew yang ditambahkan oleh plugin, lalu tambahkan endpoint kustom Anda menggunakan instruksi di bawah ini.

Server MCP Honeydew menghubungkan Claude Desktop ke Honeydew Semantic Layer untuk eksplorasi model, kueri data, manajemen model, dan akses dokumentasi.

Mode Claude Code

Saat menggunakan Claude Desktop dalam mode Claude Code, ikuti instruksi Claude Code CLI sebagai gantinya.

Catatan

Jika organisasi Anda menggunakan hostname Honeydew kustom, ganti https://mcp.honeydew.cloud/mcp dengan hostname tenant Anda. Anda dapat menemukan hostname tersebut di Settings > MCP Server di Honeydew Studio.

Untuk menambahkan MCP Honeydew dalam mode Cowork:

  1. Buka Settings -> Connectors -> Add custom connector
  2. Masukkan honeydew di kolom Name
  3. Masukkan https://mcp.honeydew.cloud/mcp di kolom Remote MCP server URL
  4. Klik Add

Anda akan diminta untuk melakukan autentikasi dengan OAuth ke Honeydew saat pertama kali terhubung.

MCP Dokumentasi Honeydew (opsional)

Server MCP Honeydew sudah menyertakan alat akses dokumentasi, jadi server dokumentasi terpisah tidak diperlukan. Tambahkan MCP Dokumentasi Honeydew hanya jika Anda ingin akses dokumentasi tanpa terhubung ke Honeydew. Tidak diperlukan autentikasi.

  1. Buka Settings -> Connectors -> Add custom connector
  2. Masukkan honeydew-docs di kolom Name
  3. Masukkan https://honeydew.ai/docs/mcp di kolom Remote MCP server URL
  4. Klik Add

Menghapus server MCP

Untuk menghapus server MCP Honeydew dalam mode Cowork:

  1. Buka Settings -> Connectors
  2. Temukan konektor honeydew dan klik ikon hapus

Untuk menghapus server MCP Dokumentasi Honeydew:

  1. Buka Settings -> Connectors
  2. Temukan konektor honeydew-docs dan klik ikon hapus

Claude.ai

#### Instalasi Plugin

Honeydew menyediakan repositori plugin dengan keterampilan dan alat untuk membangun model semantik dan menganalisis data melalui percakapan alami. Menginstal plugin akan menyiapkan server MCP Honeydew dan server MCP Dokumentasi Honeydew secara otomatis.

  1. Unduh zip plugin: honeydew-ai-claude.zip
  2. Di Claude.ai, buka Settings -> Plugins -> Add plugin -> Upload zip
  3. Unggah zip — plugin muncul di marketplace pribadi Anda

Pengaturan MCP

Gunakan bagian ini jika organisasi Anda menggunakan endpoint Honeydew kustom, atau jika Anda lebih suka mengonfigurasi server MCP tanpa menginstal plugin. Hapus konektor MCP Honeydew yang ditambahkan oleh plugin, lalu tambahkan endpoint kustom Anda menggunakan instruksi di bawah ini.

Server MCP Honeydew menghubungkan Claude.ai ke Honeydew Semantic Layer untuk eksplorasi model, kueri data, manajemen model, dan akses dokumentasi.

Catatan

Jika organisasi Anda menggunakan hostname Honeydew kustom, ganti https://mcp.honeydew.cloud/mcp dengan hostname tenant Anda. Anda dapat menemukan hostname tersebut di Settings > MCP Server di Honeydew Studio.

Untuk menambahkan server MCP Honeydew:

  1. Buka Settings -> Connectors -> Add custom connector
  2. Masukkan honeydew pada kolom Name
  3. Masukkan https://mcp.honeydew.cloud/mcp pada kolom Remote MCP server URL
  4. Klik Add

Anda akan diminta untuk melakukan autentikasi dengan OAuth ke Honeydew saat pertama kali terhubung.

Honeydew Documentation MCP (opsional)

Server MCP Honeydew sudah menyertakan alat akses dokumentasi, sehingga server dokumentasi terpisah tidak diperlukan. Tambahkan Honeydew Documentation MCP hanya jika Anda menginginkan akses dokumentasi tanpa terhubung ke Honeydew. Tidak diperlukan autentikasi.

  1. Buka Settings -> Connectors -> Add custom connector
  2. Masukkan honeydew-docs pada kolom Name
  3. Masukkan https://honeydew.ai/docs/mcp pada kolom Remote MCP server URL
  4. Klik Add

Menghapus server MCP

Untuk menghapus server MCP Honeydew:

  1. Buka Settings -> Connectors
  2. Temukan konektor honeydew dan klik ikon hapus

Untuk menghapus server MCP Honeydew Documentation:

  1. Buka Settings -> Connectors
  2. Temukan konektor honeydew-docs dan klik ikon hapus

Cortex Code CLI

#### Instalasi Plugin

Catatan

Memerlukan Git. Menginstal plugin dari GitHub akan mengkloning repositori secara lokal, sehingga Git harus diinstal dan tersedia di PATH Anda. Jika Git tidak ada, instalasi plugin akan gagal. Instal Git, atau gunakan langkah pengaturan MCP manual klien Anda untuk mengonfigurasi server secara langsung alih-alih menggunakan plugin.

Honeydew menyediakan repositori plugin dengan keterampilan dan alat untuk membangun model semantik dan menganalisis data melalui percakapan alami. Menginstal plugin akan menyiapkan server MCP Honeydew secara otomatis.

Luncurkan Cortex Code CLI dengan cortex, lalu instal plugin:

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

Pengaturan MCP

Gunakan bagian ini jika organisasi Anda menggunakan endpoint Honeydew kustom, atau jika Anda lebih suka mengonfigurasi server MCP tanpa menginstal plugin. Nonaktifkan koneksi MCP Honeydew yang ditambahkan oleh plugin, lalu tambahkan endpoint kustom Anda menggunakan petunjuk di bawah ini.

Server MCP Honeydew menghubungkan Cortex Code CLI ke Honeydew Semantic Layer untuk eksplorasi model, kueri data, pengelolaan model, dan akses dokumentasi.

Catatan

Jika organisasi Anda menggunakan hostname Honeydew kustom, ganti https://mcp.honeydew.cloud/mcp dengan hostname tenant Anda. Anda dapat menemukan hostname di Settings > MCP Server di Honeydew Studio.

```bash theme={null} cortex mcp add honeydew \ https://mcp.honeydew.cloud/mcp \ --type http ``` 
      Luncurkan Cortex Code CLI dengan `cortex`.
      Anda akan diminta untuk melakukan autentikasi
      dengan OAuth ke 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">
  Simpan berikut ke `honeydew-mcp.json`:

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

      Kemudian daftarkan dengan:

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

      Luncurkan Cortex Code CLI dengan `cortex`.
      Anda akan diminta untuk melakukan autentikasi
      dengan OAuth ke 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>"
        }
      }
      ```

      Kemudian daftarkan dengan:

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

<Tab title="mcp.json">
  Tambahkan berikut ke
  `~/.snowflake/cortex/mcp.json`:

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

      Luncurkan Cortex Code CLI dengan `cortex`.
      Anda akan diminta untuk melakukan autentikasi
      dengan OAuth ke 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 (opsional)

Server MCP Honeydew sudah menyertakan alat akses dokumentasi, sehingga server dokumentasi terpisah tidak diperlukan. Tambahkan Honeydew Documentation MCP hanya jika Anda menginginkan akses dokumentasi tanpa terhubung ke Honeydew. Tidak diperlukan autentikasi.

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

Menghapus server MCP

Untuk menghapus server MCP Honeydew:

cortex mcp remove honeydew

Untuk menghapus server MCP Honeydew Documentation:

cortex mcp remove honeydew-docs

Cortex Code Desktop

#### Instalasi Plugin

Catatan

Memerlukan Git. Menginstal plugin dari GitHub akan mengkloning repositori secara lokal, sehingga Git harus diinstal dan tersedia di PATH Anda. Jika Git tidak ada, instalasi plugin akan gagal. Instal Git, atau gunakan langkah pengaturan MCP manual klien Anda untuk mengonfigurasi server secara langsung alih-alih menggunakan plugin.

Honeydew menyediakan repositori plugin dengan keterampilan dan alat untuk membangun model semantik dan menganalisis data melalui percakapan alami. Menginstal plugin akan menyiapkan server MCP Honeydew secara otomatis.

  1. Buka Settings -> Plugins
  2. Klik Add Plugin, pilih Add from GitHub, dan tempel repositori plugin Honeydew: honeydew-ai/honeydew-ai-coding-agents-plugins
  3. Ikuti alurnya dan setujui langkah-langkah di GitHub Plugin Installer Setup

Pengaturan MCP

Gunakan bagian ini jika organisasi Anda menggunakan endpoint Honeydew kustom, atau jika Anda lebih suka mengonfigurasi server MCP tanpa menginstal plugin. Nonaktifkan koneksi MCP Honeydew yang ditambahkan oleh plugin, lalu tambahkan endpoint kustom Anda menggunakan petunjuk di bawah ini.

Server MCP Honeydew menghubungkan Cortex Code Desktop ke Honeydew Semantic Layer untuk eksplorasi model, kueri data, pengelolaan model, dan akses dokumentasi.

Untuk menambahkan server, buka MCP -> New, pilih Configuration Scope (misalnya, ~/.snowflake/cortex/mcp.json untuk Global), isi formulir, lalu klik Save. Gunakan tab Form atau JSON untuk memasukkan konfigurasi.

Catatan

Jika organisasi Anda menggunakan hostname Honeydew kustom, ganti https://mcp.honeydew.cloud/mcp dengan hostname tenant Anda. Anda dapat menemukan hostname di Settings > MCP Server di Honeydew Studio.

Tambahkan server Honeydew MCP:

1. **Server Name**: `honeydew` 2. **Server Type**: **Remote (HTTP)** 3. **Server URL**: `https://mcp.honeydew.cloud/mcp` 4. Klik **Save** 
      Anda akan diminta untuk melakukan autentikasi dengan OAuth ke Honeydew
      saat pertama kali terhubung.
    </Tab>

    <Tab title="API Key">
      1. **Server Name**: `honeydew`
      2. **Server Type**: **Remote (HTTP)**
      3. **Server URL**: `https://mcp.honeydew.cloud/mcp`
      4. Di bawah **Headers**, klik **Add Header** dan atur nama menjadi
         `Authorization` dan nilainya menjadi
         `Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET>`
      5. Klik **Save**
    </Tab>
  </Tabs>
</Tab>

<Tab title="JSON">
  Beralih ke tab **JSON** dan tempel konfigurasi:

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

      Anda akan diminta untuk melakukan autentikasi dengan OAuth ke Honeydew
      saat pertama kali terhubung.
    </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 (opsional)

Server MCP Honeydew sudah menyertakan alat akses dokumentasi, sehingga server dokumentasi terpisah tidak diperlukan. Jika Anda menginginkan akses dokumentasi tanpa terhubung ke Honeydew, tambahkan server Honeydew Documentation MCP dengan cara yang sama, menggunakan Server Name honeydew-docs, Server Type Remote (HTTP), dan Server URL https://honeydew.ai/docs/mcp. Tidak diperlukan autentikasi.

Menghapus server MCP

Untuk menghapus server, buka MCP, temukan server honeydew (atau honeydew-docs), dan hapus.

Cursor

#### Instalasi Plugin

Honeydew menyediakan repositori plugin dengan keterampilan dan alat untuk membangun model semantik dan menganalisis data melalui percakapan alami. Menginstal plugin akan menyiapkan server MCP Honeydew secara otomatis.

  1. Di pengaturan tim atau organisasi Anda, buka cursor.com/dashboard/plugins (atau klik Plugins di menu sisi kiri)
  2. Gulir ke bawah ke Team Marketplaces dan klik Marketplace yang ada, atau klik Add Marketplace untuk membuat yang baru. Jika membuat yang baru, masukkan nama dan buat.
  3. Di dalam Marketplace, klik Add Plugin, tempel jalur repositori plugin GitHub Honeydew: https://github.com/honeydew-ai/honeydew-ai-coding-agents-plugins dan klik Add 1 plugin
  4. Opsional, aktifkan auto-refresh di halaman Marketplace agar plugin diperbarui secara otomatis saat versi baru dirilis.
  5. Kembali ke halaman plugin (cursor.com/dashboard/plugins), cari plugin Honeydew, dan klik Add

Pengaturan MCP

Gunakan bagian ini jika organisasi Anda menggunakan endpoint Honeydew kustom, atau jika Anda lebih suka mengonfigurasi server MCP tanpa menginstal plugin. Nonaktifkan koneksi MCP Honeydew yang ditambahkan oleh plugin, lalu tambahkan endpoint kustom Anda menggunakan petunjuk di bawah ini.

Server MCP Honeydew menghubungkan Cursor ke Honeydew Semantic Layer untuk eksplorasi model, kueri data, pengelolaan model, dan akses dokumentasi.

Catatan

Jika organisasi Anda menggunakan hostname Honeydew kustom, ganti https://mcp.honeydew.cloud/mcp dengan hostname tenant Anda. Anda dapat menemukan hostname di Settings > MCP Server di Honeydew Studio.

Untuk menambahkan Honeydew MCP:

  1. Buka aplikasi Cursor

  2. Buka Settings -> Cursor Settings -> Tools & MCP

  3. Klik New MCP Server

  4. Tambahkan konfigurasi berikut:

    ```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. Klik Save

Honeydew Documentation MCP (opsional)

Server MCP Honeydew sudah menyertakan alat akses dokumentasi, sehingga server dokumentasi terpisah tidak diperlukan. Tambahkan Honeydew Documentation MCP hanya jika Anda menginginkan akses dokumentasi tanpa terhubung ke Honeydew. Tidak diperlukan autentikasi.

  1. Buka Settings -> Cursor Settings -> Tools & MCP
  2. Klik New MCP Server
  3. Tambahkan konfigurasi berikut: 
    {
  "name": "honeydew-docs",
  "type": "http",
  "url": "https://honeydew.ai/docs/mcp"
}
  4. Klik Save

Menghapus server MCP

Untuk menghapus server MCP Honeydew:

  1. Buka Settings -> Cursor Settings -> Tools & MCP
  2. Temukan honeydew dalam daftar dan klik ikon hapus

Untuk menghapus server MCP Honeydew Documentation:

  1. Buka Settings -> Cursor Settings -> Tools & MCP
  2. Temukan honeydew-docs dalam daftar dan klik ikon hapus

Databricks Genie Code

> **Catatan** > > Server MCP hanya didukung dalam mode Genie Code Agent. > Untuk detail lebih lanjut, lihat > [dokumentasi MCP Databricks](https://docs.databricks.com/aws/en/generative-ai/mcp/).

Prasyarat:

  • Genie Code diaktifkan di workspace Databricks Anda
  • Hak istimewa CREATE CONNECTION pada metastore Unity Catalog
1. Navigasi ke **Catalog** → **Connections** → **Create a connection** 2. Pada layar **Connection basics**: * Atur **Connection name** menjadi `honeydew-mcp` * Atur **Connection type** menjadi **HTTP** * Atur **Auth type** menjadi **Dynamic Client Registration** * Klik **Next** 3. Pada layar **Authentication**: * Atur **Host** menjadi `https://mcp.honeydew.cloud` * Biarkan **Port** sebagai `443` * Atur **OAuth scope** menjadi `openid` * Klik **Next** 4. Pada layar **Connection details**: * Centang **Is MCP connection** * Atur **Base path** menjadi `/mcp` * Klik **Create connection** 
    <Tab title="SQL">
      Jalankan SQL berikut di notebook Databricks atau editor 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>

Catatan

Jika organisasi Anda menggunakan hostname Honeydew kustom, ganti https://mcp.honeydew.cloud dengan hostname tenant Anda. Anda dapat menemukan hostname di Settings > MCP Server di Honeydew Studio. 

<Step title="Log in to the connection">
  Navigasi ke **Catalog** → **Connections** → `honeydew-mcp`
  dan klik **Login** di pojok kanan atas
  untuk mengautentikasi dan memverifikasi koneksi.
</Step>

<Step title="Grant connection access">
  Berikan hak akses `USE CONNECTION` kepada pengguna atau peran mana pun
  yang membutuhkan akses ke server 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. Buka Genie Code dan klik ikon roda gigi
  2. Navigasi ke **MCP Servers** → **Add Server**
  3. Pilih **External MCP server**
  4. Pilih koneksi `honeydew-mcp` yang Anda buat
  5. Masuk ke koneksi saat diminta
  6. Klik **Save**

Catatan

Databricks membatasi MCP hingga 20 alat di semua server yang dikonfigurasi. Jika Anda perlu menyesuaikan alat Honeydew mana yang tersedia, gunakan pengaturan MCP Genie Code untuk mengaktifkan atau menonaktifkan alat tertentu.

Menghapus server MCP

Untuk menghapus server MCP Honeydew dari Genie Code:

  1. Buka Genie Code dan klik ikon roda gigi
  2. Navigasi ke MCP Servers
  3. Temukan honeydew-mcp dan klik Remove

Untuk juga menghapus koneksi Unity Catalog yang mendasarinya, jalankan SQL berikut:

DROP CONNECTION `honeydew-mcp`;

Devin

#### MCP Server

Devin terhubung ke server MCP jarak jauh melalui MCP Marketplace.

Catatan

Jika organisasi Anda menggunakan hostname Honeydew kustom, ganti https://mcp.honeydew.cloud/mcp dengan hostname tenant Anda. Anda dapat menemukan hostname di Settings > MCP Server di Honeydew Studio.

Untuk menambahkan server MCP Honeydew:

  1. Buka Settings -> Connections -> MCP servers

  2. Klik Add a custom MCP

  3. Masukkan honeydew di kolom Server Name

  4. Opsional: tambahkan ikon dan Short Description

  5. Pilih HTTP sebagai jenis transportasi

  6. Masukkan https://mcp.honeydew.cloud/mcp di kolom Server URL

  7. Konfigurasi autentikasi:

    Pilih **OAuth** sebagai metode autentikasi. Devin akan meminta Anda untuk mengautentikasi dengan Honeydew selama sesi pertama. 
    <Tab title="API Key">
  Pilih **Auth Header** sebagai metode autentikasi.
  Biarkan kunci header sebagai `Authorization` dan atur nilainya menjadi
  `Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET>`
  (lihat [Authentication](#authentication)).
</Tab>

  8. Klik Save, lalu klik Test listing tools untuk memverifikasi koneksi

Honeydew Documentation MCP (opsional)

Server MCP Honeydew sudah menyertakan alat akses dokumentasi, jadi server dokumentasi terpisah tidak diperlukan. Tambahkan Honeydew Documentation MCP hanya jika Anda menginginkan akses dokumentasi tanpa terhubung ke Honeydew. Tidak diperlukan autentikasi.

  1. Buka Settings -> Connections -> MCP servers
  2. Klik Add a custom MCP
  3. Masukkan honeydew-docs di kolom Server Name
  4. Pilih HTTP sebagai jenis transportasi
  5. Masukkan https://honeydew.ai/docs/mcp di kolom Server URL
  6. Atur metode autentikasi menjadi None
  7. Klik Save

Menghapus server MCP

Untuk menghapus server MCP Honeydew:

  1. Buka Settings -> Connections -> MCP servers
  2. Temukan server honeydew dan hapus

Untuk menghapus server Honeydew Documentation MCP:

  1. Buka Settings -> Connections -> MCP servers
  2. Temukan server honeydew-docs dan hapus

GitHub Copilot CLI

#### MCP Server

Catatan

Jika organisasi Anda menggunakan hostname Honeydew kustom, ganti https://mcp.honeydew.cloud/mcp dengan hostname tenant Anda. Anda dapat menemukan hostname di Settings > MCP Server di Honeydew Studio.

  1. Luncurkan GitHub Copilot CLI dengan copilot

  2. Ketik /mcp add untuk membuka formulir konfigurasi server

  3. Isi kolom berikut:

    • Name: honeydew

    • Type: http

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

    • HTTP Headers:

      Tidak diperlukan header tambahan untuk OAuth. ```json theme={null} { "Authorization": "Basic " } ```

  4. Tekan Ctrl+S untuk menyimpan

Gunakan /mcp show untuk memverifikasi bahwa server terhubung.

Plugin Agen Pengkodean AI

Catatan

Memerlukan Git. Menginstal plugin dari GitHub mengkloning repositori secara lokal, jadi Git harus diinstal dan berada di PATH Anda. Jika Git tidak ada, instalasi plugin gagal. Instal Git, atau gunakan langkah pengaturan MCP manual klien Anda untuk mengonfigurasi server secara langsung alih-alih menggunakan plugin.

Honeydew menyediakan repositori plugin dengan keterampilan dan alat untuk membangun model semantik dan menganalisis data melalui percakapan alami.

Tambahkan marketplace ke Copilot CLI:

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

Kemudian instal plugin Honeydew dari marketplace:

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

Honeydew Documentation MCP (opsional)

Server MCP Honeydew sudah menyertakan alat akses dokumentasi, jadi server dokumentasi terpisah tidak diperlukan. Tambahkan Honeydew Documentation MCP hanya jika Anda menginginkan akses dokumentasi tanpa terhubung ke Honeydew. Tidak diperlukan autentikasi.

  1. Luncurkan GitHub Copilot CLI dengan copilot
  2. Ketik /mcp add untuk membuka formulir konfigurasi server
  3. Isi kolom berikut:
    • Name: honeydew-docs
    • Type: http
    • URL: https://honeydew.ai/docs/mcp
  4. Tekan Ctrl+S untuk menyimpan

Menghapus server MCP

Untuk menghapus server MCP Honeydew, luncurkan GitHub Copilot CLI dengan copilot, lalu ketik:

/mcp remove honeydew

Untuk menghapus server Honeydew Documentation MCP:

/mcp remove honeydew-docs

Gemini CLI

#### Instalasi Ekstensi

Catatan

Memerlukan Git. Menginstal plugin dari GitHub mengkloning repositori secara lokal, jadi Git harus diinstal dan berada di PATH Anda. Jika Git tidak ada, instalasi plugin gagal. Instal Git, atau gunakan langkah pengaturan MCP manual klien Anda untuk mengonfigurasi server secara langsung alih-alih menggunakan plugin.

Honeydew menyediakan repositori plugin dengan keterampilan dan alat untuk membangun model semantik dan menganalisis data melalui percakapan alami. Menginstal ekstensi akan menyiapkan server MCP Honeydew secara otomatis.

Jalankan perintah berikut untuk menginstal ekstensi Honeydew:

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

Bendera --auto-update menjaga ekstensi tetap diperbarui secara otomatis.

Pengaturan MCP

Gunakan bagian ini jika organisasi Anda menggunakan endpoint Honeydew kustom, atau jika Anda lebih suka mengonfigurasi server MCP tanpa menginstal ekstensi. Nonaktifkan koneksi MCP Honeydew yang ditambahkan oleh ekstensi, lalu tambahkan endpoint kustom Anda menggunakan instruksi di bawah ini.

Server MCP Honeydew menghubungkan Gemini CLI ke Honeydew Semantic Layer untuk eksplorasi model, kueri data, manajemen model, dan akses dokumentasi.

Catatan

Jika organisasi Anda menggunakan hostname Honeydew kustom, ganti https://mcp.honeydew.cloud/mcp dengan hostname tenant Anda. Anda dapat menemukan hostname di Settings > MCP Server di Honeydew Studio.

Jalankan perintah berikut untuk menambahkan server MCP Honeydew:

```bash theme={null} gemini mcp add --transport http honeydew \ https://mcp.honeydew.cloud/mcp ``` 
  Luncurkan Gemini CLI dengan `gemini`.
  Anda akan diminta untuk mengautentikasi dengan OAuth ke 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 (opsional)

Server MCP Honeydew sudah menyertakan alat akses dokumentasi, jadi server dokumentasi terpisah tidak diperlukan. Tambahkan Honeydew Documentation MCP hanya jika Anda menginginkan akses dokumentasi tanpa terhubung ke Honeydew. Tidak diperlukan autentikasi.

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

Menghapus server MCP

Untuk menghapus server MCP Honeydew:

gemini mcp remove honeydew

Untuk menghapus server Honeydew Documentation MCP:

gemini mcp remove honeydew-docs

VS Code dan GitHub Copilot

#### Instalasi Plugin

Honeydew menyediakan repositori plugin dengan keterampilan dan alat untuk membangun model semantik dan menganalisis data melalui percakapan alami. Menginstal plugin akan menyiapkan server MCP Honeydew secara otomatis.

Tambahkan marketplace Honeydew

  1. Buka settings.json VS Code Anda (buka Command Palette dengan CMD+Shift+P di macOS atau Ctrl+Shift+P di Windows/Linux, lalu pilih Preferences: Open User Settings (JSON))
  2. Tambahkan marketplace Honeydew ke pengaturan chat.plugins.marketplaces: 
    "chat.plugins.marketplaces": [
  "honeydew-ai/honeydew-ai-coding-agents-plugins"
]

Instal plugin

  1. Buka tampilan Extensions (CMD+Shift+X di macOS atau Ctrl+Shift+X di Windows/Linux)
  2. Masukkan @agentPlugins di kolom pencarian
  3. Temukan plugin Honeydew AI dan klik Install

Saat pertama kali Anda menginstal plugin dari marketplace baru, VS Code menampilkan prompt kepercayaan — tinjau sumber marketplace sebelum mengonfirmasi.

Perbarui plugin

Jika extensions.autoUpdate diaktifkan di pengaturan VS Code, plugin diperbarui secara otomatis. Untuk memperbarui secara manual, buka Command Palette dan jalankan Extensions: Check for Extension Updates.

MCP Server

Gunakan bagian ini jika organisasi Anda menggunakan endpoint Honeydew kustom, atau jika Anda lebih suka mengonfigurasi server MCP tanpa menginstal plugin. Nonaktifkan koneksi MCP Honeydew yang ditambahkan oleh plugin, lalu tambahkan endpoint kustom Anda menggunakan instruksi di bawah ini.

Server MCP Honeydew menghubungkan VS Code ke Honeydew Semantic Layer untuk eksplorasi model, kueri data, manajemen model, dan akses dokumentasi.

Catatan

Jika organisasi Anda menggunakan hostname Honeydew kustom, ganti https://mcp.honeydew.cloud/mcp dengan hostname tenant Anda. Anda dapat menemukan hostname di Settings > MCP Server di Honeydew Studio.

  1. Buka Command Palette dengan CMD+Shift+P (macOS) atau Ctrl+Shift+P (Windows/Linux)
  2. Pilih MCP: Add Server...
  3. Pilih HTTP (HTTP or Server-Sent Events)
  4. Masukkan URL server MCP Honeydew: https://mcp.honeydew.cloud/mcp
  5. Masukkan honeydew sebagai nama server

Ini menambahkan server ke file .vscode/mcp.json Anda. Buka file dan tambahkan header sesuai kebutuhan:

```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 (opsional)

Server MCP Honeydew sudah menyertakan alat akses dokumentasi, sehingga server dokumentasi terpisah tidak diperlukan. Tambahkan Honeydew Documentation MCP hanya jika Anda ingin akses dokumentasi tanpa terhubung ke Honeydew. Tidak diperlukan autentikasi.

Tambahkan berikut ini ke .vscode/mcp.json Anda:

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

Menghapus server MCP

Untuk menghapus server MCP Honeydew, buka .vscode/mcp.json dan hapus entri honeydew dari objek servers. Untuk menghapus server Honeydew Documentation MCP, hapus entri honeydew-docs dari file yang sama.

Codex CLI

#### Instalasi Plugin

Catatan

Memerlukan Git. Menginstal plugin dari GitHub mengkloning repositori secara lokal, jadi Git harus diinstal dan tersedia di PATH Anda. Jika Git tidak ada, instalasi plugin akan gagal. Instal Git, atau gunakan langkah pengaturan MCP manual klien Anda untuk mengonfigurasi server secara langsung alih-alih menggunakan plugin.

Honeydew menyediakan repositori plugin dengan keterampilan dan alat untuk membangun model semantik dan menganalisis data melalui percakapan alami. Menginstal plugin akan menyiapkan server MCP Honeydew secara otomatis.

Tambahkan marketplace ke Codex:

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

Kemudian luncurkan Codex dengan codex dan ketik /plugins untuk menjelajah dan menginstal plugin Honeydew AI.

Memperbarui plugin

Untuk memperbarui marketplace Honeydew, jalankan:

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

Kemudian luncurkan Codex dan ketik /plugins untuk menerapkan pembaruan.

Pengaturan MCP

Gunakan bagian ini jika organisasi Anda menggunakan endpoint Honeydew kustom, atau jika Anda lebih suka mengonfigurasi server MCP tanpa menginstal plugin. Nonaktifkan koneksi MCP Honeydew yang ditambahkan oleh plugin, lalu tambahkan endpoint kustom Anda menggunakan petunjuk di bawah ini.

Server MCP Honeydew menghubungkan Codex ke Honeydew Semantic Layer untuk eksplorasi model, kueri data, manajemen model, dan akses dokumentasi.

Catatan

Jika organisasi Anda menggunakan hostname Honeydew kustom, ganti https://mcp.honeydew.cloud/mcp dengan hostname tenant Anda. Anda dapat menemukan hostname di Settings > MCP Server di Honeydew Studio.

Baris perintah

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

Kemudian luncurkan Codex dengan codex. Anda akan diminta untuk mengautentikasi dengan OAuth ke Honeydew.

Setelah menambahkan server, buka file konfigurasi di ~/.codex/config.toml dan tambahkan header ke bagian [mcp_servers.honeydew] sesuai kebutuhan.

Konfigurasi TOML

Tambahkan berikut ini ke ~/.codex/config.toml (atau .codex/config.toml dalam proyek tepercaya):

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

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

Setel variabel lingkungan HONEYDEW_AUTH ke Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET> (lihat Autentikasi).

Honeydew Documentation MCP (opsional)

Server MCP Honeydew sudah menyertakan alat akses dokumentasi, sehingga server dokumentasi terpisah tidak diperlukan. Tambahkan Honeydew Documentation MCP hanya jika Anda ingin akses dokumentasi tanpa terhubung ke Honeydew. Tidak diperlukan autentikasi.

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

Menghapus server MCP

Untuk menghapus server MCP Honeydew:

codex mcp remove honeydew

Untuk menghapus server Honeydew Documentation MCP:

codex mcp remove honeydew-docs

Codex

#### Instalasi Plugin

Catatan

Memerlukan Git. Menginstal plugin dari GitHub mengkloning repositori secara lokal, jadi Git harus diinstal dan tersedia di PATH Anda. Jika Git tidak ada, instalasi plugin akan gagal. Instal Git, atau gunakan langkah pengaturan MCP manual klien Anda untuk mengonfigurasi server secara langsung alih-alih menggunakan plugin.

Honeydew menyediakan repositori plugin dengan keterampilan dan alat untuk membangun model semantik dan menganalisis data melalui percakapan alami. Menginstal plugin akan menyiapkan server MCP Honeydew secara otomatis.

Tambahkan marketplace di Codex:

  1. Buka Plugins
  2. Klik panah dropdown dan pilih Add marketplace
  3. Tambahkan honeydew-ai/honeydew-ai-coding-agents-plugins

Catatan

Anda juga dapat menambahkan marketplace dari Codex CLI:

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

Kemudian instal plugin:

  1. Buka Plugins
  2. Pilih marketplace Honeydew AI
  3. Instal plugin Honeydew

Pengaturan MCP

Gunakan bagian ini jika organisasi Anda menggunakan endpoint Honeydew kustom, atau jika Anda lebih suka mengonfigurasi server MCP tanpa menginstal plugin. Nonaktifkan koneksi MCP Honeydew yang ditambahkan oleh plugin, lalu tambahkan endpoint kustom Anda menggunakan petunjuk di bawah ini.

Catatan

Jika organisasi Anda menggunakan hostname Honeydew kustom, ganti https://mcp.honeydew.cloud/mcp dengan hostname tenant Anda. Anda dapat menemukan hostname di Settings > MCP Server di Honeydew Studio.

Honeydew MCP

  1. Buka aplikasi Codex

  2. Buka Settings -> MCP Servers

  3. Di bawah Custom servers, klik Add Server

  4. Setel nama server ke honeydew

  5. Pilih Streamable HTTP sebagai jenis transportasi

  6. Setel URL ke https://mcp.honeydew.cloud/mcp

  7. Biarkan kolom Bearer token environment variable kosong

  8. Konfigurasikan autentikasi sebagai berikut:

    Autentikasi OAuth

    Codex mengarahkan Anda untuk mengautentikasi dengan Honeydew saat menghubungkan. Tidak diperlukan konfigurasi tambahan.

    Autentikasi HTTP Basic

    Tambahkan header Authorization ke daftar header di atas dengan nilai Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET> (lihat Autentikasi).

Pemecahan masalah autentikasi MCP

Jika server MCP Honeydew tidak terautentikasi di Codex dan opsi "Authenticate" tidak muncul:

  1. Instal Codex CLI
  2. Jalankan codex mcp login honeydew

Honeydew Documentation MCP (opsional)

Server MCP Honeydew sudah menyertakan alat akses dokumentasi, sehingga server dokumentasi terpisah tidak diperlukan. Tambahkan Honeydew Documentation MCP hanya jika Anda ingin akses dokumentasi tanpa terhubung ke Honeydew. Tidak diperlukan autentikasi.

  1. Buka Settings -> MCP Servers
  2. Di bawah Custom servers, klik Add Server
  3. Setel nama server ke honeydew-docs
  4. Pilih Streamable HTTP sebagai jenis transportasi
  5. Setel URL ke https://honeydew.ai/docs/mcp

Menghapus server MCP

Untuk menghapus server MCP Honeydew:

  1. Buka Settings -> MCP Servers
  2. Temukan honeydew di bawah Custom servers dan klik Remove

Untuk menghapus server Honeydew Documentation MCP:

  1. Buka Settings -> MCP Servers
  2. Temukan honeydew-docs di bawah Custom servers dan klik Remove

Antigravity

#### Server MCP

Catatan

Jika organisasi Anda menggunakan hostname Honeydew kustom, ganti https://mcp.honeydew.cloud/mcp dengan hostname tenant Anda. Anda dapat menemukan hostname di Settings > MCP Server di Honeydew Studio.

  1. Buka editor Antigravity

  2. Klik dropdown ... di bagian atas panel agen

  3. Klik Manage MCP Servers

  4. Klik View raw config

  5. Tambahkan berikut ini ke 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. Simpan file

Honeydew Documentation MCP (opsional)

Server MCP Honeydew sudah menyertakan alat akses dokumentasi, sehingga server dokumentasi terpisah tidak diperlukan. Tambahkan Honeydew Documentation MCP hanya jika Anda ingin akses dokumentasi tanpa terhubung ke Honeydew. Tidak diperlukan autentikasi.

  1. Buka editor Antigravity
  2. Klik dropdown ... di bagian atas panel agen
  3. Klik Manage MCP Servers
  4. Klik View raw config
  5. Tambahkan berikut ini ke mcp_config.json: 
    {
  "name": "honeydew-docs",
  "type": "http",
  "url": "https://honeydew.ai/docs/mcp"
}
  6. Simpan file

Menghapus server MCP

Untuk menghapus server MCP Honeydew:

  1. Buka editor Antigravity
  2. Klik dropdown ... di bagian atas panel agen
  3. Klik Manage MCP Servers
  4. Klik View raw config
  5. Hapus entri honeydew dan honeydew-docs dari mcp_config.json
  6. Simpan file

OpenCode

#### Server MCP

Catatan

Jika organisasi Anda menggunakan hostname Honeydew kustom, ganti https://mcp.honeydew.cloud/mcp dengan hostname tenant Anda. Anda dapat menemukan hostname di Settings > MCP Server di Honeydew Studio.

Jalankan perintah berikut dan ikuti prompt interaktif: 
  ```bash theme={null}
  opencode mcp add
  ```

  Saat diminta, masukkan nilai berikut:

  1. **Location**: Pilih cakupan yang Anda inginkan (proyek saat ini atau global)
  2. **MCP server name**: `honeydew`
  3. **MCP server type**: `Remote`
  4. **MCP server URL**: `https://mcp.honeydew.cloud/mcp`
  5. **OAuth authentication**: `Yes`
  6. **Preregistered client ID**: `No`
</Tab>

<Tab title="JSON configuration">
  Tambahkan berikut ini ke file `opencode.jsonc` Anda:

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

      Kemudian autentikasi dengan Honeydew:

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

      Ini membuka jendela browser untuk menyelesaikan alur autentikasi 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>

Autentikasi ulang

Untuk mengautentikasi ulang, periksa status Anda dan keluar terlebih dahulu:

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

Honeydew Documentation MCP (opsional)

Server MCP Honeydew sudah menyertakan alat akses dokumentasi, sehingga server dokumentasi terpisah tidak diperlukan. Tambahkan Honeydew Documentation MCP hanya jika Anda ingin akses dokumentasi tanpa terhubung ke Honeydew. Tidak diperlukan autentikasi.

Jalankan `opencode mcp add` dan masukkan nilai berikut: 
  1. **MCP server name**: `honeydew-docs`
  2. **MCP server type**: `Remote`
  3. **MCP server URL**: `https://honeydew.ai/docs/mcp`
  4. **OAuth authentication**: `No`
</Tab>

<Tab title="JSON configuration">
  Tambahkan berikut ini ke file `opencode.jsonc` Anda:

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

Menghapus server MCP

Untuk menghapus server MCP Honeydew, hapus entri honeydew dari file opencode.jsonc Anda. Untuk menghapus server Honeydew Documentation MCP, hapus entri honeydew-docs dari file yang sama.

Kiro

IDE Kiro dan Kiro CLI berbagi file konfigurasi MCP yang sama, jadi langkah-langkah di bawah ini berlaku untuk keduanya.

Server MCP

Kiro membaca server MCP dari dua file konfigurasi:

  • Workspace: .kiro/settings/mcp.json (khusus untuk proyek saat ini)
  • User: ~/.kiro/settings/mcp.json (berlaku di semua workspace)

Jika kedua file ada, konfigurasi workspace memiliki prioritas.

Catatan

Jika organisasi Anda menggunakan hostname Honeydew kustom, ganti https://mcp.honeydew.cloud/mcp dengan hostname tenant Anda. Anda dapat menemukan hostname di Settings > MCP Server di Honeydew Studio.

Tambahkan server MCP Honeydew ke salah satu file mcp.json ini (workspace atau user):

```json theme={null} { "mcpServers": { "honeydew": { "url": "https://mcp.honeydew.cloud/mcp" } } } ``` 
  Saat pertama kali terhubung ke Honeydew, Kiro menyediakan URL autentikasi.
  Buka di browser Anda untuk menyelesaikan alur autentikasi OAuth.
</Tab>
```json theme={null} { "mcpServers": { "honeydew": { "url": "https://mcp.honeydew.cloud/mcp", "headers": { "Authorization": "Basic " } } } } ```

Di Kiro CLI, jalankan /mcp untuk memverifikasi bahwa server terhubung. Di Kiro IDE, server muncul di panel MCP.

Honeydew Documentation MCP (opsional)

Server MCP Honeydew sudah menyertakan alat akses dokumentasi, sehingga server dokumentasi terpisah tidak diperlukan. Tambahkan Honeydew Documentation MCP hanya jika Anda ingin akses dokumentasi tanpa terhubung ke Honeydew. Tidak diperlukan autentikasi.

Tambahkan berikut ini ke mcp.json Anda:

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

Menghapus server MCP

Untuk menghapus server MCP Honeydew, hapus entri honeydew dari mcp.json Anda. Untuk menghapus server Honeydew Documentation MCP, hapus entri honeydew-docs dari file yang sama.

Snowflake Intelligence

Snowflake terhubung ke server MCP eksternal melalui [konektor MCP](https://docs.snowflake.com/en/user-guide/snowflake-cortex/cortex-agents-mcp-connectors), sehingga alat Honeydew tersedia untuk Snowflake Intelligence dan Cortex Agents.

Prasyarat:

  • Peran dengan hak istimewa CREATE INTEGRATION pada akun
  • Peran dengan hak istimewa CREATE MCP SERVER pada skema target

Secara default, hanya peran ACCOUNTADMIN yang memiliki hak istimewa ini.

Catatan

Jika organisasi Anda menggunakan hostname Honeydew kustom, ganti https://mcp.honeydew.cloud/mcp dengan hostname tenant Anda. Anda dapat menemukan hostname di Settings > MCP Server di 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">
  Server MCP eksternal adalah objek tingkat skema
  yang mereferensikan integrasi 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">
  Berikan izin penggunaan pada integrasi dan server MCP
  kepada semua peran yang memerlukan akses ke 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">
  Tambahkan server MCP `honeydew` sebagai alat ke Cortex Agent
  atau agen Snowflake Intelligence.
  Pengguna akan diminta untuk mengautentikasi dengan OAuth ke Honeydew pada penggunaan pertama.
</Step>

Catatan

Server Honeydew Documentation MCP yang berdiri sendiri tidak didukung di Snowflake, karena server MCP eksternal Snowflake memerlukan autentikasi OAuth dan server dokumentasi tidak diautentikasi. Akses dokumentasi tersedia melalui alat dokumentasi server MCP Honeydew.

Menghapus server MCP

Hapus server MCP terlebih dahulu, lalu integrasi API:

DROP MCP SERVER honeydew;
DROP INTEGRATION honeydew_mcp_integration;

Klien Lainnya

Klien apa pun yang kompatibel dengan MCP dapat terhubung ke Server MCP Honeydew menggunakan transport HTTP standar.

Gunakan konfigurasi JSON berikut sebagai titik awal:

Catatan

Jika organisasi Anda menggunakan hostname Honeydew kustom, ganti https://mcp.honeydew.cloud/mcp dengan hostname tenant Anda. Anda dapat menemukan hostname di Settings > MCP Server di 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 " } } ```

Lihat Server URL, Autentikasi, dan Konfigurasi untuk detail setiap parameter.

Contoh Penggunaan

Setelah terhubung, Anda dapat menanyakan hal-hal seperti berikut kepada asisten AI Anda:

  • "Entitas apa saja yang tersedia dalam model semantik?"
  • "Tampilkan atribut dan metrik untuk entitas orders"
  • "Domain apa saja yang didefinisikan dalam model?"
  • "Tabel apa saja yang ada di skema analytics?"
  • "Berapa banyak pesanan yang ditempatkan bulan lalu?"
  • "Buat metrik baru untuk total pendapatan pada entitas orders"
  • "Berapa nilai pesanan rata-rata menurut wilayah untuk kuartal terakhir?"

Pemecahan Masalah

Masalah Autentikasi OAuth

Verifikasi bahwa klien Anda mendukung OAuth, pastikan Anda memiliki izin workspace Honeydew yang diperlukan, dan coba autentikasi ulang melalui antarmuka manajemen MCP klien Anda.

Autentikasi ulang di Claude Code

Ketik /mcp, pilih Honeydew MCP dari daftar, pilih "Clear authentication" atau "Authenticate", lalu ikuti prompt OAuth di browser untuk terhubung kembali ke Honeydew.

Masalah Koneksi

Pastikan URL server MCP cocok dengan https://mcp.honeydew.cloud/mcp dan verifikasi bahwa sintaks konfigurasi MCP klien Anda benar. Jika organisasi Anda menggunakan hostname kustom, periksa bahwa URL cocok dengan hostname tenant Anda yang muncul di Settings > MCP Server di Honeydew Studio.

Alat yang Hilang

Verifikasi bahwa autentikasi berhasil, periksa izin akses workspace Honeydew Anda, dan tinjau konsol klien Anda untuk pesan kesalahan.

Output Melebihi Batas Token Maksimum yang Diizinkan (Claude)

Di Claude Code, Claude Desktop, dan Claude.ai, panggilan alat dapat gagal dengan kesalahan bahwa output melebihi batas token maksimum yang diizinkan. Alat analisis Honeydew seperti monitor_analysis dan get_analysis_step_details dapat mengembalikan hasil besar yang melewati batas output MCP Claude.

Claude memperingatkan ketika output alat MCP melebihi 10.000 token dan menolak output di atas batas default 25.000 token. Untuk menaikkan batas, atur variabel lingkungan MAX_MCP_OUTPUT_TOKENS sebelum meluncurkan Claude:

export MAX_MCP_OUTPUT_TOKENS=50000
claude

Lihat Batas dan peringatan output MCP di dokumentasi Claude untuk detail.

Untuk dukungan tambahan, hubungi dukungan Honeydew di support@honeydew.ai.

Alat yang Tersedia

Alat yang ditandai sebagai hanya-baca tidak mengubah model semantik atau gudang data.

Tips

Untuk hanya mengekspos alat hanya-baca, atur header ReadonlyToolsOnly: true dalam konfigurasi server MCP Anda. Saat diaktifkan, server hanya mengembalikan alat yang tidak mengubah model semantik atau gudang data.

Sesi & Workspace

list_workspaces

hanya-baca

Daftarkan semua workspace yang tersedia. Mengembalikan nama workspace, dan jenis gudang data (snowflake, databricks, atau bigquery). Gunakan jenis gudang data untuk menginformasikan implementasi model semantik.

list_workspace_branches

hanya-baca

Daftarkan semua cabang yang tersedia untuk sebuah workspace.

Nama workspace.

get_session_workspace_and_branch

hanya-baca

Dapatkan workspace dan cabang yang ditetapkan untuk sesi saat ini.

set_session_workspace_and_branch

hanya-baca

Tetapkan workspace dan cabang yang akan digunakan untuk sesi saat ini. Semua panggilan alat berikutnya dalam sesi menggunakan workspace dan cabang ini.

Nama workspace. Cabang yang akan digunakan.

create_workspace_branch

Buat cabang baru untuk workspace yang ada. Cabang dibuat dari status saat ini dari cabang prod workspace. Jika tidak ada workspace yang disematkan melalui header, sesi beralih ke cabang baru secara otomatis.

Nama workspace untuk membuat cabang. Nama cabang baru yang akan dibuat.

delete_workspace_branch

Hapus cabang dari workspace. Ini adalah operasi destruktif dan tidak dapat dibatalkan. Selalu konfirmasi nama workspace dan nama cabang dengan pengguna sebelum memanggil alat ini. Cabang prod tidak dapat dihapus. Jika cabang yang dihapus adalah cabang sesi saat ini, sesi beralih ke prod secara otomatis.

Nama workspace yang berisi cabang yang akan dihapus. Nama cabang yang akan dihapus.

get_branch_history

hanya-baca

Dapatkan riwayat perubahan untuk cabang sesi saat ini. Mengembalikan daftar perubahan yang menunjukkan objek semantik apa yang dimodifikasi, oleh siapa, dan kapan.

Jumlah maksimum perubahan yang akan dikembalikan.

create_pr_for_working_branch

Buat pull request untuk cabang kerja sesi saat ini. Mengembalikan URL PR jika berhasil.

Judul untuk pull request. Deskripsi untuk pull request.

Pertanyaan & Analisis

initiate_analysis

hanya-baca

Mulai atau lanjutkan analisis data. Mengembalikan conversation_id — gunakan monitor_analysis untuk memeriksa kemajuan dan hasil, dan abort_analysis untuk menghentikannya lebih awal. Lihat Analisis Mendalam untuk detail lebih lanjut.

Pertanyaan bahasa alami yang akan diajukan. Nama agen untuk percakapan baru. Abaikan untuk pertanyaan lanjutan — agen diwarisi dari percakapan yang ada. ID percakapan yang ada untuk dilanjutkan, atau abaikan untuk memulai percakapan baru.

monitor_analysis

hanya-baca

Periksa pesan kemajuan baru dari analisis yang sedang berlangsung. Setiap panggilan hanya mengembalikan pesan sejak panggilan terakhir. Periksa berulang kali hingga status adalah DONE atau NO_CHAT_CURRENTLY_RUNNING.

ID percakapan yang dikembalikan oleh `initiate_analysis`. Jumlah maksimum pesan yang akan dikembalikan per panggilan. ID pesan untuk diputar ulang. Gunakan `last_received_message_id` dari hasil sebelumnya untuk memulihkan pesan yang terlewat.

get_analysis_step_details

hanya-baca

Ambil detail lengkap untuk langkah analisis tertentu, termasuk kueri semantik, pernyataan SQL, konteks yang digunakan, dan data yang diambil pada langkah tersebut.

ID percakapan yang dikembalikan oleh `initiate_analysis`. ID langkah dari `monitor_analysis` (mis. `STEP/0`).

abort_analysis

hanya-baca

Batalkan analisis yang sedang berlangsung. Dapat dilanjutkan dari titik pembatalan dengan initiate_analysis.

ID percakapan yang dikembalikan oleh `initiate_analysis`.

list_analysis_chats

hanya-baca

Mengembalikan daftar percakapan analisis yang dipaginasi untuk workspace saat ini, diurutkan berdasarkan waktu pembuatan (terbaru terlebih dahulu). Admin melihat semua percakapan; non-admin hanya melihat percakapan mereka sendiri. Setiap entri menyertakan ID percakapan, judul, umpan balik pengguna, domain, agen, waktu pembuatan, dan nama tampilan pengguna yang membuatnya.

Jumlah maksimum percakapan yang akan dikembalikan. Jumlah percakapan yang dilewati untuk paginasi.

provide_analysis_feedback

Tetapkan atau hapus umpan balik pada percakapan analisis tertentu. Ada satu entri umpan balik per percakapan (bukan per pertanyaan) — itu harus mencerminkan kualitas keseluruhan alur percakapan.

Panggil ini setelah monitor_analysis selesai dan pengguna menyatakan kepuasan atau ketidakpuasan dengan hasilnya. Gunakan string afirmatif pendek untuk umpan balik positif (mis. Good), atau format <Reason>: <details> untuk umpan balik negatif, di mana Reason adalah salah satu dari Chart Issue, Data Issue, Wrong Judgement, atau Other.

ID percakapan dari percakapan analisis. Teks umpan balik untuk disimpan, atau `null` untuk menghapus umpan balik yang ada.

get_stored_conversation

hanya-baca

Mengembalikan semua pesan dari percakapan analisis yang ada. Gunakan ini untuk meninjau konten lengkap percakapan sebelumnya. is_complete dalam respons menunjukkan apakah percakapan mencapai status terminal.

ID percakapan dari `list_analysis_chats`. Jika `true`, sertakan entri kemajuan `step_start` dan `step_insight`. Jika `false`, kembalikan hanya respons akhir dan pesan rencana/interpretasi.

Jelajah & Penemuan

list_entities

hanya-baca

Daftarkan semua entitas dalam model semantik dengan nama, deskripsi, dan kuncinya.

get_entity

hanya-baca

Dapatkan informasi terperinci tentang sebuah entitas, termasuk atributnya, metrik, kumpulan data, relasi, dan definisi YAML. Nama entitas.

get_field

hanya-baca

Dapatkan informasi terperinci tentang bidang tertentu (atribut atau metrik) dalam sebuah entitas, termasuk definisi YAML-nya.

Nama entitas yang berisi bidang tersebut. Nama bidang.

list_domains

hanya-baca

Daftarkan semua domain dalam model semantik beserta nama, deskripsi, dan entitasnya.

get_domain

hanya-baca

Dapatkan informasi terperinci tentang sebuah domain, termasuk entitas, filter, parameter, dan definisi YAML-nya.

Nama domain.

search_model

hanya-baca

Cari model semantik untuk entitas, atribut, metrik, kumpulan data, kumpulan data dinamis, domain, dan parameter global yang cocok dengan string kueri.

Gunakan sintaks entity.field untuk membatasi pencarian ke bidang dalam entitas tertentu. Misalnya, customers.balance menemukan bidang balance pada entitas yang cocok dengan customers; customers. mengembalikan semua bidang dari entitas yang cocok. Dalam mode OR/AND, kecocokan parsial berlaku untuk bagian entitas dan bidang — cust.bal cocok dengan customers.balance.

String kueri pencarian. Mengontrol cara kueri dicocokkan:
  • OR — memisahkan berdasarkan spasi, mengembalikan objek yang cocok dengan kata apa pun.
  • AND — memisahkan berdasarkan spasi, hanya mengembalikan objek yang cocok dengan semua kata.
  • EXACT — menggunakan string lengkap apa adanya, mengembalikan objek yang nama, nama tampilan, atau labelnya cocok persis.

Penemuan Gudang Data

list_databases

hanya-baca

Daftarkan semua basis data yang tersedia di gudang data yang terhubung.

list_schemas

hanya-baca

Daftarkan semua skema dalam basis data tertentu di gudang data yang terhubung.

Nama basis data.

list_tables

hanya-baca

Daftarkan tabel/tampilan dalam basis data dan skema tertentu di gudang data yang terhubung.

Nama basis data. Nama skema.

get_table_info

hanya-baca

Dapatkan informasi terperinci tentang tabel/tampilan gudang data, termasuk kolom dan metadatanya.

Nama basis data. Nama skema. Nama tabel.

Model Semantik

import_tables

Impor tabel dari gudang data yang terhubung ke dalam model semantik. Setiap tabel menjadi entitas dengan kolomnya sebagai atribut.

Daftar nama tabel yang sepenuhnya memenuhi syarat dalam format `database.schema.table`.

create_entity

Buat entitas baru dalam model semantik dari definisi YAML.

Definisi YAML untuk entitas. Definisi YAML untuk kumpulan data.

create_object

Buat objek model semantik baru dari definisi YAML. Jenis yang didukung: atribut terhitung, metrik, kumpulan data dinamis, domain, dan parameter global.

Definisi YAML dari objek. Buat objek meskipun validasi menghasilkan kesalahan.

update_object

Perbarui objek model semantik yang ada dari definisi YAML. Jenis yang didukung: entitas, atribut terhitung, metrik, kumpulan data, kumpulan data dinamis, domain, dan parameter global.

Definisi YAML dari objek. Kunci objek yang akan diperbarui. Perbarui objek meskipun validasi menghasilkan kesalahan.

validate_object

hanya-baca

Validasi definisi YAML objek model semantik tanpa membuat atau memperbaruinya. Jenis yang didukung: entitas, atribut terhitung, metrik, kumpulan data, kumpulan data dinamis, domain, dan parameter global.

Definisi YAML yang akan divalidasi. Kunci objek yang akan divalidasi.

delete_object

Hapus objek model semantik berdasarkan kuncinya.

Kunci objek yang akan dihapus. Hapus objek meskipun validasi menghasilkan kesalahan.

Agen

list_agents

hanya-baca

Daftarkan semua agen beserta nama, deskripsi, domain, dan referensi konteksnya.

get_agent

hanya-baca

Dapatkan informasi terperinci tentang sebuah agen, termasuk definisi frontmatter YAML-nya.

Nama agen yang akan diambil.

create_agent

Buat agen baru.

Metadata untuk agen baru. Nama hierarkis (mis., `growth-analyst`, `finance/budget-analyst`). 
<ParamField body="display_name" type="string" required>
  Nama yang dapat dibaca manusia yang ditampilkan di UI.
</ParamField>

<ParamField body="description" type="string" required>
  Deskripsi tujuan dan kemampuan agen.
</ParamField>

<ParamField body="domain" type="string" required>
  Domain tempat agen ini beroperasi.
</ParamField>

<ParamField body="welcome_message" type="string">
  Pesan pengantar yang ditampilkan saat pengguna memulai sesi.
</ParamField>

<ParamField body="sample_questions" type="string[]">
  Contoh pertanyaan yang ditampilkan kepada pengguna.
</ParamField>

<ParamField body="context" type="string[]">
  Nama item konteks atau pola glob untuk dimuat ke dalam sesi
  (mis., `skills/**`, `knowledge/marketing/**`).
</ParamField>

<ParamField body="owner" type="string">
  Pengidentifikasi pemilik untuk agen.
</ParamField>
Badan Markdown yang ditambahkan setelah frontmatter. Teks ini disuntikkan ke dalam prompt sebelum setiap sesi analisis. Buat agen meskipun validasi menghasilkan kesalahan.

update_agent

Perbarui agen yang ada.

Nama agen yang akan diperbarui. Definisi agen lengkap yang diperbarui. Semua bidang wajib dari `create_agent` harus disediakan — ini adalah penggantian penuh, bukan pembaruan parsial. Badan Markdown yang diperbarui untuk agen. Perbarui agen meskipun validasi menghasilkan kesalahan.

delete_agent

Hapus agen berdasarkan nama.

Nama agen yang akan dihapus.

Item Konteks

list_context_items

hanya-baca

Daftarkan semua item konteks beserta jenis, nama, judul, dan nilai subtipe.

get_context_item

hanya-baca

Dapatkan item konteks berdasarkan nama.

Nama item konteks yang akan diambil.

create_context_item

Buat item konteks baru. Mendukung jenis instruksi dan memori.

Metadata untuk item konteks baru. Harus `instruction`. 
<ParamField body="name" type="string" required>
  Nama hierarkis
  (mis., `knowledge/customer/churn-analysis`, `skills/reporting`).
</ParamField>

<ParamField body="subtype" type="string" required>
  Salah satu dari `knowledge`, `skill`, atau `instruction`.
</ParamField>

<ParamField body="title" type="string" required>
  Judul yang dapat dibaca manusia untuk item konteks.
</ParamField>

<ParamField body="apply" type="string" required>
  Kapan menerapkan konteks: `always` atau `on_demand`.
</ParamField>

<ParamField body="description" type="string">
  Deskripsi yang digunakan oleh AI untuk memutuskan kapan memuat item ini
  (wajib saat `apply` adalah `on_demand`).
</ParamField>

<ParamField body="owner" type="string">
  Pengidentifikasi pemilik.
</ParamField>

<ParamField body="labels" type="string[]">
  Label untuk mengatur item konteks.
</ParamField>

<ParamField body="related_objects" type="object[]">
  Objek semantik yang terkait dengan item konteks ini.
  Setiap objek memiliki `name` (string) dan `type` (`domain`, `entity`, atau `field`).
</ParamField>

<ParamField body="external_source" type="object">
  Sumber eksternal untuk mengambil konten (untuk subtipe `knowledge`).
  Memiliki `tool` (nama alat MCP), `resource_id` (pengidentifikasi di alat eksternal),
  dan opsional `cache_max_age_in_seconds` (default: `3600`).
</ParamField>
Harus `memory`. 
<ParamField body="name" type="string" required>
  Nama hierarkis (mis., `events/q4-launch`, `2024/pricing-decision`).
</ParamField>

<ParamField body="subtype" type="string" required>
  Salah satu dari `event` atau `decision_trace`.
</ParamField>

<ParamField body="title" type="string" required>
  Judul yang dapat dibaca manusia untuk item konteks.
</ParamField>

<ParamField body="apply" type="string" required>
  Kapan menerapkan konteks: `always` atau `on_demand`.
</ParamField>

<ParamField body="from_date" type="string" required>
  Tanggal mulai periode memori dalam format ISO (mis., `2024-01-01`).
</ParamField>

<ParamField body="to_date" type="string">
  Tanggal akhir periode memori dalam format ISO.
</ParamField>

<ParamField body="description" type="string">
  Deskripsi yang digunakan oleh AI untuk memutuskan kapan memuat item ini
  (wajib saat `apply` adalah `on_demand`).
</ParamField>

<ParamField body="owner" type="string">
  Pengidentifikasi pemilik.
</ParamField>

<ParamField body="labels" type="string[]">
  Label untuk mengatur item konteks.
</ParamField>

<ParamField body="related_objects" type="object[]">
  Objek semantik yang terkait dengan item konteks ini.
  Setiap objek memiliki `name` (string) dan `type` (`domain`, `entity`, atau `field`).
</ParamField>

<ParamField body="external_source" type="object">
  Sumber eksternal untuk mengambil konten.
  Memiliki `tool` (nama alat MCP), `resource_id` (pengidentifikasi di alat eksternal),
  dan opsional `cache_max_age_in_seconds` (default: `3600`).
</ParamField>
Badan Markdown untuk konten item konteks. Buat item konteks meskipun validasi menghasilkan kesalahan.

update_context_item

Perbarui item konteks yang ada.

Nama item konteks yang akan diperbarui. Definisi item konteks lengkap yang diperbarui. Semua bidang wajib dari `create_context_item` harus disediakan — ini adalah penggantian penuh, bukan pembaruan parsial. Badan Markdown yang diperbarui untuk item konteks. Perbarui item konteks meskipun validasi menghasilkan kesalahan.

delete_context_item

Hapus item konteks berdasarkan nama.

Nama item konteks yang akan dihapus.

Kueri & Pratinjau

get_sql_from_fields

hanya-baca

Hasilkan kueri SQL untuk kueri lapisan semantik yang ditentukan oleh atribut, metrik, dan filter. Mengembalikan SQL tanpa mengeksekusinya.

Nama atribut yang sepenuhnya memenuhi syarat (`entity.attribute_name`). Mendukung alias: `entity.attribute_name as alias_name`. Nama metrik yang sepenuhnya memenuhi syarat (`entity.metric_name`) atau ekspresi SQL (mis. `SUM(entity.field)`). Mendukung alias: `SUM(entity.field) as total`. Kondisi filter (mis. `entity.field = 'value'`, `entity.date_field > '2024-01-01'`). Daftar bidang untuk diurutkan. Format: `entity.field_name` atau `entity.field_name DESC`. Arah default adalah ASC. Saat menggunakan alias, urutkan berdasarkan nama alias. Domain yang akan digunakan untuk kueri. Jumlah maksimum baris yang akan dikembalikan. Jumlah baris yang akan dilewati untuk paginasi. Tambahkan [laporan pra-agregasi](/docs/performance/aggregate-awareness#debugging-aggregate-matching) di bagian atas SQL yang dikembalikan, yang menyatakan untuk setiap pra-agregasi di workspace CTE mana yang menggunakannya atau mengapa tidak dapat digunakan.

get_data_from_fields

hanya-baca

Jalankan kueri semantic layer yang ditentukan oleh atribut, metrik, dan filter, lalu kembalikan data yang dihasilkan.

Nama atribut yang sepenuhnya memenuhi syarat (`entity.attribute_name`). Mendukung alias: `entity.attribute_name as alias_name`. Nama metrik yang sepenuhnya memenuhi syarat (`entity.metric_name`) atau ekspresi SQL (mis. `SUM(entity.field)`). Mendukung alias: `SUM(entity.field) as total`. Kondisi filter (mis. `entity.field = 'value'`, `entity.date_field > '2024-01-01'`). Daftar kolom untuk diurutkan. Format: `entity.field_name` atau `entity.field_name DESC`. Arah default adalah ASC. Saat menggunakan alias, urutkan berdasarkan nama alias. Domain yang akan digunakan untuk kueri. Jumlah maksimum baris yang akan dikembalikan. Jumlah baris yang dilewati untuk paginasi.

list_query_history

hanya-baca

Daftarkan kueri yang sebelumnya dijalankan melalui semantic layer Honeydew, yang terbaru terlebih dahulu. Gunakan untuk menemukan dan menangani kueri yang gagal serta memahami mengapa kueri tersebut gagal. Pemanggil non-admin hanya melihat kueri mereka sendiri.

Setiap kueri menyertakan statusnya, pesan kesalahan, pemilik, klien, domain, SQL input asli (SQL yang dikirim pengguna untuk kueri antarmuka SQL), stempel waktu untuk kompilasi dan eksekusi warehouse, ID kueri data-warehouse, serta tautan untuk membukanya di aplikasi Honeydew.

Filter berdasarkan status kueri (`FAILED`, `SUCCESS`, `RUNNING`, atau `CANCELED`). Filter berdasarkan klien yang menjalankan kueri (mis. `Snowflake`, `MCP`). Filter berdasarkan nama domain. Filter berdasarkan pemilik kueri (email pengguna, atau nama kunci API). Hanya dihormati untuk pemanggil admin; non-admin dibatasi pada kueri mereka sendiri. Hanya kueri yang dijalankan pada atau setelah waktu ini (ISO 8601). Hanya kueri yang dijalankan pada atau sebelum waktu ini (ISO 8601). Juga kembalikan definisi YAML semantik setiap kueri (atribut, metrik, filter). Aktifkan untuk mereproduksi atau mengubah kueri. Juga kembalikan SQL warehouse terkompilasi setiap kueri (besar). Aktifkan untuk debugging sisi warehouse pada kueri tertentu. Jumlah maksimum kueri yang akan dikembalikan. Jumlah kueri yang dilewati untuk paginasi.

Dokumentasi

search_docs

hanya-baca

Cari basis pengetahuan dokumentasi Honeydew untuk informasi yang relevan, contoh kode, referensi API, dan panduan. Mengembalikan konten kontekstual dengan judul dan tautan ke halaman dokumentasi. Untuk membaca konten lengkap sebuah halaman, gunakan query_docs_filesystem.

Kueri pencarian.

query_docs_filesystem

hanya-baca

Jalankan perintah mirip shell hanya-baca terhadap sistem file virtual dalam memori yang berisi halaman dokumentasi Honeydew dan spesifikasi OpenAPI. Mendukung perintah seperti rg, grep, find, tree, ls, cat, head, dan tail. Gunakan untuk pencocokan kata kunci atau regex yang tepat, eksplorasi struktural, atau membaca konten lengkap halaman tertentu berdasarkan jalur.

Perintah shell yang akan dijalankan (mis. `rg -il "keyword" /`, `tree / -L 2`, `head -80 /path/page.mdx`).

FAQ

Alat mana yang diperlukan untuk analisis mendalam?

Menjalankan Analisis Mendalam memerlukan:

Untuk meninjau percakapan analisis sebelumnya, aktifkan juga list_analysis_chats dan get_stored_conversation.

Membatasi agen pada alat-alat ini berguna ketika:

  • Pengguna yang Anda tuju hanya menjalankan alur kerja analisis mendalam
  • Anda ingin menjaga agen tetap fokus pada tugas analisis
  • Klien Anda membatasi berapa banyak alat yang dapat diaktifkan (misalnya, Databricks Genie Code)

Untuk kasus penggunaan lain, tampilkan lebih banyak alat yang tercantum di bawah Alat yang Tersedia — agen akan memilih alat yang tepat untuk setiap tugas.