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.

Que pouvez-vous faire avec Honeydew Semantic Layer MCP ?

  • Découvrir les tables et schémas de l'entrepôt — explorez la structure de votre entrepôt de données et les définitions du modèle sémantique via une conversation naturelle.
  • Construire et maintenir des modèles sémantiques — créez ou mettez à jour des définitions de modèles sémantiques à l'aide de create_workspace_branch et d'autres outils de session.
  • Interroger les données en langage naturel — posez des questions sur vos données et obtenez des réponses sans écrire de SQL.
  • Rechercher dans la documentation Honeydew — consultez directement la documentation produit depuis n'importe quel assistant compatible MCP.

Documentation

Serveur MCP

Qu'est-ce que MCP ?

Model Context Protocol (MCP) est un standard open source pour connecter de manière sécurisée 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 via une 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 à l'adresse https://mcp.honeydew.cloud/mcp

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 tenant. 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é à :

  1. Vous connecter avec votre compte Honeydew
  2. Accepter l'autorisation OAuth

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

Authentification HTTP Basic

Le serveur MCP en mode d'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.

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 la configuration de votre 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 à partir de 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)
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](https://modelcontextprotocol.io/specification/2025-06-18/basic/transports#session-management) pour plus de détails.

Clients pris en charge

Claude Code CLI

#### Installation du plugin **Nécessite Git.** L'installation du plugin depuis GitHub clone le dépôt localement, donc [Git](https://git-scm.com/downloads) doit être installé et présent dans votre `PATH`. Si Git est manquant, 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 construire des modèles sémantiques et analyser des données via une conversation naturelle. L'installation du plugin configure automatiquement les serveurs MCP Honeydew.

Lancez Claude Code avec claude, puis ajoutez la marketplace :

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

Ensuite, installez le plugin Honeydew depuis la marketplace :

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

Puis rechargez les plugins pour les activer :

/reload-plugins

Mise à jour des plugins

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

  1. Écrivez /plugin et sélectionnez Marketplaces dans le sélecteur en haut
  2. Sélectionnez honeydew-ai-coding-agents-plugins
  3. Cliquez sur Mettre à jour la marketplace

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

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 :

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

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

      Puis 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>
**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 des variables d'environnement](https://code.claude.com/docs/en/mcp#environment-variable-expansion-in-mcp-json)
en utilisant la syntaxe `${VAR_NAME}`.

Définissez la variable d'environnement `HONEYDEW_API_KEY`,
puis référencez-la dans votre configuration :

```bash theme={null}
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}`
à l'exécution à partir de votre environnement.

MCP Documentation 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 le MCP Documentation 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 MCP Documentation Honeydew :

claude mcp remove honeydew-docs

Claude Desktop

#### Installation du plugin **Nécessite Git.** L'installation du plugin depuis GitHub clone le dépôt localement, donc [Git](https://git-scm.com/downloads) doit être installé et présent dans votre `PATH`. Si Git est manquant, 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 construire des modèles sémantiques et analyser des données via une conversation naturelle. L'installation du plugin configure automatiquement les serveurs MCP Honeydew.

  1. Allez dans Paramètres -> Personnaliser
  2. Cliquez sur Parcourir les plugins
  3. Allez dans l'onglet Personnel
  4. Cliquez sur l'icône + et choisissez Ajouter une marketplace depuis GitHub
  5. Entrez honeydew-ai/honeydew-ai-coding-agents-plugins dans la zone de saisie
  6. Le plugin Honeydew AI apparaît. Installez-le.

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 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 de Claude Code CLI.

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 tenant. Vous pouvez trouver le nom d'hôte dans **Paramètres > Serveur MCP** dans Honeydew Studio.

Pour ajouter le MCP Honeydew en mode Cowork :

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

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

MCP Documentation 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 le MCP Documentation Honeydew uniquement si vous souhaitez un accès à la documentation sans vous connecter à Honeydew. Aucune authentification n'est requise.

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

Suppression du serveur MCP

Pour supprimer le serveur MCP Honeydew en mode Cowork :

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

Pour supprimer le serveur MCP Documentation Honeydew :

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

Claude.ai

#### Installation 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 via une conversation naturelle. L'installation du plugin configure automatiquement le serveur MCP Honeydew et le serveur MCP Documentation Honeydew.

  1. Téléchargez le zip du plugin : honeydew-ai-claude.zip
  2. Dans Claude.ai, allez dans Paramètres -> Plugins -> Ajouter un plugin -> Télécharger un zip
  3. Téléchargez le zip — le plugin apparaît dans votre marketplace 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.

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 tenant. Vous pouvez trouver le nom d'hôte dans **Paramètres > Serveur MCP** dans Honeydew Studio.

Pour ajouter le serveur MCP Honeydew :

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

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

Honeydew Documentation MCP (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 le Honeydew Documentation MCP uniquement si vous souhaitez un accès à la documentation sans vous connecter à Honeydew. Aucune authentification n'est requise.

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

Suppression du serveur MCP

Pour supprimer le serveur MCP Honeydew :

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

Pour supprimer le serveur MCP Honeydew Documentation :

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

Cortex Code CLI

#### Installation du plugin **Nécessite Git.** L'installation du plugin depuis GitHub clone le dépôt localement, donc [Git](https://git-scm.com/downloads) doit être installé et présent dans votre `PATH`. Si Git est manquant, l'installation du plugin échoue. Installez Git, ou utilisez les étapes de configuration manuelle MCP 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 Cortex Code CLI avec cortex, puis installez le plugin :

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

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 Cortex Code 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.

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

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

      Puis 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 (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 le Honeydew Documentation MCP uniquement si vous souhaitez un accès à la documentation sans vous connecter à Honeydew. Aucune authentification n'est requise.

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 MCP Honeydew Documentation :

cortex mcp remove honeydew-docs

Cortex Code Desktop

#### Installation du plugin **Nécessite Git.** L'installation du plugin depuis GitHub clone le dépôt localement, donc [Git](https://git-scm.com/downloads) doit être installé et présent dans votre `PATH`. Si Git est manquant, l'installation du plugin échoue. Installez Git, ou utilisez les étapes de configuration manuelle MCP 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.

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

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 Cortex Code 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.

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 entrer la configuration.

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 (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. Si vous souhaitez un accès à la documentation sans vous connecter à Honeydew, ajoutez le serveur MCP Honeydew Documentation 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

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.

  1. 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)
  2. Faites défiler jusqu'à Marketplaces d'équipe et cliquez sur un Marketplace existant, ou cliquez sur Ajouter un Marketplace pour en créer un nouveau. Si vous en créez un nouveau, saisissez un nom et créez-le.
  3. 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
  4. Optionnellement, activez l'actualisation automatique dans la page du Marketplace pour que le plugin se mette à jour automatiquement lorsque de nouvelles versions sont publiées.
  5. Retournez à la page des plugins (cursor.com/dashboard/plugins), recherchez le plugin Honeydew, et cliquez sur Ajouter

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 Cursor à 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.

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 :

  1. Ouvrez l'application Cursor

  2. Allez dans Paramètres -> Paramètres Cursor -> Outils & MCP

  3. Cliquez sur Nouveau serveur MCP

  4. 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>
    
  5. Cliquez sur Enregistrer

Honeydew Documentation MCP (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 le Honeydew Documentation MCP uniquement si vous souhaitez un accès à la documentation sans vous connecter à Honeydew. Aucune authentification n'est requise.

  1. Allez dans Paramètres -> Paramètres Cursor -> Outils & MCP
  2. Cliquez sur Nouveau serveur MCP
  3. Ajoutez la configuration suivante :
    {
      "name": "honeydew-docs",
      "type": "http",
      "url": "https://honeydew.ai/docs/mcp"
    }
    
  4. Cliquez sur Enregistrer

Suppression du serveur MCP

Pour supprimer le serveur MCP Honeydew :

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

Pour supprimer le serveur MCP Honeydew Documentation :

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

Databricks Genie Code

Les serveurs MCP sont uniquement pris en charge en mode Agent Genie Code. Pour plus de détails, consultez la [documentation Databricks MCP](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 metastore Unity Catalog

    1. Accédez à **Catalogue** → **Connexions** → **Créer une connexion** 2. Sur l'écran **Bases de 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>
    
    Si votre organisation utilise un nom d'hôte Honeydew personnalisé, remplacez `https://mcp.honeydew.cloud` par le nom d'hôte de votre tenant. Vous pouvez trouver votre nom d'hôte dans **Paramètres > Serveur MCP** dans Honeydew Studio. Accédez à **Catalogue** → **Connexions** → `honeydew-mcp` et cliquez sur **Connexion** dans le coin supérieur droit pour vous authentifier et vérifier la connexion. Accordez le privilège `USE CONNECTION` à tous les utilisateurs ou rôles qui ont besoin d'accéder au serveur MCP Honeydew :
    GRANT USE CONNECTION ON CONNECTION `honeydew-mcp` TO <user-or-role>;
    
    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** 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 :

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

Pour supprimer également 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.

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 tenant. Vous pouvez trouver le nom d'hôte dans **Paramètres > Serveur MCP** dans Honeydew Studio.

Pour ajouter le serveur MCP Honeydew :

  1. Allez dans Paramètres -> Connexions -> Serveurs MCP

  2. Cliquez sur Ajouter un MCP personnalisé

  3. Entrez honeydew dans le champ Nom du serveur

  4. Ajoutez éventuellement une icône et une Description courte

  5. Choisissez HTTP comme type de transport

  6. Entrez https://mcp.honeydew.cloud/mcp dans le champ URL du serveur

  7. 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>
    
  8. Cliquez sur Enregistrer, puis cliquez sur Tester la liste des outils pour vérifier la connexion

MCP de documentation 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 le MCP de documentation Honeydew uniquement si vous souhaitez un accès à la documentation sans vous connecter à Honeydew. Aucune authentification n'est requise.

  1. Allez dans Paramètres -> Connexions -> Serveurs MCP
  2. Cliquez sur Ajouter un MCP personnalisé
  3. Entrez honeydew-docs dans le champ Nom du serveur
  4. Choisissez HTTP comme type de transport
  5. Entrez https://honeydew.ai/docs/mcp dans le champ URL du serveur
  6. Définissez la méthode d'authentification sur Aucune
  7. Cliquez sur Enregistrer

Suppression du serveur MCP

Pour supprimer le serveur MCP Honeydew :

  1. Allez dans Paramètres -> Connexions -> Serveurs MCP
  2. Trouvez le serveur honeydew et supprimez-le

Pour supprimer le serveur MCP de documentation Honeydew :

  1. Allez dans Paramètres -> Connexions -> Serveurs MCP
  2. Trouvez le serveur honeydew-docs et supprimez-le

GitHub Copilot CLI

#### Serveur MCP 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 tenant. Vous pouvez trouver le nom d'hôte dans **Paramètres > Serveur MCP** dans Honeydew Studio.
  1. Lancez GitHub Copilot CLI avec copilot

  2. Tapez /mcp add pour ouvrir le formulaire de configuration du serveur

  3. 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 " } ```
  4. Appuyez sur Ctrl+S pour enregistrer

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

Plugins d'agent de codage IA

**Nécessite Git.** L'installation du plugin depuis GitHub clone le dépôt localement, donc [Git](https://git-scm.com/downloads) doit être installé et présent dans votre `PATH`. Si Git est manquant, l'installation du plugin échoue. Installez Git, ou utilisez les étapes de configuration manuelle MCP 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 le biais de conversations naturelles.

Ajoutez le marketplace à Copilot CLI :

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

Ensuite, installez le plugin Honeydew depuis le marketplace :

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

MCP de documentation 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 le MCP de documentation Honeydew uniquement si vous souhaitez un accès à la documentation sans vous connecter à Honeydew. Aucune authentification n'est requise.

  1. Lancez GitHub Copilot CLI avec copilot
  2. Tapez /mcp add pour ouvrir le formulaire de configuration du serveur
  3. Remplissez les champs suivants :
    • Nom : honeydew-docs
    • Type : http
    • URL : https://honeydew.ai/docs/mcp
  4. 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 **Nécessite Git.** L'installation du plugin depuis GitHub clone le dépôt localement, donc [Git](https://git-scm.com/downloads) doit être installé et présent dans votre `PATH`. Si Git est manquant, l'installation du plugin échoue. Installez Git, ou utilisez les étapes de configuration manuelle MCP 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 le biais de conversations naturelles. 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.

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 tenant. 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 (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 le MCP de documentation Honeydew uniquement si vous souhaitez un accès à la documentation sans vous connecter à Honeydew. Aucune authentification n'est requise.

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

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 le biais de conversations naturelles. L'installation du plugin configure automatiquement les serveurs MCP Honeydew.

Ajouter le marketplace Honeydew

  1. 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))
  2. Ajoutez le marketplace Honeydew au paramètre chat.plugins.marketplaces :
    "chat.plugins.marketplaces": [
      "honeydew-ai/honeydew-ai-coding-agents-plugins"
    ]
    

Installer le plugin

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

La première fois que vous installez un plugin depuis un nouveau marketplace, VS Code affiche une invite de confiance — examinez la source du marketplace avant de confirmer.

Mettre à jour le plugin

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

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

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 tenant. Vous pouvez trouver le nom d'hôte dans **Paramètres > Serveur MCP** dans Honeydew Studio. 1. Ouvrez la palette de commandes avec `CMD+Shift+P` (macOS) ou `Ctrl+Shift+P` (Windows/Linux) 2. Sélectionnez **MCP: Add Server...** 3. Choisissez **HTTP (HTTP or Server-Sent Events)** 4. Saisissez l'URL du serveur MCP Honeydew : `https://mcp.honeydew.cloud/mcp` 5. Saisissez `honeydew` comme nom de 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)

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.

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 **Nécessite Git.** L'installation du plugin depuis GitHub clone le dépôt localement, donc [Git](https://git-scm.com/downloads) doit être installé et présent dans votre `PATH`. Si Git est manquant, 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 construire des modèles sémantiques et analyser des données par le biais de conversations naturelles. L'installation du plugin configure automatiquement les serveurs MCP Honeydew.

Ajoutez la marketplace à 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 marketplace 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

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

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 tenant. Vous pouvez trouver le nom d'hôte dans **Settings > MCP Server** 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 situé dans ~/.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)

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.

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 **Nécessite Git.** L'installation du plugin depuis GitHub clone le dépôt localement, donc [Git](https://git-scm.com/downloads) doit être installé et présent dans votre `PATH`. Si Git est manquant, 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 construire des modèles sémantiques et analyser des données par le biais de conversations naturelles. L'installation du plugin configure automatiquement les serveurs MCP Honeydew.

Ajoutez la marketplace dans Codex :

  1. Ouvrez Plugins
  2. Cliquez sur la flèche déroulante et sélectionnez Add marketplace
  3. Ajoutez honeydew-ai/honeydew-ai-coding-agents-plugins
Vous pouvez également ajouter la marketplace depuis le [Codex CLI](#codex-cli) :
```
codex plugin marketplace add honeydew-ai/honeydew-ai-coding-agents-plugins
```

Installez ensuite le plugin :

  1. Ouvrez Plugins
  2. Sélectionnez la marketplace Honeydew AI
  3. Installez le plugin Honeydew

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.

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 tenant. Vous pouvez trouver le nom d'hôte dans **Settings > MCP Server** dans Honeydew Studio.

Honeydew MCP

  1. Ouvrez l'application Codex

  2. Allez dans Settings -> MCP Servers

  3. Sous Custom servers, cliquez sur Add Server

  4. Définissez le nom du serveur sur honeydew

  5. Choisissez Streamable HTTP comme type de transport

  6. Définissez l'URL sur https://mcp.honeydew.cloud/mcp

  7. Laissez le champ Bearer token environment variable vide

  8. 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 des 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 "Authenticate" n'apparaît pas :

  1. Installez le Codex CLI
  2. Exécutez codex mcp login honeydew

Honeydew Documentation MCP (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 le Honeydew Documentation MCP uniquement si vous souhaitez un accès à la documentation sans vous connecter à Honeydew. Aucune authentification n'est requise.

  1. Allez dans Settings -> MCP Servers
  2. Sous Custom servers, cliquez sur Add Server
  3. Définissez le nom du serveur sur honeydew-docs
  4. Choisissez Streamable HTTP comme type de transport
  5. Définissez l'URL sur https://honeydew.ai/docs/mcp

Suppression du serveur MCP

Pour supprimer le serveur MCP Honeydew :

  1. Allez dans Settings -> MCP Servers
  2. Trouvez honeydew sous Custom servers et cliquez sur Remove

Pour supprimer le serveur Honeydew Documentation MCP :

  1. Allez dans Settings -> MCP Servers
  2. Trouvez honeydew-docs sous Custom servers et cliquez sur Remove

Antigravity

#### Serveur MCP 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 tenant. Vous pouvez trouver le nom d'hôte dans **Settings > MCP Server** dans Honeydew Studio.
  1. Ouvrez l'éditeur Antigravity

  2. Cliquez sur le menu déroulant ... en haut du panneau de l'agent

  3. Cliquez sur Manage MCP Servers

  4. Cliquez sur View raw config

  5. 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>
    
  6. Sauvegardez le fichier

Honeydew Documentation MCP (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 le Honeydew Documentation MCP uniquement si vous souhaitez un accès à la documentation sans vous connecter à Honeydew. Aucune authentification n'est requise.

  1. Ouvrez l'éditeur Antigravity
  2. Cliquez sur le menu déroulant ... en haut du panneau de l'agent
  3. Cliquez sur Manage MCP Servers
  4. Cliquez sur View raw config
  5. Ajoutez ce qui suit à mcp_config.json :
    {
      "name": "honeydew-docs",
      "type": "http",
      "url": "https://honeydew.ai/docs/mcp"
    }
    
  6. Sauvegardez le fichier

Suppression du serveur MCP

Pour supprimer le serveur MCP Honeydew :

  1. Ouvrez l'éditeur Antigravity
  2. Cliquez sur le menu déroulant ... en haut du panneau de l'agent
  3. Cliquez sur Manage MCP Servers
  4. Cliquez sur View raw config
  5. Supprimez les entrées honeydew et honeydew-docs de mcp_config.json
  6. Sauvegardez le fichier

OpenCode

#### Serveur MCP 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 tenant. Vous pouvez trouver le nom d'hôte dans **Settings > MCP Server** 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. **Location** : Choisissez votre portée préférée (projet actuel ou global)
  2. **MCP server name** : `honeydew`
  3. **MCP server type** : `Remote`
  4. **MCP server URL** : `https://mcp.honeydew.cloud/mcp`
  5. **OAuth authentication** : `Yes`
  6. **Preregistered client ID** : `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 votre statut et déconnectez-vous d'abord :

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

Honeydew Documentation MCP (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 le Honeydew Documentation MCP uniquement si vous souhaitez un accès à la documentation sans vous connecter à Honeydew. Aucune authentification n'est requise.

Exécutez `opencode mcp add` et saisissez les valeurs suivantes :
  1. **MCP server name** : `honeydew-docs`
  2. **MCP server type** : `Remote`
  3. **MCP server URL** : `https://honeydew.ai/docs/mcp`
  4. **OAuth authentication** : `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 :

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

Si les deux fichiers existent, la configuration de l'espace de travail est prioritaire. 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 tenant. Vous pouvez trouver le nom d'hôte dans Settings > MCP Server dans Honeydew Studio.

Ajoutez le serveur Honeydew MCP à 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>

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

Dans la 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.

Honeydew Documentation MCP (optionnel)

Le serveur Honeydew MCP inclut déjà des outils d'accès à la documentation, donc un serveur de documentation séparé n'est 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.

Ajoutez ce qui suit à votre mcp.json :

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

Suppression du serveur MCP

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

Snowflake Intelligence

Snowflake se connecte aux serveurs MCP externes via [des connecteurs MCP](https://docs.snowflake.com/en/user-guide/snowflake-cortex/cortex-agents-mcp-connectors), rendant les outils Honeydew disponibles pour Snowflake Intelligence et les 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.

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 tenant. Vous pouvez trouver le nom d'hôte dans **Settings > MCP Server** 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` en tant qu'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>
Le serveur Honeydew Documentation MCP autonome n'est pas pris en charge dans Snowflake, car les serveurs MCP externes Snowflake nécessitent 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 Honeydew MCP.

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 Honeydew MCP en utilisant le transport HTTP standard.

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

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 tenant. Vous pouvez trouver le nom d'hôte dans **Settings > MCP Server** 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 plus de détails sur chaque paramètre.

Exemple d'utilisation

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

  • "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 se trouvent 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 sur 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 Honeydew MCP dans la liste, choisissez "Clear authentication" ou "Authenticate", 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 tenant qui apparaît dans Settings > MCP Server dans Honeydew Studio.

Outils manquants

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

La sortie dépasse le nombre maximal de tokens 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 tokens autorisés. Les outils d'analyse Honeydew tels que monitor_analysis et get_analysis_step_details peuvent renvoyer des résultats volumineux qui dépassent la limite de sortie MCP de Claude.

Claude avertit lorsque la sortie de l'outil MCP dépasse 10 000 tokens et rejette la sortie au-dessus de la limite par défaut de 25 000 tokens. 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 de sortie MCP et avertissements 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 ou l'entrepôt de données.

Pour exposer uniquement les outils en lecture seule, définissez l'en-tête `ReadonlyToolsOnly: true` dans la configuration de votre serveur MCP. Lorsqu'il est activé, le serveur ne renvoie que les outils qui ne modifient pas le modèle sémantique ou 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 la session en cours, 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 pull request pour la branche de travail de la session en cours. Renvoie l'URL de la PR en cas de succès.

Titre de la pull request. Description de la pull request.

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. Omettre pour les questions de suivi — l'agent est hérité de la conversation existante. ID de conversation existant à continuer, ou omettre 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 lors de cette étape.

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

abort_analysis

lecture seule

Abandonne une analyse en cours. Peut être reprise à partir du point d'abandon 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 heure de création (la plus récente en premier). 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, l'heure 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 commentaire par conversation (pas par question) — elle doit refléter la qualité globale du flux de conversation entier.

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 courte chaîne affirmative pour un commentaire positif (par exemple Good), ou le format <Reason>: <details> pour un commentaire négatif, où Reason est l'un de Chart Issue, Data Issue, Wrong Judgement ou Other.

ID de conversation de la conversation d'analyse. Texte du commentaire à stocker, ou `null` pour effacer le commentaire existant.

get_stored_conversation

lecture seule Renvoie tous les messages d'une conversation d'analyse existante. Utilisez ceci pour consulter 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 provenant de `list_analysis_chats`. Si `true`, inclut les entrées de progression `step_start` et `step_insight`. Si `false`, renvoie uniquement 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, jeux de données, relations et définition YAML.

Le nom de l'entité.

get_field

lecture seule

Obtient 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

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

get_domain

lecture seule

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

Le nom du domaine.

search_model

lecture seule

Recherche dans le modèle sémantique des 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 aux parties entité et 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 ou le nom d'affichage est une correspondance exacte.

Découverte de l'entrepôt

list_databases

lecture seule

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

list_schemas

lecture seule

Liste 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

Liste 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

Obtient 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

Importe des tables depuis 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 complets au format `database.schema.table`.

create_entity

Crée 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ée un nouvel objet de modèle sémantique à partir d'une définition YAML. Types pris en charge : attribut, métrique, jeu de données dynamique, domaine et paramètre global.

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

update_object

Met à jour un objet de modèle sémantique existant à partir d'une définition YAML. Types pris en charge : entité, attribut, 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. Met à jour l'objet même si la validation produit des erreurs.

validate_object

lecture seule

Valide une définition YAML d'objet de modèle sémantique sans le créer ni le mettre à jour. Types pris en charge : entité, attribut, 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 par rapport à laquelle valider.

delete_object

Supprime un objet du modèle sémantique par sa clé.

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

Agents

list_agents

lecture seule

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

get_agent

lecture seule

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

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

create_agent

Crée 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 par l'humain 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 présentées aux utilisateurs.
</ParamField>

<ParamField body="context" type="string[]">
  Noms d'éléments de contexte ou motifs 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 le prompt avant chaque session d'analyse. Crée l'agent même si la validation produit des erreurs.

update_agent

Met à jour un agent existant.

Nom de l'agent à mettre à jour. Définition complète mise à jour de l'agent. Tous les champs requis 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. Met à jour l'agent même si la validation produit des erreurs.

delete_agent

Supprime un agent par nom.

Nom de l'agent à supprimer.

Éléments de Contexte

list_context_items

lecture seule

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

get_context_item

lecture seule

Obtient un élément de contexte par nom.

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

create_context_item

Crée 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 de `knowledge`, `skill` ou `instruction`.
</ParamField>

<ParamField body="title" type="string" required>
  Titre lisible par l'humain 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
  (requis 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 se rapporte.
  Chaque objet a un `name` (chaîne) et un `type` (`domain`, `entity` ou `field`).
</ParamField>

<ParamField body="external_source" type="object">
  Source externe depuis laquelle récupérer le contenu (pour le sous-type `knowledge`).
  A un `tool` (nom de l'outil MCP), un `resource_id` (identifiant dans l'outil externe),
  et un `cache_max_age_in_seconds` optionnel (par 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 de `event` ou `decision_trace`.
</ParamField>

<ParamField body="title" type="string" required>
  Titre lisible par l'humain 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
  (requis 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 se rapporte.
  Chaque objet a un `name` (chaîne) et un `type` (`domain`, `entity` ou `field`).
</ParamField>

<ParamField body="external_source" type="object">
  Source externe depuis laquelle récupérer le contenu.
  A un `tool` (nom de l'outil MCP), un `resource_id` (identifiant dans l'outil externe),
  et un `cache_max_age_in_seconds` optionnel (par défaut : `3600`).
</ParamField>
Corps Markdown pour le contenu de l'élément de contexte. Crée l'élément de contexte même si la validation produit des erreurs.

update_context_item

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

Nom de l'élément de contexte à mettre à jour. Définition complète mise à jour de l'élément de contexte. Tous les champs requis 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. Met à jour l'élément de contexte même si la validation produit des erreurs.

delete_context_item

Supprime un élément de contexte par nom.

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

Requête et Aperçu

get_sql_from_fields

lecture seule

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

Noms d'attributs complets (`entity.attribute_name`). Prend en charge les alias : `entity.attribute_name as alias_name`. Noms de métriques complets (`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. En cas d'utilisation d'alias, triez par le nom de l'alias. Le domaine sur lequel exécuter la requête. Nombre maximum de lignes à retourner. Nombre de lignes à ignorer pour la pagination.

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 retourne les données résultantes.

Noms d'attributs complets (`entity.attribute_name`). Prend en charge les alias : `entity.attribute_name as alias_name`. Noms de métriques complets (`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. En cas d'utilisation d'alias, triez par le nom de l'alias. Le domaine sur lequel exécuter la requête. Nombre maximum de lignes à retourner. 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, les plus récentes en premier. Utilisez-la pour trouver et trier les requêtes échouées 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 original (le SQL soumis par l'utilisateur pour les requêtes de l'interface SQL), les horodatages de compilation et d'exécution sur l'entrepôt de données, 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'email d'un utilisateur, ou le nom d'une clé API). Honoré uniquement 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). Retourner également la définition YAML sémantique de chaque requête (attributs, métriques, filtres). Activez pour reproduire ou modifier une requête. Retourner également le SQL compilé de l'entrepôt de données pour chaque requête (volumineux). Activez pour le débogage côté entrepôt d'une requête spécifique. Nombre maximum de requêtes à retourner. Nombre de requêtes à ignorer pour la pagination.

Documentation

search_docs

lecture seule

Recherche dans la base de connaissances de la documentation Honeydew des informations pertinentes, des exemples de code, des références d'API et des guides. Retourne 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 virtualisé 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 par mot-clé ou expression régulière, 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`).