Honeydew Semantic Layer

oficial

La capa semántica de Honeydew proporciona un modelo de datos gobernado y amigable para el negocio que unifica métricas, dimensiones y relaciones entre fuentes, permitiendo análisis de autoservicio consistentes y acceso a datos impulsado por IA.

Ver en honeydew.aiPrueba este MCPPatrocinado

¿Qué puedes hacer con Honeydew Semantic Layer MCP?

Explora los metadatos del almacén — Pídele a tu asistente que descubra tablas, esquemas y definiciones de modelos semánticos en todo tu almacén.
Gestiona modelos semánticos — Crea y mantén tu modelo semántico mediante conversación natural, incluyendo la creación de ramas de espacio de trabajo con create_workspace_branch.
Consulta datos de forma conversacional — Usa lenguaje natural para consultar tus datos desde cualquier asistente compatible con MCP.
Configura el contexto de la sesión — Establece tu espacio de trabajo y rama activos usando set_session_workspace_and_branch después de listar las opciones disponibles con list_workspaces y list_workspace_branches.
Accede a la documentación de Honeydew — Busca y lee la documentación de Honeydew directamente a través de las herramientas de documentación integradas del servidor MCP.

Documentación

Servidor MCP

¿Qué es MCP?

Model Context Protocol (MCP) es un estándar de código abierto para conectar de forma segura aplicaciones de IA con sistemas y herramientas externos. Honeydew proporciona un servidor MCP que conecta tu asistente de codificación con IA a la capa semántica de Honeydew.

Cuándo usarlo

Descubrir y explorar tus tablas del almacén, esquemas y definiciones de modelos semánticos
Construir y mantener tu modelo semántico mediante conversación natural
Consultar tus datos con lenguaje natural desde cualquier asistente compatible con MCP
Buscar y leer la documentación de Honeydew

Instalación

URL del servidor

Honeydew expone la API del servidor MCP en https://mcp.honeydew.cloud/mcp

Nota

Si tu organización utiliza un nombre de host personalizado de Honeydew, reemplaza la URL predeterminada con el nombre de host de tu inquilino. Puedes encontrar el nombre de host en la interfaz de Honeydew en Configuración > Servidor MCP.

Autenticación

Hay dos formas de autenticarse con el servidor MCP de Honeydew: OAuth o autenticación básica HTTP.

Autenticación OAuth (recomendada)

La mayoría de los clientes admiten autenticación OAuth. Cuando te conectes por primera vez, se te pedirá que:

Inicies sesión con tu cuenta de Honeydew
Aceptes la autorización de OAuth

El cliente proporciona entonces de forma segura un token de acceso para solicitudes posteriores.

Autenticación básica HTTP

El servidor MCP en modo de autenticación básica HTTP requiere una clave de API para la autenticación.

Debes proporcionar una cadena codificada en Base64 de tu clave de API y secreto de API en el formato API_KEY:API_SECRET.

Consejo

Si creas una nueva clave de API para el acceso al servidor MCP, puedes copiar la cadena codificada en Base64 desde la interfaz de Honeydew Studio en el momento de la creación.

Puedes usar el siguiente comando para generar la cadena codificada en Base64:

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

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

Proporciona la cadena codificada en el encabezado Authorization de la siguiente manera:

Authorization: Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET>

Configuración

El espacio de trabajo y la rama se establecen a nivel de sesión usando las herramientas list_workspaces, list_workspace_branches y set_session_workspace_and_branch. También puedes crear nuevas ramas con create_workspace_branch. Llama a estas herramientas desde tu asistente de IA después de conectarte al servidor MCP.

Opcionalmente, puedes proporcionar estos encabezados en tu configuración del servidor MCP:

Workspace: Fija el espacio de trabajo para todas las solicitudes (opcional)
Branch: Fija una rama específica del espacio de trabajo para todas las solicitudes (opcional, por defecto prod si el espacio de trabajo está configurado)
Honeydew-Client: Identifica el cliente MCP (opcional, se detecta automáticamente desde la herramienta conectada). Pasa este encabezado para proporcionar un identificador de cliente específico.
ReadonlyToolsOnly: Establécelo en true para exponer solo herramientas de solo lectura (opcional)

Nota

El servidor MCP usa el encabezado de respuesta Mcp-Session-Id para mantener el estado de la sesión, incluidos el espacio de trabajo y la rama activos. Consulta la especificación de gestión de sesiones de MCP para obtener más detalles.

Clientes compatibles

CLI de Claude Code

#### Instalación del plugin

Nota

Requiere Git. Instalar el plugin desde GitHub clona el repositorio localmente, por lo que Git debe estar instalado y en tu PATH. Si falta Git, la instalación del plugin falla. Instala Git, o usa los pasos de configuración manual de MCP de tu cliente para configurar el servidor directamente en lugar del plugin.

Honeydew proporciona un repositorio de plugins con habilidades y herramientas para construir modelos semánticos y analizar datos mediante conversación natural. Instalar el plugin configura automáticamente los servidores MCP de Honeydew.

Inicia Claude Code con claude y luego agrega el marketplace:

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

Luego instala el plugin de Honeydew desde el marketplace:

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

Luego recarga los plugins para activarlos:

/reload-plugins

Actualización de plugins

Para actualizar los plugins del marketplace de Honeydew, inicia Claude Code con claude y luego:

Escribe /plugin y selecciona Marketplaces en el selector de la parte superior
Selecciona honeydew-ai-coding-agents-plugins
Haz clic en Actualizar marketplace

Para recibir actualizaciones automáticamente, selecciona Habilitar actualización automática en la configuración del marketplace.

Configuración de MCP

Usa esta sección si tu organización utiliza un endpoint personalizado de Honeydew, o si prefieres configurar los servidores MCP sin instalar el plugin. Desactiva la conexión MCP de Honeydew agregada por el plugin y luego agrega tu endpoint personalizado usando las instrucciones a continuación.

El servidor MCP de Honeydew conecta Claude Code a la capa semántica de Honeydew para exploración de modelos, consulta de datos, gestión de modelos y acceso a documentación.

Usa uno de los siguientes métodos para agregar el servidor MCP de Honeydew:

Nota

Si tu organización utiliza un nombre de host personalizado de Honeydew, reemplaza https://mcp.honeydew.cloud/mcp con el nombre de host de tu inquilino. Puedes encontrar el nombre de host en Configuración > Servidor MCP en Honeydew Studio.

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

      Inicia Claude Code con `claude`.
      Se te pedirá que te autentiques con OAuth en 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">
  Guarda lo siguiente en `honeydew-mcp.json`:

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

      Luego regístralo con:

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

      Inicia Claude Code con `claude`.
      Se te pedirá que te autentiques con OAuth en 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>"
        }
      }
      ```

      Luego regístralo con:

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

<Tab title=".mcp.json">
  Agrega lo siguiente a tu archivo `.mcp.json`:

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

      Inicia Claude Code con `claude`.
      Se te pedirá que te autentiques con OAuth en 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>

Consejo

Uso de variables de entorno para la autenticación con clave de API

Para evitar almacenar valores sensibles directamente en archivos de configuración, Claude Code admite la expansión de variables de entorno usando la sintaxis ${VAR_NAME}.

Establece la variable de entorno HONEYDEW_API_KEY, y luego haz referencia a ella en tu configuración:
claude mcp add --transport http honeydew \
    https://mcp.honeydew.cloud/mcp \
    --header "Authorization: Basic ${HONEYDEW_API_KEY}"
Claude Code resuelve las referencias ${VAR_NAME} en tiempo de ejecución desde tu entorno.

MCP de documentación de Honeydew (opcional)

El servidor MCP de Honeydew ya incluye herramientas de acceso a documentación, por lo que no se necesita un servidor de documentación separado. Agrega el MCP de documentación de Honeydew solo si deseas acceso a documentación sin conectarte a Honeydew. No se requiere autenticación.

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

Eliminación del servidor MCP

Para eliminar el servidor MCP de Honeydew:

claude mcp remove honeydew

Para eliminar el servidor MCP de documentación de Honeydew:

claude mcp remove honeydew-docs

Claude Desktop

#### Instalación del plugin

Nota

Requiere Git. Instalar el plugin desde GitHub clona el repositorio localmente, por lo que Git debe estar instalado y en tu PATH. Si falta Git, la instalación del plugin falla. Instala Git, o usa los pasos de configuración manual de MCP de tu cliente para configurar el servidor directamente en lugar del plugin.

Ve a Configuración -> Personalizar
Haz clic en Explorar plugins
Ve a la pestaña Personal
Haz clic en el ícono + y elige Agregar marketplace desde GitHub
Ingresa honeydew-ai/honeydew-ai-coding-agents-plugins en el cuadro de entrada
Aparece el plugin Honeydew AI. Instálalo.

Configuración de MCP

El servidor MCP de Honeydew conecta Claude Desktop a la capa semántica de Honeydew para exploración de modelos, consulta de datos, gestión de modelos y acceso a documentación.

Modo Claude Code

Cuando uses Claude Desktop en modo Claude Code, sigue las instrucciones de CLI de Claude Code en su lugar.

Nota

Si tu organización utiliza un nombre de host personalizado de Honeydew, reemplaza https://mcp.honeydew.cloud/mcp con el nombre de host de tu inquilino. Puedes encontrar el nombre de host en Configuración > Servidor MCP en Honeydew Studio.

Para agregar el MCP de Honeydew en modo Cowork:

Ve a Configuración -> Conectores -> Agregar conector personalizado
Ingresa honeydew en el campo Nombre
Ingresa https://mcp.honeydew.cloud/mcp en el campo URL del servidor MCP remoto
Haz clic en Agregar

Se te pedirá que te autentiques con OAuth en Honeydew al conectarte por primera vez.

MCP de documentación de Honeydew (opcional)

Ve a Configuración -> Conectores -> Agregar conector personalizado
Ingresa honeydew-docs en el campo Nombre
Ingresa https://honeydew.ai/docs/mcp en el campo URL del servidor MCP remoto
Haz clic en Agregar

Eliminación del servidor MCP

Para eliminar el servidor MCP de Honeydew en modo Cowork:

Ve a Configuración -> Conectores
Encuentra el conector honeydew y haz clic en el ícono de eliminar

Para eliminar el servidor MCP de documentación de Honeydew:

Ve a Configuración -> Conectores
Encuentra el conector honeydew-docs y haz clic en el ícono de eliminar

Claude.ai

#### Instalación del plugin

Descarga el zip del plugin: honeydew-ai-claude.zip
En Claude.ai, ve a Configuración -> Plugins -> Agregar plugin -> Subir zip
Sube el zip: el plugin aparece en tu marketplace privado

Configuración de MCP

Usa esta sección si tu organización utiliza un endpoint personalizado de Honeydew, o si prefieres configurar los servidores MCP sin instalar el plugin. Elimina el conector MCP de Honeydew agregado por el plugin y luego agrega tu endpoint personalizado usando las instrucciones a continuación.

El servidor MCP de Honeydew conecta Claude.ai a la capa semántica de Honeydew para exploración de modelos, consulta de datos, gestión de modelos y acceso a documentación.

Nota

Si tu organización utiliza un nombre de host personalizado de Honeydew, reemplaza https://mcp.honeydew.cloud/mcp con el nombre de host de tu inquilino. Puedes encontrar el nombre de host en Configuración > Servidor MCP en Honeydew Studio.

Para agregar el servidor MCP de Honeydew:

Ve a Configuración -> Conectores -> Agregar conector personalizado
Ingresa honeydew en el campo Nombre
Ingresa https://mcp.honeydew.cloud/mcp en el campo URL del servidor MCP remoto
Haz clic en Agregar

Se te pedirá que te autentiques con OAuth a Honeydew al conectarte por primera vez.

Honeydew Documentation MCP (opcional)

El servidor MCP de Honeydew ya incluye herramientas de acceso a documentación, por lo que no se necesita un servidor de documentación separado. Agrega el Honeydew Documentation MCP solo si deseas acceso a documentación sin conectarte a Honeydew. No se requiere autenticación.

Ve a Configuración -> Conectores -> Agregar conector personalizado
Ingresa honeydew-docs en el campo Nombre
Ingresa https://honeydew.ai/docs/mcp en el campo URL del servidor MCP remoto
Haz clic en Agregar

Eliminación del servidor MCP

Para eliminar el servidor MCP de Honeydew:

Ve a Configuración -> Conectores
Encuentra el conector honeydew y haz clic en el ícono de eliminar

Para eliminar el servidor Honeydew Documentation MCP:

Ve a Configuración -> Conectores
Encuentra el conector honeydew-docs y haz clic en el ícono de eliminar

Cortex Code CLI

#### Instalación del plugin

Nota

Requiere Git. Instalar el plugin desde GitHub clona el repositorio localmente, por lo que Git debe estar instalado y en tu PATH. Si Git falta, la instalación del plugin falla. Instala Git, o usa los pasos de configuración manual de MCP de tu cliente para configurar el servidor directamente en lugar del plugin.

Inicia Cortex Code CLI con cortex, luego instala el plugin:

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

Configuración de MCP

El servidor MCP de Honeydew conecta Cortex Code CLI con Honeydew Semantic Layer para exploración de modelos, consulta de datos, gestión de modelos y acceso a documentación.

Nota

Si tu organización utiliza un hostname personalizado de Honeydew, reemplaza https://mcp.honeydew.cloud/mcp con el hostname de tu tenant. Puedes encontrar el hostname en Configuración > Servidor MCP en Honeydew Studio.

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

      Inicia Cortex Code CLI con `cortex`.
      Se te pedirá que te autentiques
      con OAuth a 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">
  Guarda lo siguiente en `honeydew-mcp.json`:

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

      Luego regístralo con:

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

      Inicia Cortex Code CLI con `cortex`.
      Se te pedirá que te autentiques
      con OAuth a 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>"
        }
      }
      ```

      Luego regístralo con:

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

<Tab title="mcp.json">
  Agrega lo siguiente a
  `~/.snowflake/cortex/mcp.json`:

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

      Inicia Cortex Code CLI con `cortex`.
      Se te pedirá que te autentiques
      con OAuth a 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 (opcional)

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

Eliminación del servidor MCP

Para eliminar el servidor MCP de Honeydew:

cortex mcp remove honeydew

Para eliminar el servidor Honeydew Documentation MCP:

cortex mcp remove honeydew-docs

Cortex Code Desktop

#### Instalación del plugin

Nota

Requiere Git. Instalar el plugin desde GitHub clona el repositorio localmente, por lo que Git debe estar instalado y en tu PATH. Si Git falta, la instalación del plugin falla. Instala Git, o usa los pasos de configuración manual de MCP de tu cliente para configurar el servidor directamente en lugar del plugin.

Ve a Configuración -> Plugins
Haz clic en Agregar Plugin, selecciona Agregar desde GitHub y pega el repositorio de plugins de Honeydew: honeydew-ai/honeydew-ai-coding-agents-plugins
Sigue el flujo y aprueba los pasos en Configuración del instalador de plugins de GitHub

Configuración de MCP

El servidor MCP de Honeydew conecta Cortex Code Desktop con Honeydew Semantic Layer para exploración de modelos, consulta de datos, gestión de modelos y acceso a documentación.

Para agregar un servidor, ve a MCP -> Nuevo, elige un Alcance de configuración (por ejemplo, ~/.snowflake/cortex/mcp.json para Global), completa el formulario y luego haz clic en Guardar. Usa la pestaña Formulario o JSON para ingresar la configuración.

Nota

Si tu organización utiliza un hostname personalizado de Honeydew, reemplaza https://mcp.honeydew.cloud/mcp con el hostname de tu tenant. Puedes encontrar el hostname en Configuración > Servidor MCP en Honeydew Studio.

Agrega el servidor Honeydew MCP:

1. **Nombre del servidor**: `honeydew` 2. **Tipo de servidor**: **Remoto (HTTP)** 3. **URL del servidor**: `https://mcp.honeydew.cloud/mcp` 4. Haz clic en **Guardar**

      Se te pedirá que te autentiques con OAuth a Honeydew
      al conectarte por primera vez.
    </Tab>

    <Tab title="API Key">
      1. **Nombre del servidor**: `honeydew`
      2. **Tipo de servidor**: **Remoto (HTTP)**
      3. **URL del servidor**: `https://mcp.honeydew.cloud/mcp`
      4. En **Encabezados**, haz clic en **Agregar encabezado** y establece el nombre a
         `Authorization` y el valor a
         `Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET>`
      5. Haz clic en **Guardar**
    </Tab>
  </Tabs>
</Tab>

<Tab title="JSON">
  Cambia a la pestaña **JSON** y pega la configuración:

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

      Se te pedirá que te autentiques con OAuth a Honeydew
      al conectarte por primera vez.
    </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 (opcional)

El servidor MCP de Honeydew ya incluye herramientas de acceso a documentación, por lo que no se necesita un servidor de documentación separado. Si deseas acceso a documentación sin conectarte a Honeydew, agrega el servidor Honeydew Documentation MCP de la misma manera, usando Nombre del servidor honeydew-docs, Tipo de servidor Remoto (HTTP) y URL del servidor https://honeydew.ai/docs/mcp. No se requiere autenticación.

Eliminación del servidor MCP

Para eliminar un servidor, ve a MCP, encuentra el servidor honeydew (o honeydew-docs) y elimínalo.

Cursor

#### Instalación del plugin

En la configuración de tu equipo u organización, ve a cursor.com/dashboard/plugins (o haz clic en Plugins en el menú lateral izquierdo)
Desplázate hasta Marketplaces del equipo y haz clic en un Marketplace existente, o haz clic en Agregar Marketplace para crear uno nuevo. Si creas uno nuevo, ingresa un nombre y créalo.
Dentro del Marketplace, haz clic en Agregar Plugin, pega la ruta del repositorio de GitHub del plugin de Honeydew: https://github.com/honeydew-ai/honeydew-ai-coding-agents-plugins y haz clic en Agregar 1 plugin
Opcionalmente, habilita auto-refresh en la página del Marketplace para que el plugin se actualice automáticamente cuando se publiquen nuevas versiones.
Vuelve a la página de plugins (cursor.com/dashboard/plugins), busca el plugin de Honeydew y haz clic en Agregar

Configuración de MCP

El servidor MCP de Honeydew conecta Cursor con Honeydew Semantic Layer para exploración de modelos, consulta de datos, gestión de modelos y acceso a documentación.

Nota

Si tu organización utiliza un hostname personalizado de Honeydew, reemplaza https://mcp.honeydew.cloud/mcp con el hostname de tu tenant. Puedes encontrar el hostname en Configuración > Servidor MCP en Honeydew Studio.

Para agregar el Honeydew MCP:

Abre la aplicación Cursor
Ve a Configuración -> Configuración de Cursor -> Herramientas y MCP
Haz clic en Nuevo servidor MCP

Agrega la siguiente configuración:

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

Haz clic en Guardar

Honeydew Documentation MCP (opcional)

Ve a Configuración -> Configuración de Cursor -> Herramientas y MCP
Haz clic en Nuevo servidor MCP

Agrega la siguiente configuración:

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

Haz clic en Guardar

Eliminación del servidor MCP

Para eliminar el servidor MCP de Honeydew:

Ve a Configuración -> Configuración de Cursor -> Herramientas y MCP
Encuentra honeydew en la lista y haz clic en el ícono de eliminar

Para eliminar el servidor Honeydew Documentation MCP:

Ve a Configuración -> Configuración de Cursor -> Herramientas y MCP
Encuentra honeydew-docs en la lista y haz clic en el ícono de eliminar

Databricks Genie Code

> **Nota** > > Los servidores MCP solo son compatibles en el modo Genie Code Agent. > Para más detalles, consulta la > [documentación de MCP de Databricks](https://docs.databricks.com/aws/en/generative-ai/mcp/).

Requisitos previos:

Genie Code habilitado en tu espacio de trabajo de Databricks
Privilegio CREATE CONNECTION en el metastore de Unity Catalog

1. Navega a **Catálogo** → **Conexiones** → **Crear una conexión** 2. En la pantalla **Conceptos básicos de la conexión**: * Establece **Nombre de la conexión** en `honeydew-mcp` * Establece **Tipo de conexión** en **HTTP** * Establece **Tipo de autenticación** en **Registro dinámico de cliente** * Haz clic en **Siguiente** 3. En la pantalla **Autenticación**: * Establece **Host** en `https://mcp.honeydew.cloud` * Deja **Puerto** como `443` * Establece **Alcance de OAuth** en `openid` * Haz clic en **Siguiente** 4. En la pantalla **Detalles de la conexión**: * Marca **Es una conexión MCP** * Establece **Ruta base** en `/mcp` * Haz clic en **Crear conexión**

    <Tab title="SQL">
      Ejecuta el siguiente SQL en un cuaderno de Databricks o en el editor 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>

Nota

Si tu organización utiliza un nombre de host personalizado de Honeydew, reemplaza https://mcp.honeydew.cloud con el nombre de host de tu inquilino. Puedes encontrar tu nombre de host en Configuración > Servidor MCP en Honeydew Studio.

<Step title="Log in to the connection">
  Navega a **Catálogo** → **Conexiones** → `honeydew-mcp`
  y haz clic en **Iniciar sesión** en la esquina superior derecha
  para autenticarte y verificar la conexión.
</Step>

<Step title="Grant connection access">
  Otorga el privilegio `USE CONNECTION` a cualquier usuario o rol
  que necesite acceso al servidor MCP de 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. Abre Genie Code y haz clic en el ícono de engranaje
  2. Navega a **Servidores MCP** → **Agregar servidor**
  3. Selecciona **Servidor MCP externo**
  4. Elige la conexión `honeydew-mcp` que creaste
  5. Inicia sesión en la conexión cuando se te solicite
  6. Haz clic en **Guardar**

Nota

Databricks limita MCP a 20 herramientas en todos los servidores configurados. Si necesitas ajustar qué herramientas de Honeydew están disponibles, usa la configuración de MCP de Genie Code para habilitar o deshabilitar herramientas específicas.

Eliminación del servidor MCP

Para eliminar el servidor MCP de Honeydew de Genie Code:

Abre Genie Code y haz clic en el ícono de engranaje
Navega a Servidores MCP
Encuentra honeydew-mcp y haz clic en Eliminar

Para eliminar también la conexión subyacente de Unity Catalog, ejecuta el siguiente SQL:

DROP CONNECTION `honeydew-mcp`;

Devin

#### Servidor MCP

Devin se conecta a servidores MCP remotos a través de su MCP Marketplace.

Nota

Si tu organización utiliza un nombre de host personalizado de Honeydew, reemplaza https://mcp.honeydew.cloud/mcp con el nombre de host de tu inquilino. Puedes encontrar el nombre de host en Configuración > Servidor MCP en Honeydew Studio.

Para agregar el servidor MCP de Honeydew:

Ve a Configuración -> Conexiones -> Servidores MCP
Haz clic en Agregar un MCP personalizado
Ingresa honeydew en el campo Nombre del servidor
Opcionalmente, agrega un ícono y una Descripción breve
Elige HTTP como tipo de transporte
Ingresa https://mcp.honeydew.cloud/mcp en el campo URL del servidor

Configura la autenticación:

Selecciona **OAuth** como método de autenticación. Devin te solicitará autenticarte con Honeydew durante la primera sesión.

<Tab title="API Key">
  Selecciona **Encabezado de autenticación** como método de autenticación.
  Deja la clave del encabezado como `Authorization` y establece el valor en
  `Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET>`
  (consulta [Autenticación](#authentication)).
</Tab>

Haz clic en Guardar, luego haz clic en Probar herramientas de listado para verificar la conexión

MCP de Documentación de Honeydew (opcional)

El servidor MCP de Honeydew ya incluye herramientas de acceso a documentación, por lo que no se necesita un servidor de documentación separado. Agrega el MCP de Documentación de Honeydew solo si deseas acceso a documentación sin conectarte a Honeydew. No se requiere autenticación.

Ve a Configuración -> Conexiones -> Servidores MCP
Haz clic en Agregar un MCP personalizado
Ingresa honeydew-docs en el campo Nombre del servidor
Elige HTTP como tipo de transporte
Ingresa https://honeydew.ai/docs/mcp en el campo URL del servidor
Establece el método de autenticación en Ninguno
Haz clic en Guardar

Eliminación del servidor MCP

Para eliminar el servidor MCP de Honeydew:

Ve a Configuración -> Conexiones -> Servidores MCP
Encuentra el servidor honeydew y elimínalo

Para eliminar el servidor MCP de Documentación de Honeydew:

Ve a Configuración -> Conexiones -> Servidores MCP
Encuentra el servidor honeydew-docs y elimínalo

GitHub Copilot CLI

#### Servidor MCP

Nota

Si tu organización utiliza un nombre de host personalizado de Honeydew, reemplaza https://mcp.honeydew.cloud/mcp con el nombre de host de tu inquilino. Puedes encontrar el nombre de host en Configuración > Servidor MCP en Honeydew Studio.

Inicia GitHub Copilot CLI con copilot
Escribe /mcp add para abrir el formulario de configuración del servidor
Completa los siguientes campos:
- Nombre: honeydew
- Tipo: http
- URL: https://mcp.honeydew.cloud/mcp
- Encabezados HTTP:
  No se necesitan encabezados adicionales para OAuth. ```json theme={null} { "Authorization": "Basic " } ```
Presiona Ctrl+S para guardar

Usa /mcp show para verificar que el servidor esté conectado.

Complementos de Agentes de Codificación con IA

Nota

Requiere Git. Instalar el complemento desde GitHub clona el repositorio localmente, por lo que Git debe estar instalado y en tu PATH. Si falta Git, la instalación del complemento falla. Instala Git, o usa los pasos de configuración manual de MCP de tu cliente para configurar el servidor directamente en lugar del complemento.

Honeydew proporciona un repositorio de complementos con habilidades y herramientas para construir modelos semánticos y analizar datos mediante conversación natural.

Agrega el marketplace a Copilot CLI:

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

Luego instala el complemento de Honeydew desde el marketplace:

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

MCP de Documentación de Honeydew (opcional)

Inicia GitHub Copilot CLI con copilot
Escribe /mcp add para abrir el formulario de configuración del servidor
Completa los siguientes campos:
- Nombre: honeydew-docs
- Tipo: http
- URL: https://honeydew.ai/docs/mcp
Presiona Ctrl+S para guardar

Eliminación del servidor MCP

Para eliminar el servidor MCP de Honeydew, inicia GitHub Copilot CLI con copilot, luego escribe:

/mcp remove honeydew

Para eliminar el servidor MCP de Documentación de Honeydew:

/mcp remove honeydew-docs

Gemini CLI

#### Instalación de la extensión

Nota

Requiere Git. Instalar el complemento desde GitHub clona el repositorio localmente, por lo que Git debe estar instalado y en tu PATH. Si falta Git, la instalación del complemento falla. Instala Git, o usa los pasos de configuración manual de MCP de tu cliente para configurar el servidor directamente en lugar del complemento.

Honeydew proporciona un repositorio de complementos con habilidades y herramientas para construir modelos semánticos y analizar datos mediante conversación natural. Instalar la extensión configura automáticamente los servidores MCP de Honeydew.

Ejecuta el siguiente comando para instalar la extensión de Honeydew:

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

La bandera --auto-update mantiene la extensión actualizada automáticamente.

Configuración de MCP

Usa esta sección si tu organización utiliza un endpoint personalizado de Honeydew, o si prefieres configurar los servidores MCP sin instalar la extensión. Deshabilita la conexión MCP de Honeydew agregada por la extensión y luego agrega tu endpoint personalizado usando las instrucciones a continuación.

El servidor MCP de Honeydew conecta Gemini CLI con la Capa Semántica de Honeydew para exploración de modelos, consulta de datos, gestión de modelos y acceso a documentación.

Nota

Si tu organización utiliza un nombre de host personalizado de Honeydew, reemplaza https://mcp.honeydew.cloud/mcp con el nombre de host de tu inquilino. Puedes encontrar el nombre de host en Configuración > Servidor MCP en Honeydew Studio.

Ejecuta el siguiente comando para agregar el servidor MCP de Honeydew:

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

  Inicia Gemini CLI con `gemini`.
  Se te solicitará autenticarte con OAuth en 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 Documentación de Honeydew (opcional)

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

Eliminación del servidor MCP

Para eliminar el servidor MCP de Honeydew:

gemini mcp remove honeydew

Para eliminar el servidor MCP de Documentación de Honeydew:

gemini mcp remove honeydew-docs

VS Code y GitHub Copilot

#### Instalación del complemento

Honeydew proporciona un repositorio de complementos con habilidades y herramientas para construir modelos semánticos y analizar datos mediante conversación natural. Instalar el complemento configura automáticamente los servidores MCP de Honeydew.

Agrega el marketplace de Honeydew

Abre tu settings.json de VS Code (abre la Paleta de comandos con CMD+Shift+P en macOS o Ctrl+Shift+P en Windows/Linux, luego selecciona Preferencias: Abrir configuración de usuario (JSON))

Agrega el marketplace de Honeydew a la configuración chat.plugins.marketplaces:

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

Instala el complemento

Abre la vista de Extensiones (CMD+Shift+X en macOS o Ctrl+Shift+X en Windows/Linux)
Ingresa @agentPlugins en el campo de búsqueda
Encuentra el complemento Honeydew AI y haz clic en Instalar

La primera vez que instalas un complemento de un marketplace nuevo, VS Code muestra un aviso de confianza: revisa la fuente del marketplace antes de confirmar.

Actualiza el complemento

Si extensions.autoUpdate está habilitado en la configuración de VS Code, el complemento se actualiza automáticamente. Para actualizar manualmente, abre la Paleta de comandos y ejecuta Extensiones: Buscar actualizaciones de extensiones.

Servidor MCP

Usa esta sección si tu organización utiliza un endpoint personalizado de Honeydew, o si prefieres configurar los servidores MCP sin instalar el complemento. Deshabilita la conexión MCP de Honeydew agregada por el complemento y luego agrega tu endpoint personalizado usando las instrucciones a continuación.

El servidor MCP de Honeydew conecta VS Code con la Capa Semántica de Honeydew para exploración de modelos, consulta de datos, gestión de modelos y acceso a documentación.

Nota

Si tu organización utiliza un nombre de host personalizado de Honeydew, reemplaza https://mcp.honeydew.cloud/mcp con el nombre de host de tu inquilino. Puedes encontrar el nombre de host en Configuración > Servidor MCP en Honeydew Studio.

Abre la Paleta de comandos con CMD+Shift+P (macOS) o Ctrl+Shift+P (Windows/Linux)
Selecciona MCP: Agregar servidor...
Elige HTTP (HTTP o Eventos enviados por el servidor)
Ingresa la URL del servidor MCP de Honeydew: https://mcp.honeydew.cloud/mcp
Ingresa honeydew como nombre del servidor

Esto agrega el servidor a tu archivo .vscode/mcp.json. Abre el archivo y agrega encabezados según sea necesario: 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 (opcional)

Agrega lo siguiente a tu .vscode/mcp.json:

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

Eliminación del servidor MCP

Para eliminar el servidor MCP de Honeydew, abre .vscode/mcp.json y elimina la entrada honeydew del objeto servers. Para eliminar el servidor Honeydew Documentation MCP, elimina la entrada honeydew-docs del mismo archivo.

Codex CLI

#### Instalación del plugin

Nota

Requiere Git. Instalar el plugin desde GitHub clona el repositorio localmente, por lo que Git debe estar instalado y en tu PATH. Si Git falta, la instalación del plugin falla. Instala Git, o usa los pasos de configuración manual de MCP de tu cliente para configurar el servidor directamente en lugar del plugin.

Agrega el marketplace a Codex:

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

Luego lanza Codex con codex y escribe /plugins para explorar e instalar el plugin Honeydew AI.

Actualización de plugins

Para actualizar el marketplace de Honeydew, ejecuta:

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

Luego lanza Codex y escribe /plugins para aplicar las actualizaciones.

Configuración de MCP

El servidor MCP de Honeydew conecta Codex al Honeydew Semantic Layer para exploración de modelos, consulta de datos, gestión de modelos y acceso a documentación.

Nota

Si tu organización utiliza un hostname personalizado de Honeydew, reemplaza https://mcp.honeydew.cloud/mcp con el hostname de tu tenant. Puedes encontrar el hostname en Settings > MCP Server en Honeydew Studio.

Línea de comandos

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

Luego lanza Codex con codex. Se te pedirá autenticarte con OAuth hacia Honeydew.

Después de agregar el servidor, abre el archivo de configuración en ~/.codex/config.toml y agrega encabezados a la sección [mcp_servers.honeydew] según sea necesario.

Configuración TOML

Agrega lo siguiente a ~/.codex/config.toml (o .codex/config.toml en un proyecto de confianza):

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

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

Establece la variable de entorno HONEYDEW_AUTH a Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET> (consulta Autenticación).

Honeydew Documentation MCP (opcional)

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

Eliminación del servidor MCP

Para eliminar el servidor MCP de Honeydew:

codex mcp remove honeydew

Para eliminar el servidor Honeydew Documentation MCP:

codex mcp remove honeydew-docs

Codex

#### Instalación del plugin

Nota

Requiere Git. Instalar el plugin desde GitHub clona el repositorio localmente, por lo que Git debe estar instalado y en tu PATH. Si Git falta, la instalación del plugin falla. Instala Git, o usa los pasos de configuración manual de MCP de tu cliente para configurar el servidor directamente en lugar del plugin.

Agrega el marketplace en Codex:

Abre Plugins
Haz clic en la flecha desplegable y selecciona Add marketplace
Agrega honeydew-ai/honeydew-ai-coding-agents-plugins

Nota

También puedes agregar el marketplace desde el Codex CLI:
codex plugin marketplace add honeydew-ai/honeydew-ai-coding-agents-plugins

Luego instala el plugin:

Abre Plugins
Selecciona el marketplace Honeydew AI
Instala el plugin Honeydew

Configuración de MCP

Nota

Si tu organización utiliza un hostname personalizado de Honeydew, reemplaza https://mcp.honeydew.cloud/mcp con el hostname de tu tenant. Puedes encontrar el hostname en Settings > MCP Server en Honeydew Studio.

Honeydew MCP

Abre la aplicación Codex
Ve a Settings -> MCP Servers
Bajo Custom servers, haz clic en Add Server
Establece el nombre del servidor a honeydew
Elige Streamable HTTP como tipo de transporte
Establece la URL a https://mcp.honeydew.cloud/mcp
Deja el campo Bearer token environment variable vacío
Configura la autenticación de la siguiente manera:

Autenticación OAuth

Codex te redirige para autenticarte con Honeydew al conectarte. No se necesita configuración adicional.

Autenticación HTTP Basic

Agrega un encabezado Authorization a la lista de encabezados anterior con el valor Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET> (consulta Autenticación).

Solución de problemas de autenticación MCP

Si el servidor MCP de Honeydew no está autenticado en Codex y la opción "Authenticate" no aparece:

Instala el Codex CLI
Ejecuta codex mcp login honeydew

Honeydew Documentation MCP (opcional)

Ve a Settings -> MCP Servers
Bajo Custom servers, haz clic en Add Server
Establece el nombre del servidor a honeydew-docs
Elige Streamable HTTP como tipo de transporte
Establece la URL a https://honeydew.ai/docs/mcp

Eliminación del servidor MCP

Para eliminar el servidor MCP de Honeydew:

Ve a Settings -> MCP Servers
Encuentra honeydew bajo Custom servers y haz clic en Remove

Para eliminar el servidor Honeydew Documentation MCP:

Ve a Settings -> MCP Servers
Encuentra honeydew-docs bajo Custom servers y haz clic en Remove

Antigravity

#### Servidor MCP

Nota

Si tu organización utiliza un hostname personalizado de Honeydew, reemplaza https://mcp.honeydew.cloud/mcp con el hostname de tu tenant. Puedes encontrar el hostname en Settings > MCP Server en Honeydew Studio.

Abre el editor Antigravity
Haz clic en el menú desplegable ... en la parte superior del panel de agentes
Haz clic en Manage MCP Servers
Haz clic en View raw config

Agrega lo siguiente a 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>

Guarda el archivo

Honeydew Documentation MCP (opcional)

Abre el editor Antigravity
Haz clic en el menú desplegable ... en la parte superior del panel de agentes
Haz clic en Manage MCP Servers
Haz clic en View raw config

Agrega lo siguiente a mcp_config.json:

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

Guarda el archivo

Eliminación del servidor MCP

Para eliminar el servidor MCP de Honeydew:

Abre el editor Antigravity
Haz clic en el menú desplegable ... en la parte superior del panel de agentes
Haz clic en Manage MCP Servers
Haz clic en View raw config
Elimina las entradas honeydew y honeydew-docs de mcp_config.json
Guarda el archivo

OpenCode

#### Servidor MCP

Nota

Si tu organización utiliza un hostname personalizado de Honeydew, reemplaza https://mcp.honeydew.cloud/mcp con el hostname de tu tenant. Puedes encontrar el hostname en Settings > MCP Server en Honeydew Studio.

Ejecuta el siguiente comando y sigue las indicaciones interactivas:

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

  Cuando se te solicite, ingresa los siguientes valores:

  1. **Location**: Elige tu alcance preferido (proyecto actual o 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">
  Agrega lo siguiente a tu archivo `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": {}
          }
        }
      }
      ```

      Luego autentícate con Honeydew:

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

      Esto abre una ventana del navegador para completar el flujo de autenticación 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>

Re-autenticación

Para re-autenticarte, verifica tu estado y cierra sesión primero:

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

Honeydew Documentation MCP (opcional)

Ejecuta `opencode mcp add` e ingresa los siguientes valores:

  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">
  Agrega lo siguiente a tu archivo `opencode.jsonc`:

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

Eliminación del servidor MCP

Para eliminar el servidor MCP de Honeydew, elimina la entrada honeydew de tu archivo opencode.jsonc. Para eliminar el servidor Honeydew Documentation MCP, elimina la entrada honeydew-docs del mismo archivo.

Kiro

El IDE de Kiro y el CLI de Kiro comparten los mismos archivos de configuración de MCP, por lo que los pasos a continuación se aplican a ambos.

Servidor MCP

Kiro lee los servidores MCP de dos archivos de configuración:

Workspace: .kiro/settings/mcp.json (específico del proyecto actual)
User: ~/.kiro/settings/mcp.json (se aplica en todos los workspaces)

Si ambos archivos existen, la configuración del workspace tiene prioridad.

Nota

Si tu organización utiliza un hostname personalizado de Honeydew, reemplaza https://mcp.honeydew.cloud/mcp con el hostname de tu tenant. Puedes encontrar el hostname en Settings > MCP Server en Honeydew Studio.

Agrega el servidor MCP de Honeydew a uno de estos archivos mcp.json (workspace o user):

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

  Al conectarte por primera vez a Honeydew, Kiro proporciona una URL de autenticación.
  Ábrela en tu navegador para completar el flujo de autenticación OAuth.
</Tab>

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

En la CLI de Kiro, ejecuta /mcp para verificar que el servidor esté conectado. En el IDE de Kiro, el servidor aparece en el panel de MCP.

Honeydew Documentation MCP (opcional)

Agrega lo siguiente a tu mcp.json:

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

Eliminación del servidor MCP

Para eliminar el servidor MCP de Honeydew, borra la entrada honeydew de tu mcp.json. Para eliminar el servidor Honeydew Documentation MCP, borra la entrada honeydew-docs del mismo archivo.

Snowflake Intelligence

Snowflake se conecta a servidores MCP externos a través de [conectores MCP](https://docs.snowflake.com/en/user-guide/snowflake-cortex/cortex-agents-mcp-connectors), lo que hace que las herramientas de Honeydew estén disponibles para Snowflake Intelligence y Cortex Agents.

Requisitos previos:

Un rol con el privilegio CREATE INTEGRATION en la cuenta
Un rol con el privilegio CREATE MCP SERVER en el esquema de destino

De forma predeterminada, solo el rol ACCOUNTADMIN tiene estos privilegios.

Nota

Si tu organización utiliza un nombre de host personalizado de Honeydew, reemplaza https://mcp.honeydew.cloud/mcp con el nombre de host de tu inquilino. Puedes encontrar el nombre de host en Configuración > Servidor MCP en 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">
  El servidor MCP externo es un objeto a nivel de esquema
  que hace referencia a la integración de 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">
  Otorga uso tanto de la integración como del servidor MCP
  a cualquier rol que necesite acceso a 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">
  Agrega el servidor MCP `honeydew` como herramienta a un Cortex Agent
  o a un agente de Snowflake Intelligence.
  Se solicita a los usuarios que se autentiquen con OAuth en Honeydew en el primer uso.
</Step>

Nota

El servidor Honeydew Documentation MCP independiente no es compatible en Snowflake, ya que los servidores MCP externos de Snowflake requieren autenticación OAuth y el servidor de documentación no está autenticado. El acceso a la documentación está disponible a través de las herramientas de documentación del servidor MCP de Honeydew.

Eliminación del servidor MCP

Elimina primero el servidor MCP y luego la integración de API:

DROP MCP SERVER honeydew;
DROP INTEGRATION honeydew_mcp_integration;

Otros clientes

Cualquier cliente compatible con MCP puede conectarse al servidor MCP de Honeydew utilizando el transporte HTTP estándar.

Usa la siguiente configuración JSON como punto de partida:

Nota

Si tu organización utiliza un nombre de host personalizado de Honeydew, reemplaza https://mcp.honeydew.cloud/mcp con el nombre de host de tu inquilino. Puedes encontrar el nombre de host en Configuración > Servidor MCP en 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 " } } ```

Consulta URL del servidor, Autenticación, y Configuración para obtener detalles sobre cada parámetro.

Ejemplo de uso

Una vez conectado, puedes preguntar a tu asistente de IA cosas como:

"¿Qué entidades están disponibles en el modelo semántico?"
"Muéstrame los atributos y métricas de la entidad orders"
"¿Qué dominios están definidos en el modelo?"
"¿Qué tablas hay en el esquema analytics?"
"¿Cuántos pedidos se realizaron el mes pasado?"
"Crea una nueva métrica para ingresos totales en la entidad orders"
"¿Cuál es el valor promedio de pedido por región en el último trimestre?"

Solución de problemas

Problemas de autenticación OAuth

Verifica que tu cliente sea compatible con OAuth, asegúrate de tener los permisos necesarios del espacio de trabajo de Honeydew e intenta volver a autenticarte a través de la interfaz de gestión de MCP de tu cliente.

Reautenticación en Claude Code

Escribe /mcp, selecciona el MCP de Honeydew de la lista, elige "Borrar autenticación" o "Autenticar", y luego sigue las indicaciones de OAuth en el navegador para reconectarte a Honeydew.

Problemas de conexión

Confirma que la URL del servidor MCP coincida con https://mcp.honeydew.cloud/mcp y verifica que la sintaxis de configuración de MCP de tu cliente sea correcta. Si tu organización utiliza un nombre de host personalizado, comprueba que la URL coincida con el nombre de host de tu inquilino que aparece en Configuración > Servidor MCP en Honeydew Studio.

Herramientas faltantes

Verifica que la autenticación se haya realizado correctamente, comprueba tus permisos de acceso al espacio de trabajo de Honeydew y revisa la consola de tu cliente para ver los mensajes de error.

La salida supera el máximo de tokens permitidos (Claude)

En Claude Code, Claude Desktop y Claude.ai, una llamada a herramienta puede fallar con un error de que la salida supera el máximo de tokens permitidos. Las herramientas de análisis de Honeydew como monitor_analysis y get_analysis_step_details pueden devolver resultados grandes que superan el límite de salida de MCP de Claude.

Claude advierte cuando la salida de una herramienta MCP supera los 10 000 tokens y rechaza la salida por encima del límite predeterminado de 25 000 tokens. Para aumentar el límite, establece la variable de entorno MAX_MCP_OUTPUT_TOKENS antes de iniciar Claude:

export MAX_MCP_OUTPUT_TOKENS=50000
claude

Consulta Límites y advertencias de salida de MCP en la documentación de Claude para obtener más detalles.

Para soporte adicional, contacta con el soporte de Honeydew en support@honeydew.ai.

Herramientas disponibles

Las herramientas marcadas como solo lectura no modifican el modelo semántico ni el almacén de datos.

Consejo

Para exponer solo herramientas de solo lectura, establece el encabezado ReadonlyToolsOnly: true en la configuración de tu servidor MCP. Cuando está habilitado, el servidor devuelve solo herramientas que no modifican el modelo semántico ni el almacén de datos.

Sesión y espacio de trabajo

`list_workspaces`

solo lectura

Lista todos los espacios de trabajo disponibles. Devuelve el nombre del espacio de trabajo y el tipo de almacén de datos (snowflake, databricks o bigquery). Usa el tipo de almacén de datos para informar la implementación del modelo semántico.

`list_workspace_branches`

solo lectura

Lista todas las ramas disponibles para un espacio de trabajo.

El nombre del espacio de trabajo.

`get_session_workspace_and_branch`

solo lectura

Obtiene el espacio de trabajo y la rama establecidos para la sesión actual.

`set_session_workspace_and_branch`

solo lectura

Establece el espacio de trabajo y la rama a usar para la sesión actual. Todas las llamadas posteriores a herramientas en la sesión usan este espacio de trabajo y esta rama.

El nombre del espacio de trabajo. La rama a usar.

`create_workspace_branch`

Crea una nueva rama para un espacio de trabajo existente. La rama se crea a partir del estado actual de la rama prod del espacio de trabajo. Si no se fija ningún espacio de trabajo mediante encabezados, la sesión cambia automáticamente a la nueva rama.

Nombre del espacio de trabajo para el que se crea una rama. Nombre de la nueva rama a crear.

`delete_workspace_branch`

Elimina una rama de un espacio de trabajo. Esta es una operación destructiva e irreversible. Confirma siempre el nombre del espacio de trabajo y el nombre de la rama con el usuario antes de llamar a esta herramienta. La rama prod no se puede eliminar. Si la rama eliminada es la rama de la sesión actual, la sesión cambia automáticamente a prod.

Nombre del espacio de trabajo que contiene la rama a eliminar. Nombre de la rama a eliminar.

`get_branch_history`

solo lectura

Obtiene el historial de cambios de la rama de la sesión actual. Devuelve una lista de cambios que muestra qué objetos semánticos se modificaron, por quién y cuándo.

Número máximo de cambios a devolver.

`create_pr_for_working_branch`

Crea una solicitud de extracción para la rama de trabajo de la sesión actual. Devuelve la URL de la solicitud de extracción en caso de éxito.

Título de la solicitud de extracción. Descripción de la solicitud de extracción.

Preguntas y análisis

`initiate_analysis`

solo lectura

Inicia o continúa un análisis de datos. Devuelve un conversation_id — usa monitor_analysis para consultar el progreso y los resultados, y abort_analysis para detenerlo antes de tiempo. Consulta Análisis profundo para obtener más detalles.

La pregunta en lenguaje natural a realizar. Nombre del agente para una nueva conversación. Omítelo para preguntas de seguimiento: el agente se hereda de la conversación existente. ID de conversación existente para continuar, u omítelo para iniciar una nueva conversación.

`monitor_analysis`

solo lectura

Consulta nuevos mensajes de progreso de un análisis en curso. Cada llamada devuelve solo los mensajes desde la última llamada. Consulta repetidamente hasta que status sea DONE o NO_CHAT_CURRENTLY_RUNNING.

ID de conversación devuelto por `initiate_analysis`. Número máximo de mensajes a devolver por llamada. ID de mensaje desde el que reproducir. Usa `last_received_message_id` de un resultado anterior para recuperar mensajes perdidos.

`get_analysis_step_details`

solo lectura

Recupera los detalles completos de un paso de análisis específico, incluyendo la consulta semántica, la declaración SQL, el contexto utilizado y los datos recuperados en ese paso.

ID de conversación devuelto por `initiate_analysis`. ID de paso de `monitor_analysis` (por ejemplo, `STEP/0`).

`abort_analysis`

solo lectura

Aborta un análisis en curso. Se puede reanudar desde el punto de aborto con initiate_analysis.

ID de conversación devuelto por `initiate_analysis`.

`list_analysis_chats`

solo lectura

Devuelve una lista paginada de conversaciones de análisis para el espacio de trabajo actual, ordenadas por tiempo de creación (más recientes primero). Los administradores ven todas las conversaciones; los no administradores solo ven las suyas. Cada entrada incluye el ID de conversación, el título, los comentarios del usuario, el dominio, el agente, el tiempo de creación y el nombre visible del usuario que la creó.

Número máximo de conversaciones a devolver. Número de conversaciones a omitir para la paginación.

`provide_analysis_feedback`

Establece o borra comentarios en una conversación de análisis específica. Hay una única entrada de comentarios por conversación (no por pregunta): debe reflejar la calidad general de todo el flujo de la conversación.

Llama a esto después de que monitor_analysis se complete y el usuario exprese satisfacción o insatisfacción con el resultado. Usa una cadena afirmativa corta para comentarios positivos (por ejemplo, Good), o el formato <Reason>: <details> para comentarios negativos, donde Reason es uno de Chart Issue, Data Issue, Wrong Judgement o Other.

ID de conversación de la conversación de análisis. Texto de comentarios a almacenar, o `null` para borrar los comentarios existentes.

`get_stored_conversation`

solo lectura

Devuelve todos los mensajes de una conversación de análisis existente. Usa esto para revisar el contenido completo de una conversación anterior. is_complete en la respuesta indica si la conversación alcanzó un estado terminal.

ID de conversación de `list_analysis_chats`. Si es `true`, incluye entradas de progreso de `step_start` y `step_insight`. Si es `false`, devuelve solo respuestas finales y mensajes de plan/interpretación.

Exploración y descubrimiento

`list_entities`

solo lectura

Lista todas las entidades del modelo semántico con sus nombres, descripciones y claves.

`get_entity`

solo lectura

Obtiene información detallada sobre una entidad, incluyendo sus atributos, métricas, conjuntos de datos, relaciones y definición YAML. El nombre de la entidad.

`get_field`

Solo lectura

Obtén información detallada sobre un campo específico (atributo o métrica) dentro de una entidad, incluida su definición YAML.

El nombre de la entidad que contiene el campo. El nombre del campo.

`list_domains`

Solo lectura

Lista todos los dominios en el modelo semántico con sus nombres, descripciones y entidades.

`get_domain`

Solo lectura

Obtén información detallada sobre un dominio, incluidas sus entidades, filtros, parámetros y definición YAML.

El nombre del dominio.

`search_model`

Solo lectura

Busca en el modelo semántico entidades, atributos, métricas, conjuntos de datos, conjuntos de datos dinámicos, dominios y parámetros globales que coincidan con una cadena de consulta.

Usa la sintaxis entity.field para limitar la búsqueda a campos dentro de una entidad específica. Por ejemplo, customers.balance encuentra el campo balance en entidades que coinciden con customers; customers. devuelve todos los campos de las entidades coincidentes. En el modo OR/AND, las coincidencias parciales se aplican tanto a la parte de la entidad como a la del campo — cust.bal coincide con customers.balance.

La cadena de consulta de búsqueda. Controla cómo se compara la consulta:

OR — divide por espacios en blanco, devuelve objetos que coinciden con cualquier palabra.
AND — divide por espacios en blanco, devuelve solo objetos que coinciden con todas las palabras.
EXACT — usa la cadena completa tal cual, devuelve objetos cuyo nombre, nombre para mostrar o etiqueta es una coincidencia exacta.

Descubrimiento de Almacén

`list_databases`

Solo lectura

Lista todas las bases de datos disponibles en el almacén de datos conectado.

`list_schemas`

Solo lectura

Lista todos los esquemas en una base de datos específica del almacén de datos conectado.

El nombre de la base de datos.

`list_tables`

Solo lectura

Lista tablas/vistas en una base de datos y esquema específicos del almacén de datos conectado.

El nombre de la base de datos. El nombre del esquema.

`get_table_info`

Solo lectura

Obtén información detallada sobre una tabla/vista del almacén, incluidas sus columnas y metadatos.

El nombre de la base de datos. El nombre del esquema. El nombre de la tabla.

Modelo Semántico

`import_tables`

Importa tablas del almacén de datos conectado al modelo semántico. Cada tabla se convierte en una entidad con sus columnas como atributos.

Lista de nombres de tablas totalmente calificados en el formato `database.schema.table`.

`create_entity`

Crea una nueva entidad en el modelo semántico a partir de definiciones YAML.

La definición YAML de la entidad. La definición YAML del conjunto de datos.

`create_object`

Crea un nuevo objeto del modelo semántico a partir de una definición YAML. Tipos admitidos: atributo calculado, métrica, conjunto de datos dinámico, dominio y parámetro global.

La definición YAML del objeto. Crea el objeto incluso si la validación produce errores.

`update_object`

Actualiza un objeto existente del modelo semántico a partir de una definición YAML. Tipos admitidos: entidad, atributo calculado, métrica, conjunto de datos, conjunto de datos dinámico, dominio y parámetro global.

La definición YAML del objeto. La clave del objeto a actualizar. Actualiza el objeto incluso si la validación produce errores.

`validate_object`

Solo lectura

Valida una definición YAML de un objeto del modelo semántico sin crearla ni actualizarla. Tipos admitidos: entidad, atributo calculado, métrica, conjunto de datos, conjunto de datos dinámico, dominio y parámetro global.

La definición YAML a validar. La clave del objeto contra el cual validar.

`delete_object`

Elimina un objeto del modelo semántico por su clave.

La clave del objeto a eliminar. Elimina el objeto incluso si la validación produce errores.

Agentes

`list_agents`

Solo lectura

Lista todos los agentes con sus nombres, descripciones, dominios y referencias de contexto.

`get_agent`

Solo lectura

Obtén información detallada sobre un agente, incluida su definición YAML de frontmatter.

Nombre del agente a recuperar.

`create_agent`

Crea un nuevo agente.

Metadatos para el nuevo agente. Nombre jerárquico (p. ej., `growth-analyst`, `finance/budget-analyst`).

<ParamField body="display_name" type="string" required>
  Nombre legible para humanos que se muestra en la interfaz de usuario.
</ParamField>

<ParamField body="description" type="string" required>
  Descripción del propósito y las capacidades del agente.
</ParamField>

<ParamField body="domain" type="string" required>
  El dominio en el que opera este agente.
</ParamField>

<ParamField body="welcome_message" type="string">
  Mensaje introductorio que se muestra cuando un usuario inicia una sesión.
</ParamField>

<ParamField body="sample_questions" type="string[]">
  Preguntas de ejemplo que se muestran a los usuarios.
</ParamField>

<ParamField body="context" type="string[]">
  Nombres de elementos de contexto o patrones glob para cargar en las sesiones
  (p. ej., `skills/**`, `knowledge/marketing/**`).
</ParamField>

<ParamField body="owner" type="string">
  Identificador del propietario del agente.
</ParamField>

Cuerpo Markdown que se agrega después del frontmatter. Este texto se inyecta en el prompt antes de cada sesión de análisis. Crea el agente incluso si la validación produce errores.

`update_agent`

Actualiza un agente existente.

Nombre del agente a actualizar. Definición completa actualizada del agente. Todos los campos obligatorios de `create_agent` deben proporcionarse: esto es un reemplazo completo, no una actualización parcial. Cuerpo Markdown actualizado para el agente. Actualiza el agente incluso si la validación produce errores.

`delete_agent`

Elimina un agente por nombre.

Nombre del agente a eliminar.

Elementos de Contexto

`list_context_items`

Solo lectura

Lista todos los elementos de contexto con sus tipos, nombres, títulos y valores de subtipo.

`get_context_item`

Solo lectura

Obtén un elemento de contexto por nombre.

Nombre del elemento de contexto a recuperar.

`create_context_item`

Crea un nuevo elemento de contexto. Admite tipos de instrucción y memoria.

Metadatos para el nuevo elemento de contexto. Debe ser `instruction`.

<ParamField body="name" type="string" required>
  Nombre jerárquico
  (p. ej., `knowledge/customer/churn-analysis`, `skills/reporting`).
</ParamField>

<ParamField body="subtype" type="string" required>
  Uno de `knowledge`, `skill` o `instruction`.
</ParamField>

<ParamField body="title" type="string" required>
  Título legible para humanos del elemento de contexto.
</ParamField>

<ParamField body="apply" type="string" required>
  Cuándo aplicar el contexto: `always` o `on_demand`.
</ParamField>

<ParamField body="description" type="string">
  Descripción utilizada por la IA para decidir cuándo cargar este elemento
  (obligatoria cuando `apply` es `on_demand`).
</ParamField>

<ParamField body="owner" type="string">
  Identificador del propietario.
</ParamField>

<ParamField body="labels" type="string[]">
  Etiquetas para organizar los elementos de contexto.
</ParamField>

<ParamField body="related_objects" type="object[]">
  Objetos semánticos con los que se relaciona este elemento de contexto.
  Cada objeto tiene un `name` (cadena) y `type` (`domain`, `entity` o `field`).
</ParamField>

<ParamField body="external_source" type="object">
  Fuente externa para obtener contenido (para el subtipo `knowledge`).
  Tiene `tool` (nombre de la herramienta MCP), `resource_id` (identificador en la herramienta externa)
  y `cache_max_age_in_seconds` opcional (predeterminado: `3600`).
</ParamField>

Debe ser `memory`.

<ParamField body="name" type="string" required>
  Nombre jerárquico (p. ej., `events/q4-launch`, `2024/pricing-decision`).
</ParamField>

<ParamField body="subtype" type="string" required>
  Uno de `event` o `decision_trace`.
</ParamField>

<ParamField body="title" type="string" required>
  Título legible para humanos del elemento de contexto.
</ParamField>

<ParamField body="apply" type="string" required>
  Cuándo aplicar el contexto: `always` o `on_demand`.
</ParamField>

<ParamField body="from_date" type="string" required>
  Fecha de inicio del período de memoria en formato ISO (p. ej., `2024-01-01`).
</ParamField>

<ParamField body="to_date" type="string">
  Fecha de fin del período de memoria en formato ISO.
</ParamField>

<ParamField body="description" type="string">
  Descripción utilizada por la IA para decidir cuándo cargar este elemento
  (obligatoria cuando `apply` es `on_demand`).
</ParamField>

<ParamField body="owner" type="string">
  Identificador del propietario.
</ParamField>

<ParamField body="labels" type="string[]">
  Etiquetas para organizar los elementos de contexto.
</ParamField>

<ParamField body="related_objects" type="object[]">
  Objetos semánticos con los que se relaciona este elemento de contexto.
  Cada objeto tiene un `name` (cadena) y `type` (`domain`, `entity` o `field`).
</ParamField>

<ParamField body="external_source" type="object">
  Fuente externa para obtener contenido.
  Tiene `tool` (nombre de la herramienta MCP), `resource_id` (identificador en la herramienta externa)
  y `cache_max_age_in_seconds` opcional (predeterminado: `3600`).
</ParamField>

Cuerpo Markdown para el contenido del elemento de contexto. Crea el elemento de contexto incluso si la validación produce errores.

`update_context_item`

Actualiza un elemento de contexto existente.

Nombre del elemento de contexto a actualizar. Definición completa actualizada del elemento de contexto. Todos los campos obligatorios de `create_context_item` deben proporcionarse: esto es un reemplazo completo, no una actualización parcial. Cuerpo Markdown actualizado para el elemento de contexto. Actualiza el elemento de contexto incluso si la validación produce errores.

`delete_context_item`

Elimina un elemento de contexto por nombre.

Nombre del elemento de contexto a eliminar.

Consulta y Vista Previa

`get_sql_from_fields`

Solo lectura

Genera la consulta SQL para una consulta de capa semántica definida por atributos, métricas y filtros. Devuelve el SQL sin ejecutarlo.

Nombres de atributos totalmente calificados (`entity.attribute_name`). Admite alias: `entity.attribute_name as alias_name`. Nombres de métricas totalmente calificados (`entity.metric_name`) o expresiones SQL (p. ej., `SUM(entity.field)`). Admite alias: `SUM(entity.field) as total`. Condiciones de filtro (p. ej., `entity.field = 'value'`, `entity.date_field > '2024-01-01'`). Lista de campos para ordenar. Formato: `entity.field_name` o `entity.field_name DESC`. La dirección predeterminada es ASC. Al usar alias, ordena por el nombre del alias. El dominio contra el cual consultar. Número máximo de filas a devolver. Número de filas a omitir para la paginación. Añade un [informe de pre-agregación](/docs/performance/aggregate-awareness#debugging-aggregate-matching) al inicio del SQL devuelto, indicando para cada pre-agregación en el espacio de trabajo qué CTE la utilizó o por qué no se pudo utilizar.

`get_data_from_fields`

Solo lectura

Ejecuta una consulta de capa semántica definida por atributos, métricas y filtros, y devuelve los datos resultantes.

Nombres de atributos totalmente calificados (`entity.attribute_name`). Admite alias: `entity.attribute_name as alias_name`. Nombres de métricas totalmente calificados (`entity.metric_name`) o expresiones SQL (p. ej. `SUM(entity.field)`). Admite alias: `SUM(entity.field) as total`. Condiciones de filtro (p. ej. `entity.field = 'value'`, `entity.date_field > '2024-01-01'`). Lista de campos para ordenar. Formato: `entity.field_name` o `entity.field_name DESC`. La dirección predeterminada es ASC. Al usar alias, ordena por el nombre del alias. El dominio contra el que se consulta. Número máximo de filas a devolver. Número de filas a omitir para la paginación.

`list_query_history`

Solo lectura

Lista las consultas ejecutadas previamente a través de la capa semántica de Honeydew, de la más reciente a la más antigua. Úsalo para encontrar y diagnosticar consultas fallidas y comprender por qué fallaron. Los llamadores que no son administradores solo ven sus propias consultas.

Cada consulta incluye su estado, mensaje de error, propietario, cliente, dominio, el SQL de entrada original (el SQL enviado por el usuario para consultas de interfaz SQL), marcas de tiempo para la compilación y la ejecución en el almacén de datos, el ID de consulta del almacén de datos y un enlace para abrirla en la aplicación Honeydew.

Filtra por estado de consulta (`FAILED`, `SUCCESS`, `RUNNING` o `CANCELED`). Filtra por el cliente que ejecutó la consulta (p. ej. `Snowflake`, `MCP`). Filtra por nombre de dominio. Filtra por propietario de la consulta (el correo electrónico de un usuario o el nombre de una clave de API). Solo se respeta para llamadores administradores; los no administradores están restringidos a sus propias consultas. Solo consultas ejecutadas en o después de este momento (ISO 8601). Solo consultas ejecutadas en o antes de este momento (ISO 8601). También devuelve la definición YAML semántica de cada consulta (atributos, métricas, filtros). Habilítalo para reproducir o modificar una consulta. También devuelve el SQL de almacén compilado de cada consulta (grande). Habilítalo para depurar en el lado del almacén una consulta específica. Número máximo de consultas a devolver. Número de consultas a omitir para la paginación.

Documentación

`search_docs`

Solo lectura

Busca en la base de conocimiento de documentación de Honeydew información relevante, ejemplos de código, referencias de API y guías. Devuelve contenido contextual con títulos y enlaces a las páginas de documentación. Para leer el contenido completo de una página, usa query_docs_filesystem.

La consulta de búsqueda.

`query_docs_filesystem`

Solo lectura

Ejecuta un comando de solo lectura similar a shell contra un sistema de archivos virtualizado en memoria que contiene las páginas de documentación y las especificaciones OpenAPI de Honeydew. Admite comandos como rg, grep, find, tree, ls, cat, head y tail. Úsalo para coincidencias exactas de palabras clave o regex, exploración estructural o lectura del contenido completo de una página específica por ruta.

El comando shell a ejecutar (p. ej. `rg -il "keyword" /`, `tree / -L 2`, `head -80 /path/page.mdx`).

Preguntas frecuentes

¿Qué herramientas se necesitan para el análisis profundo?

Ejecutar Análisis profundo requiere:

Configuración de sesión: list_workspaces, list_workspace_branches, get_session_workspace_and_branch, set_session_workspace_and_branch
Selección de agente: list_agents, get_agent
Análisis: initiate_analysis, monitor_analysis, get_analysis_step_details, abort_analysis
Retroalimentación: provide_analysis_feedback

Para revisar conversaciones de análisis pasadas, también habilita list_analysis_chats y get_stored_conversation.

Limitar el agente a estas herramientas es útil cuando:

Tus usuarios previstos solo ejecutan flujos de trabajo de análisis profundo
Quieres mantener al agente enfocado en tareas de análisis
Tu cliente limita cuántas herramientas se pueden habilitar (por ejemplo, Databricks Genie Code)

Para otros casos de uso, expón más de las herramientas enumeradas en Herramientas disponibles — el agente selecciona la herramienta adecuada para cada tarea.