Honeydew Semantic Layer

resmi

Honeydew semantic layer, kaynaklar arasında metrikleri, boyutları ve ilişkileri birleştiren, yönetilebilir ve iş dostu bir veri modeli sunarak tutarlı self-servis analitik ve yapay zeka destekli veri erişimi sağlar.

honeydew.ai üzerinde görüntüleBu MCP'yi deneyinSponsorlu

Honeydew Semantic Layer MCP ile neler yapabilirsiniz?

Depo meta verilerini keşfedin — Asistanınızdan deponuzdaki tabloları, şemaları ve semantik model tanımlarını keşfetmesini isteyin.
Semantik modelleri yönetin — create_workspace_branch ile çalışma alanı dalları oluşturma dahil, doğal konuşma yoluyla semantik modelinizi oluşturun ve sürdürün.
Verileri konuşarak sorgulayın — Herhangi bir MCP uyumlu asistandan verilerinizi sorgulamak için doğal dil kullanın.
Oturum bağlamını yapılandırın — list_workspaces ve list_workspace_branches ile mevcut seçenekleri listeledikten sonra set_session_workspace_and_branch kullanarak aktif çalışma alanınızı ve dalınızı ayarlayın.
Honeydew belgelerine erişin — MCP sunucusunun yerleşik belgeleme araçları aracılığıyla Honeydew belgelerini doğrudan arayın ve okuyun.

Dokümantasyon

MCP Sunucusu

MCP Nedir?

Model Context Protocol (MCP) yapay zeka uygulamalarını harici sistemlere ve araçlara güvenli bir şekilde bağlamak için açık kaynaklı bir standarttır. Honeydew, yapay zeka kodlama asistanınızı Honeydew Semantic Layer'a bağlayan bir MCP sunucusu sağlar.

Ne zaman kullanılır

Tablo şemalarınızı, şemalarınızı ve semantik model tanımlarınızı keşfedin ve inceleyin
Doğal konuşma yoluyla semantik modelinizi oluşturun ve bakımını yapın
MCP uyumlu herhangi bir asistandan doğal dil ile verilerinizi sorgulayın
Honeydew dokümantasyonunu arayın ve okuyun

Kurulum

Sunucu URL'si

Honeydew, MCP Sunucu API'sini şu adreste sunar: https://mcp.honeydew.cloud/mcp

Not

Kuruluşunuz özel bir Honeydew ana bilgisayar adı kullanıyorsa, varsayılan URL'yi kiracı ana bilgisayar adınızla değiştirin. Ana bilgisayar adını Honeydew arayüzünde Ayarlar > MCP Sunucusu altında bulabilirsiniz.

Kimlik Doğrulama

Honeydew MCP Sunucusu ile kimlik doğrulamanın iki yolu vardır: OAuth veya HTTP Temel kimlik doğrulaması.

OAuth Kimlik Doğrulaması (önerilir)

Çoğu istemci OAuth kimlik doğrulamasını destekler. İlk bağlandığınızda şunları yapmanız istenecektir:

Honeydew hesabınızla giriş yapın
OAuth yetkilendirmesini kabul edin

İstemci daha sonra sonraki istekler için güvenli bir şekilde bir erişim belirteci sağlar.

HTTP Temel Kimlik Doğrulaması

HTTP Temel kimlik doğrulama modundaki MCP Sunucusu, kimlik doğrulama için bir API Anahtarı gerektirir.

API Anahtarınızın ve API Sırrınızın API_KEY:API_SECRET biçiminde Base64 kodlu bir dizesini sağlamanız gerekir.

İpucu

MCP Sunucusu erişimi için yeni bir API Anahtarı oluşturuyorsanız, Base64 kodlu dizeyi oluşturma sırasında Honeydew Studio arayüzünden kopyalayabilirsiniz.

Base64 kodlu dizeyi oluşturmak için aşağıdaki komutu kullanabilirsiniz:

```bash theme={null} echo -n ':' | base64 ``` PowerShell kullanın:

```powershell theme={null}
[Convert]::ToBase64String(
  [Text.Encoding]::UTF8.GetBytes(
    "<API_KEY>:<API_SECRET>"
  )
)
```

Kodlanmış dizeyi Authorization başlığında şu şekilde sağlayın:

Authorization: Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET>

Yapılandırma

Çalışma alanı ve dal, oturum düzeyinde list_workspaces, list_workspace_branches ve set_session_workspace_and_branch araçları kullanılarak ayarlanır. Ayrıca create_workspace_branch ile yeni dallar oluşturabilirsiniz. MCP sunucusuna bağlandıktan sonra bu araçları yapay zeka asistanınızdan çağırın.

İsteğe bağlı olarak MCP sunucu yapılandırmanızda şu başlıkları sağlayabilirsiniz:

Workspace: Tüm istekler için çalışma alanını sabitleyin (isteğe bağlı)
Branch: Tüm istekler için belirli bir çalışma alanı dalını sabitleyin (isteğe bağlı, çalışma alanı ayarlanmışsa prod varsayılanı)
Honeydew-Client: MCP istemcisini tanımlayın (isteğe bağlı, bağlı araçtan otomatik olarak algılanır). Belirli bir istemci tanımlayıcısı sağlamak için bu başlığı iletin.
ReadonlyToolsOnly: Yalnızca salt okunur araçları kullanıma sunmak için true olarak ayarlayın (isteğe bağlı)

Not

MCP sunucusu, etkin çalışma alanı ve dal dahil olmak üzere oturum durumunu korumak için Mcp-Session-Id yanıt başlığını kullanır. Ayrıntılar için MCP oturum yönetimi belirtimine bakın.

Desteklenen İstemciler

Claude Code CLI

#### Eklenti Kurulumu

Not

Git gerektirir. Eklentiyi GitHub'dan kurmak, depoyu yerel olarak klonlar, bu nedenle Git kurulu olmalı ve PATH üzerinde olmalıdır. Git yoksa, eklenti kurulumu başarısız olur. Git'i kurun veya sunucuyu doğrudan yapılandırmak için istemcinizin manuel MCP kurulum adımlarını kullanın eklenti yerine.

Honeydew, doğal konuşma yoluyla semantik modeller oluşturmak ve verileri analiz etmek için beceriler ve araçlar içeren bir eklenti deposu sağlar. Eklentiyi kurmak, Honeydew MCP sunucularını otomatik olarak ayarlar.

Claude Code'u claude ile başlatın, ardından pazar yerini ekleyin:

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

Ardından Honeydew eklentisini pazar yerinden kurun:

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

Ardından etkinleştirmek için eklentileri yeniden yükleyin:

/reload-plugins

Eklentileri güncelleme

Honeydew pazar yeri eklentilerini güncellemek için Claude Code'u claude ile başlatın, ardından:

/plugin yazın ve üstteki seçicide Pazar Yerleri'ni seçin
honeydew-ai-coding-agents-plugins seçin
Pazar yerini güncelle'ye tıklayın

Güncellemeleri otomatik almak için pazar yeri ayarlarında Otomatik güncellemeyi etkinleştir'i seçin.

MCP Kurulumu

Kuruluşunuz özel bir Honeydew uç noktası kullanıyorsa veya eklentiyi kurmadan MCP sunucularını yapılandırmayı tercih ediyorsanız bu bölümü kullanın. Eklenti tarafından eklenen Honeydew MCP bağlantısını devre dışı bırakın, ardından aşağıdaki talimatları kullanarak özel uç noktanızı ekleyin.

Honeydew MCP sunucusu, model keşfi, veri sorgulama, model yönetimi ve dokümantasyon erişimi için Claude Code'u Honeydew Semantic Layer'a bağlar.

Honeydew MCP sunucusunu eklemek için aşağıdaki yöntemlerden birini kullanın:

Not

Kuruluşunuz özel bir Honeydew ana bilgisayar adı kullanıyorsa, https://mcp.honeydew.cloud/mcp değerini kiracı ana bilgisayar adınızla değiştirin. Ana bilgisayar adını Honeydew Studio'da Ayarlar > MCP Sunucusu altında bulabilirsiniz.

```bash theme={null} claude mcp add --transport http honeydew \ https://mcp.honeydew.cloud/mcp ```

      Claude Code'u `claude` ile başlatın.
      Honeydew'a OAuth ile kimlik doğrulamanız istenecektir.
    </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">
  Aşağıdakini `honeydew-mcp.json` dosyasına kaydedin:

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

      Ardından şununla kaydedin:

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

      Claude Code'u `claude` ile başlatın.
      Honeydew'a OAuth ile kimlik doğrulamanız istenecektir.
    </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>"
        }
      }
      ```

      Ardından şununla kaydedin:

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

<Tab title=".mcp.json">
  `.mcp.json` dosyanıza aşağıdakini ekleyin:

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

      Claude Code'u `claude` ile başlatın.
      Honeydew'a OAuth ile kimlik doğrulamanız istenecektir.
    </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>

İpucu

API Anahtarı kimlik doğrulaması için ortam değişkenlerini kullanma

Hassas değerleri doğrudan yapılandırma dosyalarında saklamaktan kaçınmak için Claude Code, ${VAR_NAME} sözdizimini kullanan ortam değişkeni genişletmeyi destekler.

HONEYDEW_API_KEY ortam değişkenini ayarlayın, ardından yapılandırmanızda buna başvurun:
claude mcp add --transport http honeydew \
    https://mcp.honeydew.cloud/mcp \
    --header "Authorization: Basic ${HONEYDEW_API_KEY}"
Claude Code, ${VAR_NAME} referanslarını çalışma zamanında ortamınızdan çözer.

Honeydew Dokümantasyon MCP'si (isteğe bağlı)

Honeydew MCP sunucusu zaten dokümantasyon erişim araçlarını içerir, bu nedenle ayrı bir dokümantasyon sunucusu gerekmez. Honeydew Dokümantasyon MCP'sini yalnızca Honeydew'a bağlanmadan dokümantasyon erişimi istiyorsanız ekleyin. Kimlik doğrulama gerekmez.

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

MCP sunucusunu kaldırma

Honeydew MCP sunucusunu kaldırmak için:

claude mcp remove honeydew

Honeydew Dokümantasyon MCP sunucusunu kaldırmak için:

claude mcp remove honeydew-docs

Claude Desktop

#### Eklenti Kurulumu

Not

Git gerektirir. Eklentiyi GitHub'dan kurmak, depoyu yerel olarak klonlar, bu nedenle Git kurulu olmalı ve PATH üzerinde olmalıdır. Git yoksa, eklenti kurulumu başarısız olur. Git'i kurun veya sunucuyu doğrudan yapılandırmak için istemcinizin manuel MCP kurulum adımlarını kullanın eklenti yerine.

Ayarlar -> Özelleştir bölümüne gidin
Eklentilere Göz At'a tıklayın
Kişisel sekmesine gidin
+ simgesine tıklayın ve GitHub'dan pazar yeri ekle'yi seçin
Giriş kutusuna honeydew-ai/honeydew-ai-coding-agents-plugins girin
Honeydew AI eklentisi görünür. Kurun.

MCP Kurulumu

Honeydew MCP sunucusu, model keşfi, veri sorgulama, model yönetimi ve dokümantasyon erişimi için Claude Desktop'u Honeydew Semantic Layer'a bağlar.

Claude Code modu

Claude Desktop'u Claude Code modunda kullanırken, bunun yerine Claude Code CLI talimatlarını izleyin.

Not

Kuruluşunuz özel bir Honeydew ana bilgisayar adı kullanıyorsa, https://mcp.honeydew.cloud/mcp değerini kiracı ana bilgisayar adınızla değiştirin. Ana bilgisayar adını Honeydew Studio'da Ayarlar > MCP Sunucusu altında bulabilirsiniz.

Cowork modunda Honeydew MCP'yi eklemek için:

Ayarlar -> Bağlayıcılar -> Özel bağlayıcı ekle bölümüne gidin
Ad alanına honeydew girin
Uzak MCP sunucu URL'si alanına https://mcp.honeydew.cloud/mcp girin
Ekle'ye tıklayın

İlk bağlandığınızda Honeydew'a OAuth ile kimlik doğrulamanız istenecektir.

Honeydew Dokümantasyon MCP'si (isteğe bağlı)

Ayarlar -> Bağlayıcılar -> Özel bağlayıcı ekle bölümüne gidin
Ad alanına honeydew-docs girin
Uzak MCP sunucu URL'si alanına https://honeydew.ai/docs/mcp girin
Ekle'ye tıklayın

MCP sunucusunu kaldırma

Cowork modunda Honeydew MCP sunucusunu kaldırmak için:

Ayarlar -> Bağlayıcılar bölümüne gidin
honeydew bağlayıcısını bulun ve sil simgesine tıklayın

Honeydew Dokümantasyon MCP sunucusunu kaldırmak için:

Ayarlar -> Bağlayıcılar bölümüne gidin
honeydew-docs bağlayıcısını bulun ve sil simgesine tıklayın

Claude.ai

#### Eklenti Kurulumu

Honeydew, doğal konuşma yoluyla semantik modeller oluşturmak ve verileri analiz etmek için beceriler ve araçlar içeren bir eklenti deposu sağlar. Eklentiyi kurmak, hem Honeydew MCP sunucusunu hem de Honeydew Dokümantasyon MCP sunucusunu otomatik olarak ayarlar.

Eklenti zip'ini indirin: honeydew-ai-claude.zip
Claude.ai'de Ayarlar -> Eklentiler -> Eklenti ekle -> Zip yükle bölümüne gidin
Zip'i yükleyin — eklenti özel pazar yerinizde görünür

MCP Kurulumu

Kuruluşunuz özel bir Honeydew uç noktası kullanıyorsa veya eklentiyi kurmadan MCP sunucularını yapılandırmayı tercih ediyorsanız bu bölümü kullanın. Eklenti tarafından eklenen Honeydew MCP bağlayıcısını kaldırın, ardından aşağıdaki talimatları kullanarak özel uç noktanızı ekleyin.

Honeydew MCP sunucusu, model keşfi, veri sorgulama, model yönetimi ve dokümantasyon erişimi için Claude.ai'yi Honeydew Semantic Layer'a bağlar.

Not

Kuruluşunuz özel bir Honeydew ana bilgisayar adı kullanıyorsa, https://mcp.honeydew.cloud/mcp değerini kiracı ana bilgisayar adınızla değiştirin. Ana bilgisayar adını Honeydew Studio'da Ayarlar > MCP Sunucusu altında bulabilirsiniz.

Honeydew MCP sunucusunu eklemek için:

Ayarlar -> Bağlayıcılar -> Özel bağlayıcı ekle bölümüne gidin
Ad alanına honeydew girin
Uzak MCP sunucu URL'si alanına https://mcp.honeydew.cloud/mcp girin
Ekle'ye tıklayın

İlk bağlantıda Honeydew'e OAuth ile kimlik doğrulamanız istenecektir.

Honeydew Dokümantasyon MCP'si (isteğe bağlı)

Honeydew MCP sunucusu zaten dokümantasyon erişim araçlarını içerir, bu nedenle ayrı bir dokümantasyon sunucusuna gerek yoktur. Honeydew Dokümantasyon MCP'sini yalnızca Honeydew'e bağlanmadan dokümantasyon erişimi istiyorsanız ekleyin. Kimlik doğrulama gerekmez.

Ayarlar -> Bağlayıcılar -> Özel bağlayıcı ekle bölümüne gidin
Ad alanına honeydew-docs girin
Uzak MCP sunucu URL'si alanına https://honeydew.ai/docs/mcp girin
Ekle'ye tıklayın

MCP sunucusunu kaldırma

Honeydew MCP sunucusunu kaldırmak için:

Ayarlar -> Bağlayıcılar bölümüne gidin
honeydew bağlayıcısını bulun ve sil simgesine tıklayın

Honeydew Dokümantasyon MCP sunucusunu kaldırmak için:

Ayarlar -> Bağlayıcılar bölümüne gidin
honeydew-docs bağlayıcısını bulun ve sil simgesine tıklayın

Cortex Code CLI

#### Eklenti Kurulumu

Not

Git gerektirir. Eklentiyi GitHub'dan yüklemek, depoyu yerel olarak kopyalar, bu nedenle Git kurulu olmalı ve PATH üzerinde bulunmalıdır. Git eksikse, eklenti kurulumu başarısız olur. Git'i kurun veya eklenti yerine sunucuyu doğrudan yapılandırmak için istemcinizin manuel MCP kurulum adımlarını kullanın.

Honeydew, doğal konuşma yoluyla anlamsal modeller oluşturmak ve verileri analiz etmek için beceriler ve araçlar içeren bir eklenti deposu sağlar. Eklentiyi kurmak, Honeydew MCP sunucularını otomatik olarak yapılandırır.

Cortex Code CLI'yi cortex ile başlatın, ardından eklentiyi kurun:

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

MCP Kurulumu

Honeydew MCP sunucusu, Cortex Code CLI'yi Honeydew Semantic Layer'a bağlar; model keşfi, veri sorgulama, model yönetimi ve dokümantasyon erişimi için.

Not

Kuruluşunuz özel bir Honeydew ana bilgisayar adı kullanıyorsa, https://mcp.honeydew.cloud/mcp değerini kiracı ana bilgisayar adınızla değiştirin. Ana bilgisayar adını Honeydew Studio'da Ayarlar > MCP Sunucusu bölümünde bulabilirsiniz.

```bash theme={null} cortex mcp add honeydew \ https://mcp.honeydew.cloud/mcp \ --type http ```

      Cortex Code CLI'yi `cortex` ile başlatın.
      Honeydew'e OAuth ile kimlik doğrulamanız
      istenecektir.
    </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">
  Aşağıdakini `honeydew-mcp.json` dosyasına kaydedin:

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

      Ardından şununla kaydedin:

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

      Cortex Code CLI'yi `cortex` ile başlatın.
      Honeydew'e OAuth ile kimlik doğrulamanız
      istenecektir.
    </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>"
        }
      }
      ```

      Ardından şununla kaydedin:

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

<Tab title="mcp.json">
  Aşağıdakini `~/.snowflake/cortex/mcp.json` dosyasına ekleyin:

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

      Cortex Code CLI'yi `cortex` ile başlatın.
      Honeydew'e OAuth ile kimlik doğrulamanız
      istenecektir.
    </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 Dokümantasyon MCP'si (isteğe bağlı)

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

MCP sunucusunu kaldırma

Honeydew MCP sunucusunu kaldırmak için:

cortex mcp remove honeydew

Honeydew Dokümantasyon MCP sunucusunu kaldırmak için:

cortex mcp remove honeydew-docs

Cortex Code Desktop

#### Eklenti Kurulumu

Not

Git gerektirir. Eklentiyi GitHub'dan yüklemek, depoyu yerel olarak kopyalar, bu nedenle Git kurulu olmalı ve PATH üzerinde bulunmalıdır. Git eksikse, eklenti kurulumu başarısız olur. Git'i kurun veya eklenti yerine sunucuyu doğrudan yapılandırmak için istemcinizin manuel MCP kurulum adımlarını kullanın.

Ayarlar -> Eklentiler bölümüne gidin
Eklenti Ekle'ye tıklayın, GitHub'dan Ekle'yi seçin ve Honeydew eklenti deposunu yapıştırın: honeydew-ai/honeydew-ai-coding-agents-plugins
Akışı izleyin ve GitHub Eklenti Yükleyici Kurulumu'ndaki adımları onaylayın

MCP Kurulumu

Honeydew MCP sunucusu, Cortex Code Desktop'ı Honeydew Semantic Layer'a bağlar; model keşfi, veri sorgulama, model yönetimi ve dokümantasyon erişimi için.

Sunucu eklemek için MCP -> Yeni bölümüne gidin, bir Yapılandırma Kapsamı seçin (örneğin, Global için ~/.snowflake/cortex/mcp.json), formu doldurun, ardından Kaydet'e tıklayın. Yapılandırmayı girmek için Form veya JSON sekmesini kullanın.

Not

Kuruluşunuz özel bir Honeydew ana bilgisayar adı kullanıyorsa, https://mcp.honeydew.cloud/mcp değerini kiracı ana bilgisayar adınızla değiştirin. Ana bilgisayar adını Honeydew Studio'da Ayarlar > MCP Sunucusu bölümünde bulabilirsiniz.

Honeydew MCP sunucusunu ekleyin:

1. **Sunucu Adı**: `honeydew` 2. **Sunucu Türü**: **Uzak (HTTP)** 3. **Sunucu URL'si**: `https://mcp.honeydew.cloud/mcp` 4. **Kaydet**'e tıklayın

      İlk bağlantıda Honeydew'e OAuth ile kimlik doğrulamanız
      istenecektir.
    </Tab>

    <Tab title="API Key">
      1. **Sunucu Adı**: `honeydew`
      2. **Sunucu Türü**: **Uzak (HTTP)**
      3. **Sunucu URL'si**: `https://mcp.honeydew.cloud/mcp`
      4. **Başlıklar** altında, **Başlık Ekle**'ye tıklayın ve adı
         `Authorization` ve değeri
         `Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET>` olarak ayarlayın
      5. **Kaydet**'e tıklayın
    </Tab>
  </Tabs>
</Tab>

<Tab title="JSON">
  **JSON** sekmesine geçin ve yapılandırmayı yapıştırın:

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

      İlk bağlantıda Honeydew'e OAuth ile kimlik doğrulamanız
      istenecektir.
    </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 Dokümantasyon MCP'si (isteğe bağlı)

Honeydew MCP sunucusu zaten dokümantasyon erişim araçlarını içerir, bu nedenle ayrı bir dokümantasyon sunucusuna gerek yoktur. Honeydew'e bağlanmadan dokümantasyon erişimi istiyorsanız, Honeydew Dokümantasyon MCP sunucusunu aynı şekilde ekleyin; Sunucu Adı honeydew-docs, Sunucu Türü Uzak (HTTP) ve Sunucu URL'si https://honeydew.ai/docs/mcp kullanarak. Kimlik doğrulama gerekmez.

MCP sunucusunu kaldırma

Bir sunucuyu kaldırmak için MCP bölümüne gidin, honeydew (veya honeydew-docs) sunucusunu bulun ve kaldırın.

Cursor

#### Eklenti Kurulumu

Takım veya kuruluş ayarlarınızda, cursor.com/dashboard/plugins bölümüne gidin (veya sol menüdeki Eklentiler'e tıklayın)
Takım Pazaryerleri'ne ilerleyin ve mevcut bir Pazaryeri'ne tıklayın veya yeni bir tane oluşturmak için Pazaryeri Ekle'ye tıklayın. Yeni bir tane oluşturuyorsanız, bir ad girin ve oluşturun.
Pazaryeri içinde Eklenti Ekle'ye tıklayın, Honeydew eklenti GitHub deposu yolunu yapıştırın: https://github.com/honeydew-ai/honeydew-ai-coding-agents-plugins ve 1 eklenti ekle'ye tıklayın
İsteğe bağlı olarak, Pazaryeri sayfasında otomatik yenilemeyi etkinleştirin böylece yeni sürümler yayınlandığında eklenti otomatik olarak güncellenir.
Eklentiler sayfasına geri dönün (cursor.com/dashboard/plugins), Honeydew eklentisini arayın ve Ekle'ye tıklayın

MCP Kurulumu

Honeydew MCP sunucusu, Cursor'ı Honeydew Semantic Layer'a bağlar; model keşfi, veri sorgulama, model yönetimi ve dokümantasyon erişimi için.

Not

Kuruluşunuz özel bir Honeydew ana bilgisayar adı kullanıyorsa, https://mcp.honeydew.cloud/mcp değerini kiracı ana bilgisayar adınızla değiştirin. Ana bilgisayar adını Honeydew Studio'da Ayarlar > MCP Sunucusu bölümünde bulabilirsiniz.

Honeydew MCP'yi eklemek için:

Cursor uygulamasını açın
Ayarlar -> Cursor Ayarları -> Araçlar ve MCP bölümüne gidin
Yeni MCP Sunucusu'na tıklayın

Aşağıdaki yapılandırmayı ekleyin:

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

Kaydet'e tıklayın

Honeydew Dokümantasyon MCP'si (isteğe bağlı)

Ayarlar -> Cursor Ayarları -> Araçlar ve MCP bölümüne gidin
Yeni MCP Sunucusu'na tıklayın

Aşağıdaki yapılandırmayı ekleyin:

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

Kaydet'e tıklayın

MCP sunucusunu kaldırma

Honeydew MCP sunucusunu kaldırmak için:

Ayarlar -> Cursor Ayarları -> Araçlar ve MCP bölümüne gidin
Listede honeydew bulun ve sil simgesine tıklayın

Honeydew Dokümantasyon MCP sunucusunu kaldırmak için:

Ayarlar -> Cursor Ayarları -> Araçlar ve MCP bölümüne gidin
Listede honeydew-docs bulun ve sil simgesine tıklayın

Databricks Genie Code

> **Not** > > MCP sunucuları yalnızca Genie Code Ajan modunda desteklenir. > Daha fazla ayrıntı için bkz. > [Databricks MCP dokümantasyonu](https://docs.databricks.com/aws/en/generative-ai/mcp/).

Ön koşullar:

Databricks çalışma alanınızda Genie Code etkinleştirilmiş olmalı
Unity Catalog metastore'unda CREATE CONNECTION ayrıcalığı

1. **Katalog** → **Bağlantılar** → **Bağlantı oluştur** bölümüne gidin 2. **Bağlantı temelleri** ekranında: * **Bağlantı adını** `honeydew-mcp` olarak ayarlayın * **Bağlantı türünü** **HTTP** olarak ayarlayın * **Kimlik doğrulama türünü** **Dinamik İstemci Kaydı** olarak ayarlayın * **İleri**'ye tıklayın 3. **Kimlik doğrulama** ekranında: * **Ana makineyi** `https://mcp.honeydew.cloud` olarak ayarlayın * **Bağlantı noktasını** `443` olarak bırakın * **OAuth kapsamını** `openid` olarak ayarlayın * **İleri**'ye tıklayın 4. **Bağlantı ayrıntıları** ekranında: * **MCP bağlantısı** seçeneğini işaretleyin * **Temel yolu** `/mcp` olarak ayarlayın * **Bağlantı oluştur**'a tıklayın

    <Tab title="SQL">
      Bir Databricks not defterinde veya SQL düzenleyicisinde aşağıdaki SQL'i çalıştırın:

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

Not

Kuruluşunuz özel bir Honeydew ana makine adı kullanıyorsa, https://mcp.honeydew.cloud değerini kendi kiracı ana makine adınızla değiştirin. Ana makine adınızı Honeydew Studio'da Ayarlar > MCP Sunucusu bölümünde bulabilirsiniz.

<Step title="Log in to the connection">
  **Katalog** → **Bağlantılar** → `honeydew-mcp` bölümüne gidin
  ve kimlik doğrulamak ve bağlantıyı doğrulamak için
  sağ üst köşedeki **Oturum aç** düğmesine tıklayın.
</Step>

<Step title="Grant connection access">
  Honeydew MCP sunucusuna erişmesi gereken tüm kullanıcılara veya rollere
  `USE CONNECTION` ayrıcalığını verin:

  ```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. Genie Code'u açın ve dişli simgesine tıklayın
  2. **MCP Sunucuları** → **Sunucu Ekle** bölümüne gidin
  3. **Harici MCP sunucusu**'nu seçin
  4. Oluşturduğunuz `honeydew-mcp` bağlantısını seçin
  5. İstendiğinde bağlantıya oturum açın
  6. **Kaydet**'e tıklayın

Not

Databricks, MCP'yi yapılandırılan tüm sunucularda 20 araçla sınırlar. Hangi Honeydew araçlarının kullanılabilir olduğunu ayarlamanız gerekiyorsa, belirli araçları etkinleştirmek veya devre dışı bırakmak için Genie Code MCP ayarlarını kullanın.

MCP sunucusunu kaldırma

Honeydew MCP sunucusunu Genie Code'dan kaldırmak için:

Genie Code'u açın ve dişli simgesine tıklayın
MCP Sunucuları bölümüne gidin
honeydew-mcp öğesini bulun ve Kaldır'a tıklayın

Temeldeki Unity Catalog bağlantısını da kaldırmak için aşağıdaki SQL'i çalıştırın:

DROP CONNECTION `honeydew-mcp`;

Devin

#### MCP Sunucusu

Devin, MCP Pazar Yeri aracılığıyla uzak MCP sunucularına bağlanır.

Not

Kuruluşunuz özel bir Honeydew ana makine adı kullanıyorsa, https://mcp.honeydew.cloud/mcp değerini kendi kiracı ana makine adınızla değiştirin. Ana makine adını Honeydew Studio'da Ayarlar > MCP Sunucusu bölümünde bulabilirsiniz.

Honeydew MCP sunucusunu eklemek için:

Ayarlar -> Bağlantılar -> MCP sunucuları bölümüne gidin
Özel MCP ekle'ye tıklayın
Sunucu Adı alanına honeydew girin
İsteğe bağlı olarak bir simge ve Kısa Açıklama ekleyin
Aktarım türü olarak HTTP'yi seçin
Sunucu URL'si alanına https://mcp.honeydew.cloud/mcp girin

Kimlik doğrulamayı yapılandırın:

Kimlik doğrulama yöntemi olarak **OAuth**'u seçin. Devin, ilk oturum sırasında Honeydew ile kimlik doğrulamanızı ister.

<Tab title="API Key">
  Kimlik doğrulama yöntemi olarak **Auth Başlığı**'nı seçin.
  Başlık anahtarını `Authorization` olarak bırakın ve değeri
  `Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET>` olarak ayarlayın
  (bkz. [Kimlik Doğrulama](#authentication)).
</Tab>

Kaydet'e tıklayın, ardından bağlantıyı doğrulamak için Test listeleme araçları'na tıklayın

Honeydew Dokümantasyon MCP'si (isteğe bağlı)

Ayarlar -> Bağlantılar -> MCP sunucuları bölümüne gidin
Özel MCP ekle'ye tıklayın
Sunucu Adı alanına honeydew-docs girin
Aktarım türü olarak HTTP'yi seçin
Sunucu URL'si alanına https://honeydew.ai/docs/mcp girin
Kimlik doğrulama yöntemini Yok olarak ayarlayın
Kaydet'e tıklayın

MCP sunucusunu kaldırma

Honeydew MCP sunucusunu kaldırmak için:

Ayarlar -> Bağlantılar -> MCP sunucuları bölümüne gidin
honeydew sunucusunu bulun ve kaldırın

Honeydew Dokümantasyon MCP sunucusunu kaldırmak için:

Ayarlar -> Bağlantılar -> MCP sunucuları bölümüne gidin
honeydew-docs sunucusunu bulun ve kaldırın

GitHub Copilot CLI

#### MCP Sunucusu

Not

Kuruluşunuz özel bir Honeydew ana makine adı kullanıyorsa, https://mcp.honeydew.cloud/mcp değerini kendi kiracı ana makine adınızla değiştirin. Ana makine adını Honeydew Studio'da Ayarlar > MCP Sunucusu bölümünde bulabilirsiniz.

GitHub Copilot CLI'yi copilot ile başlatın
Sunucu yapılandırma formunu açmak için /mcp add yazın
Aşağıdaki alanları doldurun:
- Ad: honeydew
- Tür: http
- URL: https://mcp.honeydew.cloud/mcp
- HTTP Başlıkları:
  OAuth için ek başlık gerekmez. ```json theme={null} { "Authorization": "Basic " } ```
Kaydetmek için Ctrl+S tuşuna basın

Sunucunun bağlı olduğunu doğrulamak için /mcp show kullanın.

AI Kodlama Aracısı Eklentileri

Not

Git gerektirir. Eklentiyi GitHub'dan yüklemek depoyu yerel olarak kopyalar, bu nedenle Git kurulu olmalı ve PATH üzerinde bulunmalıdır. Git yoksa, eklenti kurulumu başarısız olur. Git'i kurun veya sunucuyu doğrudan yapılandırmak için istemcinizin manuel MCP kurulum adımlarını kullanın eklenti yerine.

Honeydew, anlamsal modeller oluşturmak

ve doğal konuşma yoluyla verileri analiz etmek için beceriler ve araçlar içeren bir eklenti deposu sağlar.

Pazar yerini Copilot CLI'ye ekleyin:

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

Ardından Honeydew eklentisini pazar yerinden yükleyin:

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

Honeydew Dokümantasyon MCP'si (isteğe bağlı)

GitHub Copilot CLI'yi copilot ile başlatın
Sunucu yapılandırma formunu açmak için /mcp add yazın
Aşağıdaki alanları doldurun:
- Ad: honeydew-docs
- Tür: http
- URL: https://honeydew.ai/docs/mcp
Kaydetmek için Ctrl+S tuşuna basın

MCP sunucusunu kaldırma

Honeydew MCP sunucusunu kaldırmak için GitHub Copilot CLI'yi copilot ile başlatın, ardından şunu yazın:

/mcp remove honeydew

Honeydew Dokümantasyon MCP sunucusunu kaldırmak için:

/mcp remove honeydew-docs

Gemini CLI

#### Uzantı Kurulumu

Not

Git gerektirir. Eklentiyi GitHub'dan yüklemek depoyu yerel olarak kopyalar, bu nedenle Git kurulu olmalı ve PATH üzerinde bulunmalıdır. Git yoksa, eklenti kurulumu başarısız olur. Git'i kurun veya sunucuyu doğrudan yapılandırmak için istemcinizin manuel MCP kurulum adımlarını kullanın eklenti yerine.

Honeydew, anlamsal modeller oluşturmak

ve doğal konuşma yoluyla verileri analiz etmek için beceriler ve araçlar içeren bir eklenti deposu sağlar. Uzantıyı yüklemek Honeydew MCP sunucularını otomatik olarak kurar.

Honeydew uzantısını yüklemek için aşağıdaki komutu çalıştırın:

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

--auto-update bayrağı uzantıyı otomatik olarak güncel tutar.

MCP Kurulumu

Kuruluşunuz özel bir Honeydew uç noktası kullanıyorsa veya MCP sunucularını uzantıyı yüklemeden yapılandırmayı tercih ediyorsanız bu bölümü kullanın. Uzantı tarafından eklenen Honeydew MCP bağlantısını devre dışı bırakın, ardından

aşağıdaki talimatları kullanarak özel uç noktanızı ekleyin.

Honeydew MCP sunucusu, Gemini CLI'yi Honeydew Semantic Layer'a bağlar

model keşfi, veri sorgulama, model yönetimi ve dokümantasyon erişimi için.

Not

Kuruluşunuz özel bir Honeydew ana makine adı kullanıyorsa, https://mcp.honeydew.cloud/mcp değerini kendi kiracı ana makine adınızla değiştirin. Ana makine adını Honeydew Studio'da Ayarlar > MCP Sunucusu bölümünde bulabilirsiniz.

Honeydew MCP sunucusunu eklemek için aşağıdaki komutu çalıştırın:

```bash theme={null} gemini mcp add --transport http honeydew \ https://mcp.honeydew.cloud/mcp ```

  Gemini CLI'yi `gemini` ile başlatın.
  Honeydew'e OAuth ile kimlik doğrulamanız istenecektir.
</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 Dokümantasyon MCP'si (isteğe bağlı)

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

MCP sunucusunu kaldırma

Honeydew MCP sunucusunu kaldırmak için:

gemini mcp remove honeydew

Honeydew Dokümantasyon MCP sunucusunu kaldırmak için:

gemini mcp remove honeydew-docs

VS Code ve GitHub Copilot

#### Eklenti Kurulumu

Honeydew, anlamsal modeller oluşturmak

ve doğal konuşma yoluyla verileri analiz etmek için beceriler ve araçlar içeren bir eklenti deposu sağlar. Eklentiyi yüklemek Honeydew MCP sunucularını otomatik olarak kurar.

Honeydew pazar yerini ekleyin

VS Code settings.json dosyanızı açın (Komut Paleti'ni macOS'ta CMD+Shift+P veya Windows/Linux'ta Ctrl+Shift+P ile açın, ardından Tercihler: Kullanıcı Ayarlarını Aç (JSON) seçeneğini seçin)

Honeydew pazar yerini chat.plugins.marketplaces ayarına ekleyin:

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

Eklentiyi yükleyin

Uzantılar görünümünü açın (macOS'ta CMD+Shift+X veya Windows/Linux'ta Ctrl+Shift+X)
Arama alanına @agentPlugins girin
Honeydew AI eklentisini bulun ve Yükle'ye tıklayın

Yeni bir pazar yerinden ilk kez bir eklenti yüklediğinizde, VS Code bir güven istemi gösterir — onaylamadan önce pazar yeri kaynağını inceleyin.

Eklentiyi güncelleyin

VS Code ayarlarında extensions.autoUpdate etkinse, eklenti otomatik olarak güncellenir. Manuel olarak güncellemek için Komut Paleti'ni açın ve Uzantılar: Uzantı Güncellemelerini Kontrol Et komutunu çalıştırın.

MCP Sunucusu

Kuruluşunuz özel bir Honeydew uç noktası kullanıyorsa veya MCP sunucularını eklentiyi yüklemeden yapılandırmayı tercih ediyorsanız bu bölümü kullanın. Eklenti tarafından eklenen Honeydew MCP bağlantısını devre dışı bırakın, ardından

aşağıdaki talimatları kullanarak özel uç noktanızı ekleyin.

Honeydew MCP sunucusu, VS Code'u Honeydew Semantic Layer'a bağlar

model keşfi, veri sorgulama, model yönetimi ve dokümantasyon erişimi için.

Not

Kuruluşunuz özel bir Honeydew ana makine adı kullanıyorsa, https://mcp.honeydew.cloud/mcp değerini kendi kiracı ana makine adınızla değiştirin. Ana makine adını Honeydew Studio'da Ayarlar > MCP Sunucusu bölümünde bulabilirsiniz.

Komut Paleti'ni CMD+Shift+P (macOS) ile açın veya Ctrl+Shift+P (Windows/Linux)
MCP: Sunucu Ekle... seçeneğini seçin
HTTP (HTTP veya Sunucu Tarafı Olayları) seçeneğini seçin
Honeydew MCP sunucusu URL'sini girin: https://mcp.honeydew.cloud/mcp
Sunucu adı olarak honeydew girin

Bu, sunucuyu .vscode/mcp.json dosyanıza ekler. Dosyayı açın ve gerektiğinde başlıklar ekleyin: 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 (isteğe bağlı)

Honeydew MCP sunucusu zaten dokümantasyon erişim araçlarını içerir, bu nedenle ayrı bir dokümantasyon sunucusuna gerek yoktur. Honeydew Documentation MCP'yi yalnızca Honeydew'e bağlanmadan dokümantasyon erişimi istiyorsanız ekleyin. Kimlik doğrulama gerekmez.

Aşağıdakini .vscode/mcp.json dosyanıza ekleyin:

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

MCP sunucusunu kaldırma

Honeydew MCP sunucusunu kaldırmak için .vscode/mcp.json dosyasını açın ve honeydew girdisini servers nesnesinden silin. Honeydew Documentation MCP sunucusunu kaldırmak için aynı dosyadan honeydew-docs girdisini silin.

Codex CLI

#### Eklenti Kurulumu

Not

Git gerektirir. Eklentiyi GitHub'dan kurmak depoyu yerel olarak klonlar, bu nedenle Git kurulu olmalı ve PATH üzerinde bulunmalıdır. Git yoksa eklenti kurulumu başarısız olur. Git'i kurun veya sunucuyu doğrudan yapılandırmak için istemcinizin manuel MCP kurulum adımlarını kullanın eklenti yerine.

Honeydew, anlamsal modeller oluşturmak ve doğal konuşma yoluyla verileri analiz etmek için beceriler ve araçlar içeren bir eklenti deposu sağlar. Eklentiyi kurmak Honeydew MCP sunucularını otomatik olarak ayarlar.

Pazar yerini Codex'e ekleyin:

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

Ardından Codex'i codex ile başlatın ve /plugins yazın Honeydew AI eklentisine göz atmak ve kurmak için.

Eklentileri güncelleme

Honeydew pazar yerini güncellemek için şunu çalıştırın:

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

Ardından Codex'i başlatın ve güncellemeleri uygulamak için /plugins yazın.

MCP Kurulumu

Honeydew MCP sunucusu Codex'i Honeydew Semantic Layer'a bağlar model keşfi, veri sorgulama, model yönetimi ve dokümantasyon erişimi için.

Not

Kuruluşunuz özel bir Honeydew ana bilgisayar adı kullanıyorsa, https://mcp.honeydew.cloud/mcp değerini kiracı ana bilgisayar adınızla değiştirin. Ana bilgisayar adını Honeydew Studio'da Ayarlar > MCP Sunucusu bölümünde bulabilirsiniz.

Komut satırı

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

Ardından Codex'i codex ile başlatın. Honeydew'e OAuth ile kimlik doğrulamanız istenecektir.

Sunucuyu ekledikten sonra, yapılandırma dosyasını ~/.codex/config.toml konumunda açın ve gerekirse [mcp_servers.honeydew] bölümüne başlıklar ekleyin.

TOML yapılandırması

Aşağıdakini ~/.codex/config.toml dosyasına ekleyin (veya güvenilir bir projede .codex/config.toml):

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

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

HONEYDEW_AUTH ortam değişkenini Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET> olarak ayarlayın (bkz. Kimlik Doğrulama).

Honeydew Documentation MCP (isteğe bağlı)

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

MCP sunucusunu kaldırma

Honeydew MCP sunucusunu kaldırmak için:

codex mcp remove honeydew

Honeydew Documentation MCP sunucusunu kaldırmak için:

codex mcp remove honeydew-docs

Codex

#### Eklenti Kurulumu

Not

Git gerektirir. Eklentiyi GitHub'dan kurmak depoyu yerel olarak klonlar, bu nedenle Git kurulu olmalı ve PATH üzerinde bulunmalıdır. Git yoksa eklenti kurulumu başarısız olur. Git'i kurun veya sunucuyu doğrudan yapılandırmak için istemcinizin manuel MCP kurulum adımlarını kullanın eklenti yerine.

Codex'te pazar yerini ekleyin:

Eklentiler bölümünü açın
Açılır oka tıklayın ve Pazar yeri ekle seçeneğini seçin
honeydew-ai/honeydew-ai-coding-agents-plugins ekleyin

Not

Pazar yerini Codex CLI üzerinden de ekleyebilirsiniz:
codex plugin marketplace add honeydew-ai/honeydew-ai-coding-agents-plugins

Ardından eklentiyi kurun:

Eklentiler bölümünü açın
Honeydew AI pazar yerini seçin
Honeydew eklentisini kurun

MCP Kurulumu

Not

Kuruluşunuz özel bir Honeydew ana bilgisayar adı kullanıyorsa, https://mcp.honeydew.cloud/mcp değerini kiracı ana bilgisayar adınızla değiştirin. Ana bilgisayar adını Honeydew Studio'da Ayarlar > MCP Sunucusu bölümünde bulabilirsiniz.

Honeydew MCP

Codex uygulamasını açın
Ayarlar -> MCP Sunucuları bölümüne gidin
Özel sunucular altında Sunucu Ekle'ye tıklayın
Sunucu adını honeydew olarak ayarlayın
Aktarım türü olarak Streamable HTTP seçin
URL'yi https://mcp.honeydew.cloud/mcp olarak ayarlayın
Bearer token ortam değişkeni alanını boş bırakın
Kimlik doğrulamayı şu şekilde yapılandırın:

OAuth kimlik doğrulaması

Codex, bağlanırken Honeydew ile kimlik doğrulamanız için sizi yönlendirir. Ek yapılandırma gerekmez.

HTTP Temel kimlik doğrulaması

Yukarıdaki başlıklar listesine değeri Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET> olan bir Authorization başlığı ekleyin (bkz. Kimlik Doğrulama).

MCP kimlik doğrulama sorunlarını giderme

Honeydew MCP sunucusu Codex'te kimliği doğrulanmamışsa ve "Kimlik Doğrula" seçeneği görünmüyorsa:

Codex CLI kurun
codex mcp login honeydew çalıştırın

Honeydew Documentation MCP (isteğe bağlı)

Ayarlar -> MCP Sunucuları bölümüne gidin
Özel sunucular altında Sunucu Ekle'ye tıklayın
Sunucu adını honeydew-docs olarak ayarlayın
Aktarım türü olarak Streamable HTTP seçin
URL'yi https://honeydew.ai/docs/mcp olarak ayarlayın

MCP sunucusunu kaldırma

Honeydew MCP sunucusunu kaldırmak için:

Ayarlar -> MCP Sunucuları bölümüne gidin
Özel sunucular altında honeydew bulun ve Kaldır'a tıklayın

Honeydew Documentation MCP sunucusunu kaldırmak için:

Ayarlar -> MCP Sunucuları bölümüne gidin
Özel sunucular altında honeydew-docs bulun ve Kaldır'a tıklayın

Antigravity

#### MCP Sunucusu

Not

Kuruluşunuz özel bir Honeydew ana bilgisayar adı kullanıyorsa, https://mcp.honeydew.cloud/mcp değerini kiracı ana bilgisayar adınızla değiştirin. Ana bilgisayar adını Honeydew Studio'da Ayarlar > MCP Sunucusu bölümünde bulabilirsiniz.

Antigravity düzenleyicisini açın
Aracı panelinin üst kısmındaki ... açılır menüsüne tıklayın
MCP Sunucularını Yönet'e tıklayın
Ham yapılandırmayı görüntüle'ye tıklayın

Aşağıdakini mcp_config.json dosyasına ekleyin:

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

Dosyayı kaydedin

Honeydew Documentation MCP (isteğe bağlı)

Antigravity düzenleyicisini açın
Aracı panelinin üst kısmındaki ... açılır menüsüne tıklayın
MCP Sunucularını Yönet'e tıklayın
Ham yapılandırmayı görüntüle'ye tıklayın

Aşağıdakini mcp_config.json dosyasına ekleyin:

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

Dosyayı kaydedin

MCP sunucusunu kaldırma

Honeydew MCP sunucusunu kaldırmak için:

Antigravity düzenleyicisini açın
Aracı panelinin üst kısmındaki ... açılır menüsüne tıklayın
MCP Sunucularını Yönet'e tıklayın
Ham yapılandırmayı görüntüle'ye tıklayın
mcp_config.json dosyasından honeydew ve honeydew-docs girdilerini kaldırın
Dosyayı kaydedin

OpenCode

#### MCP Sunucusu

Not

Kuruluşunuz özel bir Honeydew ana bilgisayar adı kullanıyorsa, https://mcp.honeydew.cloud/mcp değerini kiracı ana bilgisayar adınızla değiştirin. Ana bilgisayar adını Honeydew Studio'da Ayarlar > MCP Sunucusu bölümünde bulabilirsiniz.

Aşağıdaki komutu çalıştırın ve etkileşimli istemleri izleyin:

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

  İstendiğinde aşağıdaki değerleri girin:

  1. **Konum**: Tercih ettiğiniz kapsamı seçin (geçerli proje veya genel)
  2. **MCP sunucu adı**: `honeydew`
  3. **MCP sunucu türü**: `Remote`
  4. **MCP sunucu URL'si**: `https://mcp.honeydew.cloud/mcp`
  5. **OAuth kimlik doğrulaması**: `Yes`
  6. **Önceden kayıtlı istemci kimliği**: `No`
</Tab>

<Tab title="JSON configuration">
  Aşağıdakini `opencode.jsonc` dosyanıza ekleyin:

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

      Ardından Honeydew ile kimlik doğrulayın:

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

      Bu, OAuth kimlik doğrulama akışını tamamlamak için bir tarayıcı penceresi açar.
    </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>

Yeniden kimlik doğrulama

Yeniden kimlik doğrulamak için önce durumunuzu kontrol edin ve oturumu kapatın:

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

Honeydew Documentation MCP (isteğe bağlı)

`opencode mcp add` çalıştırın ve aşağıdaki değerleri girin:

  1. **MCP sunucu adı**: `honeydew-docs`
  2. **MCP sunucu türü**: `Remote`
  3. **MCP sunucu URL'si**: `https://honeydew.ai/docs/mcp`
  4. **OAuth kimlik doğrulaması**: `No`
</Tab>

<Tab title="JSON configuration">
  Aşağıdakini `opencode.jsonc` dosyanıza ekleyin:

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

MCP sunucusunu kaldırma

Honeydew MCP sunucusunu kaldırmak için honeydew girdisini opencode.jsonc dosyanızdan kaldırın. Honeydew Documentation MCP sunucusunu kaldırmak için aynı dosyadan honeydew-docs girdisini kaldırın.

Kiro

Kiro IDE ve Kiro CLI aynı MCP yapılandırma dosyalarını paylaşır, bu nedenle aşağıdaki adımlar her ikisi için de geçerlidir.

MCP Sunucusu

Kiro, MCP sunucularını iki yapılandırma dosyasından okur:

Çalışma alanı: .kiro/settings/mcp.json (geçerli projeye özel)
Kullanıcı: ~/.kiro/settings/mcp.json (tüm çalışma alanlarında geçerlidir)

Her iki dosya da varsa, çalışma alanı yapılandırması önceliklidir.

Not

Kuruluşunuz özel bir Honeydew ana bilgisayar adı kullanıyorsa, https://mcp.honeydew.cloud/mcp değerini kiracı ana bilgisayar adınızla değiştirin. Ana bilgisayar adını Honeydew Studio'da Ayarlar > MCP Sunucusu bölümünde bulabilirsiniz.

Honeydew MCP sunucusunu bu mcp.json dosyalarından birine ekleyin (çalışma alanı veya kullanıcı):

```json theme={null} { "mcpServers": { "honeydew": { "url": "https://mcp.honeydew.cloud/mcp" } } } ```

  Honeydew'e ilk bağlandığınızda Kiro bir kimlik doğrulama URL'si sağlar.
  OAuth kimlik doğrulama akışını tamamlamak için tarayıcınızda açın.
</Tab>

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

Kiro CLI'de, sunucunun bağlı olduğunu doğrulamak için /mcp komutunu çalıştırın. Kiro IDE'de sunucu, MCP paneli altında görünür.

Honeydew Documentation MCP (isteğe bağlı)

Aşağıdakini mcp.json dosyanıza ekleyin:

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

MCP sunucusunu kaldırma

Honeydew MCP sunucusunu kaldırmak için, honeydew girdisini mcp.json dosyanızdan silin. Honeydew Documentation MCP sunucusunu kaldırmak için, aynı dosyadan honeydew-docs girdisini silin.

Snowflake Intelligence

Snowflake, harici MCP sunucularına [MCP bağlayıcıları](https://docs.snowflake.com/en/user-guide/snowflake-cortex/cortex-agents-mcp-connectors) aracılığıyla bağlanır, böylece Honeydew araçlarını Snowflake Intelligence ve Cortex Agents kullanımına sunar.

Ön koşullar:

Hesapta CREATE INTEGRATION ayrıcalığına sahip bir rol
Hedef şemada CREATE MCP SERVER ayrıcalığına sahip bir rol

Varsayılan olarak, yalnızca ACCOUNTADMIN rolü bu ayrıcalıklara sahiptir.

Not

Kuruluşunuz özel bir Honeydew ana bilgisayar adı kullanıyorsa, https://mcp.honeydew.cloud/mcp değerini kiracı ana bilgisayar adınızla değiştirin. Ana bilgisayar adını Honeydew Studio'da Ayarlar > MCP Sunucusu bölümünde bulabilirsiniz.

```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">
  Harici MCP sunucusu, API entegrasyonuna referans veren
  şema düzeyinde bir nesnedir:

  ```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">
  Honeydew'e erişmesi gereken tüm rollere hem entegrasyon hem de MCP sunucusu
  üzerinde kullanım izni verin:

  ```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">
  `honeydew` MCP sunucusunu bir Cortex Agent'a veya
  bir Snowflake Intelligence aracısına araç olarak ekleyin.
  Kullanıcılar ilk kullanımda Honeydew'e OAuth ile kimlik doğrulaması yapmaya yönlendirilir.
</Step>

Not

Bağımsız Honeydew Documentation MCP sunucusu Snowflake'te desteklenmez, çünkü Snowflake harici MCP sunucuları OAuth kimlik doğrulaması gerektirir ve dokümantasyon sunucusu kimlik doğrulamasız çalışır. Dokümantasyon erişimi, Honeydew MCP sunucusunun dokümantasyon araçları aracılığıyla kullanılabilir.

MCP sunucusunu kaldırma

Önce MCP sunucusunu, ardından API entegrasyonunu bırakın:

DROP MCP SERVER honeydew;
DROP INTEGRATION honeydew_mcp_integration;

Diğer İstemciler

MCP uyumlu herhangi bir istemci, standart HTTP taşımasını kullanarak Honeydew MCP Sunucusuna bağlanabilir.

Başlangıç noktası olarak aşağıdaki JSON yapılandırmasını kullanın:

Not

Kuruluşunuz özel bir Honeydew ana bilgisayar adı kullanıyorsa, https://mcp.honeydew.cloud/mcp değerini kiracı ana bilgisayar adınızla değiştirin. Ana bilgisayar adını Honeydew Studio'da Ayarlar > MCP Sunucusu bölümünde bulabilirsiniz.

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

Her parametreyle ilgili ayrıntılar için Sunucu URL'si, Kimlik Doğrulama ve Yapılandırma bölümlerine bakın.

Örnek Kullanım

Bağlandıktan sonra, AI asistanınıza aşağıdaki gibi sorular sorabilirsiniz:

"Semantik modelde hangi varlıklar mevcut?"
"orders varlığının özniteliklerini ve metriklerini göster"
"Modelde hangi alanlar tanımlı?"
"analytics şemasında hangi tablolar var?"
"Geçen ay kaç sipariş verildi?"
"orders varlığı için toplam gelir için yeni bir metrik oluştur"
"Son çeyrekte bölgeye göre ortalama sipariş değeri nedir?"

Sorun Giderme

OAuth Kimlik Doğrulama Sorunları

İstemcinizin OAuth'u desteklediğini doğrulayın, gerekli Honeydew çalışma alanı izinlerine sahip olduğunuzdan emin olun ve istemcinizin MCP yönetim arayüzü üzerinden yeniden kimlik doğrulamayı deneyin.

Claude Code'da yeniden kimlik doğrulama

/mcp yazın, listeden Honeydew MCP'yi seçin, "Clear authentication" veya "Authenticate" seçeneğini belirleyin, ardından Honeydew'e yeniden bağlanmak için tarayıcı OAuth istemlerini izleyin.

Bağlantı Sorunları

MCP sunucu URL'sinin https://mcp.honeydew.cloud/mcp ile eşleştiğini doğrulayın ve istemcinizin MCP yapılandırma sözdiziminin doğru olduğunu kontrol edin. Kuruluşunuz özel bir ana bilgisayar adı kullanıyorsa, URL'nin Honeydew Studio'da Ayarlar > MCP Sunucusu bölümünde görünen kiracı ana bilgisayar adınızla eşleştiğini kontrol edin.

Eksik Araçlar

Kimlik doğrulamanın başarılı olduğunu doğrulayın, Honeydew çalışma alanı erişim izinlerinizi kontrol edin ve istemcinizin konsolunda hata mesajlarını inceleyin.

Çıktı İzin Verilen Maksimum Token Sayısını Aşıyor (Claude)

Claude Code, Claude Desktop ve Claude.ai'de, bir araç çağrısı, çıktının izin verilen maksimum token sayısını aştığına dair bir hatayla başarısız olabilir. monitor_analysis ve get_analysis_step_details gibi Honeydew analiz araçları, Claude'un MCP çıktı sınırını aşan büyük sonuçlar döndürebilir.

Claude, MCP araç çıktısı 10.000 tokeni aştığında uyarır ve varsayılan 25.000 tokenlik sınırın üzerindeki çıktıyı reddeder. Sınırı yükseltmek için, Claude'u başlatmadan önce MAX_MCP_OUTPUT_TOKENS ortam değişkenini ayarlayın:

export MAX_MCP_OUTPUT_TOKENS=50000
claude

Ayrıntılar için Claude belgelerindeki MCP çıktı limitleri ve uyarıları bölümüne bakın.

Ek destek için Honeydew desteğiyle support@honeydew.ai adresinden iletişime geçin.

Kullanılabilir Araçlar

Salt okunur olarak işaretlenen araçlar, semantik modeli veya veri ambarını değiştirmez.

İpucu

Yalnızca salt okunur araçları kullanıma sunmak için, MCP sunucu yapılandırmanızda ReadonlyToolsOnly: true başlığını ayarlayın. Etkinleştirildiğinde, sunucu yalnızca semantik modeli veya veri ambarını değiştirmeyen araçları döndürür.

Oturum ve Çalışma Alanı

`list_workspaces`

salt okunur

Kullanılabilir tüm çalışma alanlarını listeler. Çalışma alanı adını ve veri ambarı türünü (snowflake, databricks veya bigquery) döndürür. Semantik model uygulamasını bilgilendirmek için veri ambarı türünü kullanın.

`list_workspace_branches`

salt okunur

Bir çalışma alanı için kullanılabilir tüm dalları listeler.

Çalışma alanının adı.

`get_session_workspace_and_branch`

salt okunur

Geçerli oturum için ayarlanan çalışma alanını ve dalı alır.

`set_session_workspace_and_branch`

salt okunur

Geçerli oturum için kullanılacak çalışma alanını ve dalı ayarlar. Oturumdaki sonraki tüm araç çağrıları bu çalışma alanını ve dalı kullanır.

Çalışma alanının adı. Kullanılacak dal.

`create_workspace_branch`

Mevcut bir çalışma alanı için yeni bir dal oluşturur. Dal, çalışma alanının prod dalının geçerli durumundan oluşturulur. Başlıklar aracılığıyla hiçbir çalışma alanı sabitlenmemişse, oturum otomatik olarak yeni dala geçer.

Dal oluşturulacak çalışma alanının adı. Oluşturulacak yeni dalın adı.

`delete_workspace_branch`

Bir çalışma alanından dal siler. Bu, yıkıcı ve geri alınamaz bir işlemdir. Bu aracı çağırmadan önce kullanıcıyla her zaman çalışma alanı adını ve dal adını doğrulayın. prod dalı silinemez. Silinen dal geçerli oturum dalıysa, oturum otomatik olarak prod dalına geçer.

Silinecek dalı içeren çalışma alanının adı. Silinecek dalın adı.

`get_branch_history`

salt okunur

Geçerli oturumun dalı için değişiklik geçmişini alır. Hangi semantik nesnelerin, kim tarafından ve ne zaman değiştirildiğini gösteren bir değişiklik listesi döndürür.

Döndürülecek maksimum değişiklik sayısı.

`create_pr_for_working_branch`

Geçerli oturumun çalışma dalı için bir çekme isteği oluşturur. Başarı durumunda PR URL'sini döndürür.

Çekme isteği için başlık. Çekme isteği için açıklama.

Soru ve Analiz

`initiate_analysis`

salt okunur

Bir veri analizini başlatır veya sürdürür. Bir conversation_id döndürür — ilerleme ve sonuçları yoklamak için monitor_analysis kullanın, erken durdurmak için abort_analysis kullanın. Daha fazla ayrıntı için Derin Analiz bölümüne bakın.

Sorulacak doğal dil sorusu. Yeni bir konuşma için aracı adı. Takip soruları için atlayın — aracı mevcut konuşmadan devralınır. Devam edilecek mevcut konuşma kimliği, veya yeni bir konuşma başlatmak için atlayın.

`monitor_analysis`

salt okunur

Devam eden bir analizden yeni ilerleme mesajlarını yoklar. Her çağrı yalnızca son çağrıdan bu yana gelen mesajları döndürür. status değeri DONE veya NO_CHAT_CURRENTLY_RUNNING olana kadar tekrar tekrar yoklayın.

`initiate_analysis` tarafından döndürülen konuşma kimliği. Çağrı başına döndürülecek maksimum mesaj sayısı. Oynatılacak mesaj kimliği. Kaçırılan mesajları kurtarmak için önceki bir sonuçtan `last_received_message_id` kullanın.

`get_analysis_step_details`

salt okunur

Belirli bir analiz adımının tüm ayrıntılarını alır; semantik sorgu, SQL ifadesi, kullanılan bağlam ve o adımda alınan veriler dahil.

`initiate_analysis` tarafından döndürülen konuşma kimliği. `monitor_analysis` adım kimliği (örn. `STEP/0`).

`abort_analysis`

salt okunur

Devam eden bir analizi durdurur. initiate_analysis ile durdurulan noktadan devam ettirilebilir.

`initiate_analysis` tarafından döndürülen konuşma kimliği.

`list_analysis_chats`

salt okunur

Geçerli çalışma alanı için, oluşturma zamanına göre sıralanmış (en yeniden en eskiye) sayfalanmış bir analiz konuşmaları listesi döndürür. Yöneticiler tüm konuşmaları görür; yönetici olmayanlar yalnızca kendi konuşmalarını görür. Her girdi konuşma kimliğini, başlığı, kullanıcı geri bildirimini, alanı, aracıyı, oluşturma zamanını ve oluşturan kullanıcının görünen adını içerir.

Döndürülecek maksimum konuşma sayısı. Sayfalama için atlanacak konuşma sayısı.

`provide_analysis_feedback`

Belirli bir analiz konuşması için geri bildirim ayarlar veya temizler. Konuşma başına tek bir geri bildirim girdisi vardır (soru başına değil) — tüm konuşma akışının genel kalitesini yansıtmalıdır.

monitor_analysis tamamlandıktan ve kullanıcı sonuçtan memnuniyetini veya memnuniyetsizliğini ifade ettikten sonra bunu çağırın. Olumlu geri bildirim için kısa bir onaylayıcı dize kullanın (örn. Good), veya olumsuz geri bildirim için <Reason>: <details> biçimini kullanın; burada Reason şunlardan biridir: Chart Issue, Data Issue, Wrong Judgement veya Other.

Analiz konuşmasının konuşma kimliği. Saklanacak geri bildirim metni veya mevcut geri bildirimi temizlemek için `null`.

`get_stored_conversation`

salt okunur

Mevcut bir analiz konuşmasındaki tüm mesajları döndürür. Önceki bir konuşmanın tüm içeriğini incelemek için bunu kullanın. Yanıttaki is_complete, konuşmanın son duruma ulaşıp ulaşmadığını gösterir.

`list_analysis_chats` konuşma kimliği. `true` ise, `step_start` ve `step_insight` ilerleme girdilerini ekleyin. `false` ise, yalnızca son yanıtları ve plan/yorumlama mesajlarını döndürün.

Göz Atma ve Keşif

`list_entities`

salt okunur

Semantik modeldeki tüm varlıkları adları, açıklamaları ve anahtarlarıyla listeler.

`get_entity`

salt okunur

Bir varlık hakkında öznitelikleri, metrikleri, veri kümeleri, ilişkileri ve YAML tanımı dahil ayrıntılı bilgi alır. Varlığın adı.

`get_field`

yalnızca okunur

Bir varlık içindeki belirli bir alan (nitelik veya metrik) hakkında YAML tanımı dahil ayrıntılı bilgi alın.

Alanı içeren varlığın adı. Alanın adı.

`list_domains`

yalnızca okunur

Semantik modeldeki tüm alanları adları, açıklamaları ve varlıklarıyla birlikte listeleyin.

`get_domain`

yalnızca okunur

Bir alan hakkında varlıkları, filtreleri, parametreleri ve YAML tanımı dahil ayrıntılı bilgi alın.

Alanın adı.

`search_model`

yalnızca okunur

Bir sorgu dizesiyle eşleşen varlıkları, nitelikleri, metrikleri, veri kümelerini, dinamik veri kümelerini, alanları ve genel parametreleri semantik modelde arayın.

Aramayı belirli bir varlık içindeki alanlarla sınırlamak için entity.field sözdizimini kullanın. Örneğin, customers.balance, customers ile eşleşen varlıklarda balance alanını bulur; customers., eşleşen varlıkların tüm alanlarını döndürür. OR/AND modunda, kısmi eşleşmeler hem varlık hem de alan bölümlerine uygulanır — cust.bal, customers.balance ile eşleşir.

Arama sorgu dizesi. Sorgunun nasıl eşleştirileceğini kontrol eder:

OR — boşluklara göre böler, herhangi bir kelimeyle eşleşen nesneleri döndürür.
AND — boşluklara göre böler, yalnızca tüm kelimelerle eşleşen nesneleri döndürür.
EXACT — dizeyi olduğu gibi kullanır, adı, görünen adı veya etiketi tam eşleşen nesneleri döndürür.

Veri Ambarı Keşfi

`list_databases`

yalnızca okunur

Bağlı veri ambarında bulunan tüm veritabanlarını listeleyin.

`list_schemas`

yalnızca okunur

Bağlı veri ambarındaki belirli bir veritabanındaki tüm şemaları listeleyin.

Veritabanı adı.

`list_tables`

yalnızca okunur

Bağlı veri ambarındaki belirli bir veritabanı ve şemadaki tabloları/görünümleri listeleyin.

Veritabanı adı. Şema adı.

`get_table_info`

yalnızca okunur

Bir veri ambarı tablosu/görünümü hakkında sütunları ve meta verileri dahil ayrıntılı bilgi alın.

Veritabanı adı. Şema adı. Tablo adı.

Semantik Model

`import_tables`

Bağlı veri ambarındaki tabloları semantik modele aktarın. Her tablo, sütunları nitelikler olacak şekilde bir varlık haline gelir.

`database.schema.table` biçiminde tam nitelikli tablo adlarının listesi.

`create_entity`

YAML tanımlarından semantik modelde yeni bir varlık oluşturun.

Varlık için YAML tanımı. Veri kümesi için YAML tanımı.

`create_object`

Bir YAML tanımından yeni bir semantik model nesnesi oluşturun. Desteklenen türler: hesaplanmış nitelik, metrik, dinamik veri kümesi, alan ve genel parametre.

Nesnenin YAML tanımı. Doğrulama hata üretse bile nesneyi oluşturun.

`update_object`

Bir YAML tanımından mevcut bir semantik model nesnesini güncelleyin. Desteklenen türler: varlık, hesaplanmış nitelik, metrik, veri kümesi, dinamik veri kümesi, alan ve genel parametre.

Nesnenin YAML tanımı. Güncellenecek nesnenin anahtarı. Doğrulama hata üretse bile nesneyi güncelleyin.

`validate_object`

yalnızca okunur

Oluşturmadan veya güncellemeden bir semantik model nesnesi YAML tanımını doğrulayın. Desteklenen türler: varlık, hesaplanmış nitelik, metrik, veri kümesi, dinamik veri kümesi, alan ve genel parametre.

Doğrulanacak YAML tanımı. Doğrulamanın karşı yapılacağı nesnenin anahtarı.

`delete_object`

Bir semantik model nesnesini anahtarına göre silin.

Silinecek nesnenin anahtarı. Doğrulama hata üretse bile nesneyi silin.

Aracılar

`list_agents`

yalnızca okunur

Tüm aracıları adları, açıklamaları, alanları ve bağlam referanslarıyla birlikte listeleyin.

`get_agent`

yalnızca okunur

Bir aracı hakkında YAML ön yüz tanımı dahil ayrıntılı bilgi alın.

Alınacak aracının adı.

`create_agent`

Yeni bir aracı oluşturun.

Yeni aracı için meta veriler. Hiyerarşik ad (ör. `growth-analyst`, `finance/budget-analyst`).

<ParamField body="display_name" type="string" required>
  Kullanıcı arayüzünde gösterilen insan tarafından okunabilir ad.
</ParamField>

<ParamField body="description" type="string" required>
  Aracının amacının ve yeteneklerinin açıklaması.
</ParamField>

<ParamField body="domain" type="string" required>
  Bu aracının çalıştığı alan.
</ParamField>

<ParamField body="welcome_message" type="string">
  Bir kullanıcı oturum başlattığında gösterilen tanıtım mesajı.
</ParamField>

<ParamField body="sample_questions" type="string[]">
  Kullanıcılara gösterilen örnek sorular.
</ParamField>

<ParamField body="context" type="string[]">
  Oturumlara yüklenecek bağlam öğesi adları veya glob desenleri
  (ör. `skills/**`, `knowledge/marketing/**`).
</ParamField>

<ParamField body="owner" type="string">
  Aracı için sahip tanımlayıcısı.
</ParamField>

Ön yüzden sonra eklenen Markdown gövdesi. Bu metin, her analiz oturumundan önce isteme eklenir. Doğrulama hata üretse bile aracıyı oluşturun.

`update_agent`

Mevcut bir aracıyı güncelleyin.

Güncellenecek aracının adı. Tam güncellenmiş aracı tanımı. `create_agent` içindeki tüm zorunlu alanlar sağlanmalıdır — bu kısmi bir güncelleme değil, tam bir değiştirmedir. Aracı için güncellenmiş Markdown gövdesi. Doğrulama hata üretse bile aracıyı güncelleyin.

`delete_agent`

Bir aracıyı adına göre silin.

Silinecek aracının adı.

Bağlam Öğeleri

`list_context_items`

yalnızca okunur

Tüm bağlam öğelerini türleri, adları, başlıkları ve alt tür değerleriyle birlikte listeleyin.

`get_context_item`

yalnızca okunur

Bir bağlam öğesini ada göre alın.

Alınacak bağlam öğesinin adı.

`create_context_item`

Yeni bir bağlam öğesi oluşturun. Talimat ve bellek türlerini destekler.

Yeni bağlam öğesi için meta veriler. `instruction` olmalıdır.

<ParamField body="name" type="string" required>
  Hiyerarşik ad
  (ör. `knowledge/customer/churn-analysis`, `skills/reporting`).
</ParamField>

<ParamField body="subtype" type="string" required>
  `knowledge`, `skill` veya `instruction` değerlerinden biri.
</ParamField>

<ParamField body="title" type="string" required>
  Bağlam öğesi için insan tarafından okunabilir başlık.
</ParamField>

<ParamField body="apply" type="string" required>
  Bağlamın ne zaman uygulanacağı: `always` veya `on_demand`.
</ParamField>

<ParamField body="description" type="string">
  Yapay zekanın bu öğeyi ne zaman yükleyeceğine karar vermek için kullandığı açıklama
  (`apply` değeri `on_demand` olduğunda zorunludur).
</ParamField>

<ParamField body="owner" type="string">
  Sahip tanımlayıcısı.
</ParamField>

<ParamField body="labels" type="string[]">
  Bağlam öğelerini düzenlemek için etiketler.
</ParamField>

<ParamField body="related_objects" type="object[]">
  Bu bağlam öğesinin ilişkili olduğu semantik nesneler.
  Her nesnenin bir `name` (dize) ve `type` (`domain`, `entity` veya `field`) değeri vardır.
</ParamField>

<ParamField body="external_source" type="object">
  İçeriğin alınacağı harici kaynak (`knowledge` alt türü için).
  `tool` (MCP araç adı), `resource_id` (harici araçtaki tanımlayıcı)
  ve isteğe bağlı `cache_max_age_in_seconds` (varsayılan: `3600`) değerlerine sahiptir.
</ParamField>

`memory` olmalıdır.

<ParamField body="name" type="string" required>
  Hiyerarşik ad (ör. `events/q4-launch`, `2024/pricing-decision`).
</ParamField>

<ParamField body="subtype" type="string" required>
  `event` veya `decision_trace` değerlerinden biri.
</ParamField>

<ParamField body="title" type="string" required>
  Bağlam öğesi için insan tarafından okunabilir başlık.
</ParamField>

<ParamField body="apply" type="string" required>
  Bağlamın ne zaman uygulanacağı: `always` veya `on_demand`.
</ParamField>

<ParamField body="from_date" type="string" required>
  Bellek döneminin ISO biçiminde başlangıç tarihi (ör. `2024-01-01`).
</ParamField>

<ParamField body="to_date" type="string">
  Bellek döneminin ISO biçiminde bitiş tarihi.
</ParamField>

<ParamField body="description" type="string">
  Yapay zekanın bu öğeyi ne zaman yükleyeceğine karar vermek için kullandığı açıklama
  (`apply` değeri `on_demand` olduğunda zorunludur).
</ParamField>

<ParamField body="owner" type="string">
  Sahip tanımlayıcısı.
</ParamField>

<ParamField body="labels" type="string[]">
  Bağlam öğelerini düzenlemek için etiketler.
</ParamField>

<ParamField body="related_objects" type="object[]">
  Bu bağlam öğesinin ilişkili olduğu semantik nesneler.
  Her nesnenin bir `name` (dize) ve `type` (`domain`, `entity` veya `field`) değeri vardır.
</ParamField>

<ParamField body="external_source" type="object">
  İçeriğin alınacağı harici kaynak.
  `tool` (MCP araç adı), `resource_id` (harici araçtaki tanımlayıcı)
  ve isteğe bağlı `cache_max_age_in_seconds` (varsayılan: `3600`) değerlerine sahiptir.
</ParamField>

Bağlam öğesinin içeriği için Markdown gövdesi. Doğrulama hata üretse bile bağlam öğesini oluşturun.

`update_context_item`

Mevcut bir bağlam öğesini güncelleyin.

Güncellenecek bağlam öğesinin adı. Tam güncellenmiş bağlam öğesi tanımı. `create_context_item` içindeki tüm zorunlu alanlar sağlanmalıdır — bu kısmi bir güncelleme değil, tam bir değiştirmedir. Bağlam öğesi için güncellenmiş Markdown gövdesi. Doğrulama hata üretse bile bağlam öğesini güncelleyin.

`delete_context_item`

Bir bağlam öğesini ada göre silin.

Silinecek bağlam öğesinin adı.

Sorgu ve Önizleme

`get_sql_from_fields`

yalnızca okunur

Nitelikler, metrikler ve filtrelerle tanımlanan bir semantik katman sorgusu için SQL sorgusunu oluşturun. SQL'i çalıştırmadan döndürür.

Tam nitelikli nitelik adları (`entity.attribute_name`). Takma adları destekler: `entity.attribute_name as alias_name`. Tam nitelikli metrik adları (`entity.metric_name`) veya SQL ifadeleri (ör. `SUM(entity.field)`). Takma adları destekler: `SUM(entity.field) as total`. Filtre koşulları (ör. `entity.field = 'value'`, `entity.date_field > '2024-01-01'`). Sıralanacak alanların listesi. Biçim: `entity.field_name` veya `entity.field_name DESC`. Varsayılan yön ASC'dir. Takma adlar kullanırken, takma ad adına göre sıralayın. Sorgulanacak alan. Döndürülecek maksimum satır sayısı. Sayfalama için atlanacak satır sayısı. Döndürülen SQL'in en üstüne bir [ön toplama raporu](/docs/performance/aggregate-awareness#debugging-aggregate-matching) ekleyin; çalışma alanındaki her ön toplama için hangi CTE'nin onu kullandığını veya neden kullanılamadığını belirtin.

`get_data_from_fields`

yalnızca okuma

Öznitelikler, metrikler ve filtreler tarafından tanımlanan bir anlamsal katman sorgusu yürütün ve sonuç verilerini döndürün.

Tam nitelikli öznitelik adları (`entity.attribute_name`). Takma adları destekler: `entity.attribute_name as alias_name`. Tam nitelikli metrik adları (`entity.metric_name`) veya SQL ifadeleri (örn. `SUM(entity.field)`). Takma adları destekler: `SUM(entity.field) as total`. Filtre koşulları (örn. `entity.field = 'value'`, `entity.date_field > '2024-01-01'`). Sıralanacak alanların listesi. Biçim: `entity.field_name` veya `entity.field_name DESC`. Varsayılan yön ASC'dir. Takma ad kullanırken, takma ad adına göre sıralayın. Sorgulanacak alan adı. Döndürülecek maksimum satır sayısı. Sayfalama için atlanacak satır sayısı.

`list_query_history`

yalnızca okuma

Honeydew anlamsal katmanı aracılığıyla daha önce yürütülen sorguları, en yeniden en eskiye doğru listeleyin. Başarısız sorguları bulmak ve önceliklendirmek ile neden başarısız olduklarını anlamak için kullanın. Yönetici olmayan çağıranlar yalnızca kendi sorgularını görür.

Her sorgu, durumunu, hata mesajını, sahibini, istemcisini, alan adını, orijinal girdi SQL'ini (SQL arayüzü sorguları için kullanıcı tarafından gönderilen SQL), derleme ve veri ambarı yürütme zaman damgalarını, veri ambarı sorgu kimliğini ve Honeydew uygulamasında açmak için bir bağlantıyı içerir.

Sorgu durumuna göre filtrele (`FAILED`, `SUCCESS`, `RUNNING` veya `CANCELED`). Sorguyu çalıştıran istemciye göre filtrele (örn. `Snowflake`, `MCP`). Alan adına göre filtrele. Sorgu sahibine göre filtrele (bir kullanıcının e-postası veya bir API anahtarının adı). Yalnızca yönetici çağıranlar için dikkate alınır; yönetici olmayanlar kendi sorgularıyla sınırlıdır. Yalnızca bu zamanda veya sonrasında yürütülen sorgular (ISO 8601). Yalnızca bu zamanda veya öncesinde yürütülen sorgular (ISO 8601). Ayrıca her sorgunun anlamsal YAML tanımını da döndür (öznitelikler, metrikler, filtreler). Bir sorguyu yeniden üretmek veya değiştirmek için etkinleştirin. Ayrıca her sorgunun derlenmiş ambar SQL'ini de döndür (büyük). Belirli bir sorgunun ambar tarafında hata ayıklaması için etkinleştirin. Döndürülecek maksimum sorgu sayısı. Sayfalama için atlanacak sorgu sayısı.

Dokümantasyon

`search_docs`

yalnızca okuma

Honeydew dokümantasyon bilgi tabanında ilgili bilgileri, kod örneklerini, API referanslarını ve kılavuzları arayın. Başlıklar ve dokümantasyon sayfalarına bağlantılar içeren bağlamsal içerik döndürür. Bir sayfanın tam içeriğini okumak için query_docs_filesystem kullanın.

Arama sorgusu.

`query_docs_filesystem`

yalnızca okuma

Honeydew dokümantasyon sayfalarını ve OpenAPI spesifikasyonlarını içeren sanallaştırılmış, bellek içi bir dosya sistemine karşı salt okunur bir kabuk benzeri komut çalıştırın. rg, grep, find, tree, ls, cat, head ve tail gibi komutları destekler. Tam anahtar kelime veya regex eşleştirme, yapısal keşif veya belirli bir sayfanın tam içeriğini yola göre okumak için kullanın.

Çalıştırılacak kabuk komutu (örn. `rg -il "keyword" /`, `tree / -L 2`, `head -80 /path/page.mdx`).

SSS

Derin analiz için hangi araçlar gereklidir?

Derin Analiz çalıştırmak şunları gerektirir:

Oturum kurulumu: list_workspaces, list_workspace_branches, get_session_workspace_and_branch, set_session_workspace_and_branch
Ajan seçimi: list_agents, get_agent
Analiz: initiate_analysis, monitor_analysis, get_analysis_step_details, abort_analysis
Geri bildirim: provide_analysis_feedback

Geçmiş analiz konuşmalarını incelemek için ayrıca list_analysis_chats ve get_stored_conversation etkinleştirin.

Ajanı bu araçlarla sınırlamak şu durumlarda yararlıdır:

Hedef kullanıcılarınız yalnızca derin analiz iş akışlarını çalıştırıyor
Ajanı analiz görevlerine odaklı tutmak istiyorsunuz
İstemciniz kaç aracın etkinleştirilebileceğini sınırlıyor (örneğin, Databricks Genie Code)

Diğer kullanım durumları için, Mevcut Araçlar altında listelenen araçların daha fazlasını açığa çıkarın — ajan her görev için doğru aracı seçer.