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

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

Explore tabelas e esquemas do warehouse — Peça ao seu assistente para descobrir e explorar tabelas, esquemas e definições de modelos semânticos no seu warehouse.
Crie modelos semânticos de forma conversacional — Use linguagem natural para criar e manter suas definições de modelos semânticos por meio do servidor MCP.
Consulte dados com linguagem natural — Faça perguntas sobre seus dados e obtenha respostas de qualquer assistente compatível com MCP.
Pesquise a documentação do Honeydew — Peça ao seu assistente para pesquisar e ler a documentação oficial do Honeydew para obter orientações.
Gerencie workspaces e branches — Use list_workspaces, list_workspace_branches e set_session_workspace_and_branch para configurar o contexto da sua sessão.

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

Descobrir e explorar tabelas, schemas e definições de modelos semânticos do seu warehouse
Construir e manter seu modelo semântico por meio de conversa natural
Consultar seus dados com linguagem natural a partir de qualquer assistente compatível com MCP
Pesquisar e ler 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 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: Fixar o workspace para todas as solicitações (opcional)
Branch: Fixar uma branch específica do workspace para todas as solicitações (opcional, padrão é prod se o workspace estiver definido)
Honeydew-Client: Identificar 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 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 skills 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 depois 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 na primeira conexão.

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.

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

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

Microsoft 365 Copilot

O Microsoft 365 Copilot conecta-se a servidores MCP externos por meio do [Copilot Studio](https://learn.microsoft.com/en-us/microsoft-copilot-studio/mcp-add-existing-server-to-agent): você adiciona o servidor MCP Honeydew como uma ferramenta em um agente do Copilot Studio e, em seguida, publica o agente no Microsoft 365 Copilot e no Teams.

Pré-requisitos:

Acesso ao Copilot Studio com permissão para criar agentes
Acesso ao Microsoft 365 Copilot para cada usuário do agente

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.

No Copilot Studio, selecione **Criar** -> **Novo agente** e nomeie o agente, por exemplo, `Honeydew`.

<Step title="Add the Honeydew MCP server as a tool">
  1. Abra o agente e vá para **Ferramentas** -> **Adicionar uma ferramenta** -> **Nova ferramenta** ->
     **Model Context Protocol**
  2. Insira `Honeydew` no campo **Nome do servidor**
  3. Insira uma descrição no campo **Descrição do servidor**, por exemplo,
     `Explore the semantic model and query data through the Honeydew Semantic Layer`.
     O agente usa a descrição para decidir quando chamar o Honeydew.
  4. Insira `https://mcp.honeydew.cloud/mcp` no campo **URL do servidor**
  5. Em **Autenticação**, selecione **OAuth 2.0** e defina o tipo como **Descoberta dinâmica**
  6. Selecione **Criar** e depois **Avançar**
</Step>

<Step title="Create the connection">
  Na caixa de diálogo **Adicionar ferramenta**, selecione **Criar uma nova conexão**. Entre com sua conta
  Honeydew e aceite a autorização OAuth, depois selecione **Adicionar ao agente**.

  Teste o agente no painel de teste do Copilot Studio, por exemplo, com
  "Quais entidades estão disponíveis no modelo semântico?"
</Step>

<Step title="Publish to Microsoft 365 Copilot">
  1. Selecione **Publicar**
  2. Vá para **Canais** -> **Teams e Microsoft Copilot**,
     mantenha **Disponibilizar o agente no Microsoft Copilot** selecionado e selecione **Adicionar canal**
  3. Selecione **Ver agente no Teams** -> **Adicionar** para instalar o agente para você no Teams e no
     Microsoft 365 Copilot
  4. Para permitir que outras pessoas usem o agente, compartilhe-o com elas pelo menu **Compartilhar** do agente e copie
     o link de instalação em **Opções de disponibilidade** ou envie o agente para aprovação do administrador
</Step>

No Microsoft 365 Copilot, abra o agente no painel esquerdo ou digite @ no chat e selecione-o, depois faça sua pergunta. Cada usuário é solicitado a entrar no Honeydew com OAuth no primeiro uso.

Honeydew Documentation MCP (opcional)

Adicione uma ferramenta Model Context Protocol ao agente com https://honeydew.ai/docs/mcp como URL do servidor e Nenhum como tipo de autenticação.

Removendo o servidor MCP

Para remover o Honeydew do agente, abra a página Ferramentas do agente e remova a ferramenta Honeydew, e a ferramenta de documentação, se você adicionou uma.

Para remover o agente do Microsoft 365 Copilot e do Teams, vá para Canais -> Teams e Microsoft Copilot e selecione Remover canal.

Cortex Code CLI

#### Instalação do Plugin

Observação

Requer Git. A instalação do 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 de configuração manual de 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 criar modelos semânticos e analisar dados por meio de conversa natural. A instalação do plugin configura os servidores MCP Honeydew automaticamente.

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.

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.

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

cortex mcp remove honeydew-docs

Cortex Code Desktop

#### Instalação do Plugin

Observação

Requer Git. A instalação do 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 de configuração manual de 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 guia Formulário ou JSON para inserir a configuraçã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.

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
      na primeira conexão.
    </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 guia **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
      na primeira conexão.
    </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 se 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, acesse cursor.com/dashboard/plugins (ou clique em Plugins no menu lateral esquerdo)
Role até Team Marketplaces e clique em um Marketplace existente, ou clique em Add Marketplace para criar um novo. Se estiver criando um novo, insira um nome e crie-o.
Dentro do Marketplace, clique em Add Plugin, cole o caminho do repositório GitHub do plugin Honeydew: https://github.com/honeydew-ai/honeydew-ai-coding-agents-plugins e clique em Add 1 plugin
Opcionalmente, ative auto-refresh 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 Add

Configuração do MCP

Use esta seção se a sua organização utiliza 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 o seu endpoint personalizado usando as instruções abaixo.

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 a sua organização utiliza um hostname Honeydew personalizado, substitua https://mcp.honeydew.cloud/mcp pelo hostname do seu tenant. Você pode encontrar o hostname em Settings > MCP Server no Honeydew Studio.

Para adicionar o MCP Honeydew:

Abra o aplicativo Cursor
Vá para Settings -> Cursor Settings -> Tools & MCP
Clique em New MCP Server

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 Save

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 apenas se você quiser acesso à documentação sem se conectar ao Honeydew. Nenhuma autenticação é necessária.

Vá para Settings -> Cursor Settings -> Tools & MCP
Clique em New MCP Server

Adicione a seguinte configuração:

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

Clique em Save

Removendo o servidor MCP

Para remover o servidor MCP Honeydew:

Vá para Settings -> Cursor Settings -> Tools & MCP
Encontre honeydew na lista e clique no ícone de exclusão

Para remover o servidor Honeydew Documentation MCP:

Vá para Settings -> Cursor Settings -> Tools & 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é **Catalog** → **Connections** → **Create a connection** 2. Na tela **Connection basics**: * Defina **Connection name** como `honeydew-mcp` * Defina **Connection type** como **HTTP** * Defina **Auth type** como **Dynamic Client Registration** * Clique em **Next** 3. Na tela **Authentication**: * Defina **Host** como `https://mcp.honeydew.cloud` * Deixe **Port** como `443` * Defina **OAuth scope** como `openid` * Clique em **Next** 4. Na tela **Connection details**: * Marque **Is MCP connection** * Defina **Base path** como `/mcp` * Clique em **Create connection**

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

Nota

Se a sua organização utiliza um hostname Honeydew personalizado, substitua https://mcp.honeydew.cloud pelo hostname do seu tenant. Você pode encontrar o hostname em Settings > MCP Server no Honeydew Studio.

<Step title="Log in to the connection">
  Navegue até **Catalog** → **Connections** → `honeydew-mcp`
  e clique em **Login** 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é **MCP Servers** → **Add Server**
  3. Selecione **External MCP server**
  4. Escolha a conexão `honeydew-mcp` que você criou
  5. Faça login na conexão quando solicitado
  6. Clique em **Save**

Nota

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 habilitar ou desabilitar 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é MCP Servers
Encontre honeydew-mcp e clique em Remove

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 através do seu MCP Marketplace.

Nota

Se a sua organização utiliza um hostname Honeydew personalizado, substitua https://mcp.honeydew.cloud/mcp pelo hostname do seu tenant. Você pode encontrar o hostname em Settings > MCP Server no Honeydew Studio.

Para adicionar o servidor MCP Honeydew:

Vá para Settings -> Connections -> MCP servers
Clique em Add a custom MCP
Insira honeydew no campo Server Name
Opcionalmente, adicione um ícone e uma Short Description
Escolha HTTP como tipo de transporte
Insira https://mcp.honeydew.cloud/mcp no campo Server URL

Configure a autenticação:

Selecione **OAuth** como 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 **Auth Header** como 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 [Authentication](#authentication)).
</Tab>

Clique em Save e depois em Test listing tools para verificar a conexão

Honeydew Documentation MCP (opcional)

Vá para Settings -> Connections -> MCP servers
Clique em Add a custom MCP
Insira honeydew-docs no campo Server Name
Escolha HTTP como tipo de transporte
Insira https://honeydew.ai/docs/mcp no campo Server URL
Defina o método de autenticação como None
Clique em Save

Removendo o servidor MCP

Para remover o servidor MCP Honeydew:

Vá para Settings -> Connections -> MCP servers
Encontre o servidor honeydew e remova-o

Para remover o servidor Honeydew Documentation MCP:

Vá para Settings -> Connections -> MCP servers
Encontre o servidor honeydew-docs e remova-o

GitHub Copilot CLI

#### Servidor MCP

Nota

Se a sua organização utiliza um hostname Honeydew personalizado, substitua https://mcp.honeydew.cloud/mcp pelo hostname do seu tenant. Você pode encontrar o hostname em Settings > MCP Server 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:
- Name: honeydew
- Type: http
- URL: https://mcp.honeydew.cloud/mcp
- HTTP Headers:
  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

Nota

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

Honeydew Documentation MCP (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:
- Name: honeydew-docs
- Type: 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 Honeydew Documentation MCP:

/mcp remove honeydew-docs

Gemini CLI

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

Nota

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

A flag --auto-update mantém a extensão atualizada automaticamente.

Configuração do MCP

Use esta seção se a sua organização utiliza um endpoint Honeydew personalizado, ou se você prefere configurar os servidores MCP sem instalar a extensão. Desative a conexão MCP Honeydew adicionada pela extensão e adicione o 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.

Nota

Se a sua organização utiliza um hostname Honeydew personalizado, substitua https://mcp.honeydew.cloud/mcp pelo hostname do seu tenant. Você pode encontrar o hostname em Settings > MCP Server 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>

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 somente se quiser acesso à documentação sem se conectar ao Honeydew. Nenhuma autenticação é necessária.

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

Removendo o servidor MCP

Para remover o servidor MCP do Honeydew:

gemini mcp remove honeydew

Para remover o servidor MCP do Honeydew Documentation:

gemini mcp remove honeydew-docs

VS Code e GitHub Copilot

#### Instalação 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. A instalação do plugin configura os servidores MCP do Honeydew automaticamente.

Adicionar o marketplace do 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 Preferences: Open User Settings (JSON))

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

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

Instalar o plugin

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

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.

Atualizar o plugin

Se extensions.autoUpdate estiver habilitado nas configurações do VS Code, o plugin é atualizado automaticamente. Para atualizar manualmente, abra a Paleta de Comandos e execute Extensions: Check for Extension Updates.

Servidor 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. Desabilite a conexão MCP do Honeydew adicionada pelo plugin e adicione seu endpoint personalizado usando as instruções abaixo.

O servidor MCP do Honeydew conecta o VS Code 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 Settings > MCP Server no Honeydew Studio.

Abra a Paleta de Comandos com CMD+Shift+P (macOS) ou Ctrl+Shift+P (Windows/Linux)
Selecione MCP: Add Server...
Escolha HTTP (HTTP or Server-Sent Events)
Digite a URL do servidor MCP do Honeydew: https://mcp.honeydew.cloud/mcp
Digite honeydew como 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)

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 do Honeydew, abra .vscode/mcp.json e exclua a entrada honeydew do objeto servers. Para remover o servidor MCP do Honeydew Documentation, 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.

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 do 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 do 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 Settings > MCP Server 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 como Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET> (veja Authentication).

Honeydew Documentation MCP (opcional)

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

Removendo o servidor MCP

Para remover o servidor MCP do Honeydew:

codex mcp remove honeydew

Para remover o servidor MCP do Honeydew Documentation:

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 Add 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 Settings > MCP Server no Honeydew Studio.

Honeydew MCP

Abra o aplicativo Codex
Vá para Settings -> MCP Servers
Em Custom servers, clique em Add Server
Defina o nome do servidor como honeydew
Escolha Streamable HTTP como o tipo de transporte
Defina a URL como https://mcp.honeydew.cloud/mcp
Deixe o campo Bearer token environment variable 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 Authentication).

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

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

Instale o Codex CLI
Execute codex mcp login honeydew

Honeydew Documentation MCP (opcional)

Vá para Settings -> MCP Servers
Em Custom servers, clique em Add Server
Defina o nome do servidor como honeydew-docs
Escolha Streamable HTTP como o tipo de transporte
Defina a URL como https://honeydew.ai/docs/mcp

Removendo o servidor MCP

Para remover o servidor MCP do Honeydew:

Vá para Settings -> MCP Servers
Encontre honeydew em Custom servers e clique em Remove

Para remover o servidor MCP do Honeydew Documentation:

Vá para Settings -> MCP Servers
Encontre honeydew-docs em Custom servers e clique em Remove

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 Settings > MCP Server no Honeydew Studio.

Abra o editor Antigravity
Clique no menu suspenso ... no topo do painel do agente
Clique em Manage MCP Servers
Clique em View raw config

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 Manage MCP Servers
Clique em View raw config

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 do Honeydew:

Abra o editor Antigravity
Clique no menu suspenso ... no topo do painel do agente
Clique em Manage MCP Servers
Clique em View raw config
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 Settings > MCP Server 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. **Local**: Escolha o escopo de sua preferência (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-se com a 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)

O servidor MCP da 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 à Honeydew. Nenhuma autenticação é necessária.

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 da 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 Kiro IDE e o Kiro CLI 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 terá precedência.

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.

Adicione o servidor MCP da 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 à 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>

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

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

Honeydew Documentation MCP (opcional)

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 da 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 conecta-se 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 da 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.

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.

```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 à 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 serão solicitados a autenticar com OAuth na Honeydew no primeiro uso.
</Step>

Nota

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

Removendo o servidor MCP

Remova primeiro o servidor MCP 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:

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.

```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 da 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 no navegador para reconectar-se à 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 da Honeydew e revise o console do seu cliente em busca de 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 da 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 recusa 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 da 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 ativado, 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 for fixado por meio de cabeçalhos, a sessão alterna automaticamente para o novo branch.

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 automaticamente para prod.

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

Poll por novas mensagens de progresso de uma análise em andamento. Cada chamada retorna apenas mensagens desde a última chamada. Faça polling 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` (ex.: `STEP/0`).

`abort_analysis`

somente leitura

Aborta uma análise em andamento. Pode ser retomada do ponto abortado com initiate_analysis.

ID da conversa retornado por `initiate_analysis`.

`list_analysis_chats`

somente leitura

Retorna uma lista paginada de conversas de análise do workspace atual, ordenadas por data de criação (mais recentes primeiro). Administradores veem todas as conversas; não administradores veem apenas as próprias. 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 isto após monitor_analysis ser concluído e o usuário expressar satisfação ou insatisfação com o resultado. Use uma string afirmativa curta para feedback positivo (ex.: 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 armazenar, ou `null` para limpar o feedback existente.

`get_stored_conversation`

somente leitura

Retorna todas as mensagens de uma conversa de análise existente. Use isto 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`, inclui entradas de progresso `step_start` e `step_insight`. Se `false`, retorna 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

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

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

`list_domains`

somente leitura

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

`get_domain`

somente leitura

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

O nome do domínio.

`search_model`

somente leitura

Pesquisa 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 à parte do campo — cust.bal corresponde a customers.balance.

Cada palavra (no modo EXACT, a consulta inteira) também corresponde a uma tag cuja chave ou valor corresponda a ela. Use key:value para corresponder a ambos: team:finance encontra objetos marcados com team=finance, e no modo OR/AND, team: encontra qualquer tag team.

A string da 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, rótulo ou tag seja uma correspondência exata.

Descoberta de Warehouse

`list_databases`

somente leitura

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

`list_schemas`

somente leitura

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

O nome do banco de dados.

`list_tables`

somente leitura

Lista 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

Obtém 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`

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

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

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

`create_object`

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

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

`update_object`

Atualiza um objeto de modelo semântico existente a partir de uma definição 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 YAML do objeto. A chave do objeto a atualizar. Atualiza o objeto mesmo se a validação produzir erros.

`validate_object`

somente leitura

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

A definição YAML a validar. A chave do objeto contra o qual validar.

`delete_object`

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

A chave do objeto a excluir. Exclui o objeto mesmo se a validação produzir erros.

Agentes

`list_agents`

somente leitura

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

`get_agent`

somente leitura

Obtém informações detalhadas sobre um agente, incluindo sua definição YAML de frontmatter.

Nome do agente a recuperar.

`create_agent`

Cria 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 Markdown anexado após o frontmatter. Este texto é injetado no prompt antes de cada sessão de análise. Cria o agente mesmo se a validação produzir erros.

`update_agent`

Atualiza um agente existente.

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

`delete_agent`

Exclui um agente pelo nome.

Nome do agente a excluir.

Itens de Contexto

`list_context_items`

somente leitura

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

`get_context_item`

somente leitura

Obtém um item de contexto pelo nome.

Nome do item de contexto a recuperar.

`create_context_item`

Cria um novo item de contexto. Suporta tipos 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>

Fonte externa para buscar conteúdo (para o subtipo `knowledge`). Possui `tool` (nome da ferramenta MCP), `resource_id` (identificador na ferramenta externa) e `cache_max_age_in_seconds` opcional (padrão: `3600`). 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 para humanos do 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 possui um `name` (string) e `type` (`domain`, `entity` ou `field`).
</ParamField>

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

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

`update_context_item`

Atualizar 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 Markdown atualizado para o item de contexto. Atualizar o item de contexto mesmo se a validação produzir erros.

`delete_context_item`

Excluir 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

Gerar a consulta SQL para uma consulta da 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. Adicionar 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 não pôde ser utilizada.

`get_data_from_fields`

somente leitura

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

`list_query_history`

somente leitura

Listar consultas executadas anteriormente por meio da camada semântica Honeydew, das mais recentes para as mais antigas. Use para encontrar e diagnosticar consultas com falha e entender por que 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 neste horário ou depois (ISO 8601). Apenas consultas executadas neste horário ou antes (ISO 8601). Também retornar a definição YAML semântica de cada consulta (atributos, métricas, filtros). Ative para reproduzir ou alterar uma consulta. Também retornar o SQL compilado do 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

Pesquisar a base de conhecimento da documentação Honeydew para obter 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 da 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

Executar um comando semelhante a shell somente leitura contra um sistema de arquivos virtualizado em memória que contém as páginas da documentação Honeydew e especificações OpenAPI. 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 ser executado (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.

Esta documentação é construída e hospedada no Mintlify, uma plataforma de documentação para desenvolvedores.