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 ansehenDieses MCP ausprobierenGesponsert

Was kann man mit Honeydew Semantic Layer MCP machen?

Warehouse-Metadaten erkunden — Bitten Sie Ihren Assistenten, Tabellen, Schemas und semantische Modelldefinitionen in Ihrem Warehouse zu entdecken.
Semantische Modelle verwalten — Erstellen und pflegen Sie Ihr semantisches Modell durch natürliche Konversation, einschließlich der Erstellung von Workspace-Branches mit create_workspace_branch.
Daten konversationell abfragen — Verwenden Sie natürliche Sprache, um Ihre Daten über jeden MCP-kompatiblen Assistenten abzufragen.
Sitzungskontext konfigurieren — Legen Sie Ihren aktiven Workspace und Branch mit set_session_workspace_and_branch fest, nachdem Sie verfügbare Optionen mit list_workspaces und list_workspace_branches aufgelistet haben.
Auf Honeydew-Dokumentation zugreifen — Durchsuchen und lesen Sie die Honeydew-Dokumentation direkt über die integrierten Dokumentationswerkzeuge des MCP-Servers.

Dokumentation

MCP-Server

Was ist MCP?

Model Context Protocol (MCP) ist ein Open-Source-Standard für die sichere Verbindung von KI-Anwendungen mit externen Systemen und Tools. Honeydew stellt einen MCP-Server bereit, der Ihren KI-Codierungsassistenten mit der Honeydew Semantic Layer verbindet.

Wann verwenden

Entdecken und erkunden Sie Ihre Warehouse-Tabellen, Schemas und semantischen Modelldefinitionen
Erstellen und pflegen Sie Ihr semantisches Modell durch natürliche Konversation
Fragen Sie Ihre Daten mit 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 bereit unter https://mcp.honeydew.cloud/mcp

Hinweis

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

Authentifizierung

Es gibt zwei Möglichkeiten, sich zu authentifizieren mit dem Honeydew MCP-Server: OAuth oder HTTP-Basisauthentifizierung.

OAuth-Authentifizierung (empfohlen)

Die meisten Clients unterstützen die OAuth-Authentifizierung. Beim ersten Verbinden werden Sie aufgefordert:

Melden Sie sich mit Ihrem Honeydew-Konto an
Akzeptieren Sie die OAuth-Autorisierung

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

HTTP-Basisauthentifizierung

Der MCP-Server im HTTP-Basisauthentifizierungsmodus erfordert einen API-Schlüssel für die Authentifizierung.

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

Tipp

Wenn Sie einen neuen API-Schlüssel für den MCP-Serverzugriff erstellen, können Sie die Base64-kodierte Zeichenfolge aus der Honeydew Studio-Benutzeroberfläche zum Zeitpunkt der Erstellung 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>"
  )
)
```

Stellen Sie die kodierte Zeichenfolge im Authorization-Header wie folgt bereit:

Authorization: Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET>

Konfiguration

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

Sie können optional diese Header in Ihrer MCP-Serverkonfiguration bereitstellen:

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

Hinweis

Der MCP-Server verwendet den Mcp-Session-Id-Antwortheader, um den Sitzungsstatus zu verwalten, einschließlich des aktiven Arbeitsbereichs und Branches. Siehe die MCP-Sitzungsverwaltungsspezifikation für Details.

Unterstützte Clients

Claude Code CLI

#### Plugin-Installation

Hinweis

Erfordert Git. Die Installation des Plugins von GitHub klont das Repository lokal, daher muss Git installiert und auf Ihrem PATH 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 anstelle des Plugins.

Honeydew stellt ein Plugins-Repository mit Fähigkeiten 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 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 aus dem 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 Auswahlfeld oben
Wählen Sie honeydew-ai-coding-agents-plugins
Klicken Sie auf Marktplatz aktualisieren

Um Updates automatisch zu erhalten, wählen Sie Auto-Update aktivieren in den Marktplatz-Einstellungen.

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 mithilfe der folgenden Anweisungen hinzu.

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

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

Hinweis

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

```bash theme={null} claude mcp add --transport http honeydew \ 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">
      ```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 in `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>

Tipp

Verwenden von Umgebungsvariablen für die API-Schlüssel-Authentifizierung

Um zu vermeiden, sensible Werte direkt in Konfigurationsdateien zu speichern, unterstützt Claude Code Umgebungsvariablen-Erweiterung mithilfe der ${VAR_NAME}-Syntax.

Setzen Sie die HONEYDEW_API_KEY-Umgebungsvariable, und referenzieren Sie sie dann in Ihrer Konfiguration:
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-Dokumentations-MCP (optional)

Der Honeydew-MCP-Server enthält bereits Dokumentationszugriffstools, daher ist ein separater Dokumentationsserver nicht erforderlich. Fügen Sie das Honeydew-Dokumentations-MCP nur hinzu, wenn Sie Dokumentationszugriff wünschen ohne Verbindung zu Honeydew. Keine Authentifizierung erforderlich.

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

Entfernen des MCP-Servers

Um den Honeydew-MCP-Server zu entfernen:

claude mcp remove honeydew

Um den Honeydew-Dokumentations-MCP-Server zu entfernen:

claude mcp remove honeydew-docs

Claude Desktop

#### Plugin-Installation

Hinweis

Erfordert Git. Die Installation des Plugins von GitHub klont das Repository lokal, daher muss Git installiert und auf Ihrem PATH 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 anstelle des Plugins.

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, Datenabfrage, Modellverwaltung, und Dokumentationszugriff.

Claude-Code-Modus

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

Hinweis

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

Um das Honeydew-MCP im Cowork-Modus hinzuzufügen:

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

Sie werden aufgefordert, sich beim ersten Verbinden mit OAuth bei Honeydew zu authentifizieren.

Honeydew-Dokumentations-MCP (optional)

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

Entfernen des MCP-Servers

Um den Honeydew-MCP-Server im Cowork-Modus zu entfernen:

Gehen Sie zu Einstellungen -> Connectors
Finden Sie den honeydew-Connector und klicken Sie auf das Löschsymbol

Um den Honeydew-Dokumentations-MCP-Server zu entfernen:

Gehen Sie zu Einstellungen -> Connectors
Finden Sie den honeydew-docs-Connector 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-Connector und fügen Sie dann Ihren benutzerdefinierten Endpunkt mithilfe der folgenden Anweisungen hinzu.

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

Hinweis

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

Um den Honeydew-MCP-Server hinzuzufügen:

Gehen Sie zu Einstellungen -> Connectors -> Benutzerdefinierten Connector 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

Beim ersten Verbinden werden Sie aufgefordert, sich mit OAuth bei Honeydew zu authentifizieren.

Honeydew Documentation MCP (optional)

Der Honeydew-MCP-Server enthält bereits Tools für den Dokumentationszugriff, daher ist ein separater Dokumentationsserver nicht erforderlich. Fügen Sie den Honeydew Documentation MCP nur hinzu, wenn Sie Dokumentationszugriff ohne Verbindung zu Honeydew wünschen. Eine Authentifizierung ist nicht erforderlich.

Gehen Sie zu Einstellungen -> Connectors -> Benutzerdefinierten Connector 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 -> Connectors
Suchen Sie den Connector honeydew und klicken Sie auf das Löschsymbol

So entfernen Sie den Honeydew Documentation MCP-Server:

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

Cortex Code CLI

#### Plugin-Installation

Hinweis

Erfordert Git. Die Installation des Plugins aus GitHub klont das Repository lokal, daher muss Git installiert und in Ihrem PATH vorhanden 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 stellt ein Plugins-Repository mit Fähigkeiten und Tools zum Erstellen semantischer Modelle und zur Datenanalyse durch natürliche Konversation bereit. Die Installation des Plugins richtet die Honeydew-MCP-Server automatisch ein.

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

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

MCP-Einrichtung

Verwenden Sie diesen Abschnitt, wenn Ihre Organisation einen benutzerdefinierten Honeydew-Endpunkt verwendet, oder wenn Sie die MCP-Server 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 mithilfe der folgenden Anweisungen hinzu.

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

Hinweis

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

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

      Starten Sie die 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 in `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 die 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 die 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)

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

#### Plugin-Installation

Hinweis

Erfordert Git. Die Installation des Plugins aus GitHub klont das Repository lokal, daher muss Git installiert und in Ihrem PATH vorhanden 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.

Gehen Sie zu Einstellungen -> Plugins
Klicken Sie auf Plugin hinzufügen, wählen Sie Aus 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 in GitHub Plugin Installer Setup

MCP-Einrichtung

Der Honeydew-MCP-Server verbindet Cortex Code Desktop mit der 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.

Hinweis

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

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

      Sie werden aufgefordert, sich beim ersten Verbinden
      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"
        }
      }
      ```

      Sie werden aufgefordert, sich beim ersten Verbinden
      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 Tools für den Dokumentationszugriff, daher ist ein separater Dokumentationsserver nicht erforderlich. Wenn Sie Dokumentationszugriff ohne Verbindung zu Honeydew wünschen, fügen Sie den Honeydew Documentation MCP-Server auf dieselbe Weise hinzu, mit Servername honeydew-docs, Servertyp Remote (HTTP) und Server-URL https://honeydew.ai/docs/mcp. Eine Authentifizierung ist nicht erforderlich.

Entfernen des MCP-Servers

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

Cursor

#### Plugin-Installation

Gehen Sie in Ihren Team- oder Organisations-Einstellungen zu cursor.com/dashboard/plugins (oder klicken Sie im linken Menü 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 innerhalb des Marketplaces auf Plugin hinzufügen, fügen Sie den Pfad des Honeydew-Plugin-GitHub-Repositorys ein: https://github.com/honeydew-ai/honeydew-ai-coding-agents-plugins und klicken Sie auf 1 Plugin hinzufügen
Aktivieren Sie optional Auto-Refresh 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 der Honeydew Semantic Layer für Modell-Exploration, Datenabfragen, Modellverwaltung und Dokumentationszugriff.

Hinweis

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

So fügen Sie den Honeydew MCP hinzu:

Öffnen Sie die Cursor-Anwendung
Gehen Sie zu Einstellungen -> Cursor-Einstellungen -> Tools & MCP
Klicken Sie auf Neuen 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)

Gehen Sie zu Einstellungen -> Cursor-Einstellungen -> Tools & MCP
Klicken Sie auf Neuen 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

> **Hinweis** > > 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 **Auth-Typ** auf **Dynamische Client-Registrierung** * Klicken Sie auf **Weiter** 3. Auf dem Bildschirm **Authentifizierung**: * Setzen Sie **Host** auf `https://mcp.honeydew.cloud` * Lassen Sie **Port** auf `443` * Setzen Sie **OAuth-Bereich** auf `openid` * Klicken Sie auf **Weiter** 4. Auf dem Bildschirm **Verbindungsdetails**: * Aktivieren Sie **Ist MCP-Verbindung** * Setzen Sie **Basis-Pfad** 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>
  </Tabs>

Hinweis

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

<Step title="Log in to the connection">
  Navigieren Sie zu **Katalog** → **Verbindungen** → `honeydew-mcp`
  und klicken Sie in der oberen rechten Ecke auf **Anmelden**,
  um sich zu authentifizieren und die Verbindung zu überprüfen.
</Step>

<Step title="Grant connection access">
  Gewähren Sie das `USE CONNECTION`-Privileg allen Benutzern oder Rollen,
  die Zugriff auf den Honeydew-MCP-Server benötigen:

  ```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. Ö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 `honeydew-mcp`-Verbindung, die Sie erstellt haben
  5. Melden Sie sich bei Aufforderung bei der Verbindung an
  6. Klicken Sie auf **Speichern**

Hinweis

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.

Hinweis

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

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 im 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 im 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 Tools auflisten testen, um die Verbindung zu überprüfen

Honeydew-Dokumentations-MCP (optional)

Der Honeydew-MCP-Server enthält bereits Dokumentationszugriffstools, daher ist ein separater Dokumentationsserver nicht erforderlich. Fügen Sie das Honeydew-Dokumentations-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 im Feld Servername ein
Wählen Sie HTTP als Transporttyp
Geben Sie https://honeydew.ai/docs/mcp im 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 honeydew-Server und entfernen Sie ihn

So entfernen Sie den Honeydew-Dokumentations-MCP-Server:

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

GitHub Copilot CLI

#### MCP-Server

Hinweis

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

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, um zu speichern

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

KI-Codierungs-Agent-Plugins

Hinweis

Erfordert Git. Die Installation des Plugins von GitHub klont das Repository lokal, daher muss Git installiert und auf Ihrem PATH 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 stellt ein Plugins-Repository mit Fähigkeiten und Tools zum Erstellen semantischer Modelle und zur Datenanalyse durch natürliche Konversation bereit.

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 aus dem Marktplatz:

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

Honeydew-Dokumentations-MCP (optional)

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

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, um zu 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-Dokumentations-MCP-Server zu entfernen:

/mcp remove honeydew-docs

Gemini CLI

#### Erweiterungsinstallation

Hinweis

Erfordert Git. Die Installation des Plugins von GitHub klont das Repository lokal, daher muss Git installiert und auf Ihrem PATH 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 stellt ein Plugins-Repository mit Fähigkeiten und Tools zum Erstellen semantischer Modelle und zur Datenanalyse durch natürliche Konversation bereit. 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 --auto-update-Flag hält die Erweiterung automatisch aktuell.

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.

Hinweis

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

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-Dokumentations-MCP (optional)

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

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-Dokumentations-MCP-Server:

gemini mcp remove honeydew-docs

VS Code und GitHub Copilot

#### Plugin-Installation

Honeydew-Marktplatz hinzufügen

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

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

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

Plugin installieren

Öffnen Sie die Erweiterungsansicht (CMD+Shift+X auf macOS oder Ctrl+Shift+X auf 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 aus 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 Erweiterungsupdates suchen aus.

MCP-Server

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

Hinweis

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

Öffnen Sie die Befehlspalette mit CMD+Shift+P (macOS) oder Ctrl+Shift+P (Windows/Linux)
Wählen Sie MCP: Server hinzufügen...
Wählen Sie HTTP (HTTP oder Server-Sent Events)
Geben Sie die Honeydew-MCP-Server-URL ein: https://mcp.honeydew.cloud/mcp
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, daher ist ein separater Dokumentationsserver nicht erforderlich. 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 .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

#### Plugin-Installation

Hinweis

Erfordert Git. Die Installation des Plugins von GitHub klont das Repository lokal, daher muss Git installiert und in Ihrer 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 statt über das Plugin zu konfigurieren.

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.

Aktualisieren von Plugins

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

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

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

MCP-Einrichtung

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

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

Hinweis

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

Befehlszeile

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

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

Öffnen Sie nach dem Hinzufügen des Servers die Konfigurationsdatei unter ~/.codex/config.toml und fügen Sie bei Bedarf Header zum [mcp_servers.honeydew]-Abschnitt 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

Um den Honeydew MCP-Server zu entfernen:

codex mcp remove honeydew

Um den Honeydew Documentation MCP-Server zu entfernen:

codex mcp remove honeydew-docs

Codex

#### Plugin-Installation

Hinweis

Erfordert Git. Die Installation des Plugins von GitHub klont das Repository lokal, daher muss Git installiert und in Ihrer 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 statt über das Plugin zu konfigurieren.

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

Hinweis

Sie können den Marketplace auch über die 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 Marketplace Honeydew AI aus
Installieren Sie das Plugin Honeydew

MCP-Einrichtung

Hinweis

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

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 Umgebungsvariable für Bearer-Token leer
Konfigurieren Sie die Authentifizierung wie folgt:

OAuth-Authentifizierung

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

HTTP-Basisauthentifizierung

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

Um den Honeydew MCP-Server zu entfernen:

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

Um den Honeydew Documentation MCP-Server zu entfernen:

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

Antigravity

#### MCP-Server

Hinweis

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

Öffnen Sie den Antigravity-Editor
Klicken Sie auf das ...-Dropdown oben im Agent-Panel
Klicken Sie auf MCP-Server verwalten
Klicken Sie auf Rohe Konfiguration 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 Rohe Konfiguration 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

Um den Honeydew MCP-Server zu entfernen:

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

OpenCode

#### MCP-Server

Hinweis

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

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

      Dadurch wird ein Browserfenster geöffnet, 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 zuerst Ihren Status und melden Sie sich 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, daher gelten die folgenden Schritte für beide.

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.

Hinweis

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

Fügen Sie den Honeydew MCP-Server zu einer dieser mcp.json-Dateien hinzu (Arbeitsbereich 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>

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

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

Honeydew Documentation MCP (optional)

Der Honeydew-MCP-Server enthält bereits Tools für den Dokumentationszugriff, daher ist ein separater Dokumentationsserver nicht erforderlich. Fügen Sie den Honeydew Documentation MCP nur hinzu, wenn Sie Dokumentationszugriff wünschen, ohne eine Verbindung zu Honeydew herzustellen. 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-Connectors](https://docs.snowflake.com/en/user-guide/snowflake-cortex/cortex-agents-mcp-connectors) mit externen MCP-Servern, wodurch Honeydew-Tools für Snowflake Intelligence und Cortex Agents verfügbar werden.

Voraussetzungen:

Eine Rolle mit der CREATE INTEGRATION-Berechtigung auf dem Konto
Eine Rolle mit der CREATE MCP SERVER-Berechtigung auf dem Ziel-Schema

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

Hinweis

Wenn Ihre Organisation einen benutzerdefinierten Honeydew-Hostnamen verwendet, ersetzen Sie https://mcp.honeydew.cloud/mcp durch Ihren Mandanten-Hostnamen. Sie finden den Hostnamen unter 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 die Nutzung sowohl der Integration als auch des MCP-Servers
  allen 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 aufgefordert, sich per OAuth bei Honeydew zu authentifizieren.
</Step>

Hinweis

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 Dokumentations-Tools 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 über den standardmäßigen HTTP-Transport eine Verbindung zum Honeydew MCP Server herstellen.

Verwenden Sie die folgende JSON-Konfiguration als Ausgangspunkt:

Hinweis

Wenn Ihre Organisation einen benutzerdefinierten Honeydew-Hostnamen verwendet, ersetzen Sie https://mcp.honeydew.cloud/mcp durch Ihren Mandanten-Hostnamen. Sie finden den Hostnamen unter 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 " } } ```

Weitere Informationen zu den einzelnen Parametern finden Sie unter Server-URL, Authentifizierung und Konfiguration.

Beispielverwendung

Nach der Verbindung können Sie Ihrem KI-Assistenten Fragen stellen wie:

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

Fehlerbehebung

OAuth-Authentifizierungsprobleme

Stellen Sie sicher, dass Ihr Client OAuth unterstützt, vergewissern Sie sich, dass Sie über die erforderlichen Honeydew-Workspace-Berechtigungen verfügen, und versuchen Sie, die Authentifizierung über die MCP-Verwaltungsoberfläche Ihres Clients erneut durchzuführen.

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-Aufforderungen im Browser, um sich erneut mit Honeydew zu verbinden.

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, prüfen Sie, ob die URL mit Ihrem Mandanten-Hostnamen übereinstimmt, der unter Einstellungen > MCP-Server in Honeydew Studio angezeigt wird.

Fehlende Tools

Stellen Sie sicher, dass die Authentifizierung erfolgreich war, prüfen Sie Ihre Zugriffsberechtigungen für den Honeydew-Workspace, und überprüfen Sie die Konsole Ihres Clients auf Fehlermeldungen.

Ausgabe überschreitet maximal zulässige Token (Claude)

In Claude Code, Claude Desktop und Claude.ai kann ein Tool-Aufruf mit einem Fehler fehlschlagen, dass die Ausgabe die maximal zulässigen Token überschreitet. Honeydew-Analyse-Tools 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 Token überschreitet, und lehnt Ausgaben über dem Standardlimit von 25.000 Token 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

Weitere Informationen finden Sie unter MCP-Ausgabelimits und Warnungen in der Claude-Dokumentation.

Für zusätzlichen Support kontaktieren Sie den Honeydew-Support unter support@honeydew.ai.

Verfügbare Tools

Tools, die als schreibgeschützt markiert sind, ändern weder das semantische Modell noch das Data Warehouse.

Tipp

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 zurück (snowflake, databricks oder bigquery). Verwenden Sie den Data-Warehouse-Typ, um die Implementierung des semantischen Modells zu informieren.

`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 Workspace und Branch ab, die für die aktuelle Sitzung festgelegt sind.

`set_session_workspace_and_branch`

schreibgeschützt

Legt den Workspace und Branch fest, die für die aktuelle Sitzung verwendet werden sollen. 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 angeheftet ist, wechselt die Sitzung automatisch zum neuen Branch.

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

`delete_workspace_branch`

Löscht einen Branch aus einem Workspace. Dies ist eine destruktive, irreversible Operation. 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 nach Fortschritt und Ergebnissen zu fragen, und abort_analysis, um sie vorzeitig zu stoppen. Weitere Details finden Sie unter Deep Analysis.

Die natürlichsprachliche Frage, die gestellt werden soll. Agentenname für eine neue Konversation. Für Folgefragen weglassen — der Agent wird von der bestehenden Konversation übernommen. Bestehende Konversations-ID zum Fortsetzen, oder weglassen, um eine neue Konversation zu starten.

`monitor_analysis`

schreibgeschützt

Fragt nach neuen Fortschrittsmeldungen von einer laufenden Analyse. Jeder Aufruf gibt nur Meldungen seit dem letzten Aufruf zurück. Fragen Sie wiederholt ab, bis status DONE oder NO_CHAT_CURRENTLY_RUNNING ist.

Konversations-ID, die von `initiate_analysis` zurückgegeben wurde. Maximale Anzahl der pro Aufruf zurückzugebenden Meldungen. Meldungs-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.

Konversations-ID, die von `initiate_analysis` zurückgegeben wurde. Schritt-ID von `monitor_analysis` (z. B. `STEP/0`).

`abort_analysis`

schreibgeschützt

Bricht eine laufende Analyse ab. Kann mit initiate_analysis ab dem abgebrochenen Punkt fortgesetzt werden.

Konversations-ID, die von `initiate_analysis` zurückgegeben wurde.

`list_analysis_chats`

schreibgeschützt

Gibt eine paginierte Liste der Analysekonversationen 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, das Benutzerfeedback, die Domäne, den Agenten, die 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`

Legt Feedback für eine bestimmte Analysekonversation fest oder löscht es. Es gibt einen einzelnen Feedback-Eintrag pro Konversation (nicht pro Frage) — er sollte die Gesamtqualität des gesamten Konversationsablaufs widerspiegeln.

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

Konversations-ID der Analysekonversation. Feedback-Text zum Speichern oder `null`, um vorhandenes Feedback zu löschen.

`get_stored_conversation`

schreibgeschützt

Gibt alle Meldungen aus einer vorhandenen Analysekonversation zurück. Verwenden Sie dies, um den vollständigen Inhalt einer früheren 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-/Interpretationsmeldungen 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, Datensätze, 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 Felds.

`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, Datensätzen, dynamischen Datensätzen, Domänen und globalen Parametern, die einer Suchanfrage entsprechen.

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

Die Suchanfragezeichenfolge. Steuert, wie die Abfrage abgeglichen wird:

OR — teilt nach Leerzeichen auf, gibt Objekte zurück, die einem beliebigen Wort entsprechen.
AND — teilt nach Leerzeichen auf, gibt nur Objekte zurück, die allen Wörtern entsprechen.
EXACT — verwendet die vollständige Zeichenfolge unverändert, gibt Objekte zurück, deren Name, Anzeigename oder Bezeichnung exakt übereinstimmt.

Warehouse-Erkennung

`list_databases`

schreibgeschützt

Listet alle Datenbanken auf, die im verbundenen Data Warehouse verfügbar sind.

`list_schemas`

schreibgeschützt

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

Der Datenbankname.

`list_tables`

schreibgeschützt

Listet Tabellen/Sichten 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/-Sicht 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 Attributen.

Liste der vollständig qualifizierten 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 den Datensatz.

`create_object`

Erstellt ein neues Objekt des semantischen Modells aus einer YAML-Definition. Unterstützte Typen: berechnetes Attribut, Metrik, dynamischer Datensatz, Domäne und globaler Parameter.

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

`update_object`

Aktualisiert ein vorhandenes Objekt des semantischen Modells aus einer YAML-Definition. Unterstützte Typen: Entität, berechnetes Attribut, Metrik, Datensatz, dynamischer Datensatz, Domäne und globaler Parameter.

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

`validate_object`

schreibgeschützt

Validiert eine YAML-Definition eines Objekts des semantischen Modells, ohne es zu erstellen oder zu aktualisieren. Unterstützte Typen: Entität, berechnetes Attribut, Metrik, Datensatz, dynamischer Datensatz, 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 Objekt des semantischen Modells anhand seines Schlüssels.

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

Agents

`list_agents`

schreibgeschützt

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

`get_agent`

schreibgeschützt

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

Name des abzurufenden Agents.

`create_agent`

Erstellt einen neuen Agent.

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

<ParamField body="display_name" type="string" required>
  Menschenlesbarer Name, der in der Benutzeroberfläche angezeigt wird.
</ParamField>

<ParamField body="description" type="string" required>
  Beschreibung des Zwecks und der Fähigkeiten des Agents.
</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 Agent.
</ParamField>

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

`update_agent`

Aktualisiert einen vorhandenen Agent.

Name des zu aktualisierenden Agents. Vollständige aktualisierte Agent-Definition. Alle Pflichtfelder aus `create_agent` müssen angegeben werden — dies ist ein vollständiger Ersatz, keine teilweise Aktualisierung. Aktualisierter Markdown-Text für den Agent. Aktualisiert den Agent auch dann, wenn die Validierung Fehler erzeugt.

`delete_agent`

Löscht einen Agent anhand seines Namens.

Name des zu löschenden Agents.

Kontextelemente

`list_context_items`

schreibgeschützt

Listet alle Kontextelemente mit ihren Typen, Namen, Titeln und Untertypwerten auf.

`get_context_item`

schreibgeschützt

Ruft ein Kontextelement anhand seines Namens ab.

Name des abzurufenden Kontextelements.

`create_context_item`

Erstellt ein neues Kontextelement. Unterstützt die Typen Anweisung und Erinnerung.

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>
  Menschenlesbarer 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[]">
  Bezeichnungen zur Organisation von Kontextelementen.
</ParamField>

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

<ParamField body="external_source" type="object">
  Externe Quelle zum Abrufen von Inhalten (für den Untertyp `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>
  Menschenlesbarer 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 Erinnerungszeitraums im ISO-Format (z. B. `2024-01-01`).
</ParamField>

<ParamField body="to_date" type="string">
  Enddatum des Erinnerungszeitraums 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[]">
  Bezeichnungen zur Organisation von Kontextelementen.
</ParamField>

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

<ParamField body="external_source" type="object">
  Externe Quelle zum Abrufen von Inhalten.
  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 dann, wenn die Validierung Fehler erzeugt.

`update_context_item`

Aktualisiert ein vorhandenes Kontextelement.

Name des zu aktualisierenden Kontextelements. Vollständige aktualisierte Kontextelement-Definition. Alle Pflichtfelder aus `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 dann, wenn die Validierung Fehler erzeugt.

`delete_context_item`

Löscht ein Kontextelement anhand seines Namens.

Name des zu löschenden Kontextelements.

Abfrage & Vorschau

`get_sql_from_fields`

schreibgeschützt

Generiert die SQL-Abfrage für eine Abfrage der semantischen Ebene, die durch Attribute, Metriken und Filter definiert ist. Gibt das SQL zurück, ohne es auszuführen.

Vollständig qualifizierte Attributnamen (`entity.attribute_name`). Unterstützt Aliase: `entity.attribute_name as alias_name`. Vollständig qualifizierte 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`. Standardrichtung 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 für die Paginierung zu überspringenden Zeilen. Fügen Sie einen [Pre-Aggregationsbericht](/docs/performance/aggregate-awareness#debugging-aggregate-matching) am Anfang des zurückgegebenen SQL hinzu, der für jede Pre-Aggregation im Workspace angibt, welche CTE sie verwendet hat oder warum sie nicht verwendet werden konnte.

`get_data_from_fields`

schreibgeschützt

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

Vollständig qualifizierte Attributnamen (`entity.attribute_name`). Unterstützt Aliase: `entity.attribute_name as alias_name`. Vollständig qualifizierte 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`. Standardrichtung 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 Zeilen, die für die Paginierung übersprungen werden sollen.

`list_query_history`

schreibgeschützt

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

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

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 Abfrageeigentümer filtern (E-Mail eines Benutzers oder Name eines API-Schlüssels). Wird nur für Administrator-Aufrufer berücksichtigt; Nicht-Administratoren 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). Gibt auch die semantische YAML-Definition jeder Abfrage zurück (Attribute, Metriken, Filter). Aktivieren, um eine Abfrage zu reproduzieren oder zu ändern. Gibt auch das kompilierte Warehouse-SQL jeder Abfrage zurück (groß). Für Warehouse-seitiges Debugging einer bestimmten Abfrage aktivieren. Maximale Anzahl der zurückzugebenden Abfragen. Anzahl der Abfragen, die für die Paginierung übersprungen werden sollen.

Dokumentation

`search_docs`

schreibgeschützt

Durchsucht die Wissensdatenbank der Honeydew-Dokumentation 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`

schreibgeschützt

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 es für exaktes Schlüsselwort- oder Regex-Matching, strukturelle Erkundung oder zum Lesen des vollständigen Inhalts einer bestimmten Seite nach Pfad.

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

FAQ

Welche Tools werden für die Tiefenanalyse benötigt?

Die Ausführung der Tiefenanalyse erfordert:

Sitzungseinrichtung: list_workspaces, list_workspace_branches, get_session_workspace_and_branch, set_session_workspace_and_branch
Agentenauswahl: list_agents, get_agent
Analyse: initiate_analysis, monitor_analysis, get_analysis_step_details, abort_analysis
Feedback: provide_analysis_feedback

Um vergangene Analysekonversationen zu überprüfen, aktivieren Sie auch list_analysis_chats und get_stored_conversation.

Die Beschränkung des Agenten auf diese Tools ist nützlich, wenn:

Ihre vorgesehenen Benutzer nur Tiefenanalyse-Workflows ausführen
Sie den Agenten auf Analyseaufgaben fokussiert halten möchten
Ihr Client begrenzt, wie viele Tools aktiviert werden können (z. B. Databricks Genie Code)

Für andere Anwendungsfälle legen Sie mehr der unter Verfügbare Tools aufgeführten Tools offen – der Agent wählt das richtige Tool für jede Aufgabe aus.