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

Apa yang bisa Anda lakukan dengan Honeydew Semantic Layer MCP?

  • Jelajahi tabel dan skema warehouse — Minta asisten Anda untuk menemukan dan menjelajahi tabel, skema, serta definisi model semantik di seluruh warehouse Anda.
  • Bangun model semantik secara percakapan — Gunakan bahasa alami untuk membuat dan memelihara definisi model semantik Anda melalui server MCP.
  • Kueri data dengan bahasa alami — Ajukan pertanyaan tentang data Anda dan dapatkan jawaban dari asisten yang kompatibel dengan MCP mana pun.
  • Cari dokumentasi Honeydew — Minta asisten Anda mencari dan membaca dokumentasi resmi Honeydew untuk panduan.
  • Kelola workspace dan cabang — Gunakan list_workspaces, list_workspace_branches, dan set_session_workspace_and_branch untuk mengonfigurasi konteks sesi Anda.

Dokumentasi

Server MCP

Apa itu MCP?

Model Context Protocol (MCP) adalah standar sumber terbuka untuk menghubungkan aplikasi AI ke sistem dan alat eksternal secara aman. 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 menyediakan token akses secara aman untuk permintaan berikutnya.

Autentikasi Dasar HTTP

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

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

Tips

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

Anda dapat menggunakan perintah berikut untuk menghasilkan string berenkode Base64:

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

Berikan string berenkode tersebut 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 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 plugin.

Honeydew menyediakan repositori plugin dengan keterampilan dan alat untuk membangun model semantik dan menganalisis data melalui percakapan alami. Menginstal plugin akan mengatur 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>

Tips

Menggunakan variabel lingkungan untuk autentikasi API Key

Untuk menghindari penyimpanan nilai sensitif secara 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 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 plugin.

Honeydew menyediakan repositori plugin dengan keterampilan dan alat untuk membangun model semantik dan menganalisis data melalui percakapan alami. Menginstal plugin akan mengatur 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 mengatur 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 Pengaturan -> Konektor -> Tambahkan konektor kustom
  2. Masukkan honeydew di kolom Nama
  3. Masukkan https://mcp.honeydew.cloud/mcp di kolom URL server MCP jarak jauh
  4. Klik Tambahkan

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

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 Pengaturan -> Konektor -> Tambahkan konektor kustom
  2. Masukkan honeydew-docs di kolom Nama
  3. Masukkan https://honeydew.ai/docs/mcp di kolom URL server MCP jarak jauh
  4. Klik Tambahkan

Menghapus server MCP

Untuk menghapus server MCP Honeydew:

  1. Buka Pengaturan -> Konektor
  2. Temukan konektor honeydew dan klik ikon hapus

Untuk menghapus server MCP Honeydew Documentation:

  1. Buka Pengaturan -> Konektor
  2. Temukan konektor honeydew-docs dan klik ikon hapus

Microsoft 365 Copilot

Microsoft 365 Copilot terhubung ke server MCP eksternal melalui [Copilot Studio](https://learn.microsoft.com/en-us/microsoft-copilot-studio/mcp-add-existing-server-to-agent): Anda menambahkan server MCP Honeydew sebagai alat pada agen Copilot Studio, lalu memublikasikan agen ke Microsoft 365 Copilot dan Teams.

Prasyarat:

  • Akses ke Copilot Studio dengan izin untuk membuat agen
  • Akses ke Microsoft 365 Copilot untuk setiap pengguna agen

Catatan

Jika organisasi Anda menggunakan nama host Honeydew kustom, ganti https://mcp.honeydew.cloud/mcp dengan nama host penyewa Anda. Anda dapat menemukan nama host di Pengaturan > Server MCP di Honeydew Studio.

Di Copilot Studio, pilih **Buat** -> **Agen baru** dan beri nama agen, misalnya `Honeydew`. 
<Step title="Add the Honeydew MCP server as a tool">
  1. Buka agen dan buka **Alat** -> **Tambahkan alat** -> **Alat baru** ->
     **Model Context Protocol**
  2. Masukkan `Honeydew` di kolom **Nama server**
  3. Masukkan deskripsi di kolom **Deskripsi server**, misalnya
     `Explore the semantic model and query data through the Honeydew Semantic Layer`.
     Agen menggunakan deskripsi untuk memutuskan kapan memanggil Honeydew.
  4. Masukkan `https://mcp.honeydew.cloud/mcp` di kolom **URL server**
  5. Di bawah **Autentikasi**, pilih **OAuth 2.0** dan atur jenisnya ke **Penemuan dinamis**
  6. Pilih **Buat**, lalu **Berikutnya**
</Step>

<Step title="Create the connection">
  Pada dialog **Tambahkan alat**, pilih **Buat koneksi baru**. Masuk dengan akun Honeydew
  Anda dan terima otorisasi OAuth, lalu pilih **Tambahkan ke agen**.

  Uji agen di panel pengujian Copilot Studio, misalnya dengan
  "Entitas apa saja yang tersedia dalam model semantik?"
</Step>

<Step title="Publish to Microsoft 365 Copilot">
  1. Pilih **Publikasikan**
  2. Buka **Saluran** -> **Teams dan Microsoft Copilot**,
     pertahankan **Buat agen tersedia di Microsoft Copilot** tetap dipilih, dan pilih **Tambahkan saluran**
  3. Pilih **Lihat agen di Teams** -> **Tambahkan** untuk menginstal agen untuk diri Anda sendiri di Teams dan
     Microsoft 365 Copilot
  4. Untuk mengizinkan orang lain menggunakan agen, bagikan dengan mereka dari menu **Bagikan** agen, lalu salin
     tautan instalasi dari **Opsi ketersediaan** atau kirimkan agen untuk persetujuan admin
</Step>

Di Microsoft 365 Copilot, buka agen dari panel kiri, atau ketik @ di obrolan dan pilih, lalu ajukan pertanyaan Anda. Setiap pengguna diminta untuk masuk ke Honeydew dengan OAuth pada penggunaan pertama.

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.

Tambahkan alat Model Context Protocol ke agen dengan https://honeydew.ai/docs/mcp sebagai URL server dan Tidak ada sebagai jenis autentikasi.

Menghapus server MCP

Untuk menghapus Honeydew dari agen, buka halaman Alat agen dan hapus alat Honeydew, dan alat dokumentasi jika Anda menambahkannya.

Untuk menghapus agen dari Microsoft 365 Copilot dan Teams, buka Saluran -> Teams dan Microsoft Copilot dan pilih Hapus saluran.

Cortex Code CLI

#### Instalasi Plugin

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 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 instruksi di bawah ini.

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

Catatan

Jika organisasi Anda menggunakan nama host Honeydew kustom, ganti https://mcp.honeydew.cloud/mcp dengan nama host penyewa Anda. Anda dapat menemukan nama host di Pengaturan > Server MCP 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 mengautentikasi
      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 mengautentikasi
      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 mengautentikasi
      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, jadi 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 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 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 Pengaturan -> Plugin
  2. Klik Tambahkan Plugin, pilih Tambahkan dari GitHub, dan tempel repositori plugin Honeydew: honeydew-ai/honeydew-ai-coding-agents-plugins
  3. Ikuti alurnya dan setujui langkah-langkah di Pengaturan Penginstal Plugin GitHub

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 Cortex Code Desktop ke Honeydew Semantic Layer untuk eksplorasi model, kueri data, manajemen model, dan akses dokumentasi.

Untuk menambahkan server, buka MCP -> Baru, pilih Cakupan Konfigurasi (misalnya, ~/.snowflake/cortex/mcp.json untuk Global), isi formulir, lalu klik Simpan. Gunakan tab Formulir atau JSON untuk memasukkan konfigurasi.

Catatan

Jika organisasi Anda menggunakan nama host Honeydew kustom, ganti https://mcp.honeydew.cloud/mcp dengan nama host penyewa Anda. Anda dapat menemukan nama host di Pengaturan > Server MCP di Honeydew Studio.

Tambahkan server Honeydew MCP:

1. **Nama Server**: `honeydew` 2. **Jenis Server**: **Jarak Jauh (HTTP)** 3. **URL Server**: `https://mcp.honeydew.cloud/mcp` 4. Klik **Simpan** 
      Anda akan diminta untuk mengautentikasi dengan OAuth ke Honeydew
      saat pertama kali terhubung.
    </Tab>

    <Tab title="API Key">
      1. **Nama Server**: `honeydew`
      2. **Jenis Server**: **Jarak Jauh (HTTP)**
      3. **URL Server**: `https://mcp.honeydew.cloud/mcp`
      4. Di bawah **Header**, klik **Tambahkan Header** dan atur nama menjadi
         `Authorization` dan nilainya menjadi
         `Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET>`
      5. Klik **Simpan**
    </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 mengautentikasi 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, jadi server dokumentasi terpisah tidak diperlukan. Jika Anda menginginkan akses dokumentasi tanpa terhubung ke Honeydew, tambahkan server MCP Honeydew Documentation dengan cara yang sama, menggunakan Nama Server honeydew-docs, Jenis Server Jarak Jauh (HTTP), dan URL Server 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 pada menu sisi kiri)
  2. Gulir ke bawah ke Team Marketplaces dan klik Marketplace yang sudah 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 GitHub plugin Honeydew: https://github.com/honeydew-ai/honeydew-ai-coding-agents-plugins dan klik Add 1 plugin
  4. Secara 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 memasang plugin. Nonaktifkan koneksi MCP Honeydew yang ditambahkan oleh plugin, lalu tambahkan endpoint kustom Anda menggunakan instruksi di bawah ini.

Server MCP Honeydew menghubungkan Cursor 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.

Untuk menambahkan MCP Honeydew:

  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, jadi 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 -> 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 istimewa `USE CONNECTION` kepada pengguna atau peran mana pun
  yang memerlukan 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

#### Server MCP

Devin terhubung ke server MCP jarak jauh melalui MCP Marketplace-nya.

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. Secara opsional tambahkan ikon dan Short Description

  5. Pilih HTTP sebagai jenis transportasi

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

  7. Konfigurasikan 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 ingin 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 MCP Honeydew Documentation:

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

GitHub Copilot CLI

#### 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. 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. Memasang plugin dari GitHub mengkloning repositori secara lokal, jadi Git harus diinstal dan berada di PATH Anda. Jika Git tidak ada, pemasangan 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.

Tambahkan marketplace ke Copilot CLI:

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

Lalu 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 ingin 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 MCP Honeydew Documentation:

/mcp remove honeydew-docs

Gemini CLI

#### Instalasi Ekstensi

Catatan

Memerlukan Git. Memasang plugin dari GitHub mengkloning repositori secara lokal, jadi Git harus diinstal dan berada di PATH Anda. Jika Git tidak ada, pemasangan 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. Memasang 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 memasang 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 ingin 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 akan diperbarui secara otomatis. Untuk memperbarui secara manual, buka Command Palette dan jalankan Extensions: Check for Extension Updates.

Server 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 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 atau 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, jadi 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 berada di PATH Anda. Jika Git tidak ada, instalasi plugin akan gagal. Instal Git, atau gunakan langkah penyiapan 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.

Penyiapan 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 di 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, jadi 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 berada di PATH Anda. Jika Git tidak ada, instalasi plugin akan gagal. Instal Git, atau gunakan langkah penyiapan 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

Penyiapan 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, jadi 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, jadi 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.

<Tab title="Interactive CLI">

  Jalankan perintah berikut
  dan ikuti prompt interaktif:

  ```bash theme={null}
  opencode mcp add
  ```

  Saat diminta, masukkan nilai berikut:

  1. **Lokasi**: Pilih cakupan yang Anda inginkan (proyek saat ini atau global)
  2. **Nama server MCP**: `honeydew`
  3. **Tipe server MCP**: `Remote`
  4. **URL server MCP**: `https://mcp.honeydew.cloud/mcp`
  5. **Autentikasi OAuth**: `Yes`
  6. **ID klien terdaftar**: `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 autentikasi 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, jadi server dokumentasi terpisah tidak diperlukan. Tambahkan Honeydew Documentation MCP hanya jika Anda menginginkan akses dokumentasi tanpa terhubung ke Honeydew. Tidak diperlukan autentikasi.

Jalankan `opencode mcp add` dan masukkan nilai berikut: 
  1. **Nama server MCP**: `honeydew-docs`
  2. **Tipe server MCP**: `Remote`
  3. **URL server MCP**: `https://honeydew.ai/docs/mcp`
  4. **Autentikasi OAuth**: `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 MCP Honeydew Documentation, hapus entri honeydew-docs dari file yang sama.

Kiro

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

Server MCP

Kiro membaca server MCP dari dua file konfigurasi:

  • Workspace: .kiro/settings/mcp.json (khusus untuk proyek saat ini)
  • Pengguna: ~/.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 pengguna):

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

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

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

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.

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 MCP Honeydew Documentation, 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), membuat 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
  ke 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 MCP Honeydew Documentation mandiri 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 URL Server, Autentikasi, dan Konfigurasi untuk detail setiap parameter.

Contoh Penggunaan

Setelah terhubung, Anda dapat menanyakan asisten AI Anda pertanyaan seperti:

  • "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 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 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 Hilang

Verifikasi 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 tipe gudang data (snowflake, databricks, atau bigquery). Gunakan tipe 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 keadaan 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 saat 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. Hilangkan untuk pertanyaan lanjutan — agen diwarisi dari percakapan yang ada. ID percakapan yang ada untuk dilanjutkan, atau hilangkan untuk memulai percakapan baru.

monitor_analysis

hanya-baca

Poll untuk pesan progres baru dari analisis yang sedang berlangsung. Setiap pemanggilan hanya mengembalikan pesan sejak pemanggilan terakhir. Poll secara berulang hingga status adalah DONE atau NO_CHAT_CURRENTLY_RUNNING.

ID Percakapan yang dikembalikan oleh `initiate_analysis`. Jumlah maksimum pesan yang dikembalikan per pemanggilan. 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 mencakup ID percakapan, judul, umpan balik pengguna, domain, agen, waktu pembuatan, dan nama tampilan pengguna yang membuatnya.

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

provide_analysis_feedback

Mengatur atau menghapus umpan balik pada percakapan analisis tertentu. Hanya ada satu entri umpan balik per percakapan (bukan per pertanyaan) — ini 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 progres `step_start` dan `step_insight`. Jika `false`, kembalikan hanya respons akhir dan pesan rencana/interpretasi.

Penjelajahan & Penemuan

list_entities

hanya-baca

Daftarkan semua entitas dalam model semantik beserta 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, pencocokan parsial berlaku untuk bagian entitas dan bidang — cust.bal cocok dengan customers.balance.

Setiap kata (dalam mode EXACT, seluruh kueri) juga cocok dengan tag yang kunci atau nilainya cocok dengannya. Gunakan key:value untuk mencocokkan keduanya: team:finance menemukan objek yang diberi tag team=finance, dan dalam mode OR/AND team: menemukan tag team apa pun.

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, label, atau tagnya cocok persis.

Penemuan Gudang Data

list_databases

hanya-baca

Daftarkan semua database yang tersedia di gudang data yang terhubung.

list_schemas

hanya-baca

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

Nama database.

list_tables

hanya-baca

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

Nama database. Nama skema.

get_table_info

hanya-baca

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

Nama database. 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 bahkan jika 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 bahkan jika 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 bahkan jika 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 bahkan jika validasi menghasilkan kesalahan.

update_agent

Perbarui agen yang ada.

Nama agen yang akan diperbarui. Definisi agen yang diperbarui sepenuhnya. Semua bidang wajib dari `create_agent` harus disediakan — ini adalah penggantian penuh, bukan pembaruan parsial. Badan Markdown yang diperbarui untuk agen. Perbarui agen bahkan jika 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 mengorganisir 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>
Sumber eksternal untuk mengambil konten (untuk subtipe `knowledge`). Memiliki `tool` (nama alat MCP), `resource_id` (pengidentifikasi di alat eksternal), dan `cache_max_age_in_seconds` opsional (default: `3600`). Harus berupa `memory`. 
<ParamField body="name" type="string" required>
  Nama hierarkis (misalnya, `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 (misalnya, `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 mengorganisir 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 `cache_max_age_in_seconds` opsional (default: `3600`).
</ParamField>
Badan Markdown untuk konten item konteks. Buat item konteks bahkan jika 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 bahkan jika 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 (misalnya `SUM(entity.field)`). Mendukung alias: `SUM(entity.field) as total`. Kondisi filter (misalnya `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) ke bagian atas SQL yang dikembalikan, yang menyatakan untuk setiap pra-agregasi di ruang kerja CTE mana yang menggunakannya atau mengapa tidak dapat digunakan.

get_data_from_fields

hanya-baca

Jalankan kueri lapisan semantik yang ditentukan oleh atribut, metrik, dan filter, dan 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 (misalnya `SUM(entity.field)`). Mendukung alias: `SUM(entity.field) as total`. Kondisi filter (misalnya `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.

list_query_history

hanya-baca

Daftarkan kueri yang sebelumnya dieksekusi melalui lapisan semantik Honeydew, yang paling 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 mencakup statusnya, pesan kesalahan, pemilik, klien, domain, SQL input asli (SQL yang dikirim pengguna untuk kueri antarmuka SQL), stempel waktu untuk kompilasi dan eksekusi gudang data, ID kueri gudang data, dan tautan untuk membukanya di aplikasi Honeydew.

Filter berdasarkan status kueri (`FAILED`, `SUCCESS`, `RUNNING`, atau `CANCELED`). Filter berdasarkan klien yang menjalankan kueri (misalnya `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 dieksekusi pada atau setelah waktu ini (ISO 8601). Hanya kueri yang dieksekusi 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 gudang data yang dikompilasi setiap kueri (besar). Aktifkan untuk debugging sisi gudang data dari kueri tertentu. Jumlah maksimum kueri yang akan dikembalikan. Jumlah kueri yang akan 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 suatu 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 (misalnya `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, juga aktifkan list_analysis_chats dan get_stored_conversation.

Membatasi agen ke 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 memilih alat yang tepat untuk setiap tugas.

Dokumentasi ini dibangun dan dihosting di Mintlify, platform dokumentasi pengembang.