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

¿Qué puedes hacer con Honeydew Semantic Layer MCP?

Descubrir tablas y esquemas del almacén — explore la estructura de su almacén de datos y las definiciones del modelo semántico mediante conversación natural.
Crear y mantener modelos semánticos — cree o actualice definiciones de modelos semánticos usando create_workspace_branch y otras herramientas de sesión.
Consultar datos con lenguaje natural — haga preguntas sobre sus datos y obtenga respuestas sin escribir SQL.
Buscar en la documentación de Honeydew — consulte la documentación del producto directamente desde cualquier asistente compatible con 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 externas. Honeydew proporciona un servidor MCP que conecta tu asistente de codificación de IA a la Capa Semántica de Honeydew.

Cuándo usarlo

Descubrir y explorar las tablas de tu almacén de datos, esquemas y definiciones del modelo semántico
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

Si tu organización usa un nombre de host personalizado de Honeydew, reemplaza la URL predeterminada por el nombre de host de tu instancia. 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 HTTP Basic.

Autenticación OAuth (recomendada)

La mayoría de los clientes soportan autenticación OAuth. Al conectarte por primera vez, se te pedirá:

Iniciar sesión con tu cuenta de Honeydew
Aceptar la autorización OAuth

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

Autenticación HTTP Basic

El Servidor MCP en modo de autenticación HTTP Basic requiere una Clave API para la autenticación.

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

Si creas una nueva Clave 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. Invoca estas herramientas desde tu asistente de IA después de conectarte al servidor MCP.

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

Workspace: Fijar el espacio de trabajo para todas las solicitudes (opcional)
Branch: Fijar una rama específica del espacio de trabajo para todas las solicitudes (opcional, por defecto prod si se establece el espacio de trabajo)
Honeydew-Client: Identificar el cliente MCP (opcional, se detecta automáticamente de la herramienta conectada). Pasa este encabezado para proporcionar un identificador de cliente específico.
ReadonlyToolsOnly: Establecer a true para exponer solo herramientas de solo lectura (opcional)

El servidor MCP usa el encabezado de respuesta `Mcp-Session-Id` para mantener el estado de la sesión, incluyendo el espacio de trabajo y la rama activos. Consulta la [especificación de gestión de sesiones MCP](https://modelcontextprotocol.io/specification/2025-06-18/basic/transports#session-management) para más detalles.

Clientes soportados

Claude Code CLI

#### Instalación del plugin **Requiere Git.** Instalar el plugin desde GitHub clona el repositorio localmente, por lo que [Git](https://git-scm.com/downloads) 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 los servidores MCP de Honeydew automáticamente.

Inicia Claude Code con claude, luego añade 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

Después recarga los plugins para activarlo:

/reload-plugins

Actualizar plugins

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

Escribe /plugin y selecciona Marketplaces en el selector 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 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. Deshabilita la conexión MCP de Honeydew añadida por el plugin, luego añade 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 la exploración de modelos, consulta de datos, gestión de modelos, y acceso a la documentación.

Usa uno de los siguientes métodos para añadir el servidor MCP de Honeydew:

Si tu organización usa un nombre de host personalizado de Honeydew, reemplaza `https://mcp.honeydew.cloud/mcp` por el nombre de host de tu instancia. 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">
  Añade 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>

**Uso de variables de entorno para autenticación con Clave API**

Para evitar almacenar valores sensibles directamente en archivos de configuración,
Claude Code soporta
[expansión de variables de entorno](https://code.claude.com/docs/en/mcp#environment-variable-expansion-in-mcp-json)
usando la sintaxis `${VAR_NAME}`.

Establece la variable de entorno `HONEYDEW_API_KEY`,
luego haz referencia a ella en tu configuración:

```bash theme={null}
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 la documentación, por lo que no se necesita un servidor de documentación separado. Añade el MCP de Documentación de Honeydew solo si deseas acceso a la documentación sin conectarte a Honeydew. No se requiere autenticación.

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

Eliminar el 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

Ve a Configuración -> Personalizar
Haz clic en Explorar plugins
Ve a la pestaña Personal
Haz clic en el icono + y elige Añadir marketplace desde GitHub
Introduce honeydew-ai/honeydew-ai-coding-agents-plugins en el campo de entrada
Aparece el plugin Honeydew AI. Instálalo.

Configuración MCP

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

Modo Claude Code

Al usar Claude Desktop en modo Claude Code, sigue las instrucciones de Claude Code CLI en su lugar.

Para añadir el MCP de Honeydew en modo Cowork:

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

Se te pedirá que te autentiques con OAuth en Honeydew la primera vez que te conectes.

MCP de Documentación de Honeydew (opcional)

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

Eliminar el 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 icono 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 icono 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 -> Añadir plugin -> Subir zip
Sube el zip — el plugin aparece en tu marketplace privado

Configuración 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 añadido por el plugin, luego añade 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 la exploración de modelos, consulta de datos, gestión de modelos, y acceso a la documentación.

Para añadir el servidor MCP de Honeydew:

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

Se le pedirá que se autentique con OAuth en Honeydew la primera vez que se conecte.

MCP de Documentación de Honeydew (opcional)

El servidor MCP de Honeydew ya incluye herramientas de acceso a la documentación, por lo que no se necesita un servidor de documentación separado. Agregue el MCP de Documentación de Honeydew solo si desea acceder a la documentación sin conectarse a Honeydew. No se requiere autenticación.

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

Eliminación del servidor MCP

Para eliminar el servidor MCP de Honeydew:

Vaya a Configuración -> Conectores
Busque el conector honeydew y haga clic en el icono de eliminar

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

Vaya a Configuración -> Conectores
Busque el conector honeydew-docs y haga clic en el icono de eliminar

CLI de Cortex Code

#### Instalación del Plugin **Requiere Git.** La instalación del plugin desde GitHub clona el repositorio localmente, por lo que [Git](https://git-scm.com/downloads) debe estar instalado y en su `PATH`. Si falta Git, la instalación del plugin falla. Instale Git, o use los pasos de configuración manual de MCP de su 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 a través de conversación natural. La instalación del plugin configura los servidores MCP de Honeydew automáticamente.

Inicie la CLI de Cortex Code con cortex, luego instale el plugin:

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

Configuración de MCP

Use esta sección si su organización utiliza un endpoint personalizado de Honeydew, o si prefiere configurar los servidores MCP sin instalar el plugin. Deshabilite la conexión MCP de Honeydew agregada por el plugin, luego agregue su endpoint personalizado usando las instrucciones a continuación.

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

      Inicie la CLI de Cortex Code con `cortex`.
      Se le pedirá que se autentique
      con OAuth en 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">
  Guarde lo siguiente en `honeydew-mcp.json`:

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

      Luego regístrelo con:

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

      Inicie la CLI de Cortex Code con `cortex`.
      Se le pedirá que se autentique
      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ístrelo con:

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

<Tab title="mcp.json">
  Agregue 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"
          }
        }
      }
      ```

      Inicie la CLI de Cortex Code con `cortex`.
      Se le pedirá que se autentique
      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>

MCP de Documentación de Honeydew (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 MCP de Documentación de Honeydew:

cortex mcp remove honeydew-docs

Cortex Code Desktop

Vaya a Configuración -> Plugins
Haga clic en Agregar Plugin, seleccione Agregar desde GitHub, y pegue el repositorio del plugin de Honeydew: honeydew-ai/honeydew-ai-coding-agents-plugins
Siga el flujo y apruebe los pasos en Configuración del Instalador de Plugins de GitHub

Configuración de MCP

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

Para agregar un servidor, vaya a MCP -> Nuevo, elija un Ámbito de Configuración (por ejemplo, ~/.snowflake/cortex/mcp.json para Global), complete el formulario, luego haga clic en Guardar. Use la pestaña Formulario o JSON para ingresar la configuración.

Agregue 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. Haga clic en **Guardar**

      Se le pedirá que se autentique con OAuth en Honeydew
      la primera vez que se conecte.
    </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**, haga clic en **Agregar Encabezado** y establezca el nombre como
         `Authorization` y el valor como
         `Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET>`
      5. Haga clic en **Guardar**
    </Tab>
  </Tabs>
</Tab>

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

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

      Se le pedirá que se autentique con OAuth en Honeydew
      la primera vez que se conecte.
    </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>

MCP de Documentación de Honeydew (opcional)

El servidor MCP de Honeydew ya incluye herramientas de acceso a la documentación, por lo que no se necesita un servidor de documentación separado. Si desea acceder a la documentación sin conectarse a Honeydew, agregue el servidor MCP de Documentación de Honeydew 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, vaya a MCP, busque el servidor honeydew (o honeydew-docs) y elimínelo.

Cursor

#### Instalación del Plugin

En la configuración de su equipo u organización, vaya a cursor.com/dashboard/plugins (o haga clic en Plugins en el menú del lado izquierdo)
Desplácese hacia abajo hasta Mercados del Equipo y haga clic en un Mercado existente, o haga clic en Agregar Mercado para crear uno nuevo. Si crea uno nuevo, ingrese un nombre y créelo.
Dentro del Mercado, haga clic en Agregar Plugin, pegue la ruta del repositorio de GitHub del plugin de Honeydew: https://github.com/honeydew-ai/honeydew-ai-coding-agents-plugins y haga clic en Agregar 1 plugin
Opcionalmente, habilite auto-refrescar en la página del Mercado para que el plugin se actualice automáticamente cuando se lancen nuevas versiones.
Vuelva a la página de plugins (cursor.com/dashboard/plugins), busque el plugin de Honeydew, y haga clic en Agregar

Configuración de MCP

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

Para agregar el MCP de Honeydew:

Abra la aplicación Cursor
Vaya a Configuración -> Configuración de Cursor -> Herramientas y MCP
Haga clic en Nuevo Servidor MCP

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

Haga clic en Guardar

MCP de Documentación de Honeydew (opcional)

Vaya a Configuración -> Configuración de Cursor -> Herramientas y MCP
Haga clic en Nuevo Servidor MCP

Agregue la siguiente configuración:

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

Haga clic en Guardar

Eliminación del servidor MCP

Para eliminar el servidor MCP de Honeydew:

Vaya a Configuración -> Configuración de Cursor -> Herramientas y MCP
Busque honeydew en la lista y haga clic en el icono de eliminar

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

Vaya a Configuración -> Configuración de Cursor -> Herramientas y MCP
Busque honeydew-docs en la lista y haga clic en el icono de eliminar

Databricks Genie Code

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

Prerrequisitos:

Genie Code habilitado en su espacio de trabajo de Databricks
Privilegio CREATE CONNECTION en el metastore de Unity Catalog
1. Navegue a **Catálogo** → **Conexiones** → **Crear una conexión** 2. En la pantalla **Aspectos básicos de la conexión**: * Establezca **Nombre de la conexión** como `honeydew-mcp` * Establezca **Tipo de conexión** como **HTTP** * Establezca **Tipo de autenticación** como **Registro dinámico de cliente** * Haga clic en **Siguiente** 3. En la pantalla **Autenticación**: * Establezca **Host** como `https://mcp.honeydew.cloud` * Deje **Puerto** como `443` * Establezca **Ámbito de OAuth** como `openid` * Haga clic en **Siguiente** 4. En la pantalla **Detalles de la conexión**: * Marque **Es conexión MCP** * Establezca **Ruta base** como `/mcp` * Haga clic en **Crear conexión**
```
<Tab title="SQL">
  Ejecute el siguiente SQL en un cuaderno de Databricks o 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>
```
Si su organización utiliza un nombre de host personalizado de Honeydew, reemplace `https://mcp.honeydew.cloud` con su nombre de host de inquilino. Puede encontrar su nombre de host en **Configuración > Servidor MCP** en Honeydew Studio. Navegue a **Catálogo** → **Conexiones** → `honeydew-mcp` y haga clic en **Iniciar sesión** en la esquina superior derecha para autenticar y verificar la conexión. Otorgue el privilegio `USE CONNECTION` a cualquier usuario o rol que necesite acceso al servidor MCP de Honeydew:
```
GRANT USE CONNECTION ON CONNECTION `honeydew-mcp` TO <user-or-role>;
```
1. Abra Genie Code y haga clic en el ícono de engranaje 2. Navegue a **Servidores MCP** → **Agregar servidor** 3. Seleccione **Servidor MCP externo** 4. Elija la conexión `honeydew-mcp` que creó 5. Inicie sesión en la conexión cuando se le solicite 6. Haga clic en **Guardar** Databricks limita MCP a 20 herramientas en todos los servidores configurados. Si necesita ajustar qué herramientas de Honeydew están disponibles, use 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:

Abra Genie Code y haga clic en el ícono de engranaje
Navegue a Servidores MCP
Encuentre honeydew-mcp y haga clic en Eliminar

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

DROP CONNECTION `honeydew-mcp`;

Devin

#### Servidor MCP

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

Para agregar el servidor MCP de Honeydew:

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

Configure la autenticación:

Seleccione **OAuth** como método de autenticación. Devin le solicitará que se autentique con Honeydew durante la primera sesión.

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

Haga clic en Guardar, luego haga 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 la documentación, por lo que no se necesita un servidor de documentación separado. Agregue el MCP de Documentación de Honeydew solo si desea acceso a la documentación sin conectarse a Honeydew. No se requiere autenticación.

Vaya a Configuración -> Conexiones -> Servidores MCP
Haga clic en Agregar un MCP personalizado
Ingrese honeydew-docs en el campo Nombre del servidor
Elija HTTP como tipo de transporte
Ingrese https://honeydew.ai/docs/mcp en el campo URL del servidor
Establezca el método de autenticación en Ninguno
Haga clic en Guardar

Eliminación del servidor MCP

Para eliminar el servidor MCP de Honeydew:

Vaya a Configuración -> Conexiones -> Servidores MCP
Encuentre el servidor honeydew y elimínelo

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

Vaya a Configuración -> Conexiones -> Servidores MCP
Encuentre el servidor honeydew-docs y elimínelo

GitHub Copilot CLI

#### Servidor MCP Si su organización utiliza un nombre de host personalizado de Honeydew, reemplace `https://mcp.honeydew.cloud/mcp` con su nombre de host de inquilino. Puede encontrar el nombre de host en **Configuración > Servidor MCP** en Honeydew Studio.

Inicie GitHub Copilot CLI con copilot
Escriba /mcp add para abrir el formulario de configuración del servidor
Complete 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 " } ```
Presione Ctrl+S para guardar

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

Plugins del Agente de Codificación IA

**Requiere Git.** La instalación del plugin desde GitHub clona el repositorio localmente, por lo que [Git](https://git-scm.com/downloads) debe estar instalado y en su `PATH`. Si falta Git, la instalación del plugin falla. Instale Git o use los pasos de configuración manual de MCP de su 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 a través de conversación natural.

Agregue el marketplace a Copilot CLI:

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

Luego instale el plugin de Honeydew desde el marketplace:

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

MCP de Documentación de Honeydew (opcional)

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

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

Eliminación del servidor MCP

Para eliminar el servidor MCP de Honeydew, inicie GitHub Copilot CLI con copilot, luego escriba:

/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 **Requiere Git.** La instalación del plugin desde GitHub clona el repositorio localmente, por lo que [Git](https://git-scm.com/downloads) debe estar instalado y en su `PATH`. Si falta Git, la instalación del plugin falla. Instale Git o use los pasos de configuración manual de MCP de su 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 a través de conversación natural. La instalación de la extensión configura los servidores MCP de Honeydew automáticamente.

Ejecute 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

Use esta sección si su organización utiliza un endpoint personalizado de Honeydew, o si prefiere configurar los servidores MCP sin instalar la extensión. Deshabilite la conexión MCP de Honeydew agregada por la extensión, luego agregue su endpoint personalizado usando las instrucciones a continuación.

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

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

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

  Inicie Gemini CLI con `gemini`.
  Se le pedirá que se autentique 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)

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

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 Plugin

Agregar el marketplace de Honeydew

Abra su settings.json de VS Code (abra la Paleta de Comandos con CMD+Shift+P en macOS o Ctrl+Shift+P en Windows/Linux, luego seleccione Preferencias: Abrir configuración de usuario (JSON))

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

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

Instalar el plugin

Abra la vista de Extensiones (CMD+Shift+X en macOS o Ctrl+Shift+X en Windows/Linux)
Ingrese @agentPlugins en el campo de búsqueda
Encuentre el plugin Honeydew AI y haga clic en Instalar

La primera vez que instala un plugin de un nuevo marketplace, VS Code muestra un aviso de confianza — revise la fuente del marketplace antes de confirmar.

Actualizar el plugin

Si extensions.autoUpdate está habilitado en la configuración de VS Code, el plugin se actualiza automáticamente. Para actualizar manualmente, abra la Paleta de Comandos y ejecute Extensiones: Buscar actualizaciones de extensiones.

Servidor MCP

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

Si su organización utiliza un nombre de host personalizado de Honeydew, reemplace `https://mcp.honeydew.cloud/mcp` con su nombre de host de inquilino. Puede encontrar el nombre de host en **Configuración > Servidor MCP** en Honeydew Studio. 1. Abra la Paleta de Comandos con `CMD+Shift+P` (macOS) o `Ctrl+Shift+P` (Windows/Linux) 2. Seleccione **MCP: Agregar servidor...** 3. Elija **HTTP (HTTP o Eventos Enviados por el Servidor)** 4. Ingrese la URL del servidor MCP de Honeydew: `https://mcp.honeydew.cloud/mcp` 5. Ingrese `honeydew` como nombre del servidor

Esto agrega el servidor a su archivo .vscode/mcp.json. Abra el archivo y agregue los 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>

MCP de Documentación de Honeydew (opcional)

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

Agregue lo siguiente a su .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, abra .vscode/mcp.json y elimine la entrada honeydew del objeto servers. Para eliminar el servidor MCP de Documentación de Honeydew, elimine la entrada honeydew-docs del mismo archivo.

Codex CLI

Agregue el marketplace a Codex:

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

Luego inicie Codex con codex y escriba /plugins para explorar e instalar el plugin de Honeydew AI.

Actualización de plugins

Para actualizar el marketplace de Honeydew, ejecute:

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

Luego inicie Codex y escriba /plugins para aplicar las actualizaciones.

Configuración de MCP

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

Línea de comandos

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

Luego inicie Codex con codex. Se le pedirá que se autentique con OAuth en Honeydew.

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

Configuración TOML

Agregue 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"

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

MCP de Documentación de Honeydew (opcional)

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

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 MCP de Documentación de Honeydew:

codex mcp remove honeydew-docs

Codex

Agregue el marketplace en Codex:

Abra Plugins
Haga clic en la flecha desplegable y seleccione Agregar marketplace
Agregue honeydew-ai/honeydew-ai-coding-agents-plugins

También puede agregar el marketplace desde el [Codex CLI](#codex-cli):

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

Luego instale el plugin:

Abra Plugins
Seleccione el marketplace Honeydew AI
Instale el plugin Honeydew

Configuración de MCP

Honeydew MCP

Abra la aplicación Codex
Vaya a Configuración -> Servidores MCP
En Servidores personalizados, haga clic en Agregar Servidor
Establezca el nombre del servidor a honeydew
Elija HTTP Transmisible como tipo de transporte
Establezca la URL a https://mcp.honeydew.cloud/mcp
Deje el campo Variable de entorno del token de portador vacío
Configure la autenticación de la siguiente manera:

Autenticación OAuth

Codex lo redirige para autenticarse con Honeydew al conectarse. No se necesita configuración adicional.

Autenticación HTTP Basic

Agregue un encabezado Authorization a la lista de encabezados arriba con el valor Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET> (consulte 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 "Autenticar" no aparece:

Instale el Codex CLI
Ejecute codex mcp login honeydew

MCP de Documentación de Honeydew (opcional)

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

Vaya a Configuración -> Servidores MCP
En Servidores personalizados, haga clic en Agregar Servidor
Establezca el nombre del servidor a honeydew-docs
Elija HTTP Transmisible como tipo de transporte
Establezca la URL a https://honeydew.ai/docs/mcp

Eliminación del servidor MCP

Para eliminar el servidor MCP de Honeydew:

Vaya a Configuración -> Servidores MCP
Encuentre honeydew en Servidores personalizados y haga clic en Eliminar

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

Vaya a Configuración -> Servidores MCP
Encuentre honeydew-docs en Servidores personalizados y haga clic en Eliminar

Antigravity

#### Servidor MCP Si su organización utiliza un nombre de host personalizado de Honeydew, reemplace `https://mcp.honeydew.cloud/mcp` con el nombre de host de su inquilino. Puede encontrar el nombre de host en **Configuración > Servidor MCP** en Honeydew Studio.

Abra el editor Antigravity
Haga clic en el menú desplegable ... en la parte superior del panel del agente
Haga clic en Administrar Servidores MCP
Haga clic en Ver configuración sin procesar

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

Guarde el archivo

MCP de Documentación de Honeydew (opcional)

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

Abra el editor Antigravity
Haga clic en el menú desplegable ... en la parte superior del panel del agente
Haga clic en Administrar Servidores MCP
Haga clic en Ver configuración sin procesar

Agregue lo siguiente a mcp_config.json:

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

Guarde el archivo

Eliminación del servidor MCP

Para eliminar el servidor MCP de Honeydew:

Abra el editor Antigravity
Haga clic en el menú desplegable ... en la parte superior del panel del agente
Haga clic en Administrar Servidores MCP
Haga clic en Ver configuración sin procesar
Elimine las entradas honeydew y honeydew-docs de mcp_config.json
Guarde el archivo

OpenCode

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

  Cuando se le solicite, ingrese los siguientes valores:

  1. **Ubicación**: Elija su ámbito preferido (proyecto actual o global)
  2. **Nombre del servidor MCP**: `honeydew`
  3. **Tipo de servidor MCP**: `Remote`
  4. **URL del servidor MCP**: `https://mcp.honeydew.cloud/mcp`
  5. **Autenticación OAuth**: `Yes`
  6. **ID de cliente pre-registrado**: `No`
</Tab>

<Tab title="JSON configuration">
  Agregue lo siguiente a su 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íquese 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-autenticarse, verifique su estado y cierre sesión primero:

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

MCP de Documentación de Honeydew (opcional)

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

Ejecute `opencode mcp add` e ingrese los siguientes valores:

  1. **Nombre del servidor MCP**: `honeydew-docs`
  2. **Tipo de servidor MCP**: `Remote`
  3. **URL del servidor MCP**: `https://honeydew.ai/docs/mcp`
  4. **Autenticación OAuth**: `No`
</Tab>

<Tab title="JSON configuration">
  Agregue lo siguiente a su 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, elimine la entrada honeydew de su archivo opencode.jsonc. Para eliminar el servidor MCP de Documentación de Honeydew, elimine la entrada honeydew-docs del mismo archivo.

Kiro

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

Servidor MCP

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

Espacio de trabajo: .kiro/settings/mcp.json (específico del proyecto actual)
Usuario: ~/.kiro/settings/mcp.json (aplica en todos los espacios de trabajo)

Si ambos archivos existen, la configuración del espacio de trabajo tiene prioridad. Si su organización utiliza un nombre de host personalizado de Honeydew, reemplace https://mcp.honeydew.cloud/mcp con el nombre de host de su inquilino. Puede encontrar el nombre de host en Configuración > Servidor MCP en Honeydew Studio.

Agregue el servidor MCP de Honeydew a uno de estos archivos mcp.json (espacio de trabajo o usuario):

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

  Al conectarse por primera vez a Honeydew, Kiro proporciona una URL de autenticación.
  Ábrala en su navegador para completar el flujo de autenticación 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>

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

MCP de Documentación de Honeydew (opcional)

Agregue lo siguiente a su mcp.json:

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

Eliminación del servidor MCP

Para eliminar el servidor MCP de Honeydew, elimine la entrada honeydew de su mcp.json. Para eliminar el servidor MCP de Documentación de Honeydew, elimine 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), haciendo que las herramientas de Honeydew estén disponibles para Snowflake Intelligence y los Agentes Cortex.

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.

Si su organización utiliza un nombre de host personalizado de Honeydew, reemplace `https://mcp.honeydew.cloud/mcp` con el nombre de host de su inquilino. Puede 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">
  Otorgue uso tanto en la integración como en el 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">
  Agregue el servidor MCP `honeydew` como una herramienta a un Agente Cortex
  o a un agente de Snowflake Intelligence.
  Se solicita a los usuarios que se autentiquen con OAuth en Honeydew en el primer uso.
</Step>

El servidor MCP de Documentación de Honeydew 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

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

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

Si su organización utiliza un nombre de host personalizado de Honeydew, reemplace `https://mcp.honeydew.cloud/mcp` con el nombre de host de su inquilino. Puede 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 " } } ```

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

Ejemplo de Uso

Una vez conectado, puede preguntar a su asistente de IA con preguntas como:

"¿Qué entidades están disponibles en el modelo semántico?"
"Muéstrame los atributos y métricas para 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 los ingresos totales en la entidad orders"
"¿Cuál es el valor promedio de los pedidos por región durante el último trimestre?"

Solución de Problemas

Problemas de Autenticación OAuth

Verifique que su cliente soporte OAuth, asegúrese de tener los permisos necesarios en el espacio de trabajo de Honeydew e intente volver a autenticarse a través de la interfaz de administración MCP de su cliente.

Reautenticación en Claude Code

Escriba /mcp, seleccione el MCP de Honeydew de la lista, elija "Borrar autenticación" o "Autenticar", luego siga las indicaciones OAuth del navegador para volver a conectarse a Honeydew.

Problemas de Conexión

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

Herramientas Faltantes

Verifique que la autenticación haya sido exitosa, compruebe sus permisos de acceso al espacio de trabajo de Honeydew, y revise la consola de su cliente en busca de 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 MCP de Claude.

Claude advierte cuando la salida de la 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, establezca la variable de entorno MAX_MCP_OUTPUT_TOKENS antes de iniciar Claude:

export MAX_MCP_OUTPUT_TOKENS=50000
claude

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

Para soporte adicional, contacte al 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.

Para exponer solo herramientas de solo lectura, establezca el encabezado `ReadonlyToolsOnly: true` en la configuración de su 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

Enumera 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). Utilice el tipo de almacén de datos para informar la implementación del modelo semántico.

`list_workspace_branches`

solo lectura

Enumera 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 utilizar para la sesión actual. Todas las llamadas a herramientas posteriores en la sesión utilizan este espacio de trabajo y rama.

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

`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 un espacio de trabajo mediante encabezados, la sesión cambia a la nueva rama automáticamente.

Nombre del espacio de trabajo para el cual crear 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. Siempre confirme 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 a prod automáticamente.

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 para la rama de la sesión actual. Devuelve una lista de cambios que muestran qué objetos semánticos fueron modificados, 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 PR en caso de éxito.

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

Pregunta y Análisis

`initiate_analysis`

solo lectura

Inicia o continúa un análisis de datos. Devuelve un conversation_id — use monitor_analysis para sondear el progreso y los resultados, y abort_analysis para detenerlo antes de tiempo. Consulte Análisis Profundo para más detalles.

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

`monitor_analysis`

solo lectura

Sondea nuevos mensajes de progreso de un análisis en curso. Cada llamada devuelve solo los mensajes desde la última llamada. Sondee 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 cual reproducir. Use `last_received_message_id` de un resultado anterior para recuperar mensajes perdidos.

`get_analysis_step_details`

solo lectura

Recupera 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 abortado 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 hora de creación (la más reciente primero). Los administradores ven todas las conversaciones; los no administradores solo ven las suyas. Cada entrada incluye el ID de conversación, título, comentarios del usuario, dominio, agente, hora de creación y el nombre para mostrar 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 los comentarios sobre 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.

Llame a esto después de que monitor_analysis se complete y el usuario exprese satisfacción o insatisfacción con el resultado. Use 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. Utilízalo para revisar el contenido completo de una conversación previa. 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 `step_start` y `step_insight` entradas de progreso. Si es `false`, devuelve solo respuestas finales y mensajes de plan/interpretación.

Exploración y Descubrimiento

`list_entities`

solo lectura

Enumera todas las entidades en el modelo semántico con sus nombres, descripciones y claves.

`get_entity`

solo lectura

Obtén 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, incluyendo su definición YAML.

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

`list_domains`

solo lectura

Enumera 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, incluyendo 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 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 empareja la consulta:

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

Descubrimiento del Almacén de Datos

`list_databases`

solo lectura

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

`list_schemas`

solo lectura

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

El nombre de la base de datos.

`list_tables`

solo lectura

Enumera tablas/vistas en una base de datos y esquema específicos en el 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, incluyendo 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 tabla completamente cualificados 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 para la entidad. La definición YAML para el conjunto de datos.

`create_object`

Crea un nuevo objeto del modelo semántico a partir de una definición YAML. Tipos soportados: atributo, 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 del modelo semántico existente a partir de una definición YAML. Tipos soportados: entidad, atributo, 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 objeto del modelo semántico sin crearlo ni actualizarlo. Tipos soportados: entidad, atributo, 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 la 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

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

`get_agent`

solo lectura

Obtén información detallada sobre un agente, incluyendo 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 (ej., `growth-analyst`, `finance/budget-analyst`).

<ParamField body="display_name" type="string" required>
  Nombre legible por humanos mostrado en la interfaz de usuario.
</ParamField>

<ParamField body="description" type="string" required>
  Descripción del propósito y 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 mostrado cuando un usuario inicia una sesión.
</ParamField>

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

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

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

Cuerpo Markdown añadido 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 requeridos de `create_agent` deben ser proporcionados — 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

Enumera 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. Soporta 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
  (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 por humanos para el 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
  (requerido 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 de la cual obtener contenido (para el subtipo `knowledge`).
  Tiene `tool` (nombre de 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 (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 por humanos para el 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 (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
  (requerido 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 de la cual obtener contenido.
  Tiene `tool` (nombre de 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 requeridos de `create_context_item` deben ser proporcionados — 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 atributo completamente cualificados (`entity.attribute_name`). Soporta alias: `entity.attribute_name as alias_name`. Nombres de métricas completamente cualificados (`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 por los que ordenar. Formato: `entity.field_name` o `entity.field_name DESC`. La dirección predeterminada es ASC. Al usar alias, ordene 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 paginación.

`get_data_from_fields`

solo lectura

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

Nombres de atributos completamente cualificados (`entity.attribute_name`). Admite alias: `entity.attribute_name as alias_name`. Nombres de métricas completamente cualificados (`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 por los que ordenar. Formato: `entity.field_name` o `entity.field_name DESC`. La dirección predeterminada es ASC. Al usar alias, ordene 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 paginación.

`list_query_history`

solo lectura

Lista las consultas ejecutadas previamente a través de la capa semántica de Honeydew, las más recientes primero. Úselo para encontrar y clasificar consultas fallidas y entender por qué fallaron. Los usuarios no 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 compilación y 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.

Filtrar por estado de consulta (`FAILED`, `SUCCESS`, `RUNNING`, o `CANCELED`). Filtrar por el cliente que ejecutó la consulta (p. ej. `Snowflake`, `MCP`). Filtrar por nombre de dominio. Filtrar por propietario de la consulta (correo electrónico de un usuario o nombre de una clave API). Solo se respeta para usuarios 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). Devolver también la definición YAML semántica de cada consulta (atributos, métricas, filtros). Habilítelo para reproducir o modificar una consulta. Devolver también el SQL compilado del almacén de datos de cada consulta (grande). Habilítelo para depuración del lado del almacén de datos de una consulta específica. Número máximo de consultas a devolver. Número de consultas a omitir para 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, use 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 de Honeydew y las especificaciones OpenAPI. Admite comandos como rg, grep, find, tree, ls, cat, head y tail. Úselo para coincidencia exacta de palabras clave o regex, exploración estructural, o lectura del contenido completo de una página específica por ruta.

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