Honeydew Semantic Layer

officiel

La couche sémantique Honeydew fournit un modèle de données gouverné et adapté aux métiers, qui unifie les métriques, les dimensions et les relations entre les sources, permettant une analyse en libre-service cohérente et un accès aux données alimenté par l'IA.

Voir sur honeydew.aiEssayer ce MCPSponsorisé

Que pouvez-vous faire avec Honeydew Semantic Layer MCP ?

Explorer les métadonnées de l’entrepôt — Demandez à votre assistant de découvrir les tables, schémas et définitions de modèles sémantiques dans votre entrepôt.
Gérer les modèles sémantiques — Créez et maintenez votre modèle sémantique par conversation naturelle, y compris la création de branches d’espace de travail avec create_workspace_branch.
Interroger les données de manière conversationnelle — Utilisez le langage naturel pour interroger vos données depuis n’importe quel assistant compatible MCP.
Configurer le contexte de session — Définissez votre espace de travail et votre branche actifs avec set_session_workspace_and_branch après avoir listé les options disponibles avec list_workspaces et list_workspace_branches.
Accéder à la documentation Honeydew — Recherchez et lisez la documentation Honeydew directement via les outils de documentation intégrés du serveur MCP.

Documentation

Serveur MCP

Qu'est-ce que MCP ?

Model Context Protocol (MCP) est une norme open-source pour connecter en toute sécurité les applications d'IA à des systèmes et outils externes. Honeydew fournit un serveur MCP qui connecte votre assistant de codage IA à la couche sémantique Honeydew.

Quand l'utiliser

Découvrir et explorer vos tables d'entrepôt, schémas et définitions de modèles sémantiques
Construire et maintenir votre modèle sémantique par conversation naturelle
Interroger vos données en langage naturel depuis n'importe quel assistant compatible MCP
Rechercher et lire la documentation Honeydew

Installation

URL du serveur

Honeydew expose l'API du serveur MCP à https://mcp.honeydew.cloud/mcp

Remarque

Si votre organisation utilise un nom d'hôte Honeydew personnalisé, remplacez l'URL par défaut par le nom d'hôte de votre locataire. Vous pouvez trouver le nom d'hôte dans l'interface Honeydew sous Paramètres > Serveur MCP.

Authentification

Il existe deux façons de s'authentifier auprès du serveur MCP Honeydew : OAuth ou authentification HTTP Basic.

Authentification OAuth (recommandée)

La plupart des clients prennent en charge l'authentification OAuth. Lors de la première connexion, vous serez invité à :

Vous connecter avec votre compte Honeydew
Accepter l'autorisation OAuth

Le client fournit ensuite de manière sécurisée un jeton d'accès pour les requêtes suivantes.

Authentification HTTP Basic

Le serveur MCP en mode authentification HTTP Basic nécessite une clé API pour l'authentification.

Vous devez fournir une chaîne encodée en Base64 de votre clé API et de votre secret API au format API_KEY:API_SECRET.

Astuce

Si vous créez une nouvelle clé API pour l'accès au serveur MCP, vous pouvez copier la chaîne encodée en Base64 depuis l'interface Honeydew Studio au moment de la création.

Vous pouvez utiliser la commande suivante pour générer la chaîne encodée en Base64 :

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

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

Fournissez la chaîne encodée dans l'en-tête Authorization comme suit :

Authorization: Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET>

Configuration

L'espace de travail et la branche sont définis au niveau de la session à l'aide des outils list_workspaces, list_workspace_branches et set_session_workspace_and_branch. Vous pouvez également créer de nouvelles branches avec create_workspace_branch. Appelez ces outils depuis votre assistant IA après vous être connecté au serveur MCP.

Vous pouvez éventuellement fournir ces en-têtes dans votre configuration de serveur MCP :

Workspace : Épingler l'espace de travail pour toutes les requêtes (optionnel)
Branch : Épingler une branche d'espace de travail spécifique pour toutes les requêtes (optionnel, par défaut prod si l'espace de travail est défini)
Honeydew-Client : Identifier le client MCP (optionnel, détecté automatiquement depuis l'outil connecté). Passez cet en-tête pour fournir un identifiant client spécifique.
ReadonlyToolsOnly : Définir sur true pour exposer uniquement les outils en lecture seule (optionnel)

Remarque

Le serveur MCP utilise l'en-tête de réponse Mcp-Session-Id pour maintenir l'état de la session, y compris l'espace de travail et la branche actifs. Voir la spécification de gestion de session MCP pour plus de détails.

Clients pris en charge

Claude Code CLI

#### Installation du plugin

Remarque

Nécessite Git. L'installation du plugin depuis GitHub clone le dépôt localement, donc Git doit être installé et sur votre PATH. Si Git est manquant, l'installation du plugin échoue. Installez Git, ou utilisez les étapes de configuration MCP manuelles de votre client pour configurer le serveur directement au lieu du plugin.

Honeydew fournit un dépôt de plugins avec des compétences et des outils pour construire des modèles sémantiques et analyser des données par conversation naturelle. L'installation du plugin configure automatiquement les serveurs MCP Honeydew.

Lancez Claude Code avec claude, puis ajoutez la place de marché :

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

Ensuite, installez le plugin Honeydew depuis la place de marché :

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

Puis rechargez les plugins pour activer :

/reload-plugins

Mise à jour des plugins

Pour mettre à jour les plugins de la place de marché Honeydew, lancez Claude Code avec claude, puis :

Écrivez /plugin et sélectionnez Places de marché dans le sélecteur en haut
Sélectionnez honeydew-ai-coding-agents-plugins
Cliquez sur Mettre à jour la place de marché

Pour recevoir les mises à jour automatiquement, sélectionnez Activer la mise à jour automatique dans les paramètres de la place de marché.

Configuration MCP

Utilisez cette section si votre organisation utilise un point de terminaison Honeydew personnalisé, ou si vous préférez configurer les serveurs MCP sans installer le plugin. Désactivez la connexion MCP Honeydew ajoutée par le plugin, puis ajoutez votre point de terminaison personnalisé en suivant les instructions ci-dessous.

Le serveur MCP Honeydew connecte Claude Code à la couche sémantique Honeydew pour l'exploration de modèles, l'interrogation de données, la gestion de modèles, et l'accès à la documentation.

Utilisez l'une des méthodes suivantes pour ajouter le serveur MCP Honeydew :

Remarque

Si votre organisation utilise un nom d'hôte Honeydew personnalisé, remplacez https://mcp.honeydew.cloud/mcp par le nom d'hôte de votre locataire. Vous pouvez trouver le nom d'hôte dans Paramètres > Serveur MCP dans Honeydew Studio.

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

      Lancez Claude Code avec `claude`.
      Vous serez invité à vous authentifier avec OAuth auprès de Honeydew.
    </Tab>

    <Tab title="API Key">
      ```bash theme={null}
      claude mcp add --transport http honeydew \
          https://mcp.honeydew.cloud/mcp \
          --header "Authorization: Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET>"
      ```
    </Tab>
  </Tabs>
</Tab>

<Tab title="JSON configuration">
  Enregistrez ce qui suit dans `honeydew-mcp.json` :

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

      Ensuite, enregistrez-le avec :

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

      Lancez Claude Code avec `claude`.
      Vous serez invité à vous authentifier avec OAuth auprès de Honeydew.
    </Tab>

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

      Ensuite, enregistrez-le avec :

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

<Tab title=".mcp.json">
  Ajoutez ce qui suit à votre fichier `.mcp.json` :

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

      Lancez Claude Code avec `claude`.
      Vous serez invité à vous authentifier avec OAuth auprès de Honeydew.
    </Tab>

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

Astuce

Utilisation de variables d'environnement pour l'authentification par clé API

Pour éviter de stocker des valeurs sensibles directement dans les fichiers de configuration, Claude Code prend en charge l'expansion de variables d'environnement en utilisant la syntaxe ${VAR_NAME}.

Définissez la variable d'environnement HONEYDEW_API_KEY, puis référencez-la dans votre configuration :
claude mcp add --transport http honeydew \
    https://mcp.honeydew.cloud/mcp \
    --header "Authorization: Basic ${HONEYDEW_API_KEY}"
Claude Code résout les références ${VAR_NAME} au moment de l'exécution depuis votre environnement.

Documentation MCP Honeydew (optionnel)

Le serveur MCP Honeydew inclut déjà des outils d'accès à la documentation, donc un serveur de documentation séparé n'est pas nécessaire. Ajoutez la documentation MCP Honeydew uniquement si vous souhaitez un accès à la documentation sans vous connecter à Honeydew. Aucune authentification n'est requise.

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

Suppression du serveur MCP

Pour supprimer le serveur MCP Honeydew :

claude mcp remove honeydew

Pour supprimer le serveur de documentation MCP Honeydew :

claude mcp remove honeydew-docs

Claude Desktop

#### Installation du plugin

Remarque

Nécessite Git. L'installation du plugin depuis GitHub clone le dépôt localement, donc Git doit être installé et sur votre PATH. Si Git est manquant, l'installation du plugin échoue. Installez Git, ou utilisez les étapes de configuration MCP manuelles de votre client pour configurer le serveur directement au lieu du plugin.

Allez dans Paramètres -> Personnaliser
Cliquez sur Parcourir les plugins
Allez dans l'onglet Personnel
Cliquez sur l'icône + et choisissez Ajouter une place de marché depuis GitHub
Saisissez honeydew-ai/honeydew-ai-coding-agents-plugins dans le champ de saisie
Le plugin Honeydew AI apparaît. Installez-le.

Configuration MCP

Le serveur MCP Honeydew connecte Claude Desktop à la couche sémantique Honeydew pour l'exploration de modèles, l'interrogation de données, la gestion de modèles, et l'accès à la documentation.

Mode Claude Code

Lorsque vous utilisez Claude Desktop en mode Claude Code, suivez plutôt les instructions Claude Code CLI.

Remarque

Si votre organisation utilise un nom d'hôte Honeydew personnalisé, remplacez https://mcp.honeydew.cloud/mcp par le nom d'hôte de votre locataire. Vous pouvez trouver le nom d'hôte dans Paramètres > Serveur MCP dans Honeydew Studio.

Pour ajouter le MCP Honeydew en mode Cowork :

Allez dans Paramètres -> Connecteurs -> Ajouter un connecteur personnalisé
Saisissez honeydew dans le champ Nom
Saisissez https://mcp.honeydew.cloud/mcp dans le champ URL du serveur MCP distant
Cliquez sur Ajouter

Vous serez invité à vous authentifier avec OAuth auprès de Honeydew lors de la première connexion.

Documentation MCP Honeydew (optionnel)

Allez dans Paramètres -> Connecteurs -> Ajouter un connecteur personnalisé
Saisissez honeydew-docs dans le champ Nom
Saisissez https://honeydew.ai/docs/mcp dans le champ URL du serveur MCP distant
Cliquez sur Ajouter

Suppression du serveur MCP

Pour supprimer le serveur MCP Honeydew en mode Cowork :

Allez dans Paramètres -> Connecteurs
Trouvez le connecteur honeydew et cliquez sur l'icône de suppression

Pour supprimer le serveur de documentation MCP Honeydew :

Allez dans Paramètres -> Connecteurs
Trouvez le connecteur honeydew-docs et cliquez sur l'icône de suppression

Claude.ai

#### Installation du plugin

Téléchargez le zip du plugin : honeydew-ai-claude.zip
Dans Claude.ai, allez dans Paramètres -> Plugins -> Ajouter un plugin -> Téléverser un zip
Téléversez le zip — le plugin apparaît dans votre place de marché privée

Configuration MCP

Utilisez cette section si votre organisation utilise un point de terminaison Honeydew personnalisé, ou si vous préférez configurer les serveurs MCP sans installer le plugin. Supprimez le connecteur MCP Honeydew ajouté par le plugin, puis ajoutez votre point de terminaison personnalisé en suivant les instructions ci-dessous.

Le serveur MCP Honeydew connecte Claude.ai à la couche sémantique Honeydew pour l'exploration de modèles, l'interrogation de données, la gestion de modèles, et l'accès à la documentation.

Remarque

Si votre organisation utilise un nom d'hôte Honeydew personnalisé, remplacez https://mcp.honeydew.cloud/mcp par le nom d'hôte de votre locataire. Vous pouvez trouver le nom d'hôte dans Paramètres > Serveur MCP dans Honeydew Studio.

Pour ajouter le serveur MCP Honeydew :

Allez dans Paramètres -> Connecteurs -> Ajouter un connecteur personnalisé
Saisissez honeydew dans le champ Nom
Saisissez https://mcp.honeydew.cloud/mcp dans le champ URL du serveur MCP distant
Cliquez sur Ajouter

Vous serez invité à vous authentifier avec OAuth auprès de Honeydew lors de la première connexion.

Honeydew Documentation MCP (facultatif)

Le serveur MCP Honeydew inclut déjà des outils d'accès à la documentation, un serveur de documentation séparé n'est donc pas nécessaire. Ajoutez le Honeydew Documentation MCP uniquement si vous souhaitez un accès à la documentation sans vous connecter à Honeydew. Aucune authentification n'est requise.

Allez dans Paramètres -> Connecteurs -> Ajouter un connecteur personnalisé
Saisissez honeydew-docs dans le champ Nom
Saisissez https://honeydew.ai/docs/mcp dans le champ URL du serveur MCP distant
Cliquez sur Ajouter

Suppression du serveur MCP

Pour supprimer le serveur MCP Honeydew :

Allez dans Paramètres -> Connecteurs
Trouvez le connecteur honeydew et cliquez sur l'icône de suppression

Pour supprimer le serveur Honeydew Documentation MCP :

Allez dans Paramètres -> Connecteurs
Trouvez le connecteur honeydew-docs et cliquez sur l'icône de suppression

Cortex Code CLI

#### Installation du plugin

Remarque

Git est requis. L'installation du plugin depuis GitHub clone le dépôt localement, donc Git doit être installé et disponible dans votre PATH. Si Git est absent, l'installation du plugin échoue. Installez Git, ou utilisez les étapes de configuration MCP manuelle de votre client pour configurer le serveur directement au lieu du plugin.

Honeydew fournit un dépôt de plugins avec des compétences et des outils pour créer des modèles sémantiques et analyser des données par conversation naturelle. L'installation du plugin configure automatiquement les serveurs MCP Honeydew.

Lancez Cortex Code CLI avec cortex, puis installez le plugin :

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

Configuration MCP

Le serveur MCP Honeydew connecte Cortex Code CLI à la Honeydew Semantic Layer pour l'exploration de modèles, l'interrogation de données, la gestion de modèles, et l'accès à la documentation.

Remarque

Si votre organisation utilise un nom d'hôte Honeydew personnalisé, remplacez https://mcp.honeydew.cloud/mcp par le nom d'hôte de votre locataire. Vous pouvez trouver le nom d'hôte dans Paramètres > Serveur MCP dans Honeydew Studio.

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

      Lancez Cortex Code CLI avec `cortex`.
      Vous serez invité à vous authentifier
      avec OAuth auprès de Honeydew.
    </Tab>

    <Tab title="API Key">
      ```bash theme={null}
      cortex mcp add honeydew \
          https://mcp.honeydew.cloud/mcp \
          --type http \
          -H "Authorization: Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET>"
      ```
    </Tab>
  </Tabs>
</Tab>

<Tab title="JSON configuration">
  Enregistrez ce qui suit dans `honeydew-mcp.json` :

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

      Ensuite, enregistrez-le avec :

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

      Lancez Cortex Code CLI avec `cortex`.
      Vous serez invité à vous authentifier
      avec OAuth auprès de Honeydew.
    </Tab>

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

      Ensuite, enregistrez-le avec :

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

<Tab title="mcp.json">
  Ajoutez ce qui suit à
  `~/.snowflake/cortex/mcp.json` :

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

      Lancez Cortex Code CLI avec `cortex`.
      Vous serez invité à vous authentifier
      avec OAuth auprès de Honeydew.
    </Tab>

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

Honeydew Documentation MCP (facultatif)

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

Suppression du serveur MCP

Pour supprimer le serveur MCP Honeydew :

cortex mcp remove honeydew

Pour supprimer le serveur Honeydew Documentation MCP :

cortex mcp remove honeydew-docs

Cortex Code Desktop

#### Installation du plugin

Remarque

Git est requis. L'installation du plugin depuis GitHub clone le dépôt localement, donc Git doit être installé et disponible dans votre PATH. Si Git est absent, l'installation du plugin échoue. Installez Git, ou utilisez les étapes de configuration MCP manuelle de votre client pour configurer le serveur directement au lieu du plugin.

Allez dans Paramètres -> Plugins
Cliquez sur Ajouter un plugin, sélectionnez Ajouter depuis GitHub, et collez le dépôt de plugins Honeydew : honeydew-ai/honeydew-ai-coding-agents-plugins
Suivez le flux et approuvez les étapes dans Configuration de l'installateur de plugins GitHub

Configuration MCP

Le serveur MCP Honeydew connecte Cortex Code Desktop à la Honeydew Semantic Layer pour l'exploration de modèles, l'interrogation de données, la gestion de modèles, et l'accès à la documentation.

Pour ajouter un serveur, allez dans MCP -> Nouveau, choisissez une Portée de configuration (par exemple, ~/.snowflake/cortex/mcp.json pour Global), remplissez le formulaire, puis cliquez sur Enregistrer. Utilisez l'onglet Formulaire ou JSON pour saisir la configuration.

Remarque

Si votre organisation utilise un nom d'hôte Honeydew personnalisé, remplacez https://mcp.honeydew.cloud/mcp par le nom d'hôte de votre locataire. Vous pouvez trouver le nom d'hôte dans Paramètres > Serveur MCP dans Honeydew Studio.

Ajoutez le serveur Honeydew MCP :

1. **Nom du serveur** : `honeydew` 2. **Type de serveur** : **Distant (HTTP)** 3. **URL du serveur** : `https://mcp.honeydew.cloud/mcp` 4. Cliquez sur **Enregistrer**

      Vous serez invité à vous authentifier avec OAuth auprès de Honeydew
      lors de la première connexion.
    </Tab>

    <Tab title="API Key">
      1. **Nom du serveur** : `honeydew`
      2. **Type de serveur** : **Distant (HTTP)**
      3. **URL du serveur** : `https://mcp.honeydew.cloud/mcp`
      4. Sous **En-têtes**, cliquez sur **Ajouter un en-tête** et définissez le nom sur
         `Authorization` et la valeur sur
         `Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET>`
      5. Cliquez sur **Enregistrer**
    </Tab>
  </Tabs>
</Tab>

<Tab title="JSON">
  Passez à l'onglet **JSON** et collez la configuration :

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

      Vous serez invité à vous authentifier avec OAuth auprès de Honeydew
      lors de la première connexion.
    </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 (facultatif)

Le serveur MCP Honeydew inclut déjà des outils d'accès à la documentation, un serveur de documentation séparé n'est donc pas nécessaire. Si vous souhaitez un accès à la documentation sans vous connecter à Honeydew, ajoutez le serveur Honeydew Documentation MCP de la même manière, en utilisant Nom du serveur honeydew-docs, Type de serveur Distant (HTTP), et URL du serveur https://honeydew.ai/docs/mcp. Aucune authentification n'est requise.

Suppression du serveur MCP

Pour supprimer un serveur, allez dans MCP, trouvez le serveur honeydew (ou honeydew-docs), et supprimez-le.

Cursor

#### Installation du plugin

Dans les paramètres de votre équipe ou organisation, allez sur cursor.com/dashboard/plugins (ou cliquez sur Plugins dans le menu latéral gauche)
Faites défiler jusqu'à Marketplaces d'équipe et cliquez soit sur un Marketplace existant, soit sur Ajouter un Marketplace pour en créer un nouveau. Si vous en créez un nouveau, saisissez un nom et créez-le.
Dans le Marketplace, cliquez sur Ajouter un plugin, collez le chemin du dépôt GitHub du plugin Honeydew : https://github.com/honeydew-ai/honeydew-ai-coding-agents-plugins et cliquez sur Ajouter 1 plugin
Optionnellement, activez l'actualisation automatique dans la page du Marketplace pour que le plugin se mette à jour automatiquement lors de nouvelles versions.
Revenez à la page des plugins (cursor.com/dashboard/plugins), recherchez le plugin Honeydew, et cliquez sur Ajouter

Configuration MCP

Le serveur MCP Honeydew connecte Cursor à la Honeydew Semantic Layer pour l'exploration de modèles, l'interrogation de données, la gestion de modèles, et l'accès à la documentation.

Remarque

Si votre organisation utilise un nom d'hôte Honeydew personnalisé, remplacez https://mcp.honeydew.cloud/mcp par le nom d'hôte de votre locataire. Vous pouvez trouver le nom d'hôte dans Paramètres > Serveur MCP dans Honeydew Studio.

Pour ajouter le Honeydew MCP :

Ouvrez l'application Cursor
Allez dans Paramètres -> Paramètres de Cursor -> Outils et MCP
Cliquez sur Nouveau serveur MCP

Ajoutez la configuration suivante :

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

Cliquez sur Enregistrer

Honeydew Documentation MCP (facultatif)

Allez dans Paramètres -> Paramètres de Cursor -> Outils et MCP
Cliquez sur Nouveau serveur MCP

Ajoutez la configuration suivante :

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

Cliquez sur Enregistrer

Suppression du serveur MCP

Pour supprimer le serveur MCP Honeydew :

Allez dans Paramètres -> Paramètres de Cursor -> Outils et MCP
Trouvez honeydew dans la liste et cliquez sur l'icône de suppression

Pour supprimer le serveur Honeydew Documentation MCP :

Allez dans Paramètres -> Paramètres de Cursor -> Outils et MCP
Trouvez honeydew-docs dans la liste et cliquez sur l'icône de suppression

Databricks Genie Code

> **Remarque** > > Les serveurs MCP ne sont pris en charge qu'en mode Genie Code Agent. > Pour plus de détails, consultez la > [documentation MCP Databricks](https://docs.databricks.com/aws/en/generative-ai/mcp/).

Prérequis :

Genie Code activé dans votre espace de travail Databricks
Privilège CREATE CONNECTION sur le métastore Unity Catalog

1. Accédez à **Catalogue** → **Connexions** → **Créer une connexion** 2. Sur l'écran **Informations de base sur la connexion** : * Définissez **Nom de la connexion** sur `honeydew-mcp` * Définissez **Type de connexion** sur **HTTP** * Définissez **Type d'authentification** sur **Enregistrement dynamique du client** * Cliquez sur **Suivant** 3. Sur l'écran **Authentification** : * Définissez **Hôte** sur `https://mcp.honeydew.cloud` * Laissez **Port** sur `443` * Définissez **Portée OAuth** sur `openid` * Cliquez sur **Suivant** 4. Sur l'écran **Détails de la connexion** : * Cochez **Est une connexion MCP** * Définissez **Chemin de base** sur `/mcp` * Cliquez sur **Créer une connexion**

    <Tab title="SQL">
      Exécutez le SQL suivant dans un notebook Databricks ou un éditeur SQL :

      ```sql theme={null}
      CREATE OR REPLACE CONNECTION `honeydew-mcp` TYPE HTTP
      OPTIONS (
        host 'https://mcp.honeydew.cloud',
        base_path '/mcp',
        is_mcp_connection 'true',
        oauth_scope 'openid'
      );

      DESCRIBE CONNECTION `honeydew-mcp`;
      ```
    </Tab>
  </Tabs>

Remarque

Si votre organisation utilise un nom d'hôte Honeydew personnalisé, remplacez https://mcp.honeydew.cloud par le nom d'hôte de votre locataire. Vous pouvez trouver votre nom d'hôte dans Paramètres > Serveur MCP dans Honeydew Studio.

<Step title="Log in to the connection">
  Accédez à **Catalogue** → **Connexions** → `honeydew-mcp`
  et cliquez sur **Connexion** dans le coin supérieur droit
  pour vous authentifier et vérifier la connexion.
</Step>

<Step title="Grant connection access">
  Accordez le privilège `USE CONNECTION` à tous les utilisateurs ou rôles
  qui ont besoin d'accéder au serveur MCP Honeydew :

  ```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. Ouvrez Genie Code et cliquez sur l'icône d'engrenage
  2. Accédez à **Serveurs MCP** → **Ajouter un serveur**
  3. Sélectionnez **Serveur MCP externe**
  4. Choisissez la connexion `honeydew-mcp` que vous avez créée
  5. Connectez-vous à la connexion lorsque vous y êtes invité
  6. Cliquez sur **Enregistrer**

Remarque

Databricks limite MCP à 20 outils sur tous les serveurs configurés. Si vous devez ajuster les outils Honeydew disponibles, utilisez les paramètres MCP de Genie Code pour activer ou désactiver des outils spécifiques.

Suppression du serveur MCP

Pour supprimer le serveur MCP Honeydew de Genie Code :

Ouvrez Genie Code et cliquez sur l'icône d'engrenage
Accédez à Serveurs MCP
Trouvez honeydew-mcp et cliquez sur Supprimer

Pour également supprimer la connexion Unity Catalog sous-jacente, exécutez le SQL suivant :

DROP CONNECTION `honeydew-mcp`;

Devin

#### Serveur MCP

Devin se connecte aux serveurs MCP distants via son MCP Marketplace.

Remarque

Si votre organisation utilise un nom d'hôte Honeydew personnalisé, remplacez https://mcp.honeydew.cloud/mcp par le nom d'hôte de votre locataire. Vous pouvez trouver le nom d'hôte dans Paramètres > Serveur MCP dans Honeydew Studio.

Pour ajouter le serveur MCP Honeydew :

Accédez à Paramètres -> Connexions -> Serveurs MCP
Cliquez sur Ajouter un MCP personnalisé
Saisissez honeydew dans le champ Nom du serveur
Ajoutez éventuellement une icône et une Description courte
Choisissez HTTP comme type de transport
Saisissez https://mcp.honeydew.cloud/mcp dans le champ URL du serveur

Configurez l'authentification :

Sélectionnez **OAuth** comme méthode d'authentification. Devin vous invite à vous authentifier auprès de Honeydew lors de la première session.

<Tab title="API Key">
  Sélectionnez **En-tête d'authentification** comme méthode d'authentification.
  Laissez la clé d'en-tête sur `Authorization` et définissez la valeur sur
  `Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET>`
  (voir [Authentification](#authentication)).
</Tab>

Cliquez sur Enregistrer, puis cliquez sur Tester les outils de liste pour vérifier la connexion

MCP de documentation Honeydew (facultatif)

Le serveur MCP Honeydew inclut déjà des outils d'accès à la documentation, donc un serveur de documentation séparé n'est pas nécessaire. Ajoutez le MCP de documentation Honeydew uniquement si vous souhaitez un accès à la documentation sans vous connecter à Honeydew. Aucune authentification n'est requise.

Accédez à Paramètres -> Connexions -> Serveurs MCP
Cliquez sur Ajouter un MCP personnalisé
Saisissez honeydew-docs dans le champ Nom du serveur
Choisissez HTTP comme type de transport
Saisissez https://honeydew.ai/docs/mcp dans le champ URL du serveur
Définissez la méthode d'authentification sur Aucune
Cliquez sur Enregistrer

Suppression du serveur MCP

Pour supprimer le serveur MCP Honeydew :

Accédez à Paramètres -> Connexions -> Serveurs MCP
Trouvez le serveur honeydew et supprimez-le

Pour supprimer le serveur MCP de documentation Honeydew :

Accédez à Paramètres -> Connexions -> Serveurs MCP
Trouvez le serveur honeydew-docs et supprimez-le

GitHub Copilot CLI

#### Serveur MCP

Remarque

Si votre organisation utilise un nom d'hôte Honeydew personnalisé, remplacez https://mcp.honeydew.cloud/mcp par le nom d'hôte de votre locataire. Vous pouvez trouver le nom d'hôte dans Paramètres > Serveur MCP dans Honeydew Studio.

Lancez GitHub Copilot CLI avec copilot
Tapez /mcp add pour ouvrir le formulaire de configuration du serveur
Remplissez les champs suivants :
- Nom : honeydew
- Type : http
- URL : https://mcp.honeydew.cloud/mcp
- En-têtes HTTP :
  Aucun en-tête supplémentaire n'est nécessaire pour OAuth. ```json theme={null} { "Authorization": "Basic " } ```
Appuyez sur Ctrl+S pour enregistrer

Utilisez /mcp show pour vérifier que le serveur est connecté.

Plugins d'agent de codage IA

Remarque

Nécessite Git. L'installation du plugin depuis GitHub clone le dépôt localement, donc Git doit être installé et sur votre PATH. Si Git est manquant, l'installation du plugin échoue. Installez Git, ou utilisez les étapes de configuration MCP manuelles de votre client pour configurer le serveur directement au lieu du plugin.

Honeydew fournit un dépôt de plugins avec des compétences et des outils pour créer des modèles sémantiques et analyser des données par conversation naturelle.

Ajoutez la place de marché à Copilot CLI :

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

Installez ensuite le plugin Honeydew depuis la place de marché :

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

MCP de documentation Honeydew (facultatif)

Lancez GitHub Copilot CLI avec copilot
Tapez /mcp add pour ouvrir le formulaire de configuration du serveur
Remplissez les champs suivants :
- Nom : honeydew-docs
- Type : http
- URL : https://honeydew.ai/docs/mcp
Appuyez sur Ctrl+S pour enregistrer

Suppression du serveur MCP

Pour supprimer le serveur MCP Honeydew, lancez GitHub Copilot CLI avec copilot, puis tapez :

/mcp remove honeydew

Pour supprimer le serveur MCP de documentation Honeydew :

/mcp remove honeydew-docs

Gemini CLI

#### Installation de l'extension

Remarque

Nécessite Git. L'installation du plugin depuis GitHub clone le dépôt localement, donc Git doit être installé et sur votre PATH. Si Git est manquant, l'installation du plugin échoue. Installez Git, ou utilisez les étapes de configuration MCP manuelles de votre client pour configurer le serveur directement au lieu du plugin.

Honeydew fournit un dépôt de plugins avec des compétences et des outils pour créer des modèles sémantiques et analyser des données par conversation naturelle. L'installation de l'extension configure automatiquement les serveurs MCP Honeydew.

Exécutez la commande suivante pour installer l'extension Honeydew :

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

Le drapeau --auto-update maintient l'extension à jour automatiquement.

Configuration MCP

Utilisez cette section si votre organisation utilise un point de terminaison Honeydew personnalisé, ou si vous préférez configurer les serveurs MCP sans installer l'extension. Désactivez la connexion MCP Honeydew ajoutée par l'extension, puis ajoutez votre point de terminaison personnalisé en suivant les instructions ci-dessous.

Le serveur MCP Honeydew connecte Gemini CLI à la couche sémantique Honeydew pour l'exploration de modèles, l'interrogation de données, la gestion de modèles, et l'accès à la documentation.

Remarque

Si votre organisation utilise un nom d'hôte Honeydew personnalisé, remplacez https://mcp.honeydew.cloud/mcp par le nom d'hôte de votre locataire. Vous pouvez trouver le nom d'hôte dans Paramètres > Serveur MCP dans Honeydew Studio.

Exécutez la commande suivante pour ajouter le serveur MCP Honeydew :

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

  Lancez Gemini CLI avec `gemini`.
  Vous serez invité à vous authentifier avec OAuth auprès de Honeydew.
</Tab>

<Tab title="API Key">
  ```bash theme={null}
  gemini mcp add --transport http honeydew \
      https://mcp.honeydew.cloud/mcp \
      --header "Authorization: Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET>"
  ```
</Tab>

MCP de documentation Honeydew (facultatif)

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

Suppression du serveur MCP

Pour supprimer le serveur MCP Honeydew :

gemini mcp remove honeydew

Pour supprimer le serveur MCP de documentation Honeydew :

gemini mcp remove honeydew-docs

VS Code et GitHub Copilot

#### Installation du plugin

Ajouter la place de marché Honeydew

Ouvrez votre settings.json VS Code (ouvrez la palette de commandes avec CMD+Shift+P sur macOS ou Ctrl+Shift+P sur Windows/Linux, puis sélectionnez Préférences : Ouvrir les paramètres utilisateur (JSON))

Ajoutez la place de marché Honeydew au paramètre chat.plugins.marketplaces :

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

Installer le plugin

Ouvrez la vue Extensions (CMD+Shift+X sur macOS ou Ctrl+Shift+X sur Windows/Linux)
Saisissez @agentPlugins dans le champ de recherche
Trouvez le plugin Honeydew AI et cliquez sur Installer

La première fois que vous installez un plugin depuis une nouvelle place de marché, VS Code affiche une invite de confiance — examinez la source de la place de marché avant de confirmer.

Mettre à jour le plugin

Si extensions.autoUpdate est activé dans les paramètres VS Code, le plugin se met à jour automatiquement. Pour mettre à jour manuellement, ouvrez la palette de commandes et exécutez Extensions : Rechercher les mises à jour d'extensions.

Serveur MCP

Le serveur MCP Honeydew connecte VS Code à la couche sémantique Honeydew pour l'exploration de modèles, l'interrogation de données, la gestion de modèles, et l'accès à la documentation.

Remarque

Si votre organisation utilise un nom d'hôte Honeydew personnalisé, remplacez https://mcp.honeydew.cloud/mcp par le nom d'hôte de votre locataire. Vous pouvez trouver le nom d'hôte dans Paramètres > Serveur MCP dans Honeydew Studio.

Ouvrez la palette de commandes avec CMD+Shift+P (macOS) ou Ctrl+Shift+P (Windows/Linux)
Sélectionnez MCP : Ajouter un serveur...
Choisissez HTTP (HTTP ou Server-Sent Events)
Saisissez l'URL du serveur MCP Honeydew : https://mcp.honeydew.cloud/mcp
Saisissez honeydew comme nom du serveur

Cela ajoute le serveur à votre fichier .vscode/mcp.json. Ouvrez le fichier et ajoutez les en-têtes si nécessaire : 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 (optionnel)

Ajoutez ce qui suit à votre .vscode/mcp.json :

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

Suppression du serveur MCP

Pour supprimer le serveur MCP Honeydew, ouvrez .vscode/mcp.json et supprimez l'entrée honeydew de l'objet servers. Pour supprimer le serveur Honeydew Documentation MCP, supprimez l'entrée honeydew-docs du même fichier.

Codex CLI

#### Installation du plugin

Remarque

Nécessite Git. L'installation du plugin depuis GitHub clone le dépôt localement, donc Git doit être installé et présent dans votre PATH. Si Git est absent, l'installation du plugin échoue. Installez Git, ou utilisez les étapes de configuration MCP manuelles de votre client pour configurer le serveur directement au lieu du plugin.

Ajoutez la place de marché à Codex :

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

Lancez ensuite Codex avec codex et tapez /plugins pour parcourir et installer le plugin Honeydew AI.

Mise à jour des plugins

Pour mettre à jour la place de marché Honeydew, exécutez :

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

Lancez ensuite Codex et tapez /plugins pour appliquer les mises à jour.

Configuration MCP

Le serveur MCP Honeydew connecte Codex à la couche sémantique Honeydew pour l'exploration de modèles, l'interrogation de données, la gestion de modèles, et l'accès à la documentation.

Remarque

Si votre organisation utilise un nom d'hôte Honeydew personnalisé, remplacez https://mcp.honeydew.cloud/mcp par le nom d'hôte de votre locataire. Vous pouvez trouver le nom d'hôte dans Paramètres > Serveur MCP dans Honeydew Studio.

Ligne de commande

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

Lancez ensuite Codex avec codex. Vous serez invité à vous authentifier avec OAuth auprès de Honeydew.

Après avoir ajouté le serveur, ouvrez le fichier de configuration à ~/.codex/config.toml et ajoutez des en-têtes à la section [mcp_servers.honeydew] si nécessaire.

Configuration TOML

Ajoutez ce qui suit à ~/.codex/config.toml (ou .codex/config.toml dans un projet de confiance) :

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

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

Définissez la variable d'environnement HONEYDEW_AUTH sur Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET> (voir Authentification).

Honeydew Documentation MCP (optionnel)

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

Suppression du serveur MCP

Pour supprimer le serveur MCP Honeydew :

codex mcp remove honeydew

Pour supprimer le serveur Honeydew Documentation MCP :

codex mcp remove honeydew-docs

Codex

#### Installation du plugin

Remarque

Nécessite Git. L'installation du plugin depuis GitHub clone le dépôt localement, donc Git doit être installé et présent dans votre PATH. Si Git est absent, l'installation du plugin échoue. Installez Git, ou utilisez les étapes de configuration MCP manuelles de votre client pour configurer le serveur directement au lieu du plugin.

Ajoutez la place de marché dans Codex :

Ouvrez Plugins
Cliquez sur la flèche du menu déroulant et sélectionnez Ajouter une place de marché
Ajoutez honeydew-ai/honeydew-ai-coding-agents-plugins

Remarque

Vous pouvez également ajouter la place de marché depuis le Codex CLI :
codex plugin marketplace add honeydew-ai/honeydew-ai-coding-agents-plugins

Installez ensuite le plugin :

Ouvrez Plugins
Sélectionnez la place de marché Honeydew AI
Installez le plugin Honeydew

Configuration MCP

Remarque

Si votre organisation utilise un nom d'hôte Honeydew personnalisé, remplacez https://mcp.honeydew.cloud/mcp par le nom d'hôte de votre locataire. Vous pouvez trouver le nom d'hôte dans Paramètres > Serveur MCP dans Honeydew Studio.

Honeydew MCP

Ouvrez l'application Codex
Allez dans Paramètres -> Serveurs MCP
Sous Serveurs personnalisés, cliquez sur Ajouter un serveur
Définissez le nom du serveur sur honeydew
Choisissez Streamable HTTP comme type de transport
Définissez l'URL sur https://mcp.honeydew.cloud/mcp
Laissez le champ Variable d'environnement du jeton Bearer vide
Configurez l'authentification comme suit :

Authentification OAuth

Codex vous redirige pour vous authentifier auprès de Honeydew lors de la connexion. Aucune configuration supplémentaire n'est nécessaire.

Authentification HTTP Basic

Ajoutez un en-tête Authorization à la liste d'en-têtes ci-dessus avec la valeur Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET> (voir Authentification).

Dépannage de l'authentification MCP

Si le serveur MCP Honeydew n'est pas authentifié dans Codex et que l'option « S'authentifier » n'apparaît pas :

Installez le Codex CLI
Exécutez codex mcp login honeydew

Honeydew Documentation MCP (optionnel)

Allez dans Paramètres -> Serveurs MCP
Sous Serveurs personnalisés, cliquez sur Ajouter un serveur
Définissez le nom du serveur sur honeydew-docs
Choisissez Streamable HTTP comme type de transport
Définissez l'URL sur https://honeydew.ai/docs/mcp

Suppression du serveur MCP

Pour supprimer le serveur MCP Honeydew :

Allez dans Paramètres -> Serveurs MCP
Trouvez honeydew sous Serveurs personnalisés et cliquez sur Supprimer

Pour supprimer le serveur Honeydew Documentation MCP :

Allez dans Paramètres -> Serveurs MCP
Trouvez honeydew-docs sous Serveurs personnalisés et cliquez sur Supprimer

Antigravity

#### Serveur MCP

Remarque

Si votre organisation utilise un nom d'hôte Honeydew personnalisé, remplacez https://mcp.honeydew.cloud/mcp par le nom d'hôte de votre locataire. Vous pouvez trouver le nom d'hôte dans Paramètres > Serveur MCP dans Honeydew Studio.

Ouvrez l'éditeur Antigravity
Cliquez sur le menu déroulant ... en haut du panneau d'agent
Cliquez sur Gérer les serveurs MCP
Cliquez sur Afficher la configuration brute

Ajoutez ce qui suit à mcp_config.json :

```json theme={null} { "name": "honeydew", "type": "http", "url": "https://mcp.honeydew.cloud/mcp" } ```

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

Enregistrez le fichier

Honeydew Documentation MCP (optionnel)

Ouvrez l'éditeur Antigravity
Cliquez sur le menu déroulant ... en haut du panneau d'agent
Cliquez sur Gérer les serveurs MCP
Cliquez sur Afficher la configuration brute

Ajoutez ce qui suit à mcp_config.json :

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

Enregistrez le fichier

Suppression du serveur MCP

Pour supprimer le serveur MCP Honeydew :

Ouvrez l'éditeur Antigravity
Cliquez sur le menu déroulant ... en haut du panneau d'agent
Cliquez sur Gérer les serveurs MCP
Cliquez sur Afficher la configuration brute
Supprimez les entrées honeydew et honeydew-docs de mcp_config.json
Enregistrez le fichier

OpenCode

#### Serveur MCP

Remarque

Si votre organisation utilise un nom d'hôte Honeydew personnalisé, remplacez https://mcp.honeydew.cloud/mcp par le nom d'hôte de votre locataire. Vous pouvez trouver le nom d'hôte dans Paramètres > Serveur MCP dans Honeydew Studio.

Exécutez la commande suivante et suivez les invites interactives :

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

  Lorsque vous y êtes invité, saisissez les valeurs suivantes :

  1. **Emplacement** : Choisissez la portée préférée (projet actuel ou global)
  2. **Nom du serveur MCP** : `honeydew`
  3. **Type de serveur MCP** : `Remote`
  4. **URL du serveur MCP** : `https://mcp.honeydew.cloud/mcp`
  5. **Authentification OAuth** : `Yes`
  6. **ID client préenregistré** : `No`
</Tab>

<Tab title="JSON configuration">
  Ajoutez ce qui suit à votre fichier `opencode.jsonc` :

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

      Authentifiez-vous ensuite auprès de Honeydew :

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

      Cela ouvre une fenêtre de navigateur pour terminer le flux d'authentification OAuth.
    </Tab>

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

Ré-authentification

Pour vous ré-authentifier, vérifiez d'abord votre statut et déconnectez-vous :

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

Honeydew Documentation MCP (optionnel)

Exécutez `opencode mcp add` et saisissez les valeurs suivantes :

  1. **Nom du serveur MCP** : `honeydew-docs`
  2. **Type de serveur MCP** : `Remote`
  3. **URL du serveur MCP** : `https://honeydew.ai/docs/mcp`
  4. **Authentification OAuth** : `No`
</Tab>

<Tab title="JSON configuration">
  Ajoutez ce qui suit à votre fichier `opencode.jsonc` :

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

Suppression du serveur MCP

Pour supprimer le serveur MCP Honeydew, supprimez l'entrée honeydew de votre fichier opencode.jsonc. Pour supprimer le serveur Honeydew Documentation MCP, supprimez l'entrée honeydew-docs du même fichier.

Kiro

L'IDE Kiro et le CLI Kiro partagent les mêmes fichiers de configuration MCP, les étapes ci-dessous s'appliquent donc aux deux.

Serveur MCP

Kiro lit les serveurs MCP à partir de deux fichiers de configuration :

Espace de travail : .kiro/settings/mcp.json (spécifique au projet actuel)
Utilisateur : ~/.kiro/settings/mcp.json (s'applique à tous les espaces de travail)

Si les deux fichiers existent, la configuration de l'espace de travail a priorité.

Remarque

Si votre organisation utilise un nom d'hôte Honeydew personnalisé, remplacez https://mcp.honeydew.cloud/mcp par le nom d'hôte de votre locataire. Vous pouvez trouver le nom d'hôte dans Paramètres > Serveur MCP dans Honeydew Studio.

Ajoutez le serveur MCP Honeydew à l'un de ces fichiers mcp.json (espace de travail ou utilisateur) :

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

  Lors de la première connexion à Honeydew, Kiro fournit une URL d'authentification.
  Ouvrez-la dans votre navigateur pour terminer le flux d'authentification OAuth.
</Tab>

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

Dans le CLI Kiro, exécutez /mcp pour vérifier que le serveur est connecté. Dans l'IDE Kiro, le serveur apparaît dans le panneau MCP.

Documentation MCP Honeydew (optionnel)

Le serveur MCP Honeydew inclut déjà des outils d'accès à la documentation, un serveur de documentation séparé n'est donc pas nécessaire. Ajoutez la Documentation MCP Honeydew uniquement si vous souhaitez un accès à la documentation sans vous connecter à Honeydew. Aucune authentification n'est requise.

Ajoutez ce qui suit à votre mcp.json :

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

Suppression du serveur MCP

Pour supprimer le serveur MCP Honeydew, supprimez l'entrée honeydew de votre mcp.json. Pour supprimer le serveur Documentation MCP Honeydew, supprimez l'entrée honeydew-docs du même fichier.

Snowflake Intelligence

Snowflake se connecte aux serveurs MCP externes via [connecteurs MCP](https://docs.snowflake.com/en/user-guide/snowflake-cortex/cortex-agents-mcp-connectors), rendant les outils Honeydew disponibles pour Snowflake Intelligence et Cortex Agents.

Prérequis :

Un rôle avec le privilège CREATE INTEGRATION sur le compte
Un rôle avec le privilège CREATE MCP SERVER sur le schéma cible

Par défaut, seul le rôle ACCOUNTADMIN détient ces privilèges.

Remarque

Si votre organisation utilise un nom d'hôte Honeydew personnalisé, remplacez https://mcp.honeydew.cloud/mcp par le nom d'hôte de votre locataire. Vous pouvez trouver le nom d'hôte dans Paramètres > Serveur MCP dans 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">
  Le serveur MCP externe est un objet au niveau du schéma
  qui référence l'intégration API :

  ```sql theme={null}
  CREATE EXTERNAL MCP SERVER honeydew
    WITH DISPLAY_NAME = 'Honeydew MCP Server'
    URL = 'https://mcp.honeydew.cloud/mcp'
    API_INTEGRATION = honeydew_mcp_integration;
  ```
</Step>

<Step title="Grant access">
  Accordez l'utilisation de l'intégration et du serveur MCP
  à tous les rôles qui ont besoin d'accéder à Honeydew :

  ```sql theme={null}
  GRANT USAGE ON INTEGRATION honeydew_mcp_integration TO ROLE <role>;
  GRANT USAGE ON EXTERNAL MCP SERVER honeydew TO ROLE <role>;
  ```
</Step>

<Step title="Add the MCP server to an agent">
  Ajoutez le serveur MCP `honeydew` comme outil à un Cortex Agent
  ou à un agent Snowflake Intelligence.
  Les utilisateurs sont invités à s'authentifier avec OAuth auprès de Honeydew lors de la première utilisation.
</Step>

Remarque

Le serveur Documentation MCP Honeydew autonome n'est pas pris en charge dans Snowflake, car les serveurs MCP externes Snowflake exigent une authentification OAuth et le serveur de documentation n'est pas authentifié. L'accès à la documentation est disponible via les outils de documentation du serveur MCP Honeydew.

Suppression du serveur MCP

Supprimez d'abord le serveur MCP, puis l'intégration API :

DROP MCP SERVER honeydew;
DROP INTEGRATION honeydew_mcp_integration;

Autres clients

Tout client compatible MCP peut se connecter au serveur MCP Honeydew en utilisant le transport HTTP standard.

Utilisez la configuration JSON suivante comme point de départ :

Remarque

Si votre organisation utilise un nom d'hôte Honeydew personnalisé, remplacez https://mcp.honeydew.cloud/mcp par le nom d'hôte de votre locataire. Vous pouvez trouver le nom d'hôte dans Paramètres > Serveur MCP dans 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 " } } ```

Voir URL du serveur, Authentification, et Configuration pour les détails sur chaque paramètre.

Exemple d'utilisation

Une fois connecté, vous pouvez poser à votre assistant IA des questions comme :

« Quelles entités sont disponibles dans le modèle sémantique ? »
« Montre-moi les attributs et les métriques pour l'entité orders »
« Quels domaines sont définis dans le modèle ? »
« Quelles tables sont dans le schéma analytics ? »
« Combien de commandes ont été passées le mois dernier ? »
« Crée une nouvelle métrique pour le revenu total sur l'entité orders »
« Quelle est la valeur moyenne des commandes par région pour le dernier trimestre ? »

Dépannage

Problèmes d'authentification OAuth

Vérifiez que votre client prend en charge OAuth, assurez-vous d'avoir les autorisations nécessaires pour l'espace de travail Honeydew, et tentez une ré-authentification via l'interface de gestion MCP de votre client.

Ré-authentification dans Claude Code

Tapez /mcp, sélectionnez le MCP Honeydew dans la liste, choisissez « Effacer l'authentification » ou « S'authentifier », puis suivez les invites OAuth du navigateur pour vous reconnecter à Honeydew.

Problèmes de connexion

Confirmez que l'URL du serveur MCP correspond à https://mcp.honeydew.cloud/mcp et vérifiez que la syntaxe de configuration MCP de votre client est correcte. Si votre organisation utilise un nom d'hôte personnalisé, vérifiez que l'URL correspond au nom d'hôte de votre locataire qui apparaît dans Paramètres > Serveur MCP dans Honeydew Studio.

Outils manquants

Vérifiez que l'authentification a réussi, contrôlez vos autorisations d'accès à l'espace de travail Honeydew, et examinez la console de votre client pour les messages d'erreur.

La sortie dépasse le nombre maximal de jetons autorisés (Claude)

Dans Claude Code, Claude Desktop et Claude.ai, un appel d'outil peut échouer avec une erreur indiquant que la sortie dépasse le nombre maximal de jetons autorisés. Les outils d'analyse Honeydew tels que monitor_analysis et get_analysis_step_details peuvent renvoyer de grands résultats qui dépassent la limite de sortie MCP de Claude.

Claude avertit lorsque la sortie d'un outil MCP dépasse 10 000 jetons et rejette la sortie au-dessus de la limite par défaut de 25 000 jetons. Pour augmenter la limite, définissez la variable d'environnement MAX_MCP_OUTPUT_TOKENS avant de lancer Claude :

export MAX_MCP_OUTPUT_TOKENS=50000
claude

Voir Limites et avertissements de sortie MCP dans la documentation Claude pour plus de détails.

Pour une assistance supplémentaire, contactez le support Honeydew à support@honeydew.ai.

Outils disponibles

Les outils marqués comme lecture seule ne modifient pas le modèle sémantique ni l'entrepôt de données.

Astuce

Pour n'exposer que les outils en lecture seule, définissez l'en-tête ReadonlyToolsOnly: true dans votre configuration de serveur MCP. Lorsqu'il est activé, le serveur ne renvoie que les outils qui ne modifient pas le modèle sémantique ni l'entrepôt de données.

Session et espace de travail

`list_workspaces`

lecture seule

Liste tous les espaces de travail disponibles. Renvoie le nom de l'espace de travail et le type d'entrepôt de données (snowflake, databricks ou bigquery). Utilisez le type d'entrepôt de données pour informer l'implémentation du modèle sémantique.

`list_workspace_branches`

lecture seule

Liste toutes les branches disponibles pour un espace de travail.

Le nom de l'espace de travail.

`get_session_workspace_and_branch`

lecture seule

Obtient l'espace de travail et la branche définis pour la session en cours.

`set_session_workspace_and_branch`

lecture seule

Définit l'espace de travail et la branche à utiliser pour la session en cours. Tous les appels d'outils suivants dans la session utilisent cet espace de travail et cette branche.

Le nom de l'espace de travail. La branche à utiliser.

`create_workspace_branch`

Crée une nouvelle branche pour un espace de travail existant. La branche est créée à partir de l'état actuel de la branche prod de l'espace de travail. Si aucun espace de travail n'est épinglé via les en-têtes, la session bascule automatiquement vers la nouvelle branche.

Nom de l'espace de travail pour lequel créer une branche. Nom de la nouvelle branche à créer.

`delete_workspace_branch`

Supprime une branche d'un espace de travail. Il s'agit d'une opération destructive et irréversible. Confirmez toujours le nom de l'espace de travail et le nom de la branche avec l'utilisateur avant d'appeler cet outil. La branche prod ne peut pas être supprimée. Si la branche supprimée est la branche de session actuelle, la session bascule automatiquement vers prod.

Nom de l'espace de travail contenant la branche à supprimer. Nom de la branche à supprimer.

`get_branch_history`

lecture seule

Obtient l'historique des modifications pour la branche de la session en cours. Renvoie une liste de modifications montrant quels objets sémantiques ont été modifiés, par qui et quand.

Nombre maximal de modifications à renvoyer.

`create_pr_for_working_branch`

Crée une demande de tirage (pull request) pour la branche de travail de la session en cours. Renvoie l'URL de la demande de tirage en cas de succès.

Titre de la demande de tirage. Description de la demande de tirage.

Question et analyse

`initiate_analysis`

lecture seule

Démarre ou continue une analyse de données. Renvoie un conversation_id — utilisez monitor_analysis pour interroger la progression et les résultats, et abort_analysis pour l'arrêter prématurément. Voir Analyse approfondie pour plus de détails.

La question en langage naturel à poser. Nom de l'agent pour une nouvelle conversation. Omettez pour les questions de suivi — l'agent est hérité de la conversation existante. ID de conversation existant pour continuer, ou omettez pour démarrer une nouvelle conversation.

`monitor_analysis`

lecture seule

Interroge les nouveaux messages de progression d'une analyse en cours. Chaque appel ne renvoie que les messages depuis le dernier appel. Interrogez de manière répétée jusqu'à ce que status soit DONE ou NO_CHAT_CURRENTLY_RUNNING.

ID de conversation renvoyé par `initiate_analysis`. Nombre maximal de messages à renvoyer par appel. ID de message à partir duquel rejouer. Utilisez `last_received_message_id` d'un résultat précédent pour récupérer les messages manqués.

`get_analysis_step_details`

lecture seule

Récupère les détails complets d'une étape d'analyse spécifique, y compris la requête sémantique, l'instruction SQL, le contexte utilisé, et les données récupérées à cette étape.

ID de conversation renvoyé par `initiate_analysis`. ID d'étape de `monitor_analysis` (par exemple `STEP/0`).

`abort_analysis`

lecture seule

Interrompt une analyse en cours. Peut être repris à partir du point d'interruption avec initiate_analysis.

ID de conversation renvoyé par `initiate_analysis`.

`list_analysis_chats`

lecture seule

Renvoie une liste paginée des conversations d'analyse pour l'espace de travail actuel, triées par date de création (les plus récentes d'abord). Les administrateurs voient toutes les conversations ; les non-administrateurs ne voient que les leurs. Chaque entrée inclut l'ID de conversation, le titre, les commentaires de l'utilisateur, le domaine, l'agent, la date de création et le nom d'affichage de l'utilisateur qui l'a créée.

Nombre maximal de conversations à renvoyer. Nombre de conversations à ignorer pour la pagination.

`provide_analysis_feedback`

Définit ou efface les commentaires sur une conversation d'analyse spécifique. Il y a une seule entrée de commentaires par conversation (pas par question) — elle doit refléter la qualité globale de l'ensemble du flux de conversation.

Appelez ceci après que monitor_analysis soit terminé et que l'utilisateur exprime sa satisfaction ou son insatisfaction quant au résultat. Utilisez une chaîne affirmative courte pour les commentaires positifs (par exemple Good), ou le format <Reason>: <details> pour les commentaires négatifs, où Reason est l'un de Chart Issue, Data Issue, Wrong Judgement ou Other.

ID de conversation de la conversation d'analyse. Texte de commentaire à stocker, ou `null` pour effacer les commentaires existants.

`get_stored_conversation`

lecture seule

Renvoie tous les messages d'une conversation d'analyse existante. Utilisez ceci pour examiner le contenu complet d'une conversation précédente. is_complete dans la réponse indique si la conversation a atteint un état terminal.

ID de conversation de `list_analysis_chats`. Si `true`, incluez les entrées de progression `step_start` et `step_insight`. Si `false`, ne renvoyez que les réponses finales et les messages de plan/interprétation.

Parcourir et découvrir

`list_entities`

lecture seule

Liste toutes les entités du modèle sémantique avec leurs noms, descriptions et clés.

`get_entity`

lecture seule

Obtient des informations détaillées sur une entité, y compris ses attributs, métriques, ensembles de données, relations et définition YAML. Le nom de l'entité.

`get_field`

lecture seule

Obtenez des informations détaillées sur un champ spécifique (attribut ou métrique) au sein d'une entité, y compris sa définition YAML.

Le nom de l'entité contenant le champ. Le nom du champ.

`list_domains`

lecture seule

Listez tous les domaines du modèle sémantique avec leurs noms, descriptions et entités.

`get_domain`

lecture seule

Obtenez des informations détaillées sur un domaine, y compris ses entités, filtres, paramètres et sa définition YAML.

Le nom du domaine.

`search_model`

lecture seule

Recherchez dans le modèle sémantique les entités, attributs, métriques, jeux de données, jeux de données dynamiques, domaines et paramètres globaux correspondant à une chaîne de requête.

Utilisez la syntaxe entity.field pour limiter la recherche aux champs d'une entité spécifique. Par exemple, customers.balance trouve le champ balance sur les entités correspondant à customers ; customers. renvoie tous les champs des entités correspondantes. En mode OR/AND, les correspondances partielles s'appliquent à la fois à l'entité et au champ — cust.bal correspond à customers.balance.

La chaîne de requête de recherche. Contrôle la manière dont la requête est mise en correspondance :

OR — divise par espaces, renvoie les objets correspondant à n'importe quel mot.
AND — divise par espaces, renvoie uniquement les objets correspondant à tous les mots.
EXACT — utilise la chaîne complète telle quelle, renvoie les objets dont le nom, le nom d'affichage ou l'étiquette correspond exactement.

Découverte de l'entrepôt de données

`list_databases`

lecture seule

Listez toutes les bases de données disponibles dans l'entrepôt de données connecté.

`list_schemas`

lecture seule

Listez tous les schémas d'une base de données spécifique dans l'entrepôt de données connecté.

Le nom de la base de données.

`list_tables`

lecture seule

Listez les tables/vues dans une base de données et un schéma spécifiques de l'entrepôt de données connecté.

Le nom de la base de données. Le nom du schéma.

`get_table_info`

lecture seule

Obtenez des informations détaillées sur une table/vue de l'entrepôt, y compris ses colonnes et métadonnées.

Le nom de la base de données. Le nom du schéma. Le nom de la table.

Modèle sémantique

`import_tables`

Importez des tables de l'entrepôt de données connecté dans le modèle sémantique. Chaque table devient une entité avec ses colonnes comme attributs.

Liste des noms de tables entièrement qualifiés au format `database.schema.table`.

`create_entity`

Créez une nouvelle entité dans le modèle sémantique à partir de définitions YAML.

La définition YAML de l'entité. La définition YAML du jeu de données.

`create_object`

Créez un nouvel objet de modèle sémantique à partir d'une définition YAML. Types pris en charge : attribut calculé, métrique, jeu de données dynamique, domaine et paramètre global.

La définition YAML de l'objet. Créez l'objet même si la validation produit des erreurs.

`update_object`

Mettez à jour un objet de modèle sémantique existant à partir d'une définition YAML. Types pris en charge : entité, attribut calculé, métrique, jeu de données, jeu de données dynamique, domaine et paramètre global.

La définition YAML de l'objet. La clé de l'objet à mettre à jour. Mettez à jour l'objet même si la validation produit des erreurs.

`validate_object`

lecture seule

Validez une définition YAML d'objet de modèle sémantique sans la créer ni la mettre à jour. Types pris en charge : entité, attribut calculé, métrique, jeu de données, jeu de données dynamique, domaine et paramètre global.

La définition YAML à valider. La clé de l'objet à valider.

`delete_object`

Supprimez un objet de modèle sémantique par sa clé.

La clé de l'objet à supprimer. Supprimez l'objet même si la validation produit des erreurs.

Agents

`list_agents`

lecture seule

Listez tous les agents avec leurs noms, descriptions, domaines et références de contexte.

`get_agent`

lecture seule

Obtenez des informations détaillées sur un agent, y compris sa définition YAML en frontmatter.

Nom de l'agent à récupérer.

`create_agent`

Créez un nouvel agent.

Métadonnées du nouvel agent. Nom hiérarchique (par exemple, `growth-analyst`, `finance/budget-analyst`).

<ParamField body="display_name" type="string" required>
  Nom lisible affiché dans l'interface utilisateur.
</ParamField>

<ParamField body="description" type="string" required>
  Description de l'objectif et des capacités de l'agent.
</ParamField>

<ParamField body="domain" type="string" required>
  Le domaine dans lequel cet agent opère.
</ParamField>

<ParamField body="welcome_message" type="string">
  Message d'introduction affiché lorsqu'un utilisateur démarre une session.
</ParamField>

<ParamField body="sample_questions" type="string[]">
  Exemples de questions affichées aux utilisateurs.
</ParamField>

<ParamField body="context" type="string[]">
  Noms d'éléments de contexte ou modèles glob à charger dans les sessions
  (par exemple, `skills/**`, `knowledge/marketing/**`).
</ParamField>

<ParamField body="owner" type="string">
  Identifiant du propriétaire de l'agent.
</ParamField>

Corps Markdown ajouté après le frontmatter. Ce texte est injecté dans l'invite avant chaque session d'analyse. Créez l'agent même si la validation produit des erreurs.

`update_agent`

Mettez à jour un agent existant.

Nom de l'agent à mettre à jour. Définition complète de l'agent mis à jour. Tous les champs obligatoires de `create_agent` doivent être fournis — il s'agit d'un remplacement complet, pas d'une mise à jour partielle. Corps Markdown mis à jour pour l'agent. Mettez à jour l'agent même si la validation produit des erreurs.

`delete_agent`

Supprimez un agent par son nom.

Nom de l'agent à supprimer.

Éléments de contexte

`list_context_items`

lecture seule

Listez tous les éléments de contexte avec leurs types, noms, titres et valeurs de sous-type.

`get_context_item`

lecture seule

Obtenez un élément de contexte par son nom.

Nom de l'élément de contexte à récupérer.

`create_context_item`

Créez un nouvel élément de contexte. Prend en charge les types instruction et mémoire.

Métadonnées du nouvel élément de contexte. Doit être `instruction`.

<ParamField body="name" type="string" required>
  Nom hiérarchique
  (par exemple, `knowledge/customer/churn-analysis`, `skills/reporting`).
</ParamField>

<ParamField body="subtype" type="string" required>
  L'un des `knowledge`, `skill` ou `instruction`.
</ParamField>

<ParamField body="title" type="string" required>
  Titre lisible pour l'élément de contexte.
</ParamField>

<ParamField body="apply" type="string" required>
  Quand appliquer le contexte : `always` ou `on_demand`.
</ParamField>

<ParamField body="description" type="string">
  Description utilisée par l'IA pour décider quand charger cet élément
  (obligatoire lorsque `apply` est `on_demand`).
</ParamField>

<ParamField body="owner" type="string">
  Identifiant du propriétaire.
</ParamField>

<ParamField body="labels" type="string[]">
  Étiquettes pour organiser les éléments de contexte.
</ParamField>

<ParamField body="related_objects" type="object[]">
  Objets sémantiques auxquels cet élément de contexte est lié.
  Chaque objet a un `name` (chaîne) et un `type` (`domain`, `entity` ou `field`).
</ParamField>

<ParamField body="external_source" type="object">
  Source externe pour récupérer le contenu (pour le sous-type `knowledge`).
  Possède `tool` (nom de l'outil MCP), `resource_id` (identifiant dans l'outil externe)
  et un `cache_max_age_in_seconds` facultatif (défaut : `3600`).
</ParamField>

Doit être `memory`.

<ParamField body="name" type="string" required>
  Nom hiérarchique (par exemple, `events/q4-launch`, `2024/pricing-decision`).
</ParamField>

<ParamField body="subtype" type="string" required>
  L'un des `event` ou `decision_trace`.
</ParamField>

<ParamField body="title" type="string" required>
  Titre lisible pour l'élément de contexte.
</ParamField>

<ParamField body="apply" type="string" required>
  Quand appliquer le contexte : `always` ou `on_demand`.
</ParamField>

<ParamField body="from_date" type="string" required>
  Date de début de la période de mémoire au format ISO (par exemple, `2024-01-01`).
</ParamField>

<ParamField body="to_date" type="string">
  Date de fin de la période de mémoire au format ISO.
</ParamField>

<ParamField body="description" type="string">
  Description utilisée par l'IA pour décider quand charger cet élément
  (obligatoire lorsque `apply` est `on_demand`).
</ParamField>

<ParamField body="owner" type="string">
  Identifiant du propriétaire.
</ParamField>

<ParamField body="labels" type="string[]">
  Étiquettes pour organiser les éléments de contexte.
</ParamField>

<ParamField body="related_objects" type="object[]">
  Objets sémantiques auxquels cet élément de contexte est lié.
  Chaque objet a un `name` (chaîne) et un `type` (`domain`, `entity` ou `field`).
</ParamField>

<ParamField body="external_source" type="object">
  Source externe pour récupérer le contenu.
  Possède `tool` (nom de l'outil MCP), `resource_id` (identifiant dans l'outil externe)
  et un `cache_max_age_in_seconds` facultatif (défaut : `3600`).
</ParamField>

Corps Markdown pour le contenu de l'élément de contexte. Créez l'élément de contexte même si la validation produit des erreurs.

`update_context_item`

Mettez à jour un élément de contexte existant.

Nom de l'élément de contexte à mettre à jour. Définition complète de l'élément de contexte mis à jour. Tous les champs obligatoires de `create_context_item` doivent être fournis — il s'agit d'un remplacement complet, pas d'une mise à jour partielle. Corps Markdown mis à jour pour l'élément de contexte. Mettez à jour l'élément de contexte même si la validation produit des erreurs.

`delete_context_item`

Supprimez un élément de contexte par son nom.

Nom de l'élément de contexte à supprimer.

Requête et aperçu

`get_sql_from_fields`

lecture seule

Générez la requête SQL pour une requête de couche sémantique définie par des attributs, des métriques et des filtres. Renvoie le SQL sans l'exécuter.

Noms d'attributs entièrement qualifiés (`entity.attribute_name`). Prend en charge les alias : `entity.attribute_name as alias_name`. Noms de métriques entièrement qualifiés (`entity.metric_name`) ou expressions SQL (par exemple `SUM(entity.field)`). Prend en charge les alias : `SUM(entity.field) as total`. Conditions de filtre (par exemple `entity.field = 'value'`, `entity.date_field > '2024-01-01'`). Liste des champs pour le tri. Format : `entity.field_name` ou `entity.field_name DESC`. La direction par défaut est ASC. Lorsque vous utilisez des alias, triez par le nom de l'alias. Le domaine à interroger. Nombre maximal de lignes à renvoyer. Nombre de lignes à ignorer pour la pagination. Ajoutez un [rapport de pré-agrégation](/docs/performance/aggregate-awareness#debugging-aggregate-matching) en haut du SQL renvoyé, indiquant pour chaque pré-agrégation de l'espace de travail quel CTE l'a utilisée ou pourquoi elle n'a pas pu être utilisée.

`get_data_from_fields`

lecture seule

Exécute une requête de couche sémantique définie par des attributs, des métriques et des filtres, et renvoie les données résultantes.

Noms d'attributs entièrement qualifiés (`entity.attribute_name`). Prend en charge les alias : `entity.attribute_name as alias_name`. Noms de métriques entièrement qualifiés (`entity.metric_name`) ou expressions SQL (par ex. `SUM(entity.field)`). Prend en charge les alias : `SUM(entity.field) as total`. Conditions de filtre (par ex. `entity.field = 'value'`, `entity.date_field > '2024-01-01'`). Liste des champs pour le tri. Format : `entity.field_name` ou `entity.field_name DESC`. La direction par défaut est ASC. Lorsque vous utilisez des alias, triez par le nom de l'alias. Le domaine à interroger. Nombre maximal de lignes à renvoyer. Nombre de lignes à ignorer pour la pagination.

`list_query_history`

lecture seule

Liste les requêtes précédemment exécutées via la couche sémantique Honeydew, de la plus récente à la plus ancienne. Utilisez-la pour trouver et trier les requêtes ayant échoué et comprendre pourquoi elles ont échoué. Les appelants non administrateurs ne voient que leurs propres requêtes.

Chaque requête inclut son statut, son message d'erreur, son propriétaire, son client, son domaine, le SQL d'entrée d'origine (le SQL soumis par l'utilisateur pour les requêtes d'interface SQL), les horodatages de compilation et d'exécution dans l'entrepôt, l'ID de requête de l'entrepôt de données, et un lien pour l'ouvrir dans l'application Honeydew.

Filtrer par statut de requête (`FAILED`, `SUCCESS`, `RUNNING` ou `CANCELED`). Filtrer par le client qui a exécuté la requête (par ex. `Snowflake`, `MCP`). Filtrer par nom de domaine. Filtrer par propriétaire de la requête (l'e-mail d'un utilisateur, ou le nom d'une clé API). Uniquement honoré pour les appelants administrateurs ; les non-administrateurs sont limités à leurs propres requêtes. Uniquement les requêtes exécutées à ou après cette heure (ISO 8601). Uniquement les requêtes exécutées à ou avant cette heure (ISO 8601). Renvoie également la définition YAML sémantique de chaque requête (attributs, métriques, filtres). Activez pour reproduire ou modifier une requête. Renvoie également le SQL d'entrepôt compilé de chaque requête (volumineux). Activez pour le débogage côté entrepôt d'une requête spécifique. Nombre maximal de requêtes à renvoyer. Nombre de requêtes à ignorer pour la pagination.

Documentation

`search_docs`

lecture seule

Recherchez dans la base de connaissances de la documentation Honeydew des informations pertinentes, des exemples de code, des références API et des guides. Renvoie un contenu contextuel avec des titres et des liens vers les pages de documentation. Pour lire le contenu complet d'une page, utilisez query_docs_filesystem.

La requête de recherche.

`query_docs_filesystem`

lecture seule

Exécute une commande de type shell en lecture seule sur un système de fichiers virtuel en mémoire qui contient les pages de documentation Honeydew et les spécifications OpenAPI. Prend en charge des commandes telles que rg, grep, find, tree, ls, cat, head et tail. Utilisez-la pour une correspondance exacte de mots-clés ou d'expressions régulières, une exploration structurelle, ou la lecture du contenu complet d'une page spécifique par chemin.

La commande shell à exécuter (par ex. `rg -il "keyword" /`, `tree / -L 2`, `head -80 /path/page.mdx`).

FAQ

Quels outils sont nécessaires pour une analyse approfondie ?

L'exécution d'une analyse approfondie nécessite :

Configuration de session : list_workspaces, list_workspace_branches, get_session_workspace_and_branch, set_session_workspace_and_branch
Sélection de l'agent : list_agents, get_agent
Analyse : initiate_analysis, monitor_analysis, get_analysis_step_details, abort_analysis
Retour d'information : provide_analysis_feedback

Pour examiner les conversations d'analyse passées, activez également list_analysis_chats et get_stored_conversation.

Limiter l'agent à ces outils est utile lorsque :

Vos utilisateurs prévus n'exécutent que des flux de travail d'analyse approfondie
Vous souhaitez garder l'agent concentré sur les tâches d'analyse
Votre client limite le nombre d'outils pouvant être activés (par exemple, Databricks Genie Code)

Pour d'autres cas d'utilisation, exposez davantage d'outils listés sous Outils disponibles — l'agent sélectionne l'outil approprié pour chaque tâche.