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?

Menemukan tabel dan skema gudang data — jelajahi struktur gudang data dan definisi model semantik Anda melalui percakapan alami.
Membangun dan memelihara model semantik — buat atau perbarui definisi model semantik menggunakan create_workspace_branch dan alat sesi lainnya.
Mengkueri data dengan bahasa alami — ajukan pertanyaan tentang data Anda dan dapatkan jawaban tanpa menulis SQL.
Mencari dokumentasi Honeydew — cari dokumen produk langsung dari asisten yang kompatibel dengan 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 digunakan

Menemukan dan menjelajahi tabel gudang data, skema, dan definisi model semantik Anda
Membangun dan memelihara model semantik Anda melalui percakapan alami
Menanyakan data Anda dengan bahasa alami dari asisten apa pun yang kompatibel dengan MCP
Mencari dan membaca dokumentasi Honeydew

Instalasi

URL Server

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

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

Autentikasi

Ada dua cara untuk mengautentikasi dengan Server MCP Honeydew: OAuth atau Autentikasi Basic HTTP.

Autentikasi OAuth (disarankan)

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

Masuk dengan akun Honeydew Anda
Menerima otorisasi OAuth

Klien kemudian secara aman menyediakan token akses untuk permintaan selanjutnya.

Autentikasi Basic HTTP

Server MCP dalam mode autentikasi Basic HTTP memerlukan Kunci API untuk autentikasi.

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

Jika membuat Kunci API 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

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

Anda dapat secara opsional menyediakan header ini dalam konfigurasi server MCP Anda:

Workspace: Sematkan ruang kerja untuk semua permintaan (opsional)
Branch: Sematkan cabang ruang kerja tertentu untuk semua permintaan (opsional, default ke prod jika ruang kerja diatur)
Honeydew-Client: Identifikasi klien MCP (opsional, terdeteksi otomatis dari alat yang terhubung). Berikan header ini untuk menyediakan pengenal klien tertentu.
ReadonlyToolsOnly: Atur ke true untuk mengekspos hanya alat baca-saja (opsional)

Server MCP menggunakan header respons `Mcp-Session-Id` untuk mempertahankan status sesi, termasuk ruang kerja dan cabang yang aktif. Lihat [spesifikasi manajemen sesi MCP](https://modelcontextprotocol.io/specification/2025-06-18/basic/transports#session-management) untuk detailnya.

Klien yang Didukung

Claude Code CLI

#### Instalasi Plugin **Memerlukan Git.** Menginstal plugin dari GitHub mengkloning repositori secara lokal, jadi [Git](https://git-scm.com/downloads) harus diinstal dan ada di `PATH` Anda. Jika Git tidak ada, instalasi plugin gagal. Instal Git, atau gunakan langkah-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

Lalu muat ulang plugin untuk mengaktifkan:

/reload-plugins

Memperbarui plugin

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

Tulis /plugin dan pilih Marketplaces di pemilih di bagian atas
Pilih honeydew-ai-coding-agents-plugins
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:

      Luncurkan Claude Code dengan `claude`.
      Anda akan diminta untuk mengautentikasi 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 yang berikut ke `honeydew-mcp.json`:

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

      Lalu daftarkan dengan:

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

      Luncurkan Claude Code dengan `claude`.
      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>"
        }
      }
      ```

      Lalu daftarkan dengan:

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

<Tab title=".mcp.json">
  Tambahkan yang 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 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>

**Menggunakan variabel lingkungan untuk autentikasi Kunci API**

Untuk menghindari penyimpanan nilai sensitif langsung di file konfigurasi,
Claude Code mendukung
[ekspansi variabel lingkungan](https://code.claude.com/docs/en/mcp#environment-variable-expansion-in-mcp-json)
menggunakan sintaks `${VAR_NAME}`.

Atur variabel lingkungan `HONEYDEW_API_KEY`,
lalu rujuk dalam konfigurasi Anda:

```bash theme={null}
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

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

Pengaturan MCP

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.

Untuk menambahkan MCP Honeydew dalam mode Cowork:

Buka Settings -> Connectors -> Add custom connector
Masukkan honeydew di bidang Name
Masukkan https://mcp.honeydew.cloud/mcp di bidang Remote MCP server URL
Klik Add

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

MCP Dokumentasi Honeydew (opsional)

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

Menghapus server MCP

Untuk menghapus server MCP Honeydew dalam mode Cowork:

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

Untuk menghapus server MCP Dokumentasi Honeydew:

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

Claude.ai

#### Instalasi Plugin

Unduh zip plugin: honeydew-ai-claude.zip
Di Claude.ai, buka Settings -> Plugins -> Add plugin -> Upload zip
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.

Untuk menambahkan server MCP Honeydew:

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

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

Honeydew Documentation MCP (opsional)

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

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

Menghapus server MCP

Untuk menghapus server Honeydew MCP:

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

Untuk menghapus server Honeydew Documentation MCP:

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

Cortex Code CLI

#### Instalasi Plugin **Membutuhkan Git.** Menginstal plugin dari GitHub akan mengkloning repositori secara lokal, jadi [Git](https://git-scm.com/downloads) harus terinstal dan ada di `PATH` Anda. Jika Git tidak ada, instalasi plugin akan gagal. Instal Git, atau gunakan langkah-langkah pengaturan MCP manual klien Anda untuk mengonfigurasi server secara langsung alih-alih menggunakan plugin.

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 Honeydew MCP yang ditambahkan oleh plugin, lalu tambahkan endpoint kustom Anda menggunakan instruksi di bawah ini.

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

      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 yang berikut ke `honeydew-mcp.json`:

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

      Lalu 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>"
        }
      }
      ```

      Lalu daftarkan dengan:

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

<Tab title="mcp.json">
  Tambahkan yang 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)

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

Menghapus server MCP

Untuk menghapus server Honeydew MCP:

cortex mcp remove honeydew

Untuk menghapus server Honeydew Documentation MCP:

cortex mcp remove honeydew-docs

Cortex Code Desktop

Buka Settings -> Plugins
Klik Add Plugin, pilih Add from GitHub, dan tempel repositori plugin Honeydew: honeydew-ai/honeydew-ai-coding-agents-plugins
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 Honeydew MCP yang ditambahkan oleh plugin, lalu tambahkan endpoint kustom Anda menggunakan instruksi di bawah ini.

Server Honeydew MCP menghubungkan Cortex Code Desktop ke Honeydew Semantic Layer untuk eksplorasi model, kueri data, manajemen 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.

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 mengautentikasi 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 konfigurasinya:

  <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 Honeydew MCP sudah menyertakan alat akses dokumentasi, jadi server dokumentasi terpisah tidak diperlukan. Jika Anda ingin 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

Di pengaturan tim atau organisasi Anda, buka cursor.com/dashboard/plugins (atau klik Plugins di menu sisi kiri)
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.
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
Secara opsional, aktifkan auto-refresh di halaman Marketplace agar plugin diperbarui secara otomatis saat versi baru dirilis.
Kembali ke halaman plugins (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 Honeydew MCP yang ditambahkan oleh plugin, lalu tambahkan endpoint kustom Anda menggunakan instruksi di bawah ini.

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

Untuk menambahkan Honeydew MCP:

Buka aplikasi Cursor
Buka Settings -> Cursor Settings -> Tools & MCP
Klik New MCP Server

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>

Klik Save

Honeydew Documentation MCP (opsional)

Buka Settings -> Cursor Settings -> Tools & MCP
Klik New MCP Server

Tambahkan konfigurasi berikut:

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

Klik Save

Menghapus server MCP

Untuk menghapus server Honeydew MCP:

Buka Settings -> Cursor Settings -> Tools & MCP
Temukan honeydew di daftar dan klik ikon hapus

Untuk menghapus server Honeydew Documentation MCP:

Buka Settings -> Cursor Settings -> Tools & MCP
Temukan honeydew-docs di daftar dan klik ikon hapus

Databricks Genie Code

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

Prasyarat:

Genie Code diaktifkan di ruang kerja 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** ke `honeydew-mcp` * Atur **Connection type** ke **HTTP** * Atur **Auth type** ke **Dynamic Client Registration** * Klik **Next** 3. Pada layar **Authentication**: * Atur **Host** ke `https://mcp.honeydew.cloud` * Biarkan **Port** sebagai `443` * Atur **OAuth scope** ke `openid` * Klik **Next** 4. Pada layar **Connection details**: * Centang **Is MCP connection** * Atur **Base path** ke `/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>
```
Jika organisasi Anda menggunakan nama host Honeydew kustom, ganti `https://mcp.honeydew.cloud` dengan nama host tenant Anda. Anda dapat menemukan nama host Anda di **Settings > MCP Server** di Honeydew Studio. Navigasi ke **Catalog** → **Connections** → `honeydew-mcp` dan klik **Login** di sudut kanan atas untuk mengautentikasi dan memverifikasi koneksi. Berikan hak istimewa `USE CONNECTION` kepada pengguna atau peran mana pun yang memerlukan akses ke server MCP Honeydew:
```
GRANT USE CONNECTION ON CONNECTION `honeydew-mcp` TO <user-or-role>;
```
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** Databricks membatasi MCP hingga 20 alat di semua server yang dikonfigurasi. Jika Anda perlu menyesuaikan alat Honeydew mana yang tersedia, gunakan pengaturan Genie Code MCP untuk mengaktifkan atau menonaktifkan alat tertentu.

Menghapus server MCP

Untuk menghapus server MCP Honeydew dari Genie Code:

Buka Genie Code dan klik ikon roda gigi
Navigasi ke MCP Servers
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.

Untuk menambahkan server MCP Honeydew:

Buka Settings -> Connections -> MCP servers
Klik Add a custom MCP
Masukkan honeydew di bidang Server Name
Secara opsional tambahkan ikon dan Short Description
Pilih HTTP sebagai tipe transport
Masukkan https://mcp.honeydew.cloud/mcp di bidang Server URL

Konfigurasikan autentikasi:

Pilih **OAuth** sebagai metode autentikasi. Devin 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 ke
  `Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET>`
  (lihat [Authentication](#authentication)).
</Tab>

Klik Save, lalu klik Test listing tools untuk memverifikasi koneksi

MCP Dokumentasi Honeydew (opsional)

Buka Settings -> Connections -> MCP servers
Klik Add a custom MCP
Masukkan honeydew-docs di bidang Server Name
Pilih HTTP sebagai tipe transport
Masukkan https://honeydew.ai/docs/mcp di bidang Server URL
Atur metode autentikasi ke None
Klik Save

Menghapus server MCP

Untuk menghapus server MCP Honeydew:

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

Untuk menghapus server MCP Dokumentasi Honeydew:

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

GitHub Copilot CLI

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

Luncurkan GitHub Copilot CLI dengan copilot
Ketik /mcp add untuk membuka formulir konfigurasi server
Isi bidang berikut:
- Name: honeydew
- Type: http
- URL: https://mcp.honeydew.cloud/mcp
- HTTP Headers:
  Tidak diperlukan header tambahan untuk OAuth. ```json theme={null} { "Authorization": "Basic " } ```
Tekan Ctrl+S untuk menyimpan

Gunakan /mcp show untuk memverifikasi server terhubung.

Plugin Agen Pengkodean AI

**Memerlukan Git.** Menginstal plugin dari GitHub akan mengkloning repositori secara lokal, jadi [Git](https://git-scm.com/downloads) harus diinstal dan ada di `PATH` Anda. Jika Git tidak ada, instalasi plugin gagal. Instal Git, atau gunakan langkah-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.

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

MCP Dokumentasi Honeydew (opsional)

Luncurkan GitHub Copilot CLI dengan copilot
Ketik /mcp add untuk membuka formulir konfigurasi server
Isi bidang berikut:
- Name: honeydew-docs
- Type: http
- URL: https://honeydew.ai/docs/mcp
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 Dokumentasi Honeydew:

/mcp remove honeydew-docs

Gemini CLI

#### Instalasi Ekstensi **Memerlukan Git.** Menginstal plugin dari GitHub akan mengkloning repositori secara lokal, jadi [Git](https://git-scm.com/downloads) harus diinstal dan ada di `PATH` Anda. Jika Git tidak ada, instalasi plugin gagal. Instal Git, atau gunakan langkah-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 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

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

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>

MCP Dokumentasi Honeydew (opsional)

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 MCP Dokumentasi Honeydew:

gemini mcp remove honeydew-docs

VS Code dan GitHub Copilot

#### Instalasi Plugin

Tambahkan marketplace Honeydew

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

Tambahkan marketplace Honeydew ke pengaturan chat.plugins.marketplaces:

"chat.plugins.marketplaces": [
  "honeydew-ai/honeydew-ai-coding-agents-plugins"
]

Instal plugin

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

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.

Server MCP

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

Jika organisasi Anda menggunakan nama host Honeydew kustom, ganti `https://mcp.honeydew.cloud/mcp` dengan nama host tenant Anda. Anda dapat menemukan nama host di **Settings > MCP Server** di Honeydew Studio. 1. Buka Palet Perintah dengan `CMD+Shift+P` (macOS) atau `Ctrl+Shift+P` (Windows/Linux) 2. Pilih **MCP: Tambah 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 tersebut 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>

MCP Dokumentasi Honeydew (opsional)

Tambahkan yang berikut 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 MCP Dokumentasi Honeydew, hapus entri honeydew-docs dari file yang sama.

Codex CLI

#### Instalasi Plugin **Memerlukan Git.** Menginstal plugin dari GitHub akan mengkloning repositori secara lokal, jadi [Git](https://git-scm.com/downloads) harus terinstal dan ada di `PATH` Anda. Jika Git tidak ada, instalasi plugin akan gagal. Instal Git, atau gunakan langkah-langkah pengaturan MCP manual klien Anda untuk mengonfigurasi server secara langsung alih-alih menggunakan plugin.

Tambahkan marketplace ke Codex:

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

Lalu luncurkan Codex dengan codex dan ketik /plugins untuk menelusuri dan menginstal plugin AI Honeydew.

Memperbarui plugin

Untuk memperbarui marketplace Honeydew, jalankan:

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

Lalu luncurkan Codex dan ketik /plugins untuk menerapkan pembaruan.

Pengaturan MCP

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

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

Baris perintah

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

Lalu 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 yang berikut 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"

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

MCP Dokumentasi Honeydew (opsional)

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 MCP Dokumentasi Honeydew:

codex mcp remove honeydew-docs

Codex

Tambahkan marketplace di Codex:

Buka Plugin
Klik panah dropdown dan pilih Tambah marketplace
Tambahkan honeydew-ai/honeydew-ai-coding-agents-plugins

Anda juga dapat menambahkan marketplace dari [Codex CLI](#codex-cli):

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

Lalu instal plugin:

Buka Plugin
Pilih marketplace Honeydew AI
Instal plugin Honeydew

Pengaturan MCP

MCP Honeydew

Buka aplikasi Codex
Buka Pengaturan -> Server MCP
Di bawah Server kustom, klik Tambah Server
Atur nama server ke honeydew
Pilih HTTP Streamable sebagai jenis transport
Atur URL ke https://mcp.honeydew.cloud/mcp
Biarkan kolom Variabel lingkungan token pembawa kosong
Konfigurasikan autentikasi sebagai berikut:

Autentikasi OAuth

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

Autentikasi Basic HTTP

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 "Autentikasi" tidak muncul:

Instal Codex CLI
Jalankan codex mcp login honeydew

MCP Dokumentasi Honeydew (opsional)

Buka Pengaturan -> Server MCP
Di bawah Server kustom, klik Tambah Server
Atur nama server ke honeydew-docs
Pilih HTTP Streamable sebagai jenis transport
Atur URL ke https://honeydew.ai/docs/mcp

Menghapus server MCP

Untuk menghapus server MCP Honeydew:

Buka Pengaturan -> Server MCP
Temukan honeydew di bawah Server kustom dan klik Hapus

Untuk menghapus server MCP Dokumentasi Honeydew:

Buka Pengaturan -> Server MCP
Temukan honeydew-docs di bawah Server kustom dan klik Hapus

Antigravity

Buka editor Antigravity
Klik dropdown ... di bagian atas panel agen
Klik Kelola Server MCP
Klik Lihat konfigurasi mentah

Tambahkan yang berikut 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>

Simpan file

MCP Dokumentasi Honeydew (opsional)

Buka editor Antigravity
Klik dropdown ... di bagian atas panel agen
Klik Kelola Server MCP
Klik Lihat konfigurasi mentah

Tambahkan yang berikut ke mcp_config.json:

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

Simpan file

Menghapus server MCP

Untuk menghapus server MCP Honeydew:

Buka editor Antigravity
Klik dropdown ... di bagian atas panel agen
Klik Kelola Server MCP
Klik Lihat konfigurasi mentah
Hapus entri honeydew dan honeydew-docs dari mcp_config.json
Simpan file

OpenCode

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

  Saat diminta, masukkan nilai berikut:

  1. **Lokasi**: Pilih cakupan pilihan Anda (proyek saat ini atau global)
  2. **Nama server MCP**: `honeydew`
  3. **Jenis server MCP**: `Remote`
  4. **URL server MCP**: `https://mcp.honeydew.cloud/mcp`
  5. **Autentikasi OAuth**: `Yes`
  6. **ID klien pra-registrasi**: `No`
</Tab>

<Tab title="JSON configuration">
  Tambahkan yang berikut 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": {}
          }
        }
      }
      ```

      Lalu 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 logout terlebih dahulu:

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

MCP Dokumentasi Honeydew (opsional)

Jalankan `opencode mcp add` dan masukkan nilai berikut:

  1. **Nama server MCP**: `honeydew-docs`
  2. **Jenis server MCP**: `Remote`
  3. **URL server MCP**: `https://honeydew.ai/docs/mcp`
  4. **Autentikasi OAuth**: `No`
</Tab>

<Tab title="JSON configuration">
  Tambahkan yang berikut 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 Dokumentasi Honeydew, hapus entri honeydew-docs dari file yang sama.

Kiro

Kiro IDE 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)
Pengguna: ~/.kiro/settings/mcp.json (berlaku di semua workspace)

Jika kedua file ada, konfigurasi workspace yang diutamakan. Jika organisasi Anda menggunakan nama host Honeydew kustom, ganti https://mcp.honeydew.cloud/mcp dengan nama host tenant Anda. Anda dapat menemukan nama host 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 Kiro CLI, jalankan /mcp untuk memverifikasi server terhubung. Di Kiro IDE, server muncul di bawah 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 ingin akses dokumentasi tanpa terhubung ke Honeydew. Tidak diperlukan autentikasi.

Tambahkan yang berikut 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), 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.

Jika organisasi Anda menggunakan nama host Honeydew kustom, ganti `https://mcp.honeydew.cloud/mcp` dengan nama host tenant Anda. Anda dapat menemukan nama host 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 merujuk 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 penggunaan pada integrasi dan server MCP
  ke peran apa pun 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 diminta untuk mengautentikasi dengan OAuth ke Honeydew pada penggunaan pertama.
</Step>

Server Honeydew Documentation MCP mandiri tidak didukung di Snowflake, karena server MCP eksternal Snowflake memerlukan autentikasi OAuth dan server dokumentasi tidak terautentikasi. 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

Setiap klien yang kompatibel dengan MCP dapat terhubung ke Honeydew MCP Server menggunakan transport HTTP standar.

Gunakan konfigurasi JSON berikut sebagai titik awal:

Jika organisasi Anda menggunakan nama host Honeydew kustom, ganti `https://mcp.honeydew.cloud/mcp` dengan nama host tenant Anda. Anda dapat menemukan nama host 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 memberikan pertanyaan kepada asisten AI Anda seperti:

"Entitas apa yang tersedia dalam model semantik?"
"Tunjukkan atribut dan metrik untuk entitas orders"
"Domain apa yang didefinisikan dalam model?"
"Tabel apa yang ada di skema analytics?"
"Berapa banyak pesanan yang dibuat bulan lalu?"
"Buat metrik baru untuk total pendapatan pada entitas orders"
"Berapa nilai pesanan rata-rata berdasarkan 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 petunjuk OAuth browser untuk terhubung kembali ke Honeydew.

Masalah Koneksi

Konfirmasi URL server MCP cocok dengan https://mcp.honeydew.cloud/mcp dan verifikasi sintaks konfigurasi MCP klien Anda sudah benar. Jika organisasi Anda menggunakan nama host kustom, periksa apakah URL cocok dengan nama host 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 Token Maksimum yang Diizinkan (Claude)

Di Claude Code, Claude Desktop, dan Claude.ai, panggilan alat dapat gagal dengan kesalahan bahwa output melebihi 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 dokumen Claude untuk detailnya.

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

Alat yang Tersedia

Alat yang ditandai sebagai read-only tidak mengubah model semantik atau gudang data.

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

Sesi & Workspace

`list_workspaces`

read-only

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

read-only

Daftar semua cabang yang tersedia untuk sebuah workspace.

Nama workspace.

`get_session_workspace_and_branch`

read-only

Dapatkan workspace dan cabang yang ditetapkan untuk sesi saat ini.

`set_session_workspace_and_branch`

read-only

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

read-only

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`

read-only

Mulai atau lanjutkan analisis data. Mengembalikan conversation_id — gunakan monitor_analysis untuk polling 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`

read-only

Polling pesan kemajuan baru dari analisis yang sedang berlangsung. Setiap panggilan hanya mengembalikan pesan sejak panggilan terakhir. Lakukan polling 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 memutar ulang. Gunakan `last_received_message_id` dari hasil sebelumnya untuk memulihkan pesan yang terlewat.

`get_analysis_step_details`

read-only

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

ID Percakapan yang dikembalikan oleh `initiate_analysis`. ID Langkah dari `monitor_analysis` (mis. `STEP/0`).

`abort_analysis`

read-only

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

ID Percakapan yang dikembalikan oleh `initiate_analysis`.

`list_analysis_chats`

read-only

Kembalikan daftar percakapan analisis yang dipaginasi untuk workspace saat ini, diurutkan berdasarkan waktu pembuatan (terbaru dulu). Admin melihat semua percakapan; non-admin hanya melihat milik 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 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 dari seluruh 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`

read-only Kembalikan semua pesan dari percakapan analisis yang ada. Gunakan ini untuk meninjau konten lengkap dari 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 final dan pesan rencana/interpretasi.

Jelajah & Penemuan

`list_entities`

hanya-baca

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

`get_entity`

hanya-baca

Dapatkan informasi detail tentang suatu entitas, termasuk atribut, metrik, dataset, relasi, dan definisi YAML-nya.

Nama entitas.

`get_field`

hanya-baca

Dapatkan informasi detail tentang bidang tertentu (atribut atau metrik) dalam suatu 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 detail tentang suatu domain, termasuk entitas, filter, parameter, dan definisi YAML-nya.

Nama domain.

`search_model`

hanya-baca

Cari model semantik untuk entitas, atribut, metrik, dataset, dataset 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.

String kueri pencarian. Mengontrol bagaimana kueri dicocokkan:

OR — memisah berdasarkan spasi, mengembalikan objek yang cocok dengan kata apa pun.
AND — memisah berdasarkan spasi, hanya mengembalikan objek yang cocok dengan semua kata.
EXACT — menggunakan string lengkap apa adanya, mengembalikan objek yang nama atau nama tampilannya cocok persis.

Penemuan Warehouse

`list_databases`

hanya-baca

Daftarkan semua database yang tersedia di data warehouse yang terhubung.

`list_schemas`

hanya-baca

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

Nama database.

`list_tables`

hanya-baca

Daftarkan tabel/view dalam database dan skema tertentu di data warehouse yang terhubung.

Nama database. Nama skema.

`get_table_info`

hanya-baca

Dapatkan informasi detail tentang tabel/view warehouse, termasuk kolom dan metadatanya.

Nama database. Nama skema. Nama tabel.

Model Semantik

`import_tables`

Impor tabel dari data warehouse 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 dataset.

`create_object`

Buat objek model semantik baru dari definisi YAML. Tipe yang didukung: atribut, metrik, dataset dinamis, domain, dan parameter global.

Definisi YAML objek. Buat objek meskipun validasi menghasilkan kesalahan.

`update_object`

Perbarui objek model semantik yang ada dari definisi YAML. Tipe yang didukung: entitas, atribut, metrik, dataset, dataset dinamis, domain, dan parameter global.

Definisi YAML 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. Tipe yang didukung: entitas, atribut, metrik, dataset, dataset 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 detail tentang suatu 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 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 perkenalan 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 yang diperbarui sepenuhnya. Semua bidang yang diperlukan 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 tipe, nama, judul, dan nilai subtipenya.

`get_context_item`

hanya-baca

Dapatkan item konteks berdasarkan nama.

Nama item konteks yang akan diambil.

`create_context_item`

Buat item konteks baru. Mendukung tipe 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
  (diperlukan 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
  (diperlukan 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 yang diperbarui sepenuhnya. Semua bidang yang diperlukan 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 dikueri. Jumlah maksimum baris yang akan dikembalikan. Jumlah baris yang dilewati untuk paginasi.

`get_data_from_fields`

hanya-baca

Jalankan kueri lapisan semantik yang ditentukan oleh atribut, metrik, dan filter, dan kembalikan data yang dihasilkan.

`list_query_history`

hanya-baca

Daftar kueri yang sebelumnya dieksekusi melalui lapisan semantik Honeydew, yang terbaru terlebih dahulu. Gunakan untuk menemukan dan mendiagnosis kueri yang gagal serta memahami mengapa mereka gagal. Pemanggil non-admin hanya melihat kueri mereka sendiri.

Setiap kueri mencakup statusnya, pesan kesalahan, pemilik, klien, domain, SQL input asli (SQL yang dikirimkan 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 (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 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 dari setiap kueri (besar). Aktifkan untuk debugging sisi gudang data dari 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 suatu halaman, gunakan query_docs_filesystem.

Kueri pencarian.

`query_docs_filesystem`

hanya-baca

Jalankan perintah seperti 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`).