Honeydew Semantic Layer

offiziell

Die Honeydew Semantic Layer bietet ein gesteuertes, geschäftsorientiertes Datenmodell, das Metriken, Dimensionen und Beziehungen über Quellen hinweg vereinheitlicht und so konsistente Self-Service-Analysen sowie KI-gestützten Datenzugriff ermöglicht.

Auf honeydew.ai ansehen

Was kann man mit Honeydew Semantic Layer MCP machen?

Warehouse-Tabellen und Schemas entdecken — erkunden Sie die Struktur Ihres Data Warehouses und die Definitionen des semantischen Modells durch natürliche Gespräche.
Semantische Modelle erstellen und pflegen — erstellen oder aktualisieren Sie Definitionen semantischer Modelle mit create_workspace_branch und anderen Sitzungswerkzeugen.
Daten mit natürlicher Sprache abfragen — stellen Sie Fragen zu Ihren Daten und erhalten Sie Antworten, ohne SQL schreiben zu müssen.
Honeydew-Dokumentation durchsuchen — schlagen Sie Produktdokumentationen direkt von jedem MCP-kompatiblen Assistenten nach.

Dokumentation

MCP-Server

Was ist MCP?

Model Context Protocol (MCP) ist ein Open-Source-Standard zur sicheren Anbindung von KI-Anwendungen an externe Systeme und Tools. Honeydew bietet einen MCP-Server, der Ihren KI-Coding-Assistenten mit der Honeydew Semantic Layer verbindet.

Wann verwenden?

Entdecken und erkunden Sie Ihre Warehouse-Tabellen, Schemata und semantischen Modelldefinitionen
Erstellen und pflegen Sie Ihr semantisches Modell durch natürliche Konversation
Fragen Sie Ihre Daten in natürlicher Sprache ab von jedem MCP-kompatiblen Assistenten
Durchsuchen und lesen Sie die Honeydew-Dokumentation

Installation

Server-URL

Honeydew stellt die MCP-Server-API unter https://mcp.honeydew.cloud/mcp bereit.

Wenn Ihre Organisation einen benutzerdefinierten Honeydew-Hostnamen verwendet, ersetzen Sie die Standard-URL durch Ihren Tenant-Hostnamen. Den Hostnamen finden Sie in der Honeydew-Benutzeroberfläche unter **Einstellungen > MCP-Server**.

Authentifizierung

Es gibt zwei Möglichkeiten, sich beim Honeydew MCP-Server zu authentifizieren: OAuth oder HTTP Basic Authentication.

OAuth-Authentifizierung (empfohlen)

Die meisten Clients unterstützen OAuth-Authentifizierung. Bei der ersten Verbindung werden Sie aufgefordert:

Sich mit Ihrem Honeydew-Konto anzumelden
Die OAuth-Autorisierung zu akzeptieren

Der Client stellt dann sicher ein Zugriffstoken für nachfolgende Anfragen bereit.

HTTP Basic Authentication

Der MCP-Server im HTTP Basic Authentication-Modus benötigt einen API-Schlüssel zur Authentifizierung.

Sie müssen eine Base64-kodierte Zeichenfolge Ihres API-Schlüssels und API-Geheimnisses im Format API_KEY:API_SECRET bereitstellen.

Wenn Sie einen neuen API-Schlüssel für den MCP-Server-Zugriff erstellen, können Sie die Base64-kodierte Zeichenfolge zum Zeitpunkt der Erstellung aus der Honeydew Studio-Benutzeroberfläche kopieren.

Sie können den folgenden Befehl verwenden, um die Base64-kodierte Zeichenfolge zu generieren:

```bash theme={null} echo -n ':' | base64 ``` Verwenden Sie PowerShell:

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

Geben Sie die kodierte Zeichenfolge wie folgt im Authorization-Header an:

Authorization: Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET>

Konfiguration

Der Arbeitsbereich und der Branch werden auf Sitzungsebene mit den Tools list_workspaces, list_workspace_branches und set_session_workspace_and_branch festgelegt. Sie können auch neue Branches mit create_workspace_branch erstellen. Rufen Sie diese Tools von Ihrem KI-Assistenten aus auf, nachdem Sie eine Verbindung zum MCP-Server hergestellt haben.

Sie können optional die folgenden Header in Ihrer MCP-Server-Konfiguration angeben:

Workspace: Legt den Arbeitsbereich für alle Anfragen fest (optional)
Branch: Legt einen bestimmten Arbeitsbereich-Branch für alle Anfragen fest (optional, Standard ist prod, wenn der Arbeitsbereich festgelegt ist)
Honeydew-Client: Identifiziert den MCP-Client (optional, automatisch vom verbundenen Tool erkannt). Übergeben Sie diesen Header, um eine bestimmte Client-Kennung anzugeben.
ReadonlyToolsOnly: Auf true setzen, um nur schreibgeschützte Tools verfügbar zu machen (optional)

Der MCP-Server verwendet den `Mcp-Session-Id`-Antwortheader, um den Sitzungsstatus, einschließlich des aktiven Arbeitsbereichs und Branches, beizubehalten. Siehe die [MCP-Sitzungsverwaltungsspezifikation](https://modelcontextprotocol.io/specification/2025-06-18/basic/transports#session-management) für Details.

Unterstützte Clients

Claude Code CLI

#### Plugin-Installation **Erfordert Git.** Die Installation des Plugins von GitHub klont das Repository lokal, daher muss [Git](https://git-scm.com/downloads) installiert und in Ihrem `PATH` verfügbar sein. Wenn Git fehlt, schlägt die Plugin-Installation fehl. Installieren Sie Git oder verwenden Sie die manuellen MCP-Einrichtungsschritte Ihres Clients, um den Server direkt anstelle des Plugins zu konfigurieren.

Honeydew bietet ein Plugins-Repository mit Fähigkeiten und Tools zum Erstellen semantischer Modelle und Analysieren von Daten durch natürliche Konversation. Die Installation des Plugins richtet die Honeydew MCP-Server automatisch ein.

Starten Sie Claude Code mit claude und fügen Sie dann den Marktplatz hinzu:

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

Installieren Sie dann das Honeydew-Plugin vom Marktplatz:

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

Laden Sie dann die Plugins neu, um sie zu aktivieren:

/reload-plugins

Plugins aktualisieren

Um die Honeydew-Marktplatz-Plugins zu aktualisieren, starten Sie Claude Code mit claude, dann:

Schreiben Sie /plugin und wählen Sie Marktplätze im Selektor oben
Wählen Sie honeydew-ai-coding-agents-plugins
Klicken Sie auf Marktplatz aktualisieren

Um Updates automatisch zu erhalten, wählen Sie Automatisches Update aktivieren in den Marktplatzeinstellungen.

MCP-Einrichtung

Verwenden Sie diesen Abschnitt, wenn Ihre Organisation einen benutzerdefinierten Honeydew-Endpunkt verwendet oder wenn Sie die MCP-Server lieber ohne Installation des Plugins konfigurieren möchten. Deaktivieren Sie die vom Plugin hinzugefügte Honeydew MCP-Verbindung und fügen Sie dann Ihren benutzerdefinierten Endpunkt mit den folgenden Anweisungen hinzu.

Der Honeydew MCP-Server verbindet Claude Code mit der Honeydew Semantic Layer für Modellerkundung, Datenabfragen, Modellverwaltung und Dokumentationszugriff.

Verwenden Sie eine der folgenden Methoden, um den Honeydew MCP-Server hinzuzufügen:

      Starten Sie Claude Code mit `claude`.
      Sie werden aufgefordert, sich mit OAuth bei Honeydew zu authentifizieren.
    </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">
  Speichern Sie Folgendes unter `honeydew-mcp.json`:

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

      Registrieren Sie es dann mit:

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

      Starten Sie Claude Code mit `claude`.
      Sie werden aufgefordert, sich mit OAuth bei Honeydew zu authentifizieren.
    </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>"
        }
      }
      ```

      Registrieren Sie es dann mit:

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

<Tab title=".mcp.json">
  Fügen Sie Folgendes zu Ihrer `.mcp.json`-Datei hinzu:

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

      Starten Sie Claude Code mit `claude`.
      Sie werden aufgefordert, sich mit OAuth bei Honeydew zu authentifizieren.
    </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>

**Umgebungsvariablen für die API-Schlüssel-Authentifizierung verwenden**

Um zu vermeiden, dass sensible Werte direkt in Konfigurationsdateien gespeichert werden,
unterstützt Claude Code die
[Erweiterung von Umgebungsvariablen](https://code.claude.com/docs/en/mcp#environment-variable-expansion-in-mcp-json)
mit der `${VAR_NAME}`-Syntax.

Setzen Sie die Umgebungsvariable `HONEYDEW_API_KEY`
und referenzieren Sie sie dann in Ihrer Konfiguration:

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

Claude Code löst `${VAR_NAME}`-Referenzen
zur Laufzeit aus Ihrer Umgebung auf.

Honeydew Documentation MCP (optional)

Der Honeydew MCP-Server enthält bereits Dokumentationszugriffstools, sodass kein separater Dokumentationsserver erforderlich ist. Fügen Sie den Honeydew Documentation MCP nur hinzu, wenn Sie Dokumentationszugriff ohne Verbindung zu Honeydew wünschen. Keine Authentifizierung erforderlich.

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

Entfernen des MCP-Servers

So entfernen Sie den Honeydew MCP-Server:

claude mcp remove honeydew

So entfernen Sie den Honeydew Documentation MCP-Server:

claude mcp remove honeydew-docs

Claude Desktop

Gehen Sie zu Einstellungen -> Anpassen
Klicken Sie auf Plugins durchsuchen
Gehen Sie zur Registerkarte Persönlich
Klicken Sie auf das +-Symbol und wählen Sie Marktplatz von GitHub hinzufügen
Geben Sie honeydew-ai/honeydew-ai-coding-agents-plugins in das Eingabefeld ein
Das Honeydew AI-Plugin erscheint. Installieren Sie es.

MCP-Einrichtung

Der Honeydew MCP-Server verbindet Claude Desktop mit der Honeydew Semantic Layer für Modellerkundung, Datenabfragen, Modellverwaltung und Dokumentationszugriff.

Claude Code-Modus

Wenn Sie Claude Desktop im Claude Code-Modus verwenden, befolgen Sie stattdessen die Anweisungen für die Claude Code CLI.

So fügen Sie den Honeydew MCP im Cowork-Modus hinzu:

Gehen Sie zu Einstellungen -> Konnektoren -> Benutzerdefinierten Konnektor hinzufügen
Geben Sie honeydew in das Feld Name ein
Geben Sie https://mcp.honeydew.cloud/mcp in das Feld Remote-MCP-Server-URL ein
Klicken Sie auf Hinzufügen

Sie werden bei der ersten Verbindung aufgefordert, sich mit OAuth bei Honeydew zu authentifizieren.

Honeydew Documentation MCP (optional)

Gehen Sie zu Einstellungen -> Konnektoren -> Benutzerdefinierten Konnektor hinzufügen
Geben Sie honeydew-docs in das Feld Name ein
Geben Sie https://honeydew.ai/docs/mcp in das Feld Remote-MCP-Server-URL ein
Klicken Sie auf Hinzufügen

Entfernen des MCP-Servers

So entfernen Sie den Honeydew MCP-Server im Cowork-Modus:

Gehen Sie zu Einstellungen -> Konnektoren
Suchen Sie den honeydew-Konnektor und klicken Sie auf das Löschsymbol

So entfernen Sie den Honeydew Documentation MCP-Server:

Gehen Sie zu Einstellungen -> Konnektoren
Suchen Sie den honeydew-docs-Konnektor und klicken Sie auf das Löschsymbol

Claude.ai

#### Plugin-Installation

Laden Sie das Plugin-Zip herunter: honeydew-ai-claude.zip
Gehen Sie in Claude.ai zu Einstellungen -> Plugins -> Plugin hinzufügen -> Zip hochladen
Laden Sie das Zip hoch – das Plugin erscheint in Ihrem privaten Marktplatz

MCP-Einrichtung

Verwenden Sie diesen Abschnitt, wenn Ihre Organisation einen benutzerdefinierten Honeydew-Endpunkt verwendet oder wenn Sie die MCP-Server lieber ohne Installation des Plugins konfigurieren möchten. Entfernen Sie den vom Plugin hinzugefügten Honeydew MCP-Konnektor und fügen Sie dann Ihren benutzerdefinierten Endpunkt mit den folgenden Anweisungen hinzu.

Der Honeydew MCP-Server verbindet Claude.ai mit der Honeydew Semantic Layer für Modellerkundung, Datenabfragen, Modellverwaltung und Dokumentationszugriff.

So fügen Sie den Honeydew MCP-Server hinzu:

Gehen Sie zu Einstellungen -> Konnektoren -> Benutzerdefinierten Konnektor hinzufügen
Geben Sie honeydew in das Feld Name ein
Geben Sie https://mcp.honeydew.cloud/mcp in das Feld Remote-MCP-Server-URL ein
Klicken Sie auf Hinzufügen

Bei der ersten Verbindung werden Sie aufgefordert, sich mit OAuth bei Honeydew zu authentifizieren.

Honeydew Documentation MCP (optional)

Der Honeydew MCP-Server enthält bereits Dokumentationszugriffstools, sodass kein separater Dokumentationsserver erforderlich ist. Fügen Sie den Honeydew Documentation MCP nur hinzu, wenn Sie auf die Dokumentation zugreifen möchten, ohne eine Verbindung zu Honeydew herzustellen. Es ist keine Authentifizierung erforderlich.

Gehen Sie zu Einstellungen -> Konnektoren -> Benutzerdefinierten Konnektor hinzufügen
Geben Sie honeydew-docs in das Feld Name ein
Geben Sie https://honeydew.ai/docs/mcp in das Feld Remote-MCP-Server-URL ein
Klicken Sie auf Hinzufügen

Entfernen des MCP-Servers

So entfernen Sie den Honeydew MCP-Server:

Gehen Sie zu Einstellungen -> Konnektoren
Suchen Sie den honeydew-Konnektor und klicken Sie auf das Löschsymbol

So entfernen Sie den Honeydew Documentation MCP-Server:

Gehen Sie zu Einstellungen -> Konnektoren
Suchen Sie den honeydew-docs-Konnektor und klicken Sie auf das Löschsymbol

Cortex Code CLI

Honeydew stellt ein Plugins-Repository mit Skills und Tools zum Erstellen semantischer Modelle und Analysieren von Daten durch natürliche Konversation bereit. Die Installation des Plugins richtet die Honeydew MCP-Server automatisch ein.

Starten Sie Cortex Code CLI mit cortex und installieren Sie dann das Plugin:

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

MCP-Einrichtung

Der Honeydew MCP-Server verbindet Cortex Code CLI mit dem Honeydew Semantic Layer für Modell-Exploration, Datenabfragen, Modellverwaltung und Dokumentationszugriff.

Wenn Ihre Organisation einen benutzerdefinierten Honeydew-Hostnamen verwendet, ersetzen Sie `https://mcp.honeydew.cloud/mcp` durch Ihren Tenant-Hostnamen. Sie finden den Hostnamen in Honeydew Studio unter **Einstellungen > MCP-Server**. ```bash theme={null} cortex mcp add honeydew \ https://mcp.honeydew.cloud/mcp \ --type http ```

      Starten Sie Cortex Code CLI mit `cortex`.
      Sie werden aufgefordert, sich mit OAuth
      bei Honeydew zu authentifizieren.
    </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">
  Speichern Sie Folgendes unter `honeydew-mcp.json`:

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

      Registrieren Sie es dann mit:

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

      Starten Sie Cortex Code CLI mit `cortex`.
      Sie werden aufgefordert, sich mit OAuth
      bei Honeydew zu authentifizieren.
    </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>"
        }
      }
      ```

      Registrieren Sie es dann mit:

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

<Tab title="mcp.json">
  Fügen Sie Folgendes zu
  `~/.snowflake/cortex/mcp.json` hinzu:

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

      Starten Sie Cortex Code CLI mit `cortex`.
      Sie werden aufgefordert, sich mit OAuth
      bei Honeydew zu authentifizieren.
    </Tab>

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

Honeydew Documentation MCP (optional)

Der Honeydew MCP-Server enthält bereits Dokumentationszugriffstools, sodass kein separater Dokumentationsserver erforderlich ist. Fügen Sie den Honeydew Documentation MCP nur hinzu, wenn Sie auf die Dokumentation zugreifen möchten, ohne eine Verbindung zu Honeydew herzustellen. Es ist keine Authentifizierung erforderlich.

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

Entfernen des MCP-Servers

So entfernen Sie den Honeydew MCP-Server:

cortex mcp remove honeydew

So entfernen Sie den Honeydew Documentation MCP-Server:

cortex mcp remove honeydew-docs

Cortex Code Desktop

Gehen Sie zu Einstellungen -> Plugins
Klicken Sie auf Plugin hinzufügen, wählen Sie Von GitHub hinzufügen und fügen Sie das Honeydew-Plugin-Repository ein: honeydew-ai/honeydew-ai-coding-agents-plugins
Folgen Sie dem Ablauf und genehmigen Sie die Schritte im GitHub Plugin Installer Setup

MCP-Einrichtung

Der Honeydew MCP-Server verbindet Cortex Code Desktop mit dem Honeydew Semantic Layer für Modell-Exploration, Datenabfragen, Modellverwaltung und Dokumentationszugriff.

Um einen Server hinzuzufügen, gehen Sie zu MCP -> Neu, wählen Sie einen Konfigurationsbereich (z. B. ~/.snowflake/cortex/mcp.json für Global), füllen Sie das Formular aus und klicken Sie dann auf Speichern. Verwenden Sie die Registerkarte Formular oder JSON, um die Konfiguration einzugeben.

Fügen Sie den Honeydew MCP-Server hinzu:

1. **Servername**: `honeydew` 2. **Servertyp**: **Remote (HTTP)** 3. **Server-URL**: `https://mcp.honeydew.cloud/mcp` 4. Klicken Sie auf **Speichern**

      Bei der ersten Verbindung werden Sie aufgefordert, sich mit OAuth bei Honeydew zu authentifizieren.
    </Tab>

    <Tab title="API Key">
      1. **Servername**: `honeydew`
      2. **Servertyp**: **Remote (HTTP)**
      3. **Server-URL**: `https://mcp.honeydew.cloud/mcp`
      4. Klicken Sie unter **Header** auf **Header hinzufügen** und setzen Sie den Namen auf
         `Authorization` und den Wert auf
         `Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET>`
      5. Klicken Sie auf **Speichern**
    </Tab>
  </Tabs>
</Tab>

<Tab title="JSON">
  Wechseln Sie zur Registerkarte **JSON** und fügen Sie die Konfiguration ein:

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

      Bei der ersten Verbindung werden Sie aufgefordert, sich mit OAuth bei Honeydew zu authentifizieren.
    </Tab>

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

Honeydew Documentation MCP (optional)

Der Honeydew MCP-Server enthält bereits Dokumentationszugriffstools, sodass kein separater Dokumentationsserver erforderlich ist. Wenn Sie auf die Dokumentation zugreifen möchten, ohne eine Verbindung zu Honeydew herzustellen, fügen Sie den Honeydew Documentation MCP-Server auf die gleiche Weise hinzu, mit Servername honeydew-docs, Servertyp Remote (HTTP) und Server-URL https://honeydew.ai/docs/mcp. Es ist keine Authentifizierung erforderlich.

Entfernen des MCP-Servers

Um einen Server zu entfernen, gehen Sie zu MCP, suchen Sie den honeydew- (oder honeydew-docs-) Server und entfernen Sie ihn.

Cursor

#### Plugin-Installation

Gehen Sie in Ihren Team- oder Organisationseinstellungen zu cursor.com/dashboard/plugins (oder klicken Sie im linken Seitenmenü auf Plugins)
Scrollen Sie nach unten zu Team Marketplaces und klicken Sie entweder auf einen vorhandenen Marketplace oder klicken Sie auf Marketplace hinzufügen, um einen neuen zu erstellen. Wenn Sie einen neuen erstellen, geben Sie einen Namen ein und erstellen Sie ihn.
Klicken Sie im Marketplace auf Plugin hinzufügen, fügen Sie den GitHub-Repository-Pfad des Honeydew-Plugins ein: https://github.com/honeydew-ai/honeydew-ai-coding-agents-plugins und klicken Sie auf 1 Plugin hinzufügen
Aktivieren Sie optional die automatische Aktualisierung auf der Marketplace-Seite, damit das Plugin automatisch aktualisiert wird, wenn neue Versionen veröffentlicht werden.
Gehen Sie zurück zur Plugins-Seite (cursor.com/dashboard/plugins), suchen Sie nach dem Honeydew-Plugin und klicken Sie auf Hinzufügen

MCP-Einrichtung

Der Honeydew MCP-Server verbindet Cursor mit dem Honeydew Semantic Layer für Modell-Exploration, Datenabfragen, Modellverwaltung und Dokumentationszugriff.

So fügen Sie den Honeydew MCP hinzu:

Öffnen Sie die Cursor-Anwendung
Gehen Sie zu Einstellungen -> Cursor-Einstellungen -> Tools & MCP
Klicken Sie auf Neuer MCP-Server

Fügen Sie die folgende Konfiguration hinzu:

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

Klicken Sie auf Speichern

Honeydew Documentation MCP (optional)

Der Honeydew MCP-Server enthält bereits Dokumentationszugriffstools, sodass kein separater Dokumentationsserver erforderlich ist. Fügen Sie den Honeydew Documentation MCP nur hinzu, wenn Sie auf die Dokumentation zugreifen möchten, ohne eine Verbindung zu Honeydew herzustellen. Es ist keine Authentifizierung erforderlich.

Gehen Sie zu Einstellungen -> Cursor-Einstellungen -> Tools & MCP
Klicken Sie auf Neuer MCP-Server

Fügen Sie die folgende Konfiguration hinzu:

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

Klicken Sie auf Speichern

Entfernen des MCP-Servers

So entfernen Sie den Honeydew MCP-Server:

Gehen Sie zu Einstellungen -> Cursor-Einstellungen -> Tools & MCP
Suchen Sie honeydew in der Liste und klicken Sie auf das Löschsymbol

So entfernen Sie den Honeydew Documentation MCP-Server:

Gehen Sie zu Einstellungen -> Cursor-Einstellungen -> Tools & MCP
Suchen Sie honeydew-docs in der Liste und klicken Sie auf das Löschsymbol

Databricks Genie Code

MCP-Server werden nur im Genie Code Agent-Modus unterstützt. Weitere Details finden Sie in der [Databricks MCP-Dokumentation](https://docs.databricks.com/aws/en/generative-ai/mcp/).

Voraussetzungen:

Genie Code in Ihrem Databricks-Arbeitsbereich aktiviert
CREATE CONNECTION-Berechtigung für den Unity Catalog-Metastore
1. Navigieren Sie zu **Katalog** → **Verbindungen** → **Verbindung erstellen** 2. Auf dem Bildschirm **Verbindungsgrundlagen**: * Setzen Sie **Verbindungsname** auf `honeydew-mcp` * Setzen Sie **Verbindungstyp** auf **HTTP** * Setzen Sie **Authentifizierungstyp** auf **Dynamic Client Registration** * Klicken Sie auf **Weiter** 3. Auf dem Bildschirm **Authentifizierung**: * Setzen Sie **Host** auf `https://mcp.honeydew.cloud` * Lassen Sie **Port** als `443` * Setzen Sie **OAuth-Bereich** auf `openid` * Klicken Sie auf **Weiter** 4. Auf dem Bildschirm **Verbindungsdetails**: * Aktivieren Sie **Ist MCP-Verbindung** * Setzen Sie **Basispfad** auf `/mcp` * Klicken Sie auf **Verbindung erstellen**
```
<Tab title="SQL">
  Führen Sie das folgende SQL in einem Databricks-Notebook oder SQL-Editor aus:

  ```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>
```
Wenn Ihre Organisation einen benutzerdefinierten Honeydew-Hostnamen verwendet, ersetzen Sie `https://mcp.honeydew.cloud` durch Ihren Mandanten-Hostnamen. Sie finden Ihren Hostnamen in Honeydew Studio unter **Einstellungen > MCP-Server**. Navigieren Sie zu **Katalog** → **Verbindungen** → `honeydew-mcp` und klicken Sie oben rechts auf **Anmelden**, um die Verbindung zu authentifizieren und zu überprüfen. Gewähren Sie die Berechtigung `USE CONNECTION` allen Benutzern oder Rollen, die Zugriff auf den Honeydew MCP-Server benötigen:
```
GRANT USE CONNECTION ON CONNECTION `honeydew-mcp` TO <user-or-role>;
```
1. Öffnen Sie Genie Code und klicken Sie auf das Zahnrad-Symbol 2. Navigieren Sie zu **MCP-Server** → **Server hinzufügen** 3. Wählen Sie **Externer MCP-Server** 4. Wählen Sie die von Ihnen erstellte Verbindung `honeydew-mcp` 5. Melden Sie sich bei Aufforderung bei der Verbindung an 6. Klicken Sie auf **Speichern** Databricks begrenzt MCP auf 20 Tools über alle konfigurierten Server hinweg. Wenn Sie anpassen müssen, welche Honeydew-Tools verfügbar sind, verwenden Sie die Genie Code MCP-Einstellungen, um bestimmte Tools zu aktivieren oder zu deaktivieren.

Entfernen des MCP-Servers

So entfernen Sie den Honeydew MCP-Server aus Genie Code:

Öffnen Sie Genie Code und klicken Sie auf das Zahnrad-Symbol
Navigieren Sie zu MCP-Server
Suchen Sie honeydew-mcp und klicken Sie auf Entfernen

Um auch die zugrunde liegende Unity Catalog-Verbindung zu entfernen, führen Sie das folgende SQL aus:

DROP CONNECTION `honeydew-mcp`;

Devin

#### MCP-Server

Devin verbindet sich über seinen MCP-Marktplatz mit entfernten MCP-Servern.

So fügen Sie den Honeydew MCP-Server hinzu:

Gehen Sie zu Einstellungen -> Verbindungen -> MCP-Server
Klicken Sie auf Benutzerdefiniertes MCP hinzufügen
Geben Sie honeydew in das Feld Servername ein
Fügen Sie optional ein Symbol und eine Kurzbeschreibung hinzu
Wählen Sie HTTP als Transporttyp
Geben Sie https://mcp.honeydew.cloud/mcp in das Feld Server-URL ein

Konfigurieren Sie die Authentifizierung:

Wählen Sie **OAuth** als Authentifizierungsmethode. Devin fordert Sie während der ersten Sitzung zur Authentifizierung bei Honeydew auf.

<Tab title="API Key">
  Wählen Sie **Auth-Header** als Authentifizierungsmethode.
  Lassen Sie den Header-Schlüssel als `Authorization` und setzen Sie den Wert auf
  `Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET>`
  (siehe [Authentifizierung](#authentication)).
</Tab>

Klicken Sie auf Speichern und dann auf Test-Auflistungstools, um die Verbindung zu überprüfen

Honeydew-Dokumentation MCP (optional)

Der Honeydew MCP-Server enthält bereits Dokumentationszugriffstools, sodass kein separater Dokumentationsserver erforderlich ist. Fügen Sie das Honeydew-Dokumentation MCP nur hinzu, wenn Sie Dokumentationszugriff ohne Verbindung zu Honeydew wünschen. Es ist keine Authentifizierung erforderlich.

Gehen Sie zu Einstellungen -> Verbindungen -> MCP-Server
Klicken Sie auf Benutzerdefiniertes MCP hinzufügen
Geben Sie honeydew-docs in das Feld Servername ein
Wählen Sie HTTP als Transporttyp
Geben Sie https://honeydew.ai/docs/mcp in das Feld Server-URL ein
Setzen Sie die Authentifizierungsmethode auf Keine
Klicken Sie auf Speichern

Entfernen des MCP-Servers

So entfernen Sie den Honeydew MCP-Server:

Gehen Sie zu Einstellungen -> Verbindungen -> MCP-Server
Suchen Sie den Server honeydew und entfernen Sie ihn

So entfernen Sie den Honeydew-Dokumentation MCP-Server:

Gehen Sie zu Einstellungen -> Verbindungen -> MCP-Server
Suchen Sie den Server honeydew-docs und entfernen Sie ihn

GitHub Copilot CLI

#### MCP-Server Wenn Ihre Organisation einen benutzerdefinierten Honeydew-Hostnamen verwendet, ersetzen Sie `https://mcp.honeydew.cloud/mcp` durch Ihren Mandanten-Hostnamen. Sie finden den Hostnamen in Honeydew Studio unter **Einstellungen > MCP-Server**.

Starten Sie GitHub Copilot CLI mit copilot
Geben Sie /mcp add ein, um das Serverkonfigurationsformular zu öffnen
Füllen Sie die folgenden Felder aus:
- Name: honeydew
- Typ: http
- URL: https://mcp.honeydew.cloud/mcp
- HTTP-Header:
  Für OAuth sind keine zusätzlichen Header erforderlich. ```json theme={null} { "Authorization": "Basic " } ```
Drücken Sie Ctrl+S zum Speichern

Verwenden Sie /mcp show, um zu überprüfen, ob der Server verbunden ist.

KI-Codierungsagent-Plugins

**Erfordert Git.** Die Installation des Plugins aus GitHub klont das Repository lokal, daher muss [Git](https://git-scm.com/downloads) installiert und in Ihrem `PATH` verfügbar sein. Wenn Git fehlt, schlägt die Plugin-Installation fehl. Installieren Sie Git oder verwenden Sie die manuellen MCP-Einrichtungsschritte Ihres Clients, um den Server direkt zu konfigurieren, anstatt das Plugin zu verwenden.

Honeydew bietet ein Plugins-Repository mit Fähigkeiten und Tools zum Erstellen semantischer Modelle und zum Analysieren von Daten durch natürliche Konversation.

Fügen Sie den Marktplatz zu Copilot CLI hinzu:

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

Installieren Sie dann das Honeydew-Plugin vom Marktplatz:

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

Honeydew-Dokumentation MCP (optional)

Starten Sie GitHub Copilot CLI mit copilot
Geben Sie /mcp add ein, um das Serverkonfigurationsformular zu öffnen
Füllen Sie die folgenden Felder aus:
- Name: honeydew-docs
- Typ: http
- URL: https://honeydew.ai/docs/mcp
Drücken Sie Ctrl+S zum Speichern

Entfernen des MCP-Servers

Um den Honeydew MCP-Server zu entfernen, starten Sie GitHub Copilot CLI mit copilot und geben Sie dann ein:

/mcp remove honeydew

Um den Honeydew-Dokumentation MCP-Server zu entfernen:

/mcp remove honeydew-docs

Gemini CLI

#### Erweiterungsinstallation **Erfordert Git.** Die Installation des Plugins aus GitHub klont das Repository lokal, daher muss [Git](https://git-scm.com/downloads) installiert und in Ihrem `PATH` verfügbar sein. Wenn Git fehlt, schlägt die Plugin-Installation fehl. Installieren Sie Git oder verwenden Sie die manuellen MCP-Einrichtungsschritte Ihres Clients, um den Server direkt zu konfigurieren, anstatt das Plugin zu verwenden.

Honeydew bietet ein Plugins-Repository mit Fähigkeiten und Tools zum Erstellen semantischer Modelle und zum Analysieren von Daten durch natürliche Konversation. Die Installation der Erweiterung richtet die Honeydew MCP-Server automatisch ein.

Führen Sie den folgenden Befehl aus, um die Honeydew-Erweiterung zu installieren:

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

Das Flag --auto-update hält die Erweiterung automatisch auf dem neuesten Stand.

MCP-Einrichtung

Verwenden Sie diesen Abschnitt, wenn Ihre Organisation einen benutzerdefinierten Honeydew-Endpunkt verwendet oder wenn Sie die MCP-Server lieber ohne Installation der Erweiterung konfigurieren möchten. Deaktivieren Sie die von der Erweiterung hinzugefügte Honeydew MCP-Verbindung und fügen Sie dann Ihren benutzerdefinierten Endpunkt mit den folgenden Anweisungen hinzu.

Der Honeydew MCP-Server verbindet Gemini CLI mit der Honeydew Semantic Layer für Modellerkundung, Datenabfragen, Modellverwaltung und Dokumentationszugriff.

Führen Sie den folgenden Befehl aus, um den Honeydew MCP-Server hinzuzufügen:

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

  Starten Sie Gemini CLI mit `gemini`.
  Sie werden aufgefordert, sich mit OAuth bei Honeydew zu authentifizieren.
</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-Dokumentation MCP (optional)

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

Entfernen des MCP-Servers

So entfernen Sie den Honeydew MCP-Server:

gemini mcp remove honeydew

So entfernen Sie den Honeydew-Dokumentation MCP-Server:

gemini mcp remove honeydew-docs

VS Code und GitHub Copilot

#### Plugin-Installation

Honeydew bietet ein Plugins-Repository mit Fähigkeiten und Tools zum Erstellen semantischer Modelle und zum Analysieren von Daten durch natürliche Konversation. Die Installation des Plugins richtet die Honeydew MCP-Server automatisch ein.

Honeydew-Marktplatz hinzufügen

Öffnen Sie Ihre VS Code settings.json (öffnen Sie die Befehlspalette mit CMD+Shift+P unter macOS oder Ctrl+Shift+P unter Windows/Linux, und wählen Sie dann Einstellungen: Benutzereinstellungen öffnen (JSON))

Fügen Sie den Honeydew-Marktplatz zur Einstellung chat.plugins.marketplaces hinzu:

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

Plugin installieren

Öffnen Sie die Erweiterungsansicht (CMD+Shift+X unter macOS oder Ctrl+Shift+X unter Windows/Linux)
Geben Sie @agentPlugins in das Suchfeld ein
Suchen Sie das Honeydew AI-Plugin und klicken Sie auf Installieren

Wenn Sie zum ersten Mal ein Plugin von einem neuen Marktplatz installieren, zeigt VS Code eine Vertrauensaufforderung an – überprüfen Sie die Marktplatzquelle, bevor Sie bestätigen.

Plugin aktualisieren

Wenn extensions.autoUpdate in den VS Code-Einstellungen aktiviert ist, wird das Plugin automatisch aktualisiert. Um manuell zu aktualisieren, öffnen Sie die Befehlspalette und führen Sie Erweiterungen: Nach Erweiterungsaktualisierungen suchen aus.

MCP-Server

Der Honeydew MCP-Server verbindet VS Code mit der Honeydew Semantic Layer für Modellerkundung, Datenabfragen, Modellverwaltung und Dokumentationszugriff.

Wenn Ihre Organisation einen benutzerdefinierten Honeydew-Hostnamen verwendet, ersetzen Sie `https://mcp.honeydew.cloud/mcp` durch Ihren Mandanten-Hostnamen. Sie finden den Hostnamen in Honeydew Studio unter **Einstellungen > MCP-Server**. 1. Öffnen Sie die Befehlspalette mit `CMD+Shift+P` (macOS) oder `Ctrl+Shift+P` (Windows/Linux) 2. Wählen Sie **MCP: Server hinzufügen...** 3. Wählen Sie **HTTP (HTTP oder Server-Sent Events)** 4. Geben Sie die Honeydew MCP-Server-URL ein: `https://mcp.honeydew.cloud/mcp` 5. Geben Sie `honeydew` als Servernamen ein

Dadurch wird der Server zu Ihrer .vscode/mcp.json-Datei hinzugefügt. Öffnen Sie die Datei und fügen Sie bei Bedarf Header hinzu:

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

Der Honeydew MCP-Server enthält bereits Tools für den Dokumentationszugriff, sodass kein separater Dokumentationsserver erforderlich ist. Fügen Sie den Honeydew Documentation MCP nur hinzu, wenn Sie auf die Dokumentation zugreifen möchten, ohne eine Verbindung zu Honeydew herzustellen. Es ist keine Authentifizierung erforderlich.

Fügen Sie Folgendes zu Ihrer .vscode/mcp.json hinzu:

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

Entfernen des MCP-Servers

Um den Honeydew MCP-Server zu entfernen, öffnen Sie .vscode/mcp.json und löschen Sie den honeydew- Eintrag aus dem servers-Objekt. Um den Honeydew Documentation MCP-Server zu entfernen, löschen Sie den honeydew-docs-Eintrag aus derselben Datei.

Codex CLI

Honeydew bietet ein Plugins-Repository mit Fähigkeiten und Werkzeugen zum Erstellen semantischer Modelle und zum Analysieren von Daten durch natürliche Konversation. Die Installation des Plugins richtet die Honeydew MCP-Server automatisch ein.

Fügen Sie den Marketplace zu Codex hinzu:

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

Starten Sie dann Codex mit codex und geben Sie /plugins ein, um das Honeydew AI-Plugin zu durchsuchen und zu installieren.

Plugins aktualisieren

Um den Honeydew-Marketplace zu aktualisieren, führen Sie aus:

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

Starten Sie dann Codex und geben Sie /plugins ein, um Updates anzuwenden.

MCP-Einrichtung

Der Honeydew MCP-Server verbindet Codex mit der Honeydew Semantic Layer für Modell-Exploration, Datenabfragen, Modellverwaltung und Dokumentationszugriff.

Wenn Ihre Organisation einen benutzerdefinierten Honeydew-Hostnamen verwendet, ersetzen Sie `https://mcp.honeydew.cloud/mcp` durch Ihren Mandanten-Hostnamen. Den Hostnamen finden Sie in Honeydew Studio unter **Einstellungen > MCP-Server**.

Befehlszeile

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

Starten Sie dann Codex mit codex. Sie werden aufgefordert, sich mit OAuth bei Honeydew zu authentifizieren.

Nachdem Sie den Server hinzugefügt haben, öffnen Sie die Konfigurationsdatei unter ~/.codex/config.toml und fügen Sie bei Bedarf Header zum Abschnitt [mcp_servers.honeydew] hinzu.

TOML-Konfiguration

Fügen Sie Folgendes zu ~/.codex/config.toml hinzu (oder .codex/config.toml in einem vertrauenswürdigen Projekt):

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

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

Setzen Sie die Umgebungsvariable HONEYDEW_AUTH auf Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET> (siehe Authentifizierung).

Honeydew Documentation MCP (optional)

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

Entfernen des MCP-Servers

So entfernen Sie den Honeydew MCP-Server:

codex mcp remove honeydew

So entfernen Sie den Honeydew Documentation MCP-Server:

codex mcp remove honeydew-docs

Codex

Fügen Sie den Marketplace in Codex hinzu:

Öffnen Sie Plugins
Klicken Sie auf den Dropdown-Pfeil und wählen Sie Marketplace hinzufügen
Fügen Sie honeydew-ai/honeydew-ai-coding-agents-plugins hinzu

Sie können den Marketplace auch über die [Codex CLI](#codex-cli) hinzufügen:

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

Installieren Sie dann das Plugin:

Öffnen Sie Plugins
Wählen Sie den Honeydew AI-Marketplace
Installieren Sie das Honeydew-Plugin

MCP-Einrichtung

Honeydew MCP

Öffnen Sie die Codex-Anwendung
Gehen Sie zu Einstellungen -> MCP-Server
Klicken Sie unter Benutzerdefinierte Server auf Server hinzufügen
Setzen Sie den Servernamen auf honeydew
Wählen Sie Streamable HTTP als Transporttyp
Setzen Sie die URL auf https://mcp.honeydew.cloud/mcp
Lassen Sie das Feld Bearer-Token-Umgebungsvariable leer
Konfigurieren Sie die Authentifizierung wie folgt:

OAuth-Authentifizierung

Codex leitet Sie zur Authentifizierung bei Honeydew weiter, wenn die Verbindung hergestellt wird. Es ist keine zusätzliche Konfiguration erforderlich.

HTTP Basic-Authentifizierung

Fügen Sie einen Authorization-Header zur obigen Header-Liste mit dem Wert Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET> hinzu (siehe Authentifizierung).

Fehlerbehebung bei der MCP-Authentifizierung

Wenn der Honeydew MCP-Server in Codex nicht authentifiziert ist und die Option "Authentifizieren" nicht angezeigt wird:

Installieren Sie die Codex CLI
Führen Sie codex mcp login honeydew aus

Honeydew Documentation MCP (optional)

Gehen Sie zu Einstellungen -> MCP-Server
Klicken Sie unter Benutzerdefinierte Server auf Server hinzufügen
Setzen Sie den Servernamen auf honeydew-docs
Wählen Sie Streamable HTTP als Transporttyp
Setzen Sie die URL auf https://honeydew.ai/docs/mcp

Entfernen des MCP-Servers

So entfernen Sie den Honeydew MCP-Server:

Gehen Sie zu Einstellungen -> MCP-Server
Suchen Sie honeydew unter Benutzerdefinierte Server und klicken Sie auf Entfernen

So entfernen Sie den Honeydew Documentation MCP-Server:

Gehen Sie zu Einstellungen -> MCP-Server
Suchen Sie honeydew-docs unter Benutzerdefinierte Server und klicken Sie auf Entfernen

Antigravity

#### MCP-Server Wenn Ihre Organisation einen benutzerdefinierten Honeydew-Hostnamen verwendet, ersetzen Sie `https://mcp.honeydew.cloud/mcp` durch Ihren Mandanten-Hostnamen. Den Hostnamen finden Sie in Honeydew Studio unter **Einstellungen > MCP-Server**.

Öffnen Sie den Antigravity-Editor
Klicken Sie auf das ...-Dropdown oben im Agent-Panel
Klicken Sie auf MCP-Server verwalten
Klicken Sie auf Rohkonfiguration anzeigen

Fügen Sie Folgendes zu mcp_config.json hinzu:

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

Speichern Sie die Datei

Honeydew Documentation MCP (optional)

Öffnen Sie den Antigravity-Editor
Klicken Sie auf das ...-Dropdown oben im Agent-Panel
Klicken Sie auf MCP-Server verwalten
Klicken Sie auf Rohkonfiguration anzeigen

Fügen Sie Folgendes zu mcp_config.json hinzu:

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

Speichern Sie die Datei

Entfernen des MCP-Servers

So entfernen Sie den Honeydew MCP-Server:

Öffnen Sie den Antigravity-Editor
Klicken Sie auf das ...-Dropdown oben im Agent-Panel
Klicken Sie auf MCP-Server verwalten
Klicken Sie auf Rohkonfiguration anzeigen
Entfernen Sie die Einträge honeydew und honeydew-docs aus mcp_config.json
Speichern Sie die Datei

OpenCode

#### MCP-Server Wenn Ihre Organisation einen benutzerdefinierten Honeydew-Hostnamen verwendet, ersetzen Sie `https://mcp.honeydew.cloud/mcp` durch Ihren Mandanten-Hostnamen. Den Hostnamen finden Sie in Honeydew Studio unter **Einstellungen > MCP-Server**. Führen Sie den folgenden Befehl aus und folgen Sie den interaktiven Eingabeaufforderungen:

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

  Geben Sie bei Aufforderung die folgenden Werte ein:

  1. **Speicherort**: Wählen Sie Ihren bevorzugten Bereich (aktuelles Projekt oder global)
  2. **MCP-Servername**: `honeydew`
  3. **MCP-Servertyp**: `Remote`
  4. **MCP-Server-URL**: `https://mcp.honeydew.cloud/mcp`
  5. **OAuth-Authentifizierung**: `Yes`
  6. **Vorregistrierte Client-ID**: `No`
</Tab>

<Tab title="JSON configuration">
  Fügen Sie Folgendes zu Ihrer `opencode.jsonc`-Datei hinzu:

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

      Authentifizieren Sie sich dann bei Honeydew:

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

      Dies öffnet ein Browserfenster, um den OAuth-Authentifizierungsablauf abzuschließen.
    </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>

Erneute Authentifizierung

Um sich erneut zu authentifizieren, überprüfen Sie Ihren Status und melden Sie sich zuerst ab:

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

Honeydew Documentation MCP (optional)

Führen Sie `opencode mcp add` aus und geben Sie die folgenden Werte ein:

  1. **MCP-Servername**: `honeydew-docs`
  2. **MCP-Servertyp**: `Remote`
  3. **MCP-Server-URL**: `https://honeydew.ai/docs/mcp`
  4. **OAuth-Authentifizierung**: `No`
</Tab>

<Tab title="JSON configuration">
  Fügen Sie Folgendes zu Ihrer `opencode.jsonc`-Datei hinzu:

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

Entfernen des MCP-Servers

Um den Honeydew MCP-Server zu entfernen, entfernen Sie den honeydew-Eintrag aus Ihrer opencode.jsonc-Datei. Um den Honeydew Documentation MCP-Server zu entfernen, entfernen Sie den honeydew-docs-Eintrag aus derselben Datei.

Kiro

Die Kiro-IDE und die Kiro-CLI verwenden dieselben MCP-Konfigurationsdateien, sodass die folgenden Schritte für beide gelten.

MCP-Server

Kiro liest MCP-Server aus zwei Konfigurationsdateien:

Arbeitsbereich: .kiro/settings/mcp.json (spezifisch für das aktuelle Projekt)
Benutzer: ~/.kiro/settings/mcp.json (gilt für alle Arbeitsbereiche)

Wenn beide Dateien vorhanden sind, hat die Arbeitsbereichskonfiguration Vorrang. Wenn Ihre Organisation einen benutzerdefinierten Honeydew-Hostnamen verwendet, ersetzen Sie https://mcp.honeydew.cloud/mcp durch Ihren Tenant-Hostnamen. Den Hostnamen finden Sie in Einstellungen > MCP-Server in Honeydew Studio.

Fügen Sie den Honeydew MCP-Server zu einer dieser mcp.json-Dateien hinzu (Workspace oder Benutzer):

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

  Bei der ersten Verbindung mit Honeydew stellt Kiro eine Authentifizierungs-URL bereit.
  Öffnen Sie diese in Ihrem Browser, um den OAuth-Authentifizierungsablauf abzuschließen.
</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>

Führen Sie in der Kiro-CLI /mcp aus, um zu überprüfen, ob der Server verbunden ist. In der Kiro-IDE erscheint der Server im MCP-Bedienfeld.

Honeydew Documentation MCP (optional)

Der Honeydew MCP-Server enthält bereits Dokumentationszugriffswerkzeuge, sodass ein separater Dokumentationsserver nicht erforderlich ist. Fügen Sie den Honeydew Documentation MCP nur hinzu, wenn Sie Dokumentationszugriff ohne Verbindung zu Honeydew wünschen. Es ist keine Authentifizierung erforderlich.

Fügen Sie Folgendes zu Ihrer mcp.json hinzu:

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

Entfernen des MCP-Servers

Um den Honeydew MCP-Server zu entfernen, löschen Sie den honeydew-Eintrag aus Ihrer mcp.json. Um den Honeydew Documentation MCP-Server zu entfernen, löschen Sie den honeydew-docs-Eintrag aus derselben Datei.

Snowflake Intelligence

Snowflake verbindet sich über [MCP-Konnektoren](https://docs.snowflake.com/en/user-guide/snowflake-cortex/cortex-agents-mcp-connectors) mit externen MCP-Servern und macht Honeydew-Tools für Snowflake Intelligence und Cortex Agents verfügbar.

Voraussetzungen:

Eine Rolle mit der CREATE INTEGRATION-Berechtigung für das Konto
Eine Rolle mit der CREATE MCP SERVER-Berechtigung für das Zielschema

Standardmäßig besitzt nur die ACCOUNTADMIN-Rolle diese Berechtigungen.

Wenn Ihre Organisation einen benutzerdefinierten Honeydew-Hostnamen verwendet, ersetzen Sie `https://mcp.honeydew.cloud/mcp` durch Ihren Tenant-Hostnamen. Den Hostnamen finden Sie in **Einstellungen > MCP-Server** in Honeydew Studio. ```sql theme={null} CREATE API INTEGRATION honeydew_mcp_integration API_PROVIDER = external_mcp API_ALLOWED_PREFIXES = ('https://mcp.honeydew.cloud/mcp') API_USER_AUTHENTICATION = ( TYPE = OAUTH_DYNAMIC_CLIENT OAUTH_RESOURCE_URL = 'https://mcp.honeydew.cloud/mcp' OAUTH_ALLOWED_SCOPES = ('openid') ) ENABLED = TRUE; ```

<Step title="Create the external MCP server">
  Der externe MCP-Server ist ein Objekt auf Schemaebene,
  das auf die API-Integration verweist:

  ```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">
  Gewähren Sie Nutzungsrechte sowohl für die Integration als auch für den MCP-Server
  an alle Rollen, die Zugriff auf Honeydew benötigen:

  ```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">
  Fügen Sie den `honeydew` MCP-Server als Tool zu einem Cortex Agent
  oder einem Snowflake Intelligence Agent hinzu.
  Benutzer werden bei der ersten Verwendung zur OAuth-Authentifizierung bei Honeydew aufgefordert.
</Step>

Der eigenständige Honeydew Documentation MCP-Server wird in Snowflake nicht unterstützt, da externe Snowflake MCP-Server eine OAuth- Authentifizierung erfordern und der Dokumentationsserver nicht authentifiziert ist. Der Dokumentationszugriff ist über die Dokumentationswerkzeuge des Honeydew MCP-Servers verfügbar.

Entfernen des MCP-Servers

Löschen Sie zuerst den MCP-Server, dann die API-Integration:

DROP MCP SERVER honeydew;
DROP INTEGRATION honeydew_mcp_integration;

Andere Clients

Jeder MCP-kompatible Client kann sich über den standardmäßigen HTTP-Transport mit dem Honeydew MCP-Server verbinden.

Verwenden Sie die folgende JSON-Konfiguration als Ausgangspunkt:

Wenn Ihre Organisation einen benutzerdefinierten Honeydew-Hostnamen verwendet, ersetzen Sie `https://mcp.honeydew.cloud/mcp` durch Ihren Tenant-Hostnamen. Den Hostnamen finden Sie in **Einstellungen > MCP-Server** in Honeydew Studio. ```json theme={null} { "name": "honeydew", "type": "http", "url": "https://mcp.honeydew.cloud/mcp" } ``` ```json theme={null} { "name": "honeydew", "type": "http", "url": "https://mcp.honeydew.cloud/mcp", "headers": { "Authorization": "Basic " } } ```

Siehe Server-URL, Authentifizierung und Konfiguration für Details zu jedem Parameter.

Beispielverwendung

Sobald die Verbindung hergestellt ist, können Sie Ihrem KI-Assistenten Fragen stellen wie:

"Welche Entitäten sind im semantischen Modell verfügbar?"
"Zeigen Sie mir die Attribute und Metriken für die orders-Entität"
"Welche Domänen sind im Modell definiert?"
"Welche Tabellen befinden sich im analytics-Schema?"
"Wie viele Bestellungen wurden letzten Monat aufgegeben?"
"Erstellen Sie eine neue Metrik für den Gesamtumsatz für die orders-Entität"
"Wie hoch ist der durchschnittliche Bestellwert nach Region für das letzte Quartal?"

Fehlerbehebung

OAuth-Authentifizierungsprobleme

Überprüfen Sie, ob Ihr Client OAuth unterstützt, stellen Sie sicher, dass Sie über die erforderlichen Honeydew-Workspace- Berechtigungen verfügen, und versuchen Sie eine erneute Authentifizierung über die MCP-Verwaltungsoberfläche Ihres Clients.

Erneute Authentifizierung in Claude Code

Geben Sie /mcp ein, wählen Sie den Honeydew MCP aus der Liste, wählen Sie "Authentifizierung löschen" oder "Authentifizieren" und folgen Sie dann den OAuth-Anweisungen im Browser, um die Verbindung zu Honeydew wiederherzustellen.

Verbindungsprobleme

Bestätigen Sie, dass die MCP-Server-URL mit https://mcp.honeydew.cloud/mcp übereinstimmt, und überprüfen Sie, ob die MCP-Konfigurationssyntax Ihres Clients korrekt ist. Wenn Ihre Organisation einen benutzerdefinierten Hostnamen verwendet, überprüfen Sie, ob die URL mit Ihrem Tenant-Hostnamen übereinstimmt, der in Einstellungen > MCP-Server in Honeydew Studio angezeigt wird.

Fehlende Tools

Überprüfen Sie, ob die Authentifizierung erfolgreich war, überprüfen Sie Ihre Honeydew-Workspace-Zugriffsberechtigungen und sehen Sie sich die Konsole Ihres Clients auf Fehlermeldungen an.

Ausgabe überschreitet maximal zulässige Tokens (Claude)

In Claude Code, Claude Desktop und Claude.ai kann ein Tool-Aufruf mit einem Fehler fehlschlagen, dass die Ausgabe die maximal zulässigen Tokens überschreitet. Honeydew-Analysetools wie monitor_analysis und get_analysis_step_details können große Ergebnisse zurückgeben, die das MCP-Ausgabelimit von Claude überschreiten.

Claude warnt, wenn die MCP-Tool-Ausgabe 10.000 Tokens überschreitet, und lehnt Ausgaben über dem Standardlimit von 25.000 Tokens ab. Um das Limit zu erhöhen, setzen Sie die Umgebungsvariable MAX_MCP_OUTPUT_TOKENS, bevor Sie Claude starten:

export MAX_MCP_OUTPUT_TOKENS=50000
claude

Siehe MCP-Ausgabelimits und Warnungen in der Claude-Dokumentation für Details.

Für zusätzliche Unterstützung wenden Sie sich an den Honeydew-Support unter support@honeydew.ai.

Verfügbare Tools

Als schreibgeschützt markierte Tools ändern das semantische Modell oder das Data Warehouse nicht.

Um nur schreibgeschützte Tools verfügbar zu machen, setzen Sie den `ReadonlyToolsOnly: true`-Header in Ihrer MCP-Serverkonfiguration. Wenn aktiviert, gibt der Server nur Tools zurück, die das semantische Modell oder das Data Warehouse nicht ändern.

Sitzung & Workspace

`list_workspaces`

schreibgeschützt

Listet alle verfügbaren Workspaces auf. Gibt den Workspace-Namen und den Data-Warehouse-Typ (snowflake, databricks oder bigquery) zurück. Verwenden Sie den Data-Warehouse-Typ, um die Implementierung des semantischen Modells zu unterstützen.

`list_workspace_branches`

schreibgeschützt

Listet alle für einen Workspace verfügbaren Branches auf.

Der Name des Workspace.

`get_session_workspace_and_branch`

schreibgeschützt

Ruft den für die aktuelle Sitzung festgelegten Workspace und Branch ab.

`set_session_workspace_and_branch`

schreibgeschützt

Legt den für die aktuelle Sitzung zu verwendenden Workspace und Branch fest. Alle nachfolgenden Tool-Aufrufe in der Sitzung verwenden diesen Workspace und Branch.

Der Name des Workspace. Der zu verwendende Branch.

`create_workspace_branch`

Erstellt einen neuen Branch für einen vorhandenen Workspace. Der Branch wird aus dem aktuellen Zustand des prod-Branches des Workspace erstellt. Wenn kein Workspace über Header festgelegt ist, wechselt die Sitzung automatisch zum neuen Branch.

Name des Workspace, für den ein Branch erstellt werden soll. Name des zu erstellenden neuen Branches.

`delete_workspace_branch`

Löscht einen Branch aus einem Workspace. Dies ist ein destruktiver, irreversibler Vorgang. Bestätigen Sie immer den Workspace-Namen und den Branch-Namen mit dem Benutzer, bevor Sie dieses Tool aufrufen. Der prod-Branch kann nicht gelöscht werden. Wenn der gelöschte Branch der aktuelle Sitzungsbranch ist, wechselt die Sitzung automatisch zu prod.

Name des Workspace, der den zu löschenden Branch enthält. Name des zu löschenden Branches.

`get_branch_history`

schreibgeschützt

Ruft den Änderungsverlauf für den Branch der aktuellen Sitzung ab. Gibt eine Liste von Änderungen zurück, die zeigt, welche semantischen Objekte geändert wurden, von wem und wann.

Maximale Anzahl der zurückzugebenden Änderungen.

`create_pr_for_working_branch`

Erstellt einen Pull-Request für den Arbeitsbranch der aktuellen Sitzung. Gibt bei Erfolg die PR-URL zurück.

Titel für den Pull-Request. Beschreibung für den Pull-Request.

Frage & Analyse

`initiate_analysis`

schreibgeschützt

Startet oder setzt eine Datenanalyse fort. Gibt eine conversation_id zurück — verwenden Sie monitor_analysis, um Fortschritt und Ergebnisse abzufragen, und abort_analysis, um sie vorzeitig zu beenden. Siehe Deep Analysis für weitere Details.

Die zu stellende Frage in natürlicher Sprache. Agent-Name für eine neue Konversation. Bei Folgefragen weglassen — der Agent wird aus der bestehenden Konversation übernommen. Vorhandene Konversations-ID zum Fortsetzen, oder weglassen, um eine neue Konversation zu starten.

`monitor_analysis`

schreibgeschützt

Fragt neue Fortschrittsmeldungen von einer laufenden Analyse ab. Jeder Aufruf gibt nur Meldungen seit dem letzten Aufruf zurück. Wiederholt abfragen, bis status entweder DONE oder NO_CHAT_CURRENTLY_RUNNING ist.

Von `initiate_analysis` zurückgegebene Konversations-ID. Maximale Anzahl der pro Aufruf zurückzugebenden Meldungen. Nachrichten-ID, ab der wiedergegeben werden soll. Verwenden Sie `last_received_message_id` aus einem vorherigen Ergebnis, um verpasste Meldungen wiederherzustellen.

`get_analysis_step_details`

schreibgeschützt

Ruft vollständige Details für einen bestimmten Analyseschritt ab, einschließlich der semantischen Abfrage, der SQL-Anweisung, des verwendeten Kontexts und der in diesem Schritt abgerufenen Daten.

Von `initiate_analysis` zurückgegebene Konversations-ID. Schritt-ID von `monitor_analysis` (z. B. `STEP/0`).

`abort_analysis`

schreibgeschützt

Bricht eine laufende Analyse ab. Kann mit initiate_analysis vom Abbruchpunkt aus fortgesetzt werden.

Von `initiate_analysis` zurückgegebene Konversations-ID.

`list_analysis_chats`

schreibgeschützt

Gibt eine paginierte Liste von Analysekonservationen für den aktuellen Workspace zurück, sortiert nach Erstellungszeit (neueste zuerst). Administratoren sehen alle Konversationen; Nicht-Administratoren sehen nur ihre eigenen. Jeder Eintrag enthält die Konversations-ID, den Titel, Benutzerfeedback, Domäne, Agent, Erstellungszeit und den Anzeigenamen des Benutzers, der sie erstellt hat.

Maximale Anzahl der zurückzugebenden Konversationen. Anzahl der für die Paginierung zu überspringenden Konversationen.

`provide_analysis_feedback`

Setzt oder löscht Feedback zu einer bestimmten Analysekonservation. Es gibt einen einzigen Feedback-Eintrag pro Konversation (nicht pro Frage) — er sollte die Gesamtqualität des gesamten Konversationsverlaufs widerspiegeln.

Rufen Sie dies auf, nachdem monitor_analysis abgeschlossen ist und der Benutzer Zufriedenheit oder Unzufriedenheit mit dem Ergebnis äußert. Verwenden Sie eine kurze bestätigende Zeichenfolge für positives Feedback (z. B. Good) oder das Format <Reason>: <details> für negatives Feedback, wobei Reason einer von Chart Issue, Data Issue, Wrong Judgement oder Other ist.

Konversations-ID der Analysekonservation. Zu speichernder Feedback-Text oder `null`, um vorhandenes Feedback zu löschen.

`get_stored_conversation`

schreibgeschützt Gibt alle Nachrichten einer bestehenden Analyse-Konversation zurück. Verwenden Sie dies, um den gesamten Inhalt einer vorherigen Konversation zu überprüfen. is_complete in der Antwort gibt an, ob die Konversation einen Endzustand erreicht hat.

Konversations-ID von `list_analysis_chats`. Wenn `true`, schließen Sie `step_start` und `step_insight` Fortschrittseinträge ein. Wenn `false`, geben Sie nur endgültige Antworten und Plan-/Interpretationsnachrichten zurück.

Durchsuchen & Entdecken

`list_entities`

schreibgeschützt

Listet alle Entitäten im semantischen Modell mit ihren Namen, Beschreibungen und Schlüsseln auf.

`get_entity`

schreibgeschützt

Ruft detaillierte Informationen zu einer Entität ab, einschließlich ihrer Attribute, Metriken, Datasets, Beziehungen und YAML-Definition.

Der Name der Entität.

`get_field`

schreibgeschützt

Ruft detaillierte Informationen zu einem bestimmten Feld (Attribut oder Metrik) innerhalb einer Entität ab, einschließlich seiner YAML-Definition.

Der Name der Entität, die das Feld enthält. Der Name des Feldes.

`list_domains`

schreibgeschützt

Listet alle Domänen im semantischen Modell mit ihren Namen, Beschreibungen und Entitäten auf.

`get_domain`

schreibgeschützt

Ruft detaillierte Informationen zu einer Domäne ab, einschließlich ihrer Entitäten, Filter, Parameter und YAML-Definition.

Der Name der Domäne.

`search_model`

schreibgeschützt

Durchsucht das semantische Modell nach Entitäten, Attributen, Metriken, Datasets, dynamischen Datasets, Domänen und globalen Parametern, die mit einer Abfragezeichenfolge übereinstimmen.

Verwenden Sie die entity.field-Syntax, um die Suche auf Felder innerhalb einer bestimmten Entität einzugrenzen. Zum Beispiel findet customers.balance das Feld balance in Entitäten, die mit customers übereinstimmen; customers. gibt alle Felder übereinstimmender Entitäten zurück. Im OR/AND- Modus gelten Teilübereinstimmungen sowohl für den Entitäts- als auch den Feldteil — cust.bal stimmt mit customers.balance überein.

Die Suchabfragezeichenfolge. Steuert, wie die Abfrage abgeglichen wird:

OR — teilt nach Leerzeichen auf und gibt Objekte zurück, die mit einem beliebigen Wort übereinstimmen.
AND — teilt nach Leerzeichen auf und gibt nur Objekte zurück, die mit allen Wörtern übereinstimmen.
EXACT — verwendet die vollständige Zeichenfolge unverändert und gibt Objekte zurück, deren Name oder Anzeigename eine exakte Übereinstimmung ist.

Warehouse-Erkundung

`list_databases`

schreibgeschützt

Listet alle im verbundenen Data Warehouse verfügbaren Datenbanken auf.

`list_schemas`

schreibgeschützt

Listet alle Schemas in einer bestimmten Datenbank im verbundenen Data Warehouse auf.

Der Datenbankname.

`list_tables`

schreibgeschützt

Listet Tabellen/Ansichten in einer bestimmten Datenbank und einem bestimmten Schema im verbundenen Data Warehouse auf.

Der Datenbankname. Der Schemaname.

`get_table_info`

schreibgeschützt

Ruft detaillierte Informationen zu einer Warehouse-Tabelle/-Ansicht ab, einschließlich ihrer Spalten und Metadaten.

Der Datenbankname. Der Schemaname. Der Tabellenname.

Semantisches Modell

`import_tables`

Importiert Tabellen aus dem verbundenen Data Warehouse in das semantische Modell. Jede Tabelle wird zu einer Entität mit ihren Spalten als Attribute.

Liste vollqualifizierter Tabellennamen im Format `database.schema.table`.

`create_entity`

Erstellt eine neue Entität im semantischen Modell aus YAML-Definitionen.

Die YAML-Definition für die Entität. Die YAML-Definition für das Dataset.

`create_object`

Erstellt ein neues semantisches Modellobjekt aus einer YAML-Definition. Unterstützte Typen: Attribut, Metrik, dynamisches Dataset, Domäne und globaler Parameter.

Die YAML-Definition des Objekts. Erstellt das Objekt, auch wenn die Validierung Fehler ergibt.

`update_object`

Aktualisiert ein bestehendes semantisches Modellobjekt aus einer YAML-Definition. Unterstützte Typen: Entität, Attribut, Metrik, Dataset, dynamisches Dataset, Domäne und globaler Parameter.

Die YAML-Definition des Objekts. Der Schlüssel des zu aktualisierenden Objekts. Aktualisiert das Objekt, auch wenn die Validierung Fehler ergibt.

`validate_object`

schreibgeschützt

Validiert eine YAML-Definition eines semantischen Modellobjekts, ohne es zu erstellen oder zu aktualisieren. Unterstützte Typen: Entität, Attribut, Metrik, Dataset, dynamisches Dataset, Domäne und globaler Parameter.

Die zu validierende YAML-Definition. Der Schlüssel des Objekts, gegen das validiert werden soll.

`delete_object`

Löscht ein semantisches Modellobjekt anhand seines Schlüssels.

Der Schlüssel des zu löschenden Objekts. Löscht das Objekt, auch wenn die Validierung Fehler ergibt.

Agenten

`list_agents`

schreibgeschützt

Listet alle Agenten mit ihren Namen, Beschreibungen, Domänen und Kontextreferenzen auf.

`get_agent`

schreibgeschützt

Ruft detaillierte Informationen zu einem Agenten ab, einschließlich seiner YAML-Frontmatter-Definition.

Name des abzurufenden Agenten.

`create_agent`

Erstellt einen neuen Agenten.

Metadaten für den neuen Agenten. Hierarchischer Name (z. B. `growth-analyst`, `finance/budget-analyst`).

<ParamField body="display_name" type="string" required>
  In der Benutzeroberfläche angezeigter, lesbarer Name.
</ParamField>

<ParamField body="description" type="string" required>
  Beschreibung des Zwecks und der Fähigkeiten des Agenten.
</ParamField>

<ParamField body="domain" type="string" required>
  Die Domäne, in der dieser Agent arbeitet.
</ParamField>

<ParamField body="welcome_message" type="string">
  Einführungsnachricht, die angezeigt wird, wenn ein Benutzer eine Sitzung startet.
</ParamField>

<ParamField body="sample_questions" type="string[]">
  Beispielfragen, die Benutzern angezeigt werden.
</ParamField>

<ParamField body="context" type="string[]">
  Kontextelementnamen oder Glob-Muster, die in Sitzungen geladen werden sollen
  (z. B. `skills/**`, `knowledge/marketing/**`).
</ParamField>

<ParamField body="owner" type="string">
  Besitzerkennung für den Agenten.
</ParamField>

Markdown-Text, der nach dem Frontmatter angehängt wird. Dieser Text wird vor jeder Analysesitzung in den Prompt eingefügt. Erstellt den Agenten, auch wenn die Validierung Fehler ergibt.

`update_agent`

Aktualisiert einen bestehenden Agenten.

Name des zu aktualisierenden Agenten. Vollständige aktualisierte Agentendefinition. Alle erforderlichen Felder von `create_agent` müssen angegeben werden — dies ist ein vollständiger Ersatz, keine teilweise Aktualisierung. Aktualisierter Markdown-Text für den Agenten. Aktualisiert den Agenten, auch wenn die Validierung Fehler ergibt.

`delete_agent`

Löscht einen Agenten anhand des Namens.

Name des zu löschenden Agenten.

Kontextelemente

`list_context_items`

schreibgeschützt

Listet alle Kontextelemente mit ihren Typen, Namen, Titeln und Subtyp-Werten auf.

`get_context_item`

schreibgeschützt

Ruft ein Kontextelement anhand des Namens ab.

Name des abzurufenden Kontextelements.

`create_context_item`

Erstellt ein neues Kontextelement. Unterstützt Anweisungs- und Speichertypen.

Metadaten für das neue Kontextelement. Muss `instruction` sein.

<ParamField body="name" type="string" required>
  Hierarchischer Name
  (z. B. `knowledge/customer/churn-analysis`, `skills/reporting`).
</ParamField>

<ParamField body="subtype" type="string" required>
  Einer von `knowledge`, `skill` oder `instruction`.
</ParamField>

<ParamField body="title" type="string" required>
  Lesbarer Titel für das Kontextelement.
</ParamField>

<ParamField body="apply" type="string" required>
  Wann der Kontext angewendet werden soll: `always` oder `on_demand`.
</ParamField>

<ParamField body="description" type="string">
  Beschreibung, die von der KI verwendet wird, um zu entscheiden, wann dieses Element geladen werden soll
  (erforderlich, wenn `apply` `on_demand` ist).
</ParamField>

<ParamField body="owner" type="string">
  Besitzerkennung.
</ParamField>

<ParamField body="labels" type="string[]">
  Labels zum Organisieren von Kontextelementen.
</ParamField>

<ParamField body="related_objects" type="object[]">
  Semantische Objekte, auf die sich dieses Kontextelement bezieht.
  Jedes Objekt hat einen `name` (String) und `type` (`domain`, `entity` oder `field`).
</ParamField>

<ParamField body="external_source" type="object">
  Externe Quelle, von der Inhalte abgerufen werden sollen (für den Subtyp `knowledge`).
  Hat `tool` (MCP-Toolname), `resource_id` (Kennung im externen Tool)
  und optional `cache_max_age_in_seconds` (Standard: `3600`).
</ParamField>

Muss `memory` sein.

<ParamField body="name" type="string" required>
  Hierarchischer Name (z. B. `events/q4-launch`, `2024/pricing-decision`).
</ParamField>

<ParamField body="subtype" type="string" required>
  Einer von `event` oder `decision_trace`.
</ParamField>

<ParamField body="title" type="string" required>
  Lesbarer Titel für das Kontextelement.
</ParamField>

<ParamField body="apply" type="string" required>
  Wann der Kontext angewendet werden soll: `always` oder `on_demand`.
</ParamField>

<ParamField body="from_date" type="string" required>
  Startdatum des Speicherzeitraums im ISO-Format (z. B. `2024-01-01`).
</ParamField>

<ParamField body="to_date" type="string">
  Enddatum des Speicherzeitraums im ISO-Format.
</ParamField>

<ParamField body="description" type="string">
  Beschreibung, die von der KI verwendet wird, um zu entscheiden, wann dieses Element geladen werden soll
  (erforderlich, wenn `apply` `on_demand` ist).
</ParamField>

<ParamField body="owner" type="string">
  Besitzerkennung.
</ParamField>

<ParamField body="labels" type="string[]">
  Labels zum Organisieren von Kontextelementen.
</ParamField>

<ParamField body="related_objects" type="object[]">
  Semantische Objekte, auf die sich dieses Kontextelement bezieht.
  Jedes Objekt hat einen `name` (String) und `type` (`domain`, `entity` oder `field`).
</ParamField>

<ParamField body="external_source" type="object">
  Externe Quelle, von der Inhalte abgerufen werden sollen.
  Hat `tool` (MCP-Toolname), `resource_id` (Kennung im externen Tool)
  und optional `cache_max_age_in_seconds` (Standard: `3600`).
</ParamField>

Markdown-Text für den Inhalt des Kontextelements. Erstellt das Kontextelement, auch wenn die Validierung Fehler ergibt.

`update_context_item`

Aktualisiert ein bestehendes Kontextelement.

Name des zu aktualisierenden Kontextelements. Vollständige aktualisierte Kontextelementdefinition. Alle erforderlichen Felder von `create_context_item` müssen angegeben werden — dies ist ein vollständiger Ersatz, keine teilweise Aktualisierung. Aktualisierter Markdown-Text für das Kontextelement. Aktualisiert das Kontextelement, auch wenn die Validierung Fehler ergibt.

`delete_context_item`

Löscht ein Kontextelement anhand des Namens.

Name des zu löschenden Kontextelements.

Abfrage & Vorschau

`get_sql_from_fields`

schreibgeschützt

Generiert die SQL-Abfrage für eine durch Attribute, Metriken und Filter definierte semantische Layer-Abfrage. Gibt das SQL zurück, ohne es auszuführen.

Vollqualifizierte Attributnamen (`entity.attribute_name`). Unterstützt Aliase: `entity.attribute_name as alias_name`. Vollqualifizierte Metriknamen (`entity.metric_name`) oder SQL-Ausdrücke (z. B. `SUM(entity.field)`). Unterstützt Aliase: `SUM(entity.field) as total`. Filterbedingungen (z. B. `entity.field = 'value'`, `entity.date_field > '2024-01-01'`). Liste der Felder, nach denen sortiert werden soll. Format: `entity.field_name` oder `entity.field_name DESC`. Standard-Sortierrichtung ist ASC. Bei Verwendung von Aliasen nach dem Aliasnamen sortieren. Die Domäne, gegen die abgefragt werden soll. Maximale Anzahl der zurückzugebenden Zeilen. Anzahl der zu überspringenden Zeilen für die Paginierung.

`get_data_from_fields`

read-only

Führt eine Semantic-Layer-Abfrage aus, die durch Attribute, Metriken und Filter definiert ist, und gibt die resultierenden Daten zurück.

`list_query_history`

read-only

Listet zuvor über den Honeydew Semantic Layer ausgeführte Abfragen auf, die neuesten zuerst. Verwenden Sie dies, um fehlgeschlagene Abfragen zu finden und zu untersuchen und zu verstehen, warum sie fehlgeschlagen sind. Nicht-Admin-Aufrufer sehen nur ihre eigenen Abfragen.

Jede Abfrage enthält ihren Status, die Fehlermeldung, den Besitzer, den Client, die Domäne, das ursprüngliche Eingabe-SQL (das vom Benutzer übermittelte SQL für SQL-Schnittstellenabfragen), Zeitstempel für die Kompilierung und die Data-Warehouse-Ausführung, die Data-Warehouse- Abfrage-ID und einen Link, um sie in der Honeydew-App zu öffnen.

Nach Abfragestatus filtern (`FAILED`, `SUCCESS`, `RUNNING` oder `CANCELED`). Nach dem Client filtern, der die Abfrage ausgeführt hat (z. B. `Snowflake`, `MCP`). Nach Domänennamen filtern. Nach Abfragebesitzer filtern (E-Mail eines Benutzers oder Name eines API-Schlüssels). Wird nur für Admin-Aufrufer berücksichtigt; Nicht-Admins sind auf ihre eigenen Abfragen beschränkt. Nur Abfragen, die zu oder nach diesem Zeitpunkt ausgeführt wurden (ISO 8601). Nur Abfragen, die zu oder vor diesem Zeitpunkt ausgeführt wurden (ISO 8601). Auch die semantische YAML-Definition jeder Abfrage zurückgeben (Attribute, Metriken, Filter). Aktivieren, um eine Abfrage zu reproduzieren oder zu ändern. Auch das kompilierte Warehouse-SQL jeder Abfrage zurückgeben (groß). Aktivieren für warehouse-seitiges Debugging einer bestimmten Abfrage. Maximale Anzahl der zurückzugebenden Abfragen. Anzahl der zu überspringenden Abfragen für die Paginierung.

Dokumentation

`search_docs`

read-only

Durchsucht die Honeydew-Dokumentations-Wissensdatenbank nach relevanten Informationen, Codebeispielen, API-Referenzen und Anleitungen. Gibt kontextbezogene Inhalte mit Titeln und Links zu den Dokumentationsseiten zurück. Um den vollständigen Inhalt einer Seite zu lesen, verwenden Sie query_docs_filesystem.

Die Suchanfrage.

`query_docs_filesystem`

read-only

Führt einen schreibgeschützten, shell-ähnlichen Befehl gegen ein virtualisiertes In-Memory- Dateisystem aus, das die Honeydew-Dokumentationsseiten und OpenAPI-Spezifikationen enthält. Unterstützt Befehle wie rg, grep, find, tree, ls, cat, head und tail. Verwenden Sie dies für exakten Keyword- oder Regex-Abgleich, strukturelle Erkundung oder das Lesen des vollständigen Inhalts einer bestimmten Seite anhand des Pfads.

Der auszuführende Shell-Befehl (z. B. `rg -il "keyword" /`, `tree / -L 2`, `head -80 /path/page.mdx`).