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?

Descubra tabelas e esquemas do warehouse — explore a estrutura do seu data warehouse e definições de modelo semântico por meio de conversas naturais.
Crie e mantenha modelos semânticos — crie ou atualize definições de modelo semântico usando create_workspace_branch e outras ferramentas de sessão.
Consulte dados com linguagem natural — faça perguntas sobre seus dados e obtenha respostas sem escrever SQL.
Pesquise na documentação do Honeydew — consulte a documentação do produto diretamente de qualquer assistente compatível com 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 de IA à Camada Semântica Honeydew.

Quando usar

Descobrir e explorar suas tabelas de warehouse, esquemas e definições de modelo semântico
Construir e manter seu modelo semântico através de conversa natural
Consultar seus dados com linguagem natural 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

Se sua organização usa um hostname Honeydew personalizado, 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 maneiras de autenticar com o Servidor MCP 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 requisições subsequentes.

Autenticação HTTP Basic

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

Você precisa fornecer uma string codificada em Base64 da sua Chave de API e Segredo de API no formato API_KEY:API_SECRET.

Se estiver criando uma nova Chave de API 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 do 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 requisições (opcional)
Branch: Fixar uma branch específica do workspace para todas as requisições (opcional, padrão prod se o workspace estiver definido)
Honeydew-Client: Identificar o cliente MCP (opcional, detectado automaticamente da ferramenta conectada). Passe este cabeçalho para fornecer um identificador de cliente específico.
ReadonlyToolsOnly: Defina como true para expor apenas ferramentas de leitura (opcional)

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. Veja a [especificação de gerenciamento de sessão MCP](https://modelcontextprotocol.io/specification/2025-06-18/basic/transports#session-management) para detalhes.

Clientes Suportados

Claude Code CLI

#### Instalação do Plugin **Requer Git.** Instalar o plugin do GitHub clona o repositório localmente, então o [Git](https://git-scm.com/downloads) 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 do 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 através de conversa natural. Instalar o plugin configura os servidores MCP da Honeydew automaticamente.

Inicie o Claude Code com claude, depois adicione o marketplace:

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

Depois instale o plugin Honeydew 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 Honeydew, inicie o Claude Code com claude, depois:

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 Honeydew personalizado, ou se você prefere configurar os servidores MCP sem instalar o plugin. Desabilite a conexão MCP Honeydew adicionada pelo plugin, depois adicione seu endpoint personalizado usando as instruções abaixo.

O servidor MCP Honeydew conecta o Claude Code à Camada Semântica Honeydew 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 Honeydew:

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} claude mcp add --transport http honeydew \ https://mcp.honeydew.cloud/mcp ```

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

      Depois registre com:

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

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

      Depois registre 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 na 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>

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

Para evitar armazenar valores sensíveis diretamente em arquivos de configuração,
o Claude Code suporta
[expansão de variáveis de ambiente](https://code.claude.com/docs/en/mcp#environment-variable-expansion-in-mcp-json)
usando a sintaxe `${VAR_NAME}`.

Defina a variável de ambiente `HONEYDEW_API_KEY`,
depois faça referência a ela na sua configuração:

```bash theme={null}
claude mcp add --transport http honeydew \
    https://mcp.honeydew.cloud/mcp \
    --header "Authorization: Basic ${HONEYDEW_API_KEY}"
```

O Claude Code resolve as referências `${VAR_NAME}`
em tempo de execução a partir do seu ambiente.

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 apenas se quiser acesso à documentação sem se 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 Honeydew:

claude mcp remove honeydew

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

claude mcp remove honeydew-docs

Claude Desktop

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 Honeydew conecta o Claude Desktop à Camada Semântica Honeydew 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.

Para adicionar o MCP 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 na Honeydew ao conectar pela primeira vez.

MCP de Documentação 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 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 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 Honeydew personalizado, ou se você prefere configurar os servidores MCP sem instalar o plugin. Remova o conector MCP Honeydew adicionado pelo plugin, depois adicione seu endpoint personalizado usando as instruções abaixo.

O servidor MCP Honeydew conecta o Claude.ai à Camada Semântica Honeydew para exploração de modelos, consulta de dados, gerenciamento de modelos e acesso à documentação.

Para adicionar o servidor MCP 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 no Honeydew ao conectar pela primeira vez.

Honeydew Documentation MCP (opcional)

O servidor Honeydew MCP 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 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 Honeydew MCP:

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

Cortex Code CLI

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

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

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

Configuração do 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 Honeydew MCP adicionada pelo plugin e, em seguida, adicione seu endpoint personalizado usando as instruções abaixo.

O servidor Honeydew MCP conecta o Cortex Code CLI à Camada Semântica do Honeydew para exploração de modelos, consulta de dados, gerenciamento de modelos e acesso à documentação.

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

cortex mcp remove honeydew

Para remover o servidor Honeydew Documentation MCP:

cortex mcp remove honeydew-docs

Cortex Code Desktop

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 Plugin do GitHub

Configuração do MCP

O servidor Honeydew MCP conecta o Cortex Code Desktop à Camada Semântica do Honeydew 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.

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 no 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">
  Mude 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 no 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 Honeydew MCP 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, vá para cursor.com/dashboard/plugins (ou clique em Plugins no menu lateral esquerdo)
Role para baixo até Marketplaces da Equipe e clique em um Marketplace existente, ou clique em Adicionar Marketplace para criar um novo. Se criar um novo, insira um nome e crie-o.
Dentro do Marketplace, clique em Adicionar Plugin, cole o caminho do repositório do plugin Honeydew no GitHub: https://github.com/honeydew-ai/honeydew-ai-coding-agents-plugins e clique em Adicionar 1 plugin
Opcionalmente, habilite 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 Adicionar

Configuração do MCP

O servidor Honeydew MCP conecta o Cursor à Camada Semântica do Honeydew para exploração de modelos, consulta de dados, gerenciamento de modelos e acesso à documentação.

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

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

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

Servidores MCP são suportados apenas no modo Genie Code Agent. Para mais detalhes, veja a [documentação do Databricks MCP](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 **Informaçõ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 **É 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>
```
Se sua organização usa um hostname Honeydew personalizado, substitua `https://mcp.honeydew.cloud` pelo hostname do seu tenant. Você pode encontrar seu hostname em **Configurações > Servidor MCP** no Honeydew Studio. Navegue até **Catálogo** → **Conexões** → `honeydew-mcp` e clique em **Login** no canto superior direito para autenticar e verificar a conexão. Conceda o privilégio `USE CONNECTION` a quaisquer usuários ou funções que precisem de acesso ao servidor MCP Honeydew:
```
GRANT USE CONNECTION ON CONNECTION `honeydew-mcp` TO <user-or-role>;
```
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** 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 de 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é Servidores MCP
Encontre honeydew-mcp e clique em Remover

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

DROP CONNECTION `honeydew-mcp`;

Devin

#### Servidor MCP

O Devin conecta-se a servidores MCP remotos através do seu MCP Marketplace.

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ê 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>`
  (veja [Autenticação](#authentication)).
</Tab>

Clique em Salvar e, em seguida, clique em Testar ferramentas de listagem para verificar a conexão

MCP de Documentação Honeydew (opcional)

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

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 IA

**Requer Git.** A instalação do plugin a partir do GitHub clona o repositório localmente, portanto, o [Git](https://git-scm.com/downloads) 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 do 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 através 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 **Requer Git.** A instalação do plugin a partir do GitHub clona o repositório localmente, portanto, o [Git](https://git-scm.com/downloads) 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 do 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 através de conversa natural. A instalação da 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 sua organização usa um endpoint Honeydew personalizado, ou se você preferir configurar os servidores MCP sem instalar a extensão. Desabilite a conexão MCP Honeydew adicionada pela extensão e, em seguida, adicione seu endpoint personalizado usando as instruções abaixo.

O servidor MCP Honeydew conecta o Gemini CLI à Camada Semântica Honeydew para exploração de modelos, consulta de dados, gerenciamento de modelos e acesso à documentação.

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

O Honeydew fornece um repositório de plugins com habilidades e ferramentas para construir modelos semânticos e analisar dados através de conversa natural. A instalação do plugin configura os servidores MCP Honeydew automaticamente.

Adicionar 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, depois 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"
]

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 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 aviso de confiança — revise a origem 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 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. Desabilite a conexão MCP Honeydew adicionada pelo plugin e, em seguida, adicione seu endpoint personalizado usando as instruções abaixo.

O servidor MCP Honeydew conecta o VS Code à Camada Semântica Honeydew para exploração de modelos, consulta de dados, gerenciamento de modelos e acesso à documentação.

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. 1. Abra a Paleta de Comandos com `CMD+Shift+P` (macOS) ou `Ctrl+Shift+P` (Windows/Linux) 2. Selecione **MCP: Adicionar Servidor...** 3. Escolha **HTTP (HTTP ou Eventos Enviados pelo Servidor)** 4. Insira a URL do servidor MCP do Honeydew: `https://mcp.honeydew.cloud/mcp` 5. 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>

MCP de Documentação do Honeydew (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 MCP de Documentação do Honeydew apenas 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 do Honeydew, abra .vscode/mcp.json e exclua a entrada honeydew do objeto servers. Para remover o servidor MCP de Documentação do Honeydew, exclua a entrada honeydew-docs do mesmo arquivo.

Codex CLI

#### Instalação do Plugin **Requer Git.** A instalação do plugin a partir do GitHub clona o repositório localmente, portanto, o [Git](https://git-scm.com/downloads) 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 do 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 do MCP

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

O servidor MCP do Honeydew conecta o Codex à Camada Semântica do Honeydew para exploração de modelos, consulta de dados, gerenciamento de modelos e acesso à documentação.

Se sua organização usa um nome de host personalizado do Honeydew, substitua `https://mcp.honeydew.cloud/mcp` pelo nome de host do seu tenant. Você pode encontrar o nome de host 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 no 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> (consulte Autenticação).

MCP de Documentação do Honeydew (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 de Documentação do Honeydew:

codex mcp remove honeydew-docs

Codex

Adicione o marketplace no Codex:

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

Você também pode adicionar o marketplace a partir do [Codex CLI](#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 do MCP

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 HTTP Transmissível como o tipo de transporte
Defina a URL como https://mcp.honeydew.cloud/mcp
Deixe o campo Variável de ambiente do token de portador 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> (consulte Autenticação).

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

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

Instale o Codex CLI
Execute codex mcp login honeydew

MCP de Documentação do Honeydew (opcional)

Vá para Configurações -> Servidores MCP
Em Servidores personalizados, clique em Adicionar Servidor
Defina o nome do servidor como honeydew-docs
Escolha HTTP Transmissível 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 Configurações -> Servidores MCP
Encontre honeydew em Servidores personalizados e clique em Remover

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

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

Antigravity

#### Servidor MCP Se sua organização usa um nome de host personalizado do Honeydew, substitua `https://mcp.honeydew.cloud/mcp` pelo nome de host do seu tenant. Você pode encontrar o nome de host 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

MCP de Documentação do Honeydew (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 do 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

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

MCP de Documentação do Honeydew (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 do Honeydew, remova a entrada honeydew do seu arquivo opencode.jsonc. Para remover o servidor MCP de Documentação do Honeydew, 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 para o 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. 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.

Adicione o servidor Honeydew MCP a um destes 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 em 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>

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 Honeydew MCP 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 quiser acesso à documentação sem conectar-se 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 Honeydew MCP, 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 do Honeydew para o Snowflake Intelligence e Cortex Agents.

Pré-requisitos:

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

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

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. ```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 em nível de schema
  que referencia a integração da 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
  para quaisquer roles que precisem 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 um agente do Snowflake Intelligence.
  Os usuários são solicitados a autenticar-se com OAuth no Honeydew no primeiro uso.
</Step>

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

Removendo o servidor MCP

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

DROP MCP SERVER honeydew;
DROP INTEGRATION honeydew_mcp_integration;

Outros Clientes

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

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

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

Uma vez conectado, você pode perguntar ao seu assistente de IA coisas 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, certifique-se de ter as permissões necessárias no workspace Honeydew e tente reautenticar através da interface de gerenciamento MCP do seu cliente.

Reautenticando no Claude Code

Digite /mcp, selecione o Honeydew MCP na lista, escolha "Clear authentication" ou "Authenticate", e siga as instruções OAuth no navegador para reconectar-se 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 de 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 Settings > MCP Server no Honeydew Studio.

Ferramentas Ausentes

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

Saída Excede o Máximo de Tokens Permitidos (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 máximo de tokens permitidos. 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 a saída 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 de saída MCP e avisos na documentação do Claude para obter detalhes.

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

Ferramentas Disponíveis

Ferramentas marcadas como read-only não modificam o modelo semântico ou o data warehouse.

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 ou o data warehouse.

Sessão & Workspace

`list_workspaces`

read-only

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`

read-only

Lista todas as branches disponíveis para um workspace.

O nome do workspace.

`get_session_workspace_and_branch`

read-only

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

`set_session_workspace_and_branch`

read-only

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

O nome do workspace. A branch a ser usada.

`create_workspace_branch`

Cria uma nova branch para um workspace existente. A branch é criada a partir do estado atual da branch prod do workspace. Se nenhum workspace estiver fixado via cabeçalhos, a sessão muda para a nova branch automaticamente.

Nome do workspace para o qual criar uma branch. Nome da nova branch a ser criada.

`delete_workspace_branch`

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

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

`get_branch_history`

read-only

Obtém o histórico de alterações para a 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 a 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 & Análise

`initiate_analysis`

read-only

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ê-la antecipadamente. Consulte Análise Profunda para 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`

read-only

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 a partir da qual reproduzir. Use `last_received_message_id` de um resultado anterior para recuperar mensagens perdidas.

`get_analysis_step_details`

read-only

Recupera detalhes completos de uma etapa de análise específica, 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`

read-only

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`

read-only

Retorna uma lista paginada de conversas de análise para o workspace atual, ordenadas por hora 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, hora 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 de análise. Texto de feedback a armazenar, ou `null` para limpar o feedback existente.

`get_stored_conversation`

read-only Retorna todas as mensagens de uma conversa de análise existente. Use isso 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 & 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 correspondam a customers; customers. retorna todos os campos das entidades correspondentes. No modo OR/AND, correspondências parciais se aplicam tanto à parte da entidade quanto à do 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 correspondam a qualquer palavra.
AND — divide por espaços em branco, retorna apenas objetos que correspondam a todas as palavras.
EXACT — usa a string completa como está, retorna objetos cujo nome ou nome de exibição seja uma correspondência exata.

Descoberta do 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 tabela 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 do modelo semântico a partir de uma definição YAML. Tipos suportados: atributo, métrica, conjunto de dados dinâmico, domínio e parâmetro global.

A definição YAML do objeto. Cria o objeto mesmo que a validação produza erros.

`update_object`

Atualiza um objeto existente do modelo semântico a partir de uma definição YAML. Tipos suportados: entidade, atributo, 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 ser atualizado. Atualiza o objeto mesmo que a validação produza erros.

`validate_object`

somente leitura

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

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

`delete_object`

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

A chave do objeto a ser excluído. Exclui o objeto mesmo que a validação produza 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 de frontmatter YAML.

Nome do agente a ser recuperado.

`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 mostrado na IU.
</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 mostrada quando um usuário inicia uma sessão.
</ParamField>

<ParamField body="sample_questions" type="string[]">
  Perguntas de exemplo mostradas 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 que a validação produza erros.

`update_agent`

Atualiza um agente existente.

Nome do agente a ser atualizado. Definição completa e 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 Markdown atualizado para o agente. Atualiza o agente mesmo que a validação produza erros.

`delete_agent`

Exclui um agente pelo nome.

Nome do agente a ser excluído.

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

`create_context_item`

Cria um novo item de contexto. Suporta os 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ório quando `apply` for `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 de onde 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ório quando `apply` for `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 de onde 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 Markdown para o conteúdo do item de contexto. Cria o item de contexto mesmo que a validação produza erros.

`update_context_item`

Atualiza um item de contexto existente.

Nome do item de contexto a ser atualizado. Definição completa e 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. Atualiza o item de contexto mesmo que a validação produza erros.

`delete_context_item`

Exclui um item de contexto pelo nome.

Nome do item de contexto a ser excluído.

Consulta & Pré-visualização

`get_sql_from_fields`

somente leitura

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

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

`list_query_history`

somente leitura

Lista consultas executadas anteriormente através da camada semântica Honeydew, as mais recentes primeiro. Use para encontrar e classificar 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), registros de data/hora para compilação e execução no data 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 por proprietário da consulta (e-mail de um usuário ou nome de uma chave de API). Respeitado 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). Retornar também a definição YAML semântica de cada consulta (atributos, métricas, filtros). Habilite para reproduzir ou alterar uma consulta. Retornar também o SQL compilado do data warehouse de cada consulta (grande). Habilite para depuração no lado do data 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

Pesquisa na base de conhecimento da documentação 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

Executa um comando somente leitura similar a shell em um sistema de arquivos virtualizado em memória que contém as páginas de 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 pelo caminho.

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