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üle

Honeydew Semantic Layer MCP ile neler yapabilirsiniz?

Depo tablolarını ve şemalarını keşfedin — doğal konuşma yoluyla veri depo yapınızı ve anlamsal model tanımlarınızı inceleyin.
Anlamsal modeller oluşturun ve bakımını yapın — create_workspace_branch ve diğer oturum araçlarını kullanarak anlamsal model tanımlarını oluşturun veya güncelleyin.
Verileri doğal dille sorgulayın — SQL yazmadan verileriniz hakkında sorular sorun ve yanıtlar alın.
Honeydew belgelerini arayın — MCP uyumlu herhangi bir asistandan doğrudan ürün belgelerine bakın.

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?

Veri ambarı tabloları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 sürdürü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

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 kullanıcı 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 oturum açı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 Gizli Anahtarınızın Base64 ile kodlanmış bir dizesini API_KEY:API_SECRET biçiminde sağlamanız gerekir.

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

Base64 ile kodlanmış 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 aşağıdaki gibi 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.

MCP sunucu yapılandırmanızda isteğe bağlı olarak ş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 varsayılan prod)
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ı göstermek için true olarak ayarlayın (isteğe bağlı)

MCP sunucusu, aktif ç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 spesifikasyonuna](https://modelcontextprotocol.io/specification/2025-06-18/basic/transports#session-management) bakın.

Desteklenen İstemciler

Claude Code CLI

#### Eklenti Kurulumu **Git gerektirir.** Eklentiyi GitHub'dan yüklemek depoyu yerel olarak klonlar, bu nedenle [Git](https://git-scm.com/downloads) kurulu olmalı ve `PATH` üzerinde bulunmalıdır. Git eksikse, eklenti kurulumu başarısız olur. Git'i yükleyin veya eklenti yerine sunucuyu doğrudan yapılandırmak için istemcinizin manuel MCP kurulum adımlarını kullanın.

Honeydew, semantik 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.

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 yükleyin:

/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çiciden Pazar Yerleri'ni seçin
honeydew-ai-coding-agents-plugins seçeneğini belirleyin
Pazar yerini güncelle'ye tıklayın

Güncellemeleri otomatik olarak 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 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, 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:

Kuruluşunuz özel bir Honeydew ana bilgisayar adı kullanıyorsa, `https://mcp.honeydew.cloud/mcp` adresini 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'e 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'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}
      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'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>

**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 kullanarak
[ortam değişkeni genişletmeyi](https://code.claude.com/docs/en/mcp#environment-variable-expansion-in-mcp-json) destekler.

`HONEYDEW_API_KEY` ortam değişkenini ayarlayın,
ardından yapılandırmanızda buna başvurun:

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

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

Ayarlar -> Özelleştir'e gidin
Eklentilere Gözat'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 yazın
Honeydew AI eklentisi görünür. Yükleyin.

MCP Kurulumu

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

Claude Code modu

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

Honeydew MCP'sini Cowork modunda eklemek için:

Ayarlar -> Bağlayıcılar -> Özel bağlayıcı ekle'ye 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ğlanırken Honeydew'e 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'ye 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 Cowork modunda kaldırmak için:

Ayarlar -> Bağlayıcılar'a gidin
honeydew bağlayıcısını bulun ve silme simgesine tıklayın

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

Ayarlar -> Bağlayıcılar'a gidin
honeydew-docs bağlayıcısını bulun ve silme simgesine tıklayın

Claude.ai

#### Eklenti Kurulumu

Honeydew, semantik 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, hem Honeydew MCP sunucusunu hem de Honeydew Dokümantasyon MCP sunucusunu otomatik olarak kurar.

Eklenti zip dosyasını indirin: honeydew-ai-claude.zip
Claude.ai'de Ayarlar -> Eklentiler -> Eklenti ekle -> Zip yükle'ye gidin
Zip dosyasını yükleyin — eklenti özel pazar yerinizde görünür

MCP Kurulumu

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

Honeydew MCP sunucusunu eklemek için:

Ayarlar -> Bağlayıcılar -> Özel bağlayıcı ekle yoluna gidin
Ad alanına honeydew yazın
Uzak MCP sunucu URL'si alanına https://mcp.honeydew.cloud/mcp yazın
Ekle düğmesine tıklayın

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

Honeydew Dokümantasyon 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 Dokümantasyon MCP'yi yalnızca Honeydew'e bağlanmadan dokümantasyon erişimi istiyorsanız ekleyin. Kimlik doğrulaması gerekmez.

Ayarlar -> Bağlayıcılar -> Özel bağlayıcı ekle yoluna gidin
Ad alanına honeydew-docs yazın
Uzak MCP sunucu URL'si alanına https://honeydew.ai/docs/mcp yazın
Ekle düğmesine tıklayın

MCP sunucusunu kaldırma

Honeydew MCP sunucusunu kaldırmak için:

Ayarlar -> Bağlayıcılar yoluna gidin
honeydew bağlayıcısını bulun ve silme simgesine tıklayın

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

Ayarlar -> Bağlayıcılar yoluna gidin
honeydew-docs bağlayıcısını bulun ve silme simgesine tıklayın

Cortex Code CLI

#### Eklenti Kurulumu **Git gerektirir.** Eklentiyi GitHub'dan yüklemek depoyu yerel olarak klonlar, bu nedenle [Git](https://git-scm.com/downloads) kurulu olmalı ve `PATH` üzerinde bulunmalıdır. Git eksikse eklenti kurulumu başarısız olur. Git'i yükleyin veya sunucuyu doğrudan yapılandırmak için eklenti yerine istemcinizin manuel MCP kurulum adımlarını kullanın.

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 yapılandırır.

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

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

MCP Kurulumu

Honeydew MCP sunucusu, model keşfi, veri sorgulama, model yönetimi ve dokümantasyon erişimi için Cortex Code CLI'yi Honeydew Semantik Katmanına bağlar.

      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 (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 **Git gerektirir.** Eklentiyi GitHub'dan yüklemek depoyu yerel olarak klonlar, bu nedenle [Git](https://git-scm.com/downloads) kurulu olmalı ve `PATH` üzerinde bulunmalıdır. Git eksikse eklenti kurulumu başarısız olur. Git'i yükleyin veya sunucuyu doğrudan yapılandırmak için eklenti yerine istemcinizin manuel MCP kurulum adımlarını kullanın.

Ayarlar -> Eklentiler yoluna gidin
Eklenti Ekle düğmesine tıklayın, GitHub'dan Ekle seçeneğini belirleyin ve Honeydew eklenti deposunu yapıştırın: honeydew-ai/honeydew-ai-coding-agents-plugins
Akışı takip edin ve GitHub Eklenti Yükleyici Kurulumu içindeki adımları onaylayın

MCP Kurulumu

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

Bir sunucu eklemek için MCP -> Yeni yoluna gidin, bir Yapılandırma Kapsamı seçin (örneğin, Global için ~/.snowflake/cortex/mcp.json), formu doldurun, ardından Kaydet düğmesine tıklayın. Yapılandırmayı girmek için Form veya JSON sekmesini kullanın.

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** düğmesine tıklayın

      İlk bağlantı sırasında 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** düğmesine tıklayın ve adı
         `Authorization` ve değeri
         `Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET>` olarak ayarlayın
      5. **Kaydet** düğmesine 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ı sırasında 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 (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, Sunucu Adı honeydew-docs, Sunucu Türü Uzak (HTTP) ve Sunucu URL'si https://honeydew.ai/docs/mcp kullanarak ekleyin. Kimlik doğrulaması gerekmez.

MCP sunucusunu kaldırma

Bir sunucuyu kaldırmak için MCP yoluna gidin, honeydew (veya honeydew-docs) sunucusunu bulun ve kaldırın.

Cursor

#### Eklenti Kurulumu

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

MCP Kurulumu

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

Honeydew MCP'yi eklemek için:

Cursor uygulamasını açın
Ayarlar -> Cursor Ayarları -> Araçlar ve MCP yoluna gidin
Yeni MCP Sunucusu düğmesine 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 düğmesine tıklayın

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

Ayarlar -> Cursor Ayarları -> Araçlar ve MCP yoluna gidin
Yeni MCP Sunucusu düğmesine tıklayın

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

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

Kaydet düğmesine tıklayın

MCP sunucusunu kaldırma

Honeydew MCP sunucusunu kaldırmak için:

Ayarlar -> Cursor Ayarları -> Araçlar ve MCP yoluna gidin
Listede honeydew öğesini bulun ve silme simgesine tıklayın

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

Ayarlar -> Cursor Ayarları -> Araçlar ve MCP yoluna gidin
Listede honeydew-docs öğesini bulun ve silme simgesine tıklayın

Databricks Genie Code

MCP sunucuları yalnızca Genie Code Agent modunda desteklenir. Daha fazla ayrıntı için [Databricks MCP dokümantasyonuna](https://docs.databricks.com/aws/en/generative-ai/mcp/) bakın.

Ön koşullar:

Databricks çalışma alanınızda Genie Code etkinleştirilmiş olmalıdır
Unity Catalog metastore üzerinde CREATE CONNECTION ayrıcalığı

1. **Katalog** → **Bağlantılar** → **Bağlantı oluştur** seçeneğine gidin 2. **Bağlantı temelleri** ekranında: * **Bağlantı adı** alanını `honeydew-mcp` olarak ayarlayın * **Bağlantı türü** alanını **HTTP** olarak ayarlayın * **Kimlik doğrulama türü** alanını **Dinamik İstemci Kaydı** olarak ayarlayın * **İleri** seçeneğine tıklayın 3. **Kimlik doğrulama** ekranında: * **Ana bilgisayar** alanını `https://mcp.honeydew.cloud` olarak ayarlayın * **Port** alanını `443` olarak bırakın * **OAuth kapsamı** alanını `openid` olarak ayarlayın * **İleri** seçeneğine tıklayın 4. **Bağlantı detayları** ekranında: * **MCP bağlantısıdır** seçeneğini işaretleyin * **Temel yol** alanını `/mcp` olarak ayarlayın * **Bağlantı oluştur** seçeneğine tıklayın

    <Tab title="SQL">
      Aşağıdaki SQL'i bir Databricks not defterinde veya SQL düzenleyicide ç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>

  <Note>
    Kuruluşunuz özel bir Honeydew ana bilgisayar adı kullanıyorsa,
    `https://mcp.honeydew.cloud` yerine kiracı ana bilgisayar adınızı yazın.
    Ana bilgisayar adınızı Honeydew Studio'da **Ayarlar > MCP Sunucusu** bölümünde bulabilirsiniz.
  </Note>
</Step>

<Step title="Log in to the connection">
  **Katalog** → **Bağlantılar** → `honeydew-mcp` seçeneğine gidin
  ve kimlik doğrulamak ve bağlantıyı doğrulamak için
  sağ üst köşedeki **Oturum aç** seçeneğine 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** seçeneğine gidin
  3. **Harici MCP sunucusu** seçeneğini belirleyin
  4. Oluşturduğunuz `honeydew-mcp` bağlantısını seçin
  5. İstendiğinde bağlantıda oturum açın
  6. **Kaydet** seçeneğine tıklayın

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

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ı seçeneğine gidin
honeydew-mcp öğesini bulun ve Kaldır seçeneğine tıklayın

Ayrıca temeldeki Unity Katalog bağlantısını kaldırmak için aşağıdaki SQL'i çalıştırın:

DROP CONNECTION `honeydew-mcp`;

Devin

#### MCP Sunucusu

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

Honeydew MCP sunucusunu eklemek için:

Ayarlar -> Bağlantılar -> MCP sunucuları seçeneğine gidin
Özel bir MCP ekle seçeneğine tıklayın
Sunucu Adı alanına honeydew yazın
İsteğe bağlı olarak bir simge ve Kısa Açıklama ekleyin
Taşıma türü olarak HTTP seçeneğini belirleyin
Sunucu URL'si alanına https://mcp.honeydew.cloud/mcp yazın

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

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

<Tab title="API Key">
  Kimlik doğrulama yöntemi olarak **Kimlik Doğrulama Başlığı** seçeneğini belirleyin.
  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 seçeneğine tıklayın, ardından bağlantıyı doğrulamak için Araçları listele testi seçeneğine tıklayın

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

Ayarlar -> Bağlantılar -> MCP sunucuları seçeneğine gidin
Özel bir MCP ekle seçeneğine tıklayın
Sunucu Adı alanına honeydew-docs yazın
Taşıma türü olarak HTTP seçeneğini belirleyin
Sunucu URL'si alanına https://honeydew.ai/docs/mcp yazın
Kimlik doğrulama yöntemini Hiçbiri olarak ayarlayın
Kaydet seçeneğine tıklayın

MCP sunucusunu kaldırma

Honeydew MCP sunucusunu kaldırmak için:

Ayarlar -> Bağlantılar -> MCP sunucuları seçeneğine gidin
honeydew sunucusunu bulun ve kaldırın

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

Ayarlar -> Bağlantılar -> MCP sunucuları seçeneğine gidin
honeydew-docs sunucusunu bulun ve kaldırın

GitHub Copilot CLI

#### MCP Sunucusu Kuruluşunuz özel bir Honeydew ana bilgisayar adı kullanıyorsa, `https://mcp.honeydew.cloud/mcp` yerine kiracı ana bilgisayar adınızı yazın. Ana bilgisayar adınızı 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.

Yapay Zeka Kodlama Aracı Eklentileri

**Git gerektirir.** Eklentiyi GitHub'dan yüklemek depoyu yerel olarak klonlar, bu nedenle [Git](https://git-scm.com/downloads) 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, 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 **Git gerektirir.** Eklentiyi GitHub'dan yüklemek depoyu yerel olarak klonlar, bu nedenle [Git](https://git-scm.com/downloads) 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, 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, model keşfi, veri sorgulama, model yönetimi ve dokümantasyon erişimi için Gemini CLI'yi Honeydew Anlamsal Katmanına bağlar.

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 Paletini macOS'ta CMD+Shift+P ile veya Windows/Linux'ta Ctrl+Shift+P ile açın, ardından Tercihler: Kullanıcı Ayarlarını Aç (JSON) seçeneğini belirleyin)

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 yazın
Honeydew AI eklentisini bulun ve Yükle seçeneğine 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 Paletini açın ve Uzantılar: Uzantı Güncellemelerini Denetle seçeneğini çalıştırın.

MCP Sunucusu

Honeydew MCP sunucusu, model keşfi, veri sorgulama, model yönetimi ve dokümantasyon erişimi için VS Code'u Honeydew Anlamsal Katmanına bağlar.

Kuruluşunuz özel bir Honeydew ana bilgisayar adı kullanıyorsa, `https://mcp.honeydew.cloud/mcp` yerine kiracı ana bilgisayar adınızı yazın. Ana bilgisayar adınızı Honeydew Studio'da **Ayarlar > MCP Sunucusu** bölümünde bulabilirsiniz. 1. Komut Paletini `CMD+Shift+P` (macOS) veya `Ctrl+Shift+P` (Windows/Linux) ile açın 2. **MCP: Sunucu Ekle...** seçeneğini belirleyin 3. **HTTP (HTTP veya Sunucu Tarafından Gönderilen Olaylar)** seçeneğini belirleyin 4. Honeydew MCP sunucu URL'sini girin: `https://mcp.honeydew.cloud/mcp` 5. Sunucu adı olarak `honeydew` girin

Bu, sunucuyu .vscode/mcp.json dosyanıza ekler. Dosyayı açın ve gerektiği gibi 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 Dokümantasyon MCP (isteğe bağlı)

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 servers nesnesinden honeydew girdisini silin. Honeydew Dokümantasyon MCP sunucusunu kaldırmak için, aynı dosyadan honeydew-docs girdisini silin.

Codex CLI

#### Eklenti Kurulumu **Git Gerektirir.** Eklentiyi GitHub'dan yüklemek depoyu yerel olarak klonlar, bu nedenle [Git](https://git-scm.com/downloads) kurulu olmalı ve `PATH` üzerinde bulunmalıdır. Git eksikse, eklenti kurulumu başarısız olur. Git'i yükleyin veya eklenti yerine sunucuyu doğrudan yapılandırmak için istemcinizin manuel MCP kurulum adımlarını kullanın.

Codex'e pazar yerini ekleyin:

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

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

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, model keşfi, veri sorgulama, model yönetimi ve dokümantasyon erişimi için Codex'i Honeydew Anlamsal Katmanına bağlar.

Komut satırı

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

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

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

TOML yapılandırması

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

[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 Dokümantasyon 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 Dokümantasyon MCP sunucusunu kaldırmak için:

codex mcp remove honeydew-docs

Codex

Codex'te pazar yerini ekleyin:

Eklentiler'i açın
Açılır oka tıklayın ve Pazar yeri ekle'yi seçin
honeydew-ai/honeydew-ai-coding-agents-plugins ekleyin

Pazar yerini [Codex CLI](#codex-cli) üzerinden de ekleyebilirsiniz:

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

Ardından eklentiyi yükleyin:

Eklentiler'i açın
Honeydew AI pazar yerini seçin
Honeydew eklentisini yükleyin

MCP Kurulumu

Honeydew MCP

Codex uygulamasını açın
Ayarlar -> MCP Sunucuları'na gidin
Özel sunucular altında, Sunucu Ekle'ye tıklayın
Sunucu adını honeydew olarak ayarlayın
Aktarım türü olarak Akışlı HTTP'yi seçin
URL'yi https://mcp.honeydew.cloud/mcp olarak ayarlayın
Taşıyıcı belirteç ortam değişkeni alanını boş bırakın
Kimlik doğrulamayı aşağıdaki gibi yapılandırın:

OAuth kimlik doğrulaması

Codex, bağlanırken sizi Honeydew ile kimlik doğrulaması yapmaya yönlendirir. Ek yapılandırma gerekmez.

HTTP Temel kimlik doğrulaması

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

MCP kimlik doğrulama sorunlarını giderme

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

Codex CLI yükleyin
codex mcp login honeydew komutunu çalıştırın

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

Ayarlar -> MCP Sunucuları'na gidin
Özel sunucular altında, Sunucu Ekle'ye tıklayın
Sunucu adını honeydew-docs olarak ayarlayın
Aktarım türü olarak Akışlı HTTP'yi 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ı'na gidin
Özel sunucular altında honeydew öğesini bulun ve Kaldır'a tıklayın

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

Ayarlar -> MCP Sunucuları'na gidin
Özel sunucular altında honeydew-docs öğesini bulun ve Kaldır'a tıklayın

Antigravity

#### MCP Sunucusu Kuruluşunuz özel bir Honeydew ana bilgisayar adı kullanıyorsa, `https://mcp.honeydew.cloud/mcp` yerine kiracı ana bilgisayar adınızı yazın. 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 Dokümantasyon 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 Kuruluşunuz özel bir Honeydew ana bilgisayar adı kullanıyorsa, `https://mcp.honeydew.cloud/mcp` yerine kiracı ana bilgisayar adınızı yazın. 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 kaydedilmiş 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ğrulaması yapı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 Dokümantasyon MCP (isteğe bağlı)

`opencode mcp add` komutunu ç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, opencode.jsonc dosyanızdan honeydew girdisini kaldırın. Honeydew Dokümantasyon 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 özgü)
Kullanıcı: ~/.kiro/settings/mcp.json (tüm çalışma alanlarında geçerlidir)

Her iki dosya da mevcutsa, çalışma alanı yapılandırması önceliklidir. Kuruluşunuz özel bir Honeydew ana bilgisayar adı kullanıyorsa, https://mcp.honeydew.cloud/mcp yerine kiracı ana bilgisayar adınızı yazın. Ana bilgisayar adını Honeydew Studio'da Ayarlar > MCP Sunucusu bölümünde bulabilirsiniz.

Honeydew MCP sunucusunu şu 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 kez bağlanırken, Kiro bir kimlik doğrulama URL'si sağlar.
  OAuth kimlik doğrulama akışını tamamlamak için bunu tarayıcınızda açın.
</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>

Kiro CLI'da, 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 Dokümantasyon MCP'si (isteğe bağlı)

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

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

MCP sunucusunu kaldırma

Honeydew MCP sunucusunu kaldırmak için, mcp.json dosyanızdan honeydew girişini silin. Honeydew Dokümantasyon MCP sunucusunu kaldırmak için, aynı dosyadan honeydew-docs girişini 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 Agent'lar için kullanılabilir hale getirir.

Ön koşullar:

Hesap üzerinde CREATE INTEGRATION ayrıcalığına sahip bir rol
Hedef şema üzerinde CREATE MCP SERVER ayrıcalığına sahip bir rol

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

Kuruluşunuz özel bir Honeydew ana bilgisayar adı kullanıyorsa, `https://mcp.honeydew.cloud/mcp` yerine kiracı ana bilgisayar adınızı yazın. 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 agent'ına araç olarak ekleyin.
  Kullanıcılardan ilk kullanımda OAuth ile Honeydew'e kimlik doğrulaması yapmaları istenir.
</Step>

Bağımsız Honeydew Dokümantasyon MCP sunucusu Snowflake'te desteklenmez, çünkü Snowflake harici MCP sunucuları OAuth kimlik doğrulaması gerektirir ve dokümantasyon sunucusu kimlik doğrulamasızdı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 aktarımını kullanarak Honeydew MCP Sunucusuna bağlanabilir.

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

Kuruluşunuz özel bir Honeydew ana bilgisayar adı kullanıyorsa, `https://mcp.honeydew.cloud/mcp` yerine kiracı ana bilgisayar adınızı yazın. 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 bir 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, yapay zeka asistanınıza şu gibi sorular sorabilirsiniz:

"Anlamsal modelde hangi varlıklar mevcut?"
"orders varlığı için öznitelikleri ve metrikleri göster"
"Modelde hangi alanlar tanımlanmış?"
"analytics şemasında hangi tablolar var?"
"Geçen ay kaç sipariş verildi?"
"orders varlığında toplam gelir için yeni bir metrik oluştur"
"Son çeyrek için 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, "Kimlik doğrulamayı temizle" veya "Kimlik doğrula"yı seçin, ardından Honeydew'e yeniden bağlanmak için tarayıcıdaki OAuth istemlerini izleyin.

Bağlantı Sorunları

MCP sunucu URL'sinin https://mcp.honeydew.cloud/mcp ile eşleştiğini onaylayın ve istemcinizin MCP yapılandırma sözdiziminin doğru olduğunu doğrulayın. 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 token'ı aştığında uyarır ve varsayılan 25.000 token sınırını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ı sınırları ve uyarıları bölümüne bakın.

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

Mevcut Araçlar

salt okunur olarak işaretlenmiş araçlar, anlamsal modeli veya veri ambarını değiştirmez.

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

Oturum ve Çalışma Alanı

`list_workspaces`

salt okunur

Mevcut 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. Anlamsal model uygulamasını bilgilendirmek için veri ambarı türünü kullanın.

`list_workspace_branches`

salt okunur

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

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

`get_session_workspace_and_branch`

salt okunur

Geçerli oturum için ayarlanmış ç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 mevcut durumundan oluşturulur. Başlıklar aracılığıyla sabitlenmiş bir çalışma alanı yoksa, 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 bir dalı siler. Bu, yıkıcı ve geri alınamaz bir işlemdir. Bu aracı çağırmadan önce her zaman kullanıcıyla çalışma alanı adını ve dal adını onaylayı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 anlamsal 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 analizi başlatır veya devam ettirir. Bir conversation_id döndürür — ilerleme ve sonuçları sorgulamak için monitor_analysis, erken durdurmak için ise abort_analysis kullanın. Daha fazla bilgi 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ı sorgular. Her çağrı yalnızca son çağrıdan bu yana gelen mesajları döndürür. status, DONE veya NO_CHAT_CURRENTLY_RUNNING olana kadar tekrar tekrar sorgulayı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ı. Tekrar 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

Anlamsal sorgu, SQL ifadesi, kullanılan bağlam ve o adımda alınan veriler dahil olmak üzere belirli bir analiz adımı için tam ayrıntıları alır.

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

`abort_analysis`

salt okunur

Devam eden bir analizi iptal eder. İptal edilen noktadan initiate_analysis ile 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şturulma zamanına göre sıralanmış (en yeni önce) sayfalandırılmış bir analiz konuşmaları listesi döndürür. Yöneticiler tüm konuşmaları görür; yönetici olmayanlar yalnızca kendilerininkini görür. Her giriş; konuşma kimliğini, başlığı, kullanıcı geri bildirimini, alanı, aracıyı, oluşturulma 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ı. Sayfalandırma için atlanacak konuşma sayısı.

`provide_analysis_feedback`

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

Bunu, monitor_analysis tamamlandıktan ve kullanıcı sonuçtan memnuniyet veya memnuniyetsizlik ifade ettikten sonra ç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, Chart Issue, Data Issue, Wrong Judgement veya Other değerlerinden biridir.

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 tam içeriğini gözden geçirmek için bunu kullanın. Yanıttaki is_complete, konuşmanın bir terminal durumuna ulaşıp ulaşmadığını belirtir.

`list_analysis_chats`'dan gelen Konuşma Kimliği. Eğer `true` ise, `step_start` ve `step_insight` ilerleme girişlerini dahil edin. Eğer `false` ise, yalnızca nihai yanıtları ve plan/yorumlama mesajlarını döndürün.

Göz Atma ve Keşif

`list_entities`

salt okunur

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

`get_entity`

salt okunur

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

Varlığın adı.

`get_field`

salt okunur

Bir varlık içindeki belirli bir alan (öznitelik veya metrik) hakkında, YAML tanımı dahil olmak üzere ayrıntılı bilgi alın.

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

`list_domains`

salt okunur

Anlamsal modeldeki tüm alan adlarını adları, açıklamaları ve varlıklarıyla listeleyin.

`get_domain`

salt okunur

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

Alan adının adı.

`search_model`

salt okunur

Bir sorgu dizesiyle eşleşen varlıklar, öznitelikler, metrikler, veri kümeleri, dinamik veri kümeleri, alan adları ve genel parametreler için anlamsal modeli 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ıklardaki 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 kısımları için geçerlidir — cust.bal, customers.balance ile eşleşir.

Arama sorgusu 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 — tam dizeyi olduğu gibi kullanır, adı veya görünen adı tam eşleşme olan nesneleri döndürür.

Veri Ambarı Keşfi

`list_databases`

salt okunur

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

`list_schemas`

salt okunur

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

Veritabanı adı.

`list_tables`

salt okunur

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

Veritabanı adı. Şema adı.

`get_table_info`

salt okunur

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

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

Anlamsal Model

`import_tables`

Bağlı veri ambarındaki tabloları anlamsal modele aktarın. Her tablo, sütunları öznitelik 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 anlamsal 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 anlamsal model nesnesi oluşturun. Desteklenen türler: öznitelik, metrik, dinamik veri kümesi, alan adı ve genel parametre.

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

`update_object`

Bir YAML tanımından mevcut bir anlamsal model nesnesini güncelleyin. Desteklenen türler: varlık, öznitelik, metrik, veri kümesi, dinamik veri kümesi, alan adı ve genel parametre.

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

`validate_object`

salt okunur

Bir anlamsal model nesnesi YAML tanımını oluşturmadan veya güncellemeden doğrulayın. Desteklenen türler: varlık, öznitelik, metrik, veri kümesi, dinamik veri kümesi, alan adı ve genel parametre.

Doğrulanacak YAML tanımı. Doğrulamanın karşılaştırılacağı nesnenin anahtarı.

`delete_object`

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

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

Ajanlar

`list_agents`

salt okunur

Tüm ajanları adları, açıklamaları, alan adları ve bağlam referanslarıyla listeleyin.

`get_agent`

salt okunur

Bir ajan hakkında, YAML ön madde tanımı dahil olmak üzere ayrıntılı bilgi alın.

Alınacak ajanın adı.

`create_agent`

Yeni bir ajan oluşturun.

Yeni ajan için meta veriler. Hiyerarşik ad (örn., `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>
  Ajanın amacının ve yeteneklerinin açıklaması.
</ParamField>

<ParamField body="domain" type="string" required>
  Bu ajanın faaliyet gösterdiği alan adı.
</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
  (örn., `skills/**`, `knowledge/marketing/**`).
</ParamField>

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

Ön maddeden sonra eklenen Markdown gövdesi. Bu metin, her analiz oturumundan önce isteme enjekte edilir. Doğrulama hataları üretse bile ajanı oluşturun.

`update_agent`

Mevcut bir ajanı güncelleyin.

Güncellenecek ajanın adı. Tam güncellenmiş ajan tanımı. `create_agent`'daki tüm gerekli alanlar sağlanmalıdır — bu kısmi bir güncelleme değil, tam bir değiştirmedir. Ajan için güncellenmiş Markdown gövdesi. Doğrulama hataları üretse bile ajanı güncelleyin.

`delete_agent`

Bir ajanı adına göre silin.

Silinecek ajanın adı.

Bağlam Öğeleri

`list_context_items`

salt okunur

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

`get_context_item`

salt okunur

Bir bağlam öğesini adına 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
  (örn., `knowledge/customer/churn-analysis`, `skills/reporting`).
</ParamField>

<ParamField body="subtype" type="string" required>
  `knowledge`, `skill` veya `instruction`'den 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 zeka tarafından bu öğenin ne zaman yükleneceğine karar vermek için kullanılan açıklama
  (`apply`, `on_demand` olduğunda gereklidir).
</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 anlamsal nesneler.
  Her nesnenin bir `name` (dize) ve `type` (`domain`, `entity` veya `field`) değeri vardır.
</ParamField>

<ParamField body="external_source" type="object">
  İçerik alınacak 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`) içerir.
</ParamField>

`memory` olmalıdır.

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

<ParamField body="subtype" type="string" required>
  `event` veya `decision_trace`'den 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 başlangıç tarihi ISO biçiminde (örn., `2024-01-01`).
</ParamField>

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

<ParamField body="description" type="string">
  Yapay zeka tarafından bu öğenin ne zaman yükleneceğine karar vermek için kullanılan açıklama
  (`apply`, `on_demand` olduğunda gereklidir).
</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 anlamsal nesneler.
  Her nesnenin bir `name` (dize) ve `type` (`domain`, `entity` veya `field`) değeri vardır.
</ParamField>

<ParamField body="external_source" type="object">
  İçerik alınacak 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`) içerir.
</ParamField>

Bağlam öğesinin içeriği için Markdown gövdesi. Doğrulama hataları ü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`'daki tüm gerekli 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 hataları üretse bile bağlam öğesini güncelleyin.

`delete_context_item`

Bir bağlam öğesini adına göre silin.

Silinecek bağlam öğesinin adı.

Sorgu ve Önizleme

`get_sql_from_fields`

salt okunur

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

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 adlar kullanıldığında, takma ad adına göre sıralayın. Sorgulanacak etki alanı. Döndürülecek maksimum satır sayısı. Sayfalama için atlanacak satır sayısı.

`get_data_from_fields`

salt okunur

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

`list_query_history`

salt okunur

Honeydew anlamsal katmanı aracılığıyla daha önce yürütülen sorguları, en yenisi önce olacak şekilde listeler. Başarısız sorguları bulmak, sınıflandırmak ve neden başarısız olduklarını anlamak için kullanın. Yönetici olmayan çağrıcılar yalnızca kendi sorgularını görür.

Her sorgu; durumunu, hata mesajını, sahibini, istemciyi, etki alanı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`). Etki 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ğrıcılar için geçerlidir; 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ı (öznitelikler, metrikler, filtreler) döndür. Bir sorguyu yeniden oluşturmak veya değiştirmek için etkinleştirin. Ayrıca her sorgunun derlenmiş veri ambarı SQL'ini döndür (büyük). Belirli bir sorgunun veri 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`

salt okunur

İlgili bilgiler, kod örnekleri, API referansları ve kılavuzlar için Honeydew dokümantasyon bilgi tabanında arama yapar. 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`

salt okunur

Honeydew dokümantasyon sayfalarını ve OpenAPI şartnamelerini içeren sanallaştırılmış, bellek içi bir dosya sistemine karşı salt okunur bir kabuk benzeri komut çalıştırır. rg, grep, find, tree, ls, cat, head ve tail gibi komutları destekler. Tam anahtar kelime veya düzenli ifade 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`).