Honeydew Semantic Layer

oficial

A camada semântica Honeydew fornece um modelo de dados governado e amigável para negócios que unifica métricas, dimensões e relacionamentos entre fontes, permitindo análises consistentes de autoatendimento e acesso a dados com inteligência artificial.

Ver em honeydew.aiExperimente este MCPPatrocinado

O que você pode fazer com Honeydew Semantic Layer MCP?

Explore os metadados do warehouse — Peça ao seu assistente para descobrir tabelas, esquemas e definições de modelos semânticos em todo o seu warehouse.
Gerencie modelos semânticos — Construa e mantenha seu modelo semântico por meio de conversa natural, incluindo a criação de branches de workspace com create_workspace_branch.
Consulte dados de forma conversacional — Use linguagem natural para consultar seus dados a partir de qualquer assistente compatível com MCP.
Configure o contexto da sessão — Defina seu workspace e branch ativos usando set_session_workspace_and_branch após listar as opções disponíveis com list_workspaces e list_workspace_branches.
Acesse a documentação do Honeydew — Pesquise e leia a documentação do Honeydew diretamente por meio das ferramentas de documentação integradas do servidor MCP.

Documentação

Servidor MCP

O que é MCP?

Model Context Protocol (MCP) é um padrão de código aberto para conectar com segurança aplicações de IA a sistemas e ferramentas externas. A Honeydew fornece um servidor MCP que conecta seu assistente de codificação com IA à Honeydew Semantic Layer.

Quando usar

Descubra e explore tabelas, schemas e definições de modelos semânticos do seu warehouse
Construa e mantenha seu modelo semântico por meio de conversa natural
Consulte seus dados com linguagem natural a partir de qualquer assistente compatível com MCP
Pesquise e leia a documentação da Honeydew

Instalação

URL do servidor

A Honeydew expõe a API do servidor MCP em https://mcp.honeydew.cloud/mcp

Nota

Se sua organização usa um hostname personalizado da Honeydew, substitua a URL padrão pelo hostname do seu tenant. Você pode encontrar o hostname na interface da Honeydew em Configurações > Servidor MCP.

Autenticação

Existem duas formas de autenticar com o servidor MCP da Honeydew: OAuth ou autenticação HTTP Basic.

Autenticação OAuth (recomendada)

A maioria dos clientes suporta autenticação OAuth. Ao conectar pela primeira vez, você será solicitado a:

Fazer login com sua conta Honeydew
Aceitar a autorização OAuth

O cliente então fornece com segurança um token de acesso para solicitações subsequentes.

Autenticação HTTP Basic

O servidor MCP no modo de autenticação HTTP Basic requer uma API Key para autenticação.

Você precisa fornecer uma string codificada em Base64 da sua API Key e API Secret no formato API_KEY:API_SECRET.

Dica

Ao criar uma nova API Key para acesso ao servidor MCP, você pode copiar a string codificada em Base64 da interface do Honeydew Studio no momento da criação.

Você pode usar o seguinte comando para gerar a string codificada em Base64:

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

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

Forneça a string codificada no cabeçalho Authorization da seguinte forma:

Authorization: Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET>

Configuração

O workspace e a branch são definidos no nível da sessão usando as ferramentas list_workspaces, list_workspace_branches e set_session_workspace_and_branch. Você também pode criar novas branches com create_workspace_branch. Chame essas ferramentas pelo seu assistente de IA após conectar ao servidor MCP.

Você pode opcionalmente fornecer estes cabeçalhos na configuração do seu servidor MCP:

Workspace: Fixa o workspace para todas as solicitações (opcional)
Branch: Fixa uma branch específica do workspace para todas as solicitações (opcional, padrão é prod se o workspace estiver definido)
Honeydew-Client: Identifica o cliente MCP (opcional, detectado automaticamente a partir da ferramenta conectada). Envie este cabeçalho para fornecer um identificador de cliente específico.
ReadonlyToolsOnly: Defina como true para expor apenas ferramentas somente leitura (opcional)

Nota

O servidor MCP usa o cabeçalho de resposta Mcp-Session-Id para manter o estado da sessão, incluindo o workspace e a branch ativos. Consulte a especificação de gerenciamento de sessão MCP para obter detalhes.

Clientes Suportados

Claude Code CLI

#### Instalação do Plugin

Nota

Requer Git. Instalar o plugin do GitHub clona o repositório localmente, então o Git deve estar instalado e no seu PATH. Se o Git estiver ausente, a instalação do plugin falha. Instale o Git, ou use as etapas de configuração manual de MCP do seu cliente para configurar o servidor diretamente em vez do plugin.

A Honeydew fornece um repositório de plugins com habilidades e ferramentas para construir modelos semânticos e analisar dados por meio de conversa natural. Instalar o plugin configura os servidores MCP da Honeydew automaticamente.

Inicie o Claude Code com claude e adicione o marketplace:

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

Em seguida, instale o plugin da Honeydew a partir do marketplace:

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

Depois, recarregue os plugins para ativar:

/reload-plugins

Atualizando plugins

Para atualizar os plugins do marketplace da Honeydew, inicie o Claude Code com claude e:

Escreva /plugin e selecione Marketplaces no seletor no topo
Selecione honeydew-ai-coding-agents-plugins
Clique em Atualizar marketplace

Para receber atualizações automaticamente, selecione Ativar atualização automática nas configurações do marketplace.

Configuração MCP

Use esta seção se sua organização usa um endpoint personalizado da Honeydew, ou se você prefere configurar os servidores MCP sem instalar o plugin. Desative a conexão MCP da Honeydew adicionada pelo plugin e adicione seu endpoint personalizado usando as instruções abaixo.

O servidor MCP da Honeydew conecta o Claude Code à Honeydew Semantic Layer para exploração de modelos, consulta de dados, gerenciamento de modelos e acesso à documentação.

Use um dos seguintes métodos para adicionar o servidor MCP da Honeydew:

Nota

Se sua organização usa um hostname personalizado da Honeydew, substitua https://mcp.honeydew.cloud/mcp pelo hostname do seu tenant. Você pode encontrar o hostname em Configurações > Servidor MCP no Honeydew Studio.

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

      Inicie o Claude Code com `claude`.
      Você será solicitado a autenticar com OAuth para a 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">
  Salve o seguinte em `honeydew-mcp.json`:

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

      Em seguida, registre-o com:

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

      Inicie o Claude Code com `claude`.
      Você será solicitado a autenticar com OAuth para 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>"
        }
      }
      ```

      Em seguida, registre-o com:

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

<Tab title=".mcp.json">
  Adicione o seguinte ao seu arquivo `.mcp.json`:

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

      Inicie o Claude Code com `claude`.
      Você será solicitado a autenticar com OAuth para 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>

Dica

Usando variáveis de ambiente para autenticação com API Key

Para evitar armazenar valores sensíveis diretamente em arquivos de configuração, o Claude Code suporta expansão de variáveis de ambiente usando a sintaxe ${VAR_NAME}.

Defina a variável de ambiente HONEYDEW_API_KEY, e então faça referência a ela na sua configuração:
claude mcp add --transport http honeydew \
    https://mcp.honeydew.cloud/mcp \
    --header "Authorization: Basic ${HONEYDEW_API_KEY}"
O Claude Code resolve referências ${VAR_NAME} em tempo de execução a partir do seu ambiente.

MCP de Documentação da Honeydew (opcional)

O servidor MCP da Honeydew já inclui ferramentas de acesso à documentação, então um servidor de documentação separado não é necessário. Adicione o MCP de Documentação da Honeydew apenas se você quiser acesso à documentação sem conectar à Honeydew. Nenhuma autenticação é necessária.

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

Removendo o servidor MCP

Para remover o servidor MCP da Honeydew:

claude mcp remove honeydew

Para remover o servidor MCP de Documentação da Honeydew:

claude mcp remove honeydew-docs

Claude Desktop

#### Instalação do Plugin

Nota

Requer Git. Instalar o plugin do GitHub clona o repositório localmente, então o Git deve estar instalado e no seu PATH. Se o Git estiver ausente, a instalação do plugin falha. Instale o Git, ou use as etapas de configuração manual de MCP do seu cliente para configurar o servidor diretamente em vez do plugin.

Vá para Configurações -> Personalizar
Clique em Procurar Plugins
Vá para a aba Pessoal
Clique no ícone + e escolha Adicionar marketplace do GitHub
Digite honeydew-ai/honeydew-ai-coding-agents-plugins na caixa de entrada
O plugin Honeydew AI aparece. Instale-o.

Configuração MCP

O servidor MCP da Honeydew conecta o Claude Desktop à Honeydew Semantic Layer para exploração de modelos, consulta de dados, gerenciamento de modelos e acesso à documentação.

Modo Claude Code

Ao usar o Claude Desktop no modo Claude Code, siga as instruções do Claude Code CLI em vez disso.

Nota

Se sua organização usa um hostname personalizado da Honeydew, substitua https://mcp.honeydew.cloud/mcp pelo hostname do seu tenant. Você pode encontrar o hostname em Configurações > Servidor MCP no Honeydew Studio.

Para adicionar o MCP da Honeydew no modo Cowork:

Vá para Configurações -> Conectores -> Adicionar conector personalizado
Digite honeydew no campo Nome
Digite https://mcp.honeydew.cloud/mcp no campo URL do servidor MCP remoto
Clique em Adicionar

Você será solicitado a autenticar com OAuth para a Honeydew ao conectar pela primeira vez.

MCP de Documentação da Honeydew (opcional)

Vá para Configurações -> Conectores -> Adicionar conector personalizado
Digite honeydew-docs no campo Nome
Digite https://honeydew.ai/docs/mcp no campo URL do servidor MCP remoto
Clique em Adicionar

Removendo o servidor MCP

Para remover o servidor MCP da Honeydew no modo Cowork:

Vá para Configurações -> Conectores
Encontre o conector honeydew e clique no ícone de exclusão

Para remover o servidor MCP de Documentação da Honeydew:

Vá para Configurações -> Conectores
Encontre o conector honeydew-docs e clique no ícone de exclusão

Claude.ai

#### Instalação do Plugin

Baixe o zip do plugin: honeydew-ai-claude.zip
No Claude.ai, vá para Configurações -> Plugins -> Adicionar plugin -> Enviar zip
Envie o zip — o plugin aparece no seu marketplace privado

Configuração MCP

Use esta seção se sua organização usa um endpoint personalizado da Honeydew, ou se você prefere configurar os servidores MCP sem instalar o plugin. Remova o conector MCP da Honeydew adicionado pelo plugin e adicione seu endpoint personalizado usando as instruções abaixo.

O servidor MCP da Honeydew conecta o Claude.ai à Honeydew Semantic Layer para exploração de modelos, consulta de dados, gerenciamento de modelos e acesso à documentação.

Nota

Se sua organização usa um hostname personalizado da Honeydew, substitua https://mcp.honeydew.cloud/mcp pelo hostname do seu tenant. Você pode encontrar o hostname em Configurações > Servidor MCP no Honeydew Studio.

Para adicionar o servidor MCP da Honeydew:

Vá para Configurações -> Conectores -> Adicionar conector personalizado
Insira honeydew no campo Nome
Insira https://mcp.honeydew.cloud/mcp no campo URL do servidor MCP remoto
Clique em Adicionar

Você será solicitado a autenticar com OAuth para Honeydew ao conectar pela primeira vez.

Honeydew Documentation MCP (opcional)

O servidor MCP Honeydew já inclui ferramentas de acesso à documentação, portanto, um servidor de documentação separado não é necessário. Adicione o Honeydew Documentation MCP somente se quiser acesso à documentação sem conectar ao Honeydew. Nenhuma autenticação é necessária.

Vá para Configurações -> Conectores -> Adicionar conector personalizado
Insira honeydew-docs no campo Nome
Insira https://honeydew.ai/docs/mcp no campo URL do servidor MCP remoto
Clique em Adicionar

Removendo o servidor MCP

Para remover o servidor MCP Honeydew:

Vá para Configurações -> Conectores
Encontre o conector honeydew e clique no ícone de exclusão

Para remover o servidor MCP Honeydew Documentation:

Vá para Configurações -> Conectores
Encontre o conector honeydew-docs e clique no ícone de exclusão

Cortex Code CLI

#### Instalação do Plugin

Nota

Requer Git. Instalar o plugin do GitHub clona o repositório localmente, então Git deve estar instalado e no seu PATH. Se o Git estiver ausente, a instalação do plugin falha. Instale o Git, ou use as etapas manuais de configuração MCP do seu cliente para configurar o servidor diretamente em vez do plugin.

Inicie o Cortex Code CLI com cortex e instale o plugin:

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

Configuração MCP

Use esta seção se sua organização usa um endpoint Honeydew personalizado, ou se você prefere configurar os servidores MCP sem instalar o plugin. Desative a conexão MCP Honeydew adicionada pelo plugin e adicione seu endpoint personalizado usando as instruções abaixo.

O servidor MCP Honeydew conecta o Cortex Code CLI ao Honeydew Semantic Layer para exploração de modelos, consulta de dados, gerenciamento de modelos e acesso à documentação.

Nota

Se sua organização usa um hostname Honeydew personalizado, substitua https://mcp.honeydew.cloud/mcp pelo hostname do seu tenant. Você pode encontrar o hostname em Configurações > Servidor MCP no Honeydew Studio.

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

      Inicie o Cortex Code CLI com `cortex`.
      Você será solicitado a autenticar
      com OAuth para 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">
  Salve o seguinte em `honeydew-mcp.json`:

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

      Em seguida, registre-o com:

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

      Inicie o Cortex Code CLI com `cortex`.
      Você será solicitado a autenticar
      com OAuth para 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>"
        }
      }
      ```

      Em seguida, registre-o com:

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

<Tab title="mcp.json">
  Adicione o seguinte a
  `~/.snowflake/cortex/mcp.json`:

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

      Inicie o Cortex Code CLI com `cortex`.
      Você será solicitado a autenticar
      com OAuth para 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

Removendo o servidor MCP

Para remover o servidor MCP Honeydew:

cortex mcp remove honeydew

Para remover o servidor MCP Honeydew Documentation:

cortex mcp remove honeydew-docs

Cortex Code Desktop

#### Instalação do Plugin

Nota

Requer Git. Instalar o plugin do GitHub clona o repositório localmente, então Git deve estar instalado e no seu PATH. Se o Git estiver ausente, a instalação do plugin falha. Instale o Git, ou use as etapas manuais de configuração MCP do seu cliente para configurar o servidor diretamente em vez do plugin.

Vá para Configurações -> Plugins
Clique em Adicionar Plugin, selecione Adicionar do GitHub e cole o repositório do plugin Honeydew: honeydew-ai/honeydew-ai-coding-agents-plugins
Siga o fluxo e aprove as etapas em Configuração do Instalador de Plugins do GitHub

Configuração MCP

O servidor MCP Honeydew conecta o Cortex Code Desktop ao Honeydew Semantic Layer para exploração de modelos, consulta de dados, gerenciamento de modelos e acesso à documentação.

Para adicionar um servidor, vá para MCP -> Novo, escolha um Escopo de Configuração (por exemplo, ~/.snowflake/cortex/mcp.json para Global), preencha o formulário e clique em Salvar. Use a aba Formulário ou JSON para inserir a configuração.

Nota

Se sua organização usa um hostname Honeydew personalizado, substitua https://mcp.honeydew.cloud/mcp pelo hostname do seu tenant. Você pode encontrar o hostname em Configurações > Servidor MCP no Honeydew Studio.

Adicione o servidor Honeydew MCP:

1. **Nome do Servidor**: `honeydew` 2. **Tipo de Servidor**: **Remoto (HTTP)** 3. **URL do Servidor**: `https://mcp.honeydew.cloud/mcp` 4. Clique em **Salvar**

      Você será solicitado a autenticar com OAuth para Honeydew
      ao conectar pela primeira vez.
    </Tab>

    <Tab title="API Key">
      1. **Nome do Servidor**: `honeydew`
      2. **Tipo de Servidor**: **Remoto (HTTP)**
      3. **URL do Servidor**: `https://mcp.honeydew.cloud/mcp`
      4. Em **Cabeçalhos**, clique em **Adicionar Cabeçalho** e defina o nome como
         `Authorization` e o valor como
         `Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET>`
      5. Clique em **Salvar**
    </Tab>
  </Tabs>
</Tab>

<Tab title="JSON">
  Alterne para a aba **JSON** e cole a configuração:

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

      Você será solicitado a autenticar com OAuth para Honeydew
      ao conectar pela primeira 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)

O servidor MCP Honeydew já inclui ferramentas de acesso à documentação, portanto, um servidor de documentação separado não é necessário. Se você quiser acesso à documentação sem conectar ao Honeydew, adicione o servidor Honeydew Documentation MCP da mesma forma, usando Nome do Servidor honeydew-docs, Tipo de Servidor Remoto (HTTP) e URL do Servidor https://honeydew.ai/docs/mcp. Nenhuma autenticação é necessária.

Removendo o servidor MCP

Para remover um servidor, vá para MCP, encontre o servidor honeydew (ou honeydew-docs) e remova-o.

Cursor

#### Instalação do Plugin

Nas configurações da sua equipe ou organização, vá para cursor.com/dashboard/plugins (ou clique em Plugins no menu lateral esquerdo)
Role até Marketplaces da Equipe e clique em um Marketplace existente, ou clique em Adicionar Marketplace para criar um novo. Se estiver criando um novo, insira um nome e crie-o.
Dentro do Marketplace, clique em Adicionar Plugin, cole o caminho do repositório GitHub do plugin Honeydew: https://github.com/honeydew-ai/honeydew-ai-coding-agents-plugins e clique em Adicionar 1 plugin
Opcionalmente, ative a atualização automática na página do Marketplace para que o plugin seja atualizado automaticamente quando novas versões forem lançadas.
Volte para a página de plugins (cursor.com/dashboard/plugins), procure pelo plugin Honeydew e clique em Adicionar

Configuração MCP

O servidor MCP Honeydew conecta o Cursor ao Honeydew Semantic Layer para exploração de modelos, consulta de dados, gerenciamento de modelos e acesso à documentação.

Nota

Se sua organização usa um hostname Honeydew personalizado, substitua https://mcp.honeydew.cloud/mcp pelo hostname do seu tenant. Você pode encontrar o hostname em Configurações > Servidor MCP no Honeydew Studio.

Para adicionar o Honeydew MCP:

Abra o aplicativo Cursor
Vá para Configurações -> Configurações do Cursor -> Ferramentas e MCP
Clique em Novo Servidor MCP

Adicione a seguinte configuração:

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

Clique em Salvar

Honeydew Documentation MCP (opcional)

Vá para Configurações -> Configurações do Cursor -> Ferramentas e MCP
Clique em Novo Servidor MCP

Adicione a seguinte configuração:

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

Clique em Salvar

Removendo o servidor MCP

Para remover o servidor MCP Honeydew:

Vá para Configurações -> Configurações do Cursor -> Ferramentas e MCP
Encontre honeydew na lista e clique no ícone de exclusão

Para remover o servidor MCP Honeydew Documentation:

Vá para Configurações -> Configurações do Cursor -> Ferramentas e MCP
Encontre honeydew-docs na lista e clique no ícone de exclusão

Databricks Genie Code

> **Nota** > > Os servidores MCP são suportados apenas no modo Genie Code Agent. > Para mais detalhes, consulte a > [documentação MCP do Databricks](https://docs.databricks.com/aws/en/generative-ai/mcp/).

Pré-requisitos:

Genie Code habilitado no seu workspace Databricks
Privilégio CREATE CONNECTION no metastore do Unity Catalog

1. Navegue até **Catálogo** → **Conexões** → **Criar uma conexão** 2. Na tela **Noções básicas da conexão**: * Defina **Nome da conexão** como `honeydew-mcp` * Defina **Tipo de conexão** como **HTTP** * Defina **Tipo de autenticação** como **Registro Dinâmico de Cliente** * Clique em **Avançar** 3. Na tela **Autenticação**: * Defina **Host** como `https://mcp.honeydew.cloud` * Deixe **Porta** como `443` * Defina **Escopo OAuth** como `openid` * Clique em **Avançar** 4. Na tela **Detalhes da conexão**: * Marque **É uma conexão MCP** * Defina **Caminho base** como `/mcp` * Clique em **Criar conexão**

    <Tab title="SQL">
      Execute o seguinte SQL em um notebook Databricks ou 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>

Observação

Se sua organização usa um nome de host Honeydew personalizado, substitua https://mcp.honeydew.cloud pelo nome de host do seu locatário. Você pode encontrar seu nome de host em Configurações > Servidor MCP no Honeydew Studio.

<Step title="Log in to the connection">
  Navegue até **Catálogo** → **Conexões** → `honeydew-mcp`
  e clique em **Entrar** no canto superior direito
  para autenticar e verificar a conexão.
</Step>

<Step title="Grant connection access">
  Conceda o privilégio `USE CONNECTION` a quaisquer usuários ou funções
  que precisem de acesso ao servidor MCP Honeydew:

  ```sql theme={null}
  GRANT USE CONNECTION ON CONNECTION `honeydew-mcp` TO <user-or-role>;
  ```
</Step>

<Step title="Add the MCP server in Genie Code">
  1. Abra o Genie Code e clique no ícone de engrenagem
  2. Navegue até **Servidores MCP** → **Adicionar servidor**
  3. Selecione **Servidor MCP externo**
  4. Escolha a conexão `honeydew-mcp` que você criou
  5. Faça login na conexão quando solicitado
  6. Clique em **Salvar**

Observação

O Databricks limita o MCP a 20 ferramentas em todos os servidores configurados. Se você precisar ajustar quais ferramentas Honeydew estão disponíveis, use as configurações MCP do Genie Code para ativar ou desativar ferramentas específicas.

Removendo o servidor MCP

Para remover o servidor MCP Honeydew do Genie Code:

Abra o Genie Code e clique no ícone de engrenagem
Navegue até Servidores MCP
Encontre honeydew-mcp e clique em Remover

Para também remover a conexão subjacente do Unity Catalog, execute o seguinte SQL:

DROP CONNECTION `honeydew-mcp`;

Devin

#### Servidor MCP

Devin conecta-se a servidores MCP remotos por meio do seu MCP Marketplace.

Observação

Se sua organização usa um nome de host Honeydew personalizado, substitua https://mcp.honeydew.cloud/mcp pelo nome de host do seu locatário. Você pode encontrar o nome de host em Configurações > Servidor MCP no Honeydew Studio.

Para adicionar o servidor MCP Honeydew:

Vá para Configurações -> Conexões -> Servidores MCP
Clique em Adicionar um MCP personalizado
Insira honeydew no campo Nome do servidor
Opcionalmente, adicione um ícone e uma Descrição curta
Escolha HTTP como o tipo de transporte
Insira https://mcp.honeydew.cloud/mcp no campo URL do servidor

Configure a autenticação:

Selecione **OAuth** como o método de autenticação. O Devin solicitará que você se autentique com o Honeydew durante a primeira sessão.

<Tab title="API Key">
  Selecione **Cabeçalho de autenticação** como o método de autenticação.
  Deixe a chave do cabeçalho como `Authorization` e defina o valor como
  `Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET>`
  (consulte [Autenticação](#authentication)).
</Tab>

Clique em Salvar e depois em Testar ferramentas de listagem para verificar a conexão

MCP de Documentação Honeydew (opcional)

O servidor MCP Honeydew já inclui ferramentas de acesso à documentação, portanto, um servidor de documentação separado não é necessário. Adicione o MCP de Documentação Honeydew somente se quiser acesso à documentação sem se conectar ao Honeydew. Nenhuma autenticação é necessária.

Vá para Configurações -> Conexões -> Servidores MCP
Clique em Adicionar um MCP personalizado
Insira honeydew-docs no campo Nome do servidor
Escolha HTTP como o tipo de transporte
Insira https://honeydew.ai/docs/mcp no campo URL do servidor
Defina o método de autenticação como Nenhum
Clique em Salvar

Removendo o servidor MCP

Para remover o servidor MCP Honeydew:

Vá para Configurações -> Conexões -> Servidores MCP
Encontre o servidor honeydew e remova-o

Para remover o servidor MCP de Documentação Honeydew:

Vá para Configurações -> Conexões -> Servidores MCP
Encontre o servidor honeydew-docs e remova-o

GitHub Copilot CLI

#### Servidor MCP

Observação

Se sua organização usa um nome de host Honeydew personalizado, substitua https://mcp.honeydew.cloud/mcp pelo nome de host do seu locatário. Você pode encontrar o nome de host em Configurações > Servidor MCP no Honeydew Studio.

Inicie o GitHub Copilot CLI com copilot
Digite /mcp add para abrir o formulário de configuração do servidor
Preencha os seguintes campos:
- Nome: honeydew
- Tipo: http
- URL: https://mcp.honeydew.cloud/mcp
- Cabeçalhos HTTP:
  Nenhum cabeçalho adicional é necessário para OAuth. ```json theme={null} { "Authorization": "Basic " } ```
Pressione Ctrl+S para salvar

Use /mcp show para verificar se o servidor está conectado.

Plugins do Agente de Codificação de IA

Observação

Requer Git. Instalar o plugin do GitHub clona o repositório localmente, portanto, o Git deve estar instalado e no seu PATH. Se o Git estiver ausente, a instalação do plugin falhará. Instale o Git, ou use as etapas manuais de configuração MCP do seu cliente para configurar o servidor diretamente em vez do plugin.

A Honeydew fornece um repositório de plugins com habilidades e ferramentas para construir modelos semânticos e analisar dados por meio de conversa natural.

Adicione o marketplace ao Copilot CLI:

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

Em seguida, instale o plugin Honeydew do marketplace:

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

MCP de Documentação Honeydew (opcional)

Inicie o GitHub Copilot CLI com copilot
Digite /mcp add para abrir o formulário de configuração do servidor
Preencha os seguintes campos:
- Nome: honeydew-docs
- Tipo: http
- URL: https://honeydew.ai/docs/mcp
Pressione Ctrl+S para salvar

Removendo o servidor MCP

Para remover o servidor MCP Honeydew, inicie o GitHub Copilot CLI com copilot e digite:

/mcp remove honeydew

Para remover o servidor MCP de Documentação Honeydew:

/mcp remove honeydew-docs

Gemini CLI

#### Instalação da Extensão

Observação

Requer Git. Instalar o plugin do GitHub clona o repositório localmente, portanto, o Git deve estar instalado e no seu PATH. Se o Git estiver ausente, a instalação do plugin falhará. Instale o Git, ou use as etapas manuais de configuração MCP do seu cliente para configurar o servidor diretamente em vez do plugin.

A Honeydew fornece um repositório de plugins com habilidades e ferramentas para construir modelos semânticos e analisar dados por meio de conversa natural. Instalar a extensão configura os servidores MCP Honeydew automaticamente.

Execute o seguinte comando para instalar a extensão Honeydew:

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

O sinalizador --auto-update mantém a extensão atualizada automaticamente.

Configuração MCP

Use esta seção se sua organização usa um endpoint Honeydew personalizado, ou se você preferir configurar os servidores MCP sem instalar a extensão. Desative a conexão MCP Honeydew adicionada pela extensão e adicione seu endpoint personalizado usando as instruções abaixo.

O servidor MCP Honeydew conecta o Gemini CLI ao Honeydew Semantic Layer para exploração de modelos, consulta de dados, gerenciamento de modelos e acesso à documentação.

Observação

Se sua organização usa um nome de host Honeydew personalizado, substitua https://mcp.honeydew.cloud/mcp pelo nome de host do seu locatário. Você pode encontrar o nome de host em Configurações > Servidor MCP no Honeydew Studio.

Execute o seguinte comando para adicionar o servidor MCP Honeydew:

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

  Inicie o Gemini CLI com `gemini`.
  Você será solicitado a autenticar com OAuth para o 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 Documentação Honeydew (opcional)

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

Removendo o servidor MCP

Para remover o servidor MCP Honeydew:

gemini mcp remove honeydew

Para remover o servidor MCP de Documentação Honeydew:

gemini mcp remove honeydew-docs

VS Code e GitHub Copilot

#### Instalação do Plugin

Adicione o marketplace Honeydew

Abra seu settings.json do VS Code (abra a Paleta de Comandos com CMD+Shift+P no macOS ou Ctrl+Shift+P no Windows/Linux, e selecione Preferências: Abrir Configurações do Usuário (JSON))

Adicione o marketplace Honeydew à configuração chat.plugins.marketplaces:

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

Instale o plugin

Abra a visualização de Extensões (CMD+Shift+X no macOS ou Ctrl+Shift+X no Windows/Linux)
Insira @agentPlugins no campo de pesquisa
Encontre o plugin Honeydew AI e clique em Instalar

Na primeira vez que você instala um plugin de um novo marketplace, o VS Code mostra um prompt de confiança — revise a fonte do marketplace antes de confirmar.

Atualize o plugin

Se extensions.autoUpdate estiver habilitado nas configurações do VS Code, o plugin será atualizado automaticamente. Para atualizar manualmente, abra a Paleta de Comandos e execute Extensões: Verificar Atualizações de Extensões.

Servidor MCP

Use esta seção se sua organização usa um endpoint Honeydew personalizado, ou se você preferir configurar os servidores MCP sem instalar o plugin. Desative a conexão MCP Honeydew adicionada pelo plugin e adicione seu endpoint personalizado usando as instruções abaixo.

O servidor MCP Honeydew conecta o VS Code ao Honeydew Semantic Layer para exploração de modelos, consulta de dados, gerenciamento de modelos e acesso à documentação.

Observação

Se sua organização usa um nome de host Honeydew personalizado, substitua https://mcp.honeydew.cloud/mcp pelo nome de host do seu locatário. Você pode encontrar o nome de host em Configurações > Servidor MCP no Honeydew Studio.

Abra a Paleta de Comandos com CMD+Shift+P (macOS) ou Ctrl+Shift+P (Windows/Linux)
Selecione MCP: Adicionar Servidor...
Escolha HTTP (HTTP ou Server-Sent Events)
Insira a URL do servidor MCP Honeydew: https://mcp.honeydew.cloud/mcp
Insira honeydew como o nome do servidor

Isso adiciona o servidor ao seu arquivo .vscode/mcp.json. Abra o arquivo e adicione cabeçalhos conforme necessário: 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)

O servidor MCP Honeydew já inclui ferramentas de acesso à documentação, portanto um servidor de documentação separado não é necessário. Adicione o Honeydew Documentation MCP somente se quiser acesso à documentação sem se conectar ao Honeydew. Nenhuma autenticação é necessária.

Adicione o seguinte ao seu .vscode/mcp.json:

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

Removendo o servidor MCP

Para remover o servidor MCP Honeydew, abra .vscode/mcp.json e exclua a entrada honeydew do objeto servers. Para remover o servidor Honeydew Documentation MCP, exclua a entrada honeydew-docs do mesmo arquivo.

Codex CLI

#### Instalação do Plugin

Nota

Requer Git. Instalar o plugin do GitHub clona o repositório localmente, então o Git deve estar instalado e no seu PATH. Se o Git estiver ausente, a instalação do plugin falha. Instale o Git, ou use as etapas manuais de configuração MCP do seu cliente para configurar o servidor diretamente em vez do plugin.

O Honeydew fornece um repositório de plugins com habilidades e ferramentas para construir modelos semânticos e analisar dados por meio de conversa natural. Instalar o plugin configura os servidores MCP Honeydew automaticamente.

Adicione o marketplace ao Codex:

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

Em seguida, inicie o Codex com codex e digite /plugins para navegar e instalar o plugin Honeydew AI.

Atualizando plugins

Para atualizar o marketplace Honeydew, execute:

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

Em seguida, inicie o Codex e digite /plugins para aplicar as atualizações.

Configuração MCP

O servidor MCP Honeydew conecta o Codex ao Honeydew Semantic Layer para exploração de modelos, consulta de dados, gerenciamento de modelos e acesso à documentação.

Nota

Se sua organização usa um hostname Honeydew personalizado, substitua https://mcp.honeydew.cloud/mcp pelo hostname do seu tenant. Você pode encontrar o hostname em Configurações > Servidor MCP no Honeydew Studio.

Linha de comando

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

Em seguida, inicie o Codex com codex. Você será solicitado a autenticar com OAuth para o Honeydew.

Após adicionar o servidor, abra o arquivo de configuração em ~/.codex/config.toml e adicione cabeçalhos à seção [mcp_servers.honeydew] conforme necessário.

Configuração TOML

Adicione o seguinte a ~/.codex/config.toml (ou .codex/config.toml em um projeto confiável):

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

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

Defina a variável de ambiente HONEYDEW_AUTH para Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET> (veja Autenticação).

Honeydew Documentation MCP (opcional)

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

Removendo o servidor MCP

Para remover o servidor MCP Honeydew:

codex mcp remove honeydew

Para remover o servidor Honeydew Documentation MCP:

codex mcp remove honeydew-docs

Codex

#### Instalação do Plugin

Nota

Requer Git. Instalar o plugin do GitHub clona o repositório localmente, então o Git deve estar instalado e no seu PATH. Se o Git estiver ausente, a instalação do plugin falha. Instale o Git, ou use as etapas manuais de configuração MCP do seu cliente para configurar o servidor diretamente em vez do plugin.

Adicione o marketplace no Codex:

Abra Plugins
Clique na seta do menu suspenso e selecione Adicionar marketplace
Adicione honeydew-ai/honeydew-ai-coding-agents-plugins

Nota

Você também pode adicionar o marketplace pelo Codex CLI:
codex plugin marketplace add honeydew-ai/honeydew-ai-coding-agents-plugins

Em seguida, instale o plugin:

Abra Plugins
Selecione o marketplace Honeydew AI
Instale o plugin Honeydew

Configuração MCP

Nota

Se sua organização usa um hostname Honeydew personalizado, substitua https://mcp.honeydew.cloud/mcp pelo hostname do seu tenant. Você pode encontrar o hostname em Configurações > Servidor MCP no Honeydew Studio.

Honeydew MCP

Abra o aplicativo Codex
Vá para Configurações -> Servidores MCP
Em Servidores personalizados, clique em Adicionar servidor
Defina o nome do servidor como honeydew
Escolha Streamable HTTP como o tipo de transporte
Defina a URL para https://mcp.honeydew.cloud/mcp
Deixe o campo Variável de ambiente do token Bearer vazio
Configure a autenticação da seguinte forma:

Autenticação OAuth

O Codex redireciona você para autenticar com o Honeydew ao conectar. Nenhuma configuração adicional é necessária.

Autenticação HTTP Basic

Adicione um cabeçalho Authorization à lista de cabeçalhos acima com o valor Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET> (veja Autenticação).

Solução de problemas de autenticação MCP

Se o servidor MCP Honeydew não estiver autenticado no Codex e a opção "Autenticar" não aparecer:

Instale o Codex CLI
Execute codex mcp login honeydew

Honeydew Documentation MCP (opcional)

Vá para Configurações -> Servidores MCP
Em Servidores personalizados, clique em Adicionar servidor
Defina o nome do servidor como honeydew-docs
Escolha Streamable HTTP como o tipo de transporte
Defina a URL para https://honeydew.ai/docs/mcp

Removendo o servidor MCP

Para remover o servidor MCP Honeydew:

Vá para Configurações -> Servidores MCP
Encontre honeydew em Servidores personalizados e clique em Remover

Para remover o servidor Honeydew Documentation MCP:

Vá para Configurações -> Servidores MCP
Encontre honeydew-docs em Servidores personalizados e clique em Remover

Antigravity

#### Servidor MCP

Nota

Se sua organização usa um hostname Honeydew personalizado, substitua https://mcp.honeydew.cloud/mcp pelo hostname do seu tenant. Você pode encontrar o hostname em Configurações > Servidor MCP no Honeydew Studio.

Abra o editor Antigravity
Clique no menu suspenso ... no topo do painel do agente
Clique em Gerenciar servidores MCP
Clique em Ver configuração bruta

Adicione o seguinte 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>

Salve o arquivo

Honeydew Documentation MCP (opcional)

Abra o editor Antigravity
Clique no menu suspenso ... no topo do painel do agente
Clique em Gerenciar servidores MCP
Clique em Ver configuração bruta

Adicione o seguinte a mcp_config.json:

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

Salve o arquivo

Removendo o servidor MCP

Para remover o servidor MCP Honeydew:

Abra o editor Antigravity
Clique no menu suspenso ... no topo do painel do agente
Clique em Gerenciar servidores MCP
Clique em Ver configuração bruta
Remova as entradas honeydew e honeydew-docs de mcp_config.json
Salve o arquivo

OpenCode

#### Servidor MCP

Nota

Se sua organização usa um hostname Honeydew personalizado, substitua https://mcp.honeydew.cloud/mcp pelo hostname do seu tenant. Você pode encontrar o hostname em Configurações > Servidor MCP no Honeydew Studio.

Execute o seguinte comando e siga os prompts interativos:

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

  Quando solicitado, insira os seguintes valores:

  1. **Localização**: Escolha seu escopo preferido (projeto atual ou global)
  2. **Nome do servidor MCP**: `honeydew`
  3. **Tipo de servidor MCP**: `Remote`
  4. **URL do servidor MCP**: `https://mcp.honeydew.cloud/mcp`
  5. **Autenticação OAuth**: `Yes`
  6. **ID de cliente pré-registrado**: `No`
</Tab>

<Tab title="JSON configuration">
  Adicione o seguinte ao seu arquivo `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": {}
          }
        }
      }
      ```

      Em seguida, autentique com o Honeydew:

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

      Isso abre uma janela do navegador para concluir o fluxo de autenticação 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>

Reautenticação

Para reautenticar, verifique seu status e faça logout primeiro:

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

Honeydew Documentation MCP (opcional)

Execute `opencode mcp add` e insira os seguintes valores:

  1. **Nome do servidor MCP**: `honeydew-docs`
  2. **Tipo de servidor MCP**: `Remote`
  3. **URL do servidor MCP**: `https://honeydew.ai/docs/mcp`
  4. **Autenticação OAuth**: `No`
</Tab>

<Tab title="JSON configuration">
  Adicione o seguinte ao seu arquivo `opencode.jsonc`:

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

Removendo o servidor MCP

Para remover o servidor MCP Honeydew, remova a entrada honeydew do seu arquivo opencode.jsonc. Para remover o servidor Honeydew Documentation MCP, remova a entrada honeydew-docs do mesmo arquivo.

Kiro

O IDE Kiro e o CLI Kiro compartilham os mesmos arquivos de configuração MCP, portanto as etapas abaixo se aplicam a ambos.

Servidor MCP

O Kiro lê os servidores MCP de dois arquivos de configuração:

Workspace: .kiro/settings/mcp.json (específico do projeto atual)
Usuário: ~/.kiro/settings/mcp.json (aplica-se a todos os workspaces)

Se ambos os arquivos existirem, a configuração do workspace tem precedência.

Nota

Se sua organização usa um hostname Honeydew personalizado, substitua https://mcp.honeydew.cloud/mcp pelo hostname do seu tenant. Você pode encontrar o hostname em Configurações > Servidor MCP no Honeydew Studio.

Adicione o servidor MCP Honeydew a um desses arquivos mcp.json (workspace ou usuário):

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

  Ao conectar-se ao Honeydew pela primeira vez, o Kiro fornece uma URL de autenticação.
  Abra-a no seu navegador para concluir o fluxo de autenticação OAuth.
</Tab>

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

Na CLI do Kiro, execute /mcp para verificar se o servidor está conectado. No IDE do Kiro, o servidor aparece no painel MCP.

Honeydew Documentation MCP (opcional)

O servidor MCP do Honeydew já inclui ferramentas de acesso à documentação, portanto um servidor de documentação separado não é necessário. Adicione o Honeydew Documentation MCP apenas se você quiser acesso à documentação sem se conectar ao Honeydew. Nenhuma autenticação é necessária.

Adicione o seguinte ao seu mcp.json:

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

Removendo o servidor MCP

Para remover o servidor MCP do Honeydew, exclua a entrada honeydew do seu mcp.json. Para remover o servidor Honeydew Documentation MCP, exclua a entrada honeydew-docs do mesmo arquivo.

Snowflake Intelligence

O Snowflake se conecta a servidores MCP externos por meio de [conectores MCP](https://docs.snowflake.com/en/user-guide/snowflake-cortex/cortex-agents-mcp-connectors), disponibilizando as ferramentas do Honeydew para o Snowflake Intelligence e os Cortex Agents.

Pré-requisitos:

Uma função com o privilégio CREATE INTEGRATION na conta
Uma função com o privilégio CREATE MCP SERVER no schema de destino

Por padrão, apenas a função ACCOUNTADMIN possui esses privilégios.

Observação

Se sua organização usa um hostname personalizado do Honeydew, substitua https://mcp.honeydew.cloud/mcp pelo hostname do seu tenant. Você pode encontrar o hostname em Configurações > Servidor MCP no 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">
  O servidor MCP externo é um objeto de nível de schema
  que faz referência à integração 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">
  Conceda uso tanto na integração quanto no servidor MCP
  a todas as funções que precisam de acesso ao 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">
  Adicione o servidor MCP `honeydew` como uma ferramenta a um Cortex Agent
  ou a um agente do Snowflake Intelligence.
  Os usuários são solicitados a autenticar com OAuth no Honeydew no primeiro uso.
</Step>

Observação

O servidor Honeydew Documentation MCP autônomo não é suportado no Snowflake, pois os servidores MCP externos do Snowflake exigem autenticação OAuth e o servidor de documentação não é autenticado. O acesso à documentação está disponível por meio das ferramentas de documentação do servidor MCP do Honeydew.

Removendo o servidor MCP

Remova o servidor MCP primeiro e, em seguida, a integração de API:

DROP MCP SERVER honeydew;
DROP INTEGRATION honeydew_mcp_integration;

Outros Clientes

Qualquer cliente compatível com MCP pode se conectar ao Honeydew MCP Server usando o transporte HTTP padrão.

Use a seguinte configuração JSON como ponto de partida:

Observação

Se sua organização usa um hostname personalizado do Honeydew, substitua https://mcp.honeydew.cloud/mcp pelo hostname do seu tenant. Você pode encontrar o hostname em Configurações > Servidor MCP no 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 do servidor, Autenticação, e Configuração para obter detalhes sobre cada parâmetro.

Exemplo de Uso

Depois de conectado, você pode fazer perguntas ao seu assistente de IA, como:

"Quais entidades estão disponíveis no modelo semântico?"
"Mostre-me os atributos e métricas para a entidade orders"
"Quais domínios estão definidos no modelo?"
"Quais tabelas estão no schema analytics?"
"Quantos pedidos foram feitos no mês passado?"
"Crie uma nova métrica para receita total na entidade orders"
"Qual é o valor médio do pedido por região no último trimestre?"

Solução de Problemas

Problemas de Autenticação OAuth

Verifique se seu cliente suporta OAuth, garanta que você tenha as permissões necessárias do workspace do Honeydew e tente reautenticar por meio da interface de gerenciamento MCP do seu cliente.

Reautenticando no Claude Code

Digite /mcp, selecione o Honeydew MCP na lista, escolha "Limpar autenticação" ou "Autenticar", e siga os prompts OAuth do navegador para reconectar ao Honeydew.

Problemas de Conexão

Confirme se a URL do servidor MCP corresponde a https://mcp.honeydew.cloud/mcp e verifique se a sintaxe da configuração MCP do seu cliente está correta. Se sua organização usa um hostname personalizado, verifique se a URL corresponde ao hostname do seu tenant que aparece em Configurações > Servidor MCP no Honeydew Studio.

Ferramentas Ausentes

Verifique se a autenticação foi bem-sucedida, confira suas permissões de acesso ao workspace do Honeydew e revise o console do seu cliente para mensagens de erro.

Saída Excede o Limite Máximo de Tokens (Claude)

No Claude Code, Claude Desktop e Claude.ai, uma chamada de ferramenta pode falhar com um erro de que a saída excede o limite máximo de tokens. Ferramentas de análise do Honeydew, como monitor_analysis e get_analysis_step_details, podem retornar resultados grandes que ultrapassam o limite de saída MCP do Claude.

O Claude avisa quando a saída da ferramenta MCP excede 10.000 tokens e rejeita saídas acima do limite padrão de 25.000 tokens. Para aumentar o limite, defina a variável de ambiente MAX_MCP_OUTPUT_TOKENS antes de iniciar o Claude:

export MAX_MCP_OUTPUT_TOKENS=50000
claude

Consulte Limites e avisos de saída MCP na documentação do Claude para obter detalhes.

Para suporte adicional, entre em contato com o suporte do Honeydew em support@honeydew.ai.

Ferramentas Disponíveis

Ferramentas marcadas como somente leitura não modificam o modelo semântico nem o data warehouse.

Dica

Para expor apenas ferramentas somente leitura, defina o cabeçalho ReadonlyToolsOnly: true na configuração do seu servidor MCP. Quando habilitado, o servidor retorna apenas ferramentas que não modificam o modelo semântico nem o data warehouse.

Sessão e Workspace

`list_workspaces`

somente leitura

Lista todos os workspaces disponíveis. Retorna o nome do workspace e o tipo de data warehouse (snowflake, databricks ou bigquery). Use o tipo de data warehouse para informar a implementação do modelo semântico.

`list_workspace_branches`

somente leitura

Lista todos os branches disponíveis para um workspace.

O nome do workspace.

`get_session_workspace_and_branch`

somente leitura

Obtém o workspace e o branch definidos para a sessão atual.

`set_session_workspace_and_branch`

somente leitura

Define o workspace e o branch a serem usados na sessão atual. Todas as chamadas de ferramenta subsequentes na sessão usam este workspace e branch.

O nome do workspace. O branch a ser usado.

`create_workspace_branch`

Cria um novo branch para um workspace existente. O branch é criado a partir do estado atual do branch prod do workspace. Se nenhum workspace estiver fixado por meio de cabeçalhos, a sessão alterna para o novo branch automaticamente.

Nome do workspace para o qual criar um branch. Nome do novo branch a ser criado.

`delete_workspace_branch`

Exclui um branch de um workspace. Esta é uma operação destrutiva e irreversível. Sempre confirme o nome do workspace e o nome do branch com o usuário antes de chamar esta ferramenta. O branch prod não pode ser excluído. Se o branch excluído for o branch da sessão atual, a sessão alterna para prod automaticamente.

Nome do workspace que contém o branch a ser excluído. Nome do branch a ser excluído.

`get_branch_history`

somente leitura

Obtém o histórico de alterações do branch da sessão atual. Retorna uma lista de alterações mostrando quais objetos semânticos foram modificados, por quem e quando.

Número máximo de alterações a retornar.

`create_pr_for_working_branch`

Cria um pull request para o branch de trabalho da sessão atual. Retorna a URL do PR em caso de sucesso.

Título do pull request. Descrição do pull request.

Pergunta e Análise

`initiate_analysis`

somente leitura

Inicia ou continua uma análise de dados. Retorna um conversation_id — use monitor_analysis para consultar o progresso e os resultados, e abort_analysis para interrompê-lo antecipadamente. Consulte Análise Profunda para obter mais detalhes.

A pergunta em linguagem natural a ser feita. Nome do agente para uma nova conversa. Omita para perguntas de acompanhamento — o agente é herdado da conversa existente. ID da conversa existente para continuar, ou omita para iniciar uma nova conversa.

`monitor_analysis`

somente leitura

Consulta novas mensagens de progresso de uma análise em andamento. Cada chamada retorna apenas mensagens desde a última chamada. Consulte repetidamente até que status seja DONE ou NO_CHAT_CURRENTLY_RUNNING.

ID da conversa retornado por `initiate_analysis`. Número máximo de mensagens a retornar por chamada. ID da mensagem para reproduzir a partir dela. Use `last_received_message_id` de um resultado anterior para recuperar mensagens perdidas.

`get_analysis_step_details`

somente leitura

Recupera detalhes completos de uma etapa específica da análise, incluindo a consulta semântica, a instrução SQL, o contexto usado e os dados recuperados nessa etapa.

ID da conversa retornado por `initiate_analysis`. ID da etapa de `monitor_analysis` (por exemplo, `STEP/0`).

`abort_analysis`

somente leitura

Interrompe uma análise em andamento. Pode ser retomada do ponto interrompido com initiate_analysis.

ID da conversa retornado por `initiate_analysis`.

`list_analysis_chats`

somente leitura

Retorna uma lista paginada de conversas de análise para o workspace atual, ordenadas por data de criação (mais recentes primeiro). Administradores veem todas as conversas; não administradores veem apenas as suas. Cada entrada inclui o ID da conversa, título, feedback do usuário, domínio, agente, data de criação e o nome de exibição do usuário que a criou.

Número máximo de conversas a retornar. Número de conversas a pular para paginação.

`provide_analysis_feedback`

Define ou limpa o feedback em uma conversa de análise específica. Há uma única entrada de feedback por conversa (não por pergunta) — ela deve refletir a qualidade geral de todo o fluxo da conversa.

Chame esta ferramenta após monitor_analysis ser concluída e o usuário expressar satisfação ou insatisfação com o resultado. Use uma string afirmativa curta para feedback positivo (por exemplo, Good), ou o formato <Reason>: <details> para feedback negativo, onde Reason é um de Chart Issue, Data Issue, Wrong Judgement ou Other.

ID da conversa da conversa de análise. Texto do feedback a ser armazenado, ou `null` para limpar o feedback existente.

`get_stored_conversation`

somente leitura

Retorna todas as mensagens de uma conversa de análise existente. Use esta ferramenta para revisar o conteúdo completo de uma conversa anterior. is_complete na resposta indica se a conversa atingiu um estado terminal.

ID da conversa de `list_analysis_chats`. Se `true`, inclua entradas de progresso `step_start` e `step_insight`. Se `false`, retorne apenas respostas finais e mensagens de plano/interpretação.

Navegação e Descoberta

`list_entities`

somente leitura

Lista todas as entidades no modelo semântico com seus nomes, descrições e chaves.

`get_entity`

somente leitura

Obtém informações detalhadas sobre uma entidade, incluindo seus atributos, métricas, conjuntos de dados, relações e definição YAML. O nome da entidade.

`get_field`

somente leitura

Obtenha informações detalhadas sobre um campo específico (atributo ou métrica) dentro de uma entidade, incluindo sua definição em YAML.

O nome da entidade que contém o campo. O nome do campo.

`list_domains`

somente leitura*

Liste todos os domínios no modelo semântico com seus nomes, descrições e entidades.

`get_domain`

somente leitura

Obtenha informações detalhadas sobre um domínio, incluindo suas entidades, filtros, parâmetros e definição em YAML.

O nome do domínio.

`search_model`

somente leitura*

Pesquise no modelo semântico por entidades, atributos, métricas, conjuntos de dados, conjuntos de dados dinâmicos, domínios e parâmetros globais que correspondam a uma string de consulta.

Use a sintaxe entity.field para limitar a pesquisa a campos dentro de uma entidade específica. Por exemplo, customers.balance encontra o campo balance em entidades que correspondem a customers; customers. retorna todos os campos de entidades correspondentes. No modo OR/AND, correspondências parciais se aplicam tanto à entidade quanto ao campo — cust.bal corresponde a customers.balance.

A string de consulta de pesquisa. Controla como a consulta é correspondida:

OR — divide por espaços em branco, retorna objetos que correspondem a qualquer palavra.
AND — divide por espaços em branco, retorna apenas objetos que correspondem a todas as palavras.
EXACT — usa a string completa como está, retorna objetos cujo nome, nome de exibição ou rótulo é uma correspondência exata.

Descoberta de Warehouse

`list_databases`

somente leitura*

Liste todos os bancos de dados disponíveis no data warehouse conectado.

`list_schemas`

somente leitura*

Liste todos os esquemas em um banco de dados específico no data warehouse conectado.

O nome do banco de dados.

`list_tables`

somente leitura*

Liste tabelas/visões em um banco de dados e esquema específicos no data warehouse conectado.

O nome do banco de dados. O nome do esquema.

`get_table_info`

somente leitura*

Obtenha informações detalhadas sobre uma tabela/visão do warehouse, incluindo suas colunas e metadados.

O nome do banco de dados. O nome do esquema. O nome da tabela.

Modelo Semântico

`import_tables`

Importe tabelas do data warehouse conectado para o modelo semântico. Cada tabela se torna uma entidade com suas colunas como atributos.

Lista de nomes de tabelas totalmente qualificados no formato `database.schema.table`.

`create_entity`

Crie uma nova entidade no modelo semântico a partir de definições em YAML.

A definição em YAML para a entidade. A definição em YAML para o conjunto de dados.

`create_object`

Crie um novo objeto de modelo semântico a partir de uma definição em YAML. Tipos suportados: atributo calculado, métrica, conjunto de dados dinâmico, domínio e parâmetro global.

A definição em YAML do objeto. Crie o objeto mesmo se a validação produzir erros.

`update_object`

Atualize um objeto de modelo semântico existente a partir de uma definição em YAML. Tipos suportados: entidade, atributo calculado, métrica, conjunto de dados, conjunto de dados dinâmico, domínio e parâmetro global.

A definição em YAML do objeto. A chave do objeto a ser atualizado. Atualize o objeto mesmo se a validação produzir erros.

`validate_object`

somente leitura*

Valide uma definição em YAML de objeto de modelo semântico sem criar ou atualizá-lo. Tipos suportados: entidade, atributo calculado, métrica, conjunto de dados, conjunto de dados dinâmico, domínio e parâmetro global.

A definição em YAML a ser validada. A chave do objeto a ser validado.

`delete_object`

Exclua um objeto de modelo semântico pela sua chave.

A chave do objeto a ser excluído. Exclua o objeto mesmo se a validação produzir erros.

Agentes

`list_agents`

somente leitura*

Liste todos os agentes com seus nomes, descrições, domínios e referências de contexto.

`get_agent`

somente leitura*

Obtenha informações detalhadas sobre um agente, incluindo sua definição em frontmatter YAML.

Nome do agente a ser recuperado.

`create_agent`

Crie um novo agente.

Metadados para o novo agente. Nome hierárquico (ex.: `growth-analyst`, `finance/budget-analyst`).

<ParamField body="display_name" type="string" required>
  Nome legível por humanos exibido na interface.
</ParamField>

<ParamField body="description" type="string" required>
  Descrição do propósito e das capacidades do agente.
</ParamField>

<ParamField body="domain" type="string" required>
  O domínio em que este agente opera.
</ParamField>

<ParamField body="welcome_message" type="string">
  Mensagem introdutória exibida quando um usuário inicia uma sessão.
</ParamField>

<ParamField body="sample_questions" type="string[]">
  Perguntas de exemplo exibidas aos usuários.
</ParamField>

<ParamField body="context" type="string[]">
  Nomes de itens de contexto ou padrões glob para carregar nas sessões
  (ex.: `skills/**`, `knowledge/marketing/**`).
</ParamField>

<ParamField body="owner" type="string">
  Identificador do proprietário do agente.
</ParamField>

Corpo em Markdown anexado após o frontmatter. Este texto é injetado no prompt antes de cada sessão de análise. Crie o agente mesmo se a validação produzir erros.

`update_agent`

Atualize um agente existente.

Nome do agente a ser atualizado. Definição completa atualizada do agente. Todos os campos obrigatórios de `create_agent` devem ser fornecidos — esta é uma substituição completa, não uma atualização parcial. Corpo em Markdown atualizado para o agente. Atualize o agente mesmo se a validação produzir erros.

`delete_agent`

Exclua um agente pelo nome.

Nome do agente a ser excluído.

Itens de Contexto

`list_context_items`

somente leitura*

Liste todos os itens de contexto com seus tipos, nomes, títulos e valores de subtipo.

`get_context_item`

somente leitura*

Obtenha um item de contexto pelo nome.

Nome do item de contexto a ser recuperado.

`create_context_item`

Crie um novo item de contexto. Suporta tipos de instrução e memória.

Metadados para o novo item de contexto. Deve ser `instruction`.

<ParamField body="name" type="string" required>
  Nome hierárquico
  (ex.: `knowledge/customer/churn-analysis`, `skills/reporting`).
</ParamField>

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

<ParamField body="title" type="string" required>
  Título legível por humanos para o item de contexto.
</ParamField>

<ParamField body="apply" type="string" required>
  Quando aplicar o contexto: `always` ou `on_demand`.
</ParamField>

<ParamField body="description" type="string">
  Descrição usada pela IA para decidir quando carregar este item
  (obrigatória quando `apply` é `on_demand`).
</ParamField>

<ParamField body="owner" type="string">
  Identificador do proprietário.
</ParamField>

<ParamField body="labels" type="string[]">
  Rótulos para organizar itens de contexto.
</ParamField>

<ParamField body="related_objects" type="object[]">
  Objetos semânticos aos quais este item de contexto se relaciona.
  Cada objeto tem um `name` (string) e `type` (`domain`, `entity` ou `field`).
</ParamField>

<ParamField body="external_source" type="object">
  Fonte externa para buscar conteúdo (para o subtipo `knowledge`).
  Tem `tool` (nome da ferramenta MCP), `resource_id` (identificador na ferramenta externa)
  e `cache_max_age_in_seconds` opcional (padrão: `3600`).
</ParamField>

Deve ser `memory`.

<ParamField body="name" type="string" required>
  Nome hierárquico (ex.: `events/q4-launch`, `2024/pricing-decision`).
</ParamField>

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

<ParamField body="title" type="string" required>
  Título legível por humanos para o item de contexto.
</ParamField>

<ParamField body="apply" type="string" required>
  Quando aplicar o contexto: `always` ou `on_demand`.
</ParamField>

<ParamField body="from_date" type="string" required>
  Data de início do período de memória em formato ISO (ex.: `2024-01-01`).
</ParamField>

<ParamField body="to_date" type="string">
  Data de término do período de memória em formato ISO.
</ParamField>

<ParamField body="description" type="string">
  Descrição usada pela IA para decidir quando carregar este item
  (obrigatória quando `apply` é `on_demand`).
</ParamField>

<ParamField body="owner" type="string">
  Identificador do proprietário.
</ParamField>

<ParamField body="labels" type="string[]">
  Rótulos para organizar itens de contexto.
</ParamField>

<ParamField body="related_objects" type="object[]">
  Objetos semânticos aos quais este item de contexto se relaciona.
  Cada objeto tem um `name` (string) e `type` (`domain`, `entity` ou `field`).
</ParamField>

<ParamField body="external_source" type="object">
  Fonte externa para buscar conteúdo.
  Tem `tool` (nome da ferramenta MCP), `resource_id` (identificador na ferramenta externa)
  e `cache_max_age_in_seconds` opcional (padrão: `3600`).
</ParamField>

Corpo em Markdown para o conteúdo do item de contexto. Crie o item de contexto mesmo se a validação produzir erros.

`update_context_item`

Atualize um item de contexto existente.

Nome do item de contexto a ser atualizado. Definição completa atualizada do item de contexto. Todos os campos obrigatórios de `create_context_item` devem ser fornecidos — esta é uma substituição completa, não uma atualização parcial. Corpo em Markdown atualizado para o item de contexto. Atualize o item de contexto mesmo se a validação produzir erros.

`delete_context_item`

Exclua um item de contexto pelo nome.

Nome do item de contexto a ser excluído.

Consulta e Visualização

`get_sql_from_fields`

somente leitura*

Gere a consulta SQL para uma consulta de camada semântica definida por atributos, métricas e filtros. Retorna o SQL sem executá-lo.

Nomes de atributos totalmente qualificados (`entity.attribute_name`). Suporta aliases: `entity.attribute_name as alias_name`. Nomes de métricas totalmente qualificados (`entity.metric_name`) ou expressões SQL (ex.: `SUM(entity.field)`). Suporta aliases: `SUM(entity.field) as total`. Condições de filtro (ex.: `entity.field = 'value'`, `entity.date_field > '2024-01-01'`). Lista de campos para ordenar. Formato: `entity.field_name` ou `entity.field_name DESC`. A direção padrão é ASC. Ao usar aliases, ordene pelo nome do alias. O domínio a ser consultado. Número máximo de linhas a retornar. Número de linhas a pular para paginação. Adicione um [relatório de pré-agregação](/docs/performance/aggregate-awareness#debugging-aggregate-matching) ao topo do SQL retornado, informando para cada pré-agregação no workspace qual CTE a utilizou ou por que ela não pôde ser utilizada.

`get_data_from_fields`

somente leitura

Executa uma consulta da camada semântica definida por atributos, métricas e filtros, e retorna os dados resultantes.

Nomes de atributos totalmente qualificados (`entity.attribute_name`). Suporta aliases: `entity.attribute_name as alias_name`. Nomes de métricas totalmente qualificados (`entity.metric_name`) ou expressões SQL (ex.: `SUM(entity.field)`). Suporta aliases: `SUM(entity.field) as total`. Condições de filtro (ex.: `entity.field = 'value'`, `entity.date_field > '2024-01-01'`). Lista de campos para ordenação. Formato: `entity.field_name` ou `entity.field_name DESC`. A direção padrão é ASC. Ao usar aliases, ordene pelo nome do alias. O domínio a ser consultado. Número máximo de linhas a retornar. Número de linhas a pular para paginação.

`list_query_history`

somente leitura

Lista consultas executadas anteriormente por meio da camada semântica do Honeydew, das mais recentes para as mais antigas. Use para encontrar e diagnosticar consultas com falha e entender por que elas falharam. Chamadores não administradores veem apenas suas próprias consultas.

Cada consulta inclui seu status, mensagem de erro, proprietário, cliente, domínio, o SQL de entrada original (o SQL enviado pelo usuário para consultas da interface SQL), carimbos de data/hora para compilação e execução no warehouse, o ID da consulta no data warehouse e um link para abri-la no aplicativo Honeydew.

Filtrar por status da consulta (`FAILED`, `SUCCESS`, `RUNNING` ou `CANCELED`). Filtrar pelo cliente que executou a consulta (ex.: `Snowflake`, `MCP`). Filtrar por nome do domínio. Filtrar pelo proprietário da consulta (e-mail de um usuário ou nome de uma chave de API). Considerado apenas para chamadores administradores; não administradores são restritos às suas próprias consultas. Apenas consultas executadas a partir deste horário (ISO 8601). Apenas consultas executadas até este horário (ISO 8601). Também retorna a definição YAML semântica de cada consulta (atributos, métricas, filtros). Ative para reproduzir ou alterar uma consulta. Também retorna o SQL compilado no warehouse de cada consulta (grande). Ative para depuração no lado do warehouse de uma consulta específica. Número máximo de consultas a retornar. Número de consultas a pular para paginação.

Documentação

`search_docs`

somente leitura

Pesquise na base de conhecimento da documentação do Honeydew por informações relevantes, exemplos de código, referências de API e guias. Retorna conteúdo contextual com títulos e links para as páginas de documentação. Para ler o conteúdo completo de uma página, use query_docs_filesystem.

A consulta de pesquisa.

`query_docs_filesystem`

somente leitura

Execute um comando somente leitura semelhante a shell contra um sistema de arquivos virtualizado em memória que contém as páginas de documentação e especificações OpenAPI do Honeydew. Suporta comandos como rg, grep, find, tree, ls, cat, head e tail. Use para correspondência exata de palavras-chave ou regex, exploração estrutural ou leitura do conteúdo completo de uma página específica por caminho.

O comando shell a executar (ex.: `rg -il "keyword" /`, `tree / -L 2`, `head -80 /path/page.mdx`).

FAQ

Quais ferramentas são necessárias para análise profunda?

Executar Deep Analysis requer:

Configuração da sessão: list_workspaces, list_workspace_branches, get_session_workspace_and_branch, set_session_workspace_and_branch
Seleção do agente: list_agents, get_agent
Análise: initiate_analysis, monitor_analysis, get_analysis_step_details, abort_analysis
Feedback: provide_analysis_feedback

Para revisar conversas de análise anteriores, também ative list_analysis_chats e get_stored_conversation.

Limitar o agente a essas ferramentas é útil quando:

Seus usuários pretendidos executam apenas fluxos de trabalho de análise profunda
Você deseja manter o agente focado em tarefas de análise
Seu cliente limita quantas ferramentas podem ser ativadas (por exemplo, Databricks Genie Code)

Para outros casos de uso, exponha mais das ferramentas listadas em Tools Available — o agente seleciona a ferramenta certa para cada tarefa.