Honeydew Semantic Layer

официальный

Семантический слой Honeydew предоставляет управляемую, удобную для бизнеса модель данных, объединяющую метрики, измерения и взаимосвязи между источниками, обеспечивая согласованную самостоятельную аналитику и доступ к данным на основе ИИ.

Смотреть на honeydew.aiПопробовать этот MCPСпонсировано

Что можно делать с Honeydew Semantic Layer MCP?

  • Изучение метаданных хранилища — Попросите вашего ассистента обнаружить таблицы, схемы и определения семантических моделей в вашем хранилище.
  • Управление семантическими моделями — Создавайте и поддерживайте свою семантическую модель через естественный диалог, включая создание веток рабочего пространства с помощью create_workspace_branch.
  • Запрос данных в разговорном режиме — Используйте естественный язык для запроса данных из любого MCP-совместимого ассистента.
  • Настройка контекста сеанса — Установите активное рабочее пространство и ветку с помощью set_session_workspace_and_branch после просмотра доступных опций через list_workspaces и list_workspace_branches.
  • Доступ к документации Honeydew — Ищите и читайте документацию Honeydew напрямую через встроенные инструменты документации MCP-сервера.

Документация

MCP-сервер

Что такое MCP?

Model Context Protocol (MCP) — это открытый стандарт для безопасного подключения AI-приложений к внешним системам и инструментам. Honeydew предоставляет MCP-сервер, который подключает ваш AI-ассистент для программирования к Honeydew Semantic Layer.

Когда использовать

  • Исследуйте и изучайте таблицы вашего хранилища, схемы и определения семантических моделей
  • Создавайте и поддерживайте семантическую модель с помощью естественного диалога
  • Запрашивайте данные на естественном языке из любого MCP-совместимого ассистента
  • Ищите и читайте документацию Honeydew

Установка

URL сервера

Honeydew предоставляет API MCP-сервера по адресу https://mcp.honeydew.cloud/mcp

Примечание

Если ваша организация использует собственное имя хоста Honeydew, замените URL по умолчанию на имя хоста вашего тенанта. Имя хоста можно найти в интерфейсе Honeydew в разделе Settings > MCP Server.

Аутентификация

Существует два способа аутентификации на MCP-сервере Honeydew: OAuth или HTTP Basic аутентификация.

OAuth-аутентификация (рекомендуется)

Большинство клиентов поддерживают OAuth-аутентификацию. При первом подключении вам будет предложено:

  1. Войти с помощью учетной записи Honeydew
  2. Принять авторизацию OAuth

Затем клиент безопасно предоставляет токен доступа для последующих запросов.

HTTP Basic аутентификация

MCP-сервер в режиме HTTP Basic аутентификации требует API-ключ для аутентификации.

Вам необходимо предоставить строку в кодировке Base64, содержащую ваш API-ключ и API-секрет, в формате API_KEY:API_SECRET.

Совет

При создании нового API-ключа для доступа к MCP-серверу вы можете скопировать строку в кодировке Base64 из интерфейса Honeydew Studio в момент создания.

Вы можете использовать следующую команду для генерации строки в кодировке Base64:

```bash theme={null} echo -n ':' | base64 ``` Используйте PowerShell: 
```powershell theme={null}
[Convert]::ToBase64String(
  [Text.Encoding]::UTF8.GetBytes(
    "<API_KEY>:<API_SECRET>"
  )
)
```

Укажите закодированную строку в заголовке Authorization следующим образом:

Authorization: Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET>

Конфигурация

Рабочая область и ветка задаются на уровне сеанса с помощью инструментов list_workspaces, list_workspace_branches и set_session_workspace_and_branch. Вы также можете создавать новые ветки с помощью create_workspace_branch. Вызывайте эти инструменты из вашего AI-ассистента после подключения к MCP-серверу.

Вы можете дополнительно указать эти заголовки в конфигурации MCP-сервера:

  • Workspace: закрепить рабочую область для всех запросов (необязательно)
  • Branch: закрепить конкретную ветку рабочей области для всех запросов (необязательно, по умолчанию prod, если задана рабочая область)
  • Honeydew-Client: идентифицировать MCP-клиента (необязательно, определяется автоматически из подключенного инструмента). Передайте этот заголовок, чтобы указать конкретный идентификатор клиента.
  • ReadonlyToolsOnly: установите значение true, чтобы предоставить доступ только к инструментам чтения (необязательно)

Примечание

MCP-сервер использует заголовок ответа Mcp-Session-Id для поддержания состояния сеанса, включая активную рабочую область и ветку. См. спецификацию управления сеансами MCP для подробностей.

Поддерживаемые клиенты

Claude Code CLI

#### Установка плагина

Примечание

Требуется Git. Установка плагина из GitHub клонирует репозиторий локально, поэтому Git должен быть установлен и находиться в вашем PATH. Если Git отсутствует, установка плагина завершится ошибкой. Установите Git или используйте шаги ручной настройки MCP вашего клиента для прямой настройки сервера вместо плагина.

Honeydew предоставляет репозиторий плагинов с навыками и инструментами для создания семантических моделей и анализа данных с помощью естественного диалога. Установка плагина автоматически настраивает MCP-серверы Honeydew.

Запустите Claude Code с claude, затем добавьте маркетплейс:

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

Затем установите плагин Honeydew из маркетплейса:

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

Затем перезагрузите плагины для активации:

/reload-plugins

Обновление плагинов

Чтобы обновить плагины маркетплейса Honeydew, запустите Claude Code с claude, затем:

  1. Введите /plugin и выберите Marketplaces в селекторе вверху
  2. Выберите honeydew-ai-coding-agents-plugins
  3. Нажмите Update marketplace

Чтобы получать обновления автоматически, выберите Enable auto-update в настройках маркетплейса.

Настройка MCP

Используйте этот раздел, если ваша организация использует собственную конечную точку Honeydew, или если вы предпочитаете настраивать MCP-серверы без установки плагина. Отключите подключение MCP Honeydew, добавленное плагином, затем добавьте собственную конечную точку, следуя инструкциям ниже.

MCP-сервер Honeydew подключает Claude Code к Honeydew Semantic Layer для исследования моделей, запроса данных, управления моделями и доступа к документации.

Используйте один из следующих методов для добавления MCP-сервера Honeydew:

Примечание

Если ваша организация использует собственное имя хоста Honeydew, замените https://mcp.honeydew.cloud/mcp на имя хоста вашего тенанта. Имя хоста можно найти в Settings > MCP Server в Honeydew Studio.

```bash theme={null} claude mcp add --transport http honeydew \ https://mcp.honeydew.cloud/mcp ``` 
      Запустите Claude Code с `claude`.
      Вам будет предложено пройти аутентификацию с помощью OAuth для 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">
  Сохраните следующее в `honeydew-mcp.json`:

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

      Затем зарегистрируйте его с помощью:

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

      Запустите Claude Code с `claude`.
      Вам будет предложено пройти аутентификацию с помощью OAuth для 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>"
        }
      }
      ```

      Затем зарегистрируйте его с помощью:

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

<Tab title=".mcp.json">
  Добавьте следующее в ваш файл `.mcp.json`:

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

      Запустите Claude Code с `claude`.
      Вам будет предложено пройти аутентификацию с помощью OAuth для 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>

Совет

Использование переменных окружения для аутентификации по API-ключу

Чтобы избежать хранения чувствительных значений непосредственно в файлах конфигурации, Claude Code поддерживает подстановку переменных окружения с использованием синтаксиса ${VAR_NAME}.

Установите переменную окружения HONEYDEW_API_KEY, затем укажите ее в вашей конфигурации:

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

Claude Code разрешает ссылки ${VAR_NAME} во время выполнения из вашего окружения.

MCP документации Honeydew (необязательно)

MCP-сервер Honeydew уже включает инструменты доступа к документации, поэтому отдельный сервер документации не требуется. Добавляйте MCP документации Honeydew только в том случае, если вам нужен доступ к документации без подключения к Honeydew. Аутентификация не требуется.

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

Удаление MCP-сервера

Чтобы удалить MCP-сервер Honeydew:

claude mcp remove honeydew

Чтобы удалить MCP-сервер документации Honeydew:

claude mcp remove honeydew-docs

Claude Desktop

#### Установка плагина

Примечание

Требуется Git. Установка плагина из GitHub клонирует репозиторий локально, поэтому Git должен быть установлен и находиться в вашем PATH. Если Git отсутствует, установка плагина завершится ошибкой. Установите Git или используйте шаги ручной настройки MCP вашего клиента для прямой настройки сервера вместо плагина.

Honeydew предоставляет репозиторий плагинов с навыками и инструментами для создания семантических моделей и анализа данных с помощью естественного диалога. Установка плагина автоматически настраивает MCP-серверы Honeydew.

  1. Перейдите в Settings -> Customize
  2. Нажмите Browse Plugins
  3. Перейдите на вкладку Personal
  4. Нажмите значок + и выберите Add marketplace from GitHub
  5. Введите honeydew-ai/honeydew-ai-coding-agents-plugins в поле ввода
  6. Появится плагин Honeydew AI. Установите его.

Настройка MCP

Используйте этот раздел, если ваша организация использует собственную конечную точку Honeydew, или если вы предпочитаете настраивать MCP-серверы без установки плагина. Отключите подключение MCP Honeydew, добавленное плагином, затем добавьте собственную конечную точку, следуя инструкциям ниже.

MCP-сервер Honeydew подключает Claude Desktop к Honeydew Semantic Layer для исследования моделей, запроса данных, управления моделями и доступа к документации.

Режим Claude Code

При использовании Claude Desktop в режиме Claude Code следуйте инструкциям для Claude Code CLI.

Примечание

Если ваша организация использует собственное имя хоста Honeydew, замените https://mcp.honeydew.cloud/mcp на имя хоста вашего тенанта. Имя хоста можно найти в Settings > MCP Server в Honeydew Studio.

Чтобы добавить MCP Honeydew в режиме Cowork:

  1. Перейдите в Settings -> Connectors -> Add custom connector
  2. Введите honeydew в поле Name
  3. Введите https://mcp.honeydew.cloud/mcp в поле Remote MCP server URL
  4. Нажмите Add

При первом подключении вам будет предложено пройти аутентификацию с помощью OAuth для Honeydew.

MCP документации Honeydew (необязательно)

MCP-сервер Honeydew уже включает инструменты доступа к документации, поэтому отдельный сервер документации не требуется. Добавляйте MCP документации Honeydew только в том случае, если вам нужен доступ к документации без подключения к Honeydew. Аутентификация не требуется.

  1. Перейдите в Settings -> Connectors -> Add custom connector
  2. Введите honeydew-docs в поле Name
  3. Введите https://honeydew.ai/docs/mcp в поле Remote MCP server URL
  4. Нажмите Add

Удаление MCP-сервера

Чтобы удалить MCP-сервер Honeydew в режиме Cowork:

  1. Перейдите в Settings -> Connectors
  2. Найдите коннектор honeydew и нажмите значок удаления

Чтобы удалить MCP-сервер документации Honeydew:

  1. Перейдите в Settings -> Connectors
  2. Найдите коннектор honeydew-docs и нажмите значок удаления

Claude.ai

#### Установка плагина

Honeydew предоставляет репозиторий плагинов с навыками и инструментами для создания семантических моделей и анализа данных с помощью естественного диалога. Установка плагина автоматически настраивает как MCP-сервер Honeydew, так и MCP-сервер документации Honeydew.

  1. Скачайте zip-архив плагина: honeydew-ai-claude.zip
  2. В Claude.ai перейдите в Settings -> Plugins -> Add plugin -> Upload zip
  3. Загрузите zip-архив — плагин появится в вашем частном маркетплейсе

Настройка MCP

Используйте этот раздел, если ваша организация использует собственную конечную точку Honeydew, или если вы предпочитаете настраивать MCP-серверы без установки плагина. Удалите коннектор MCP Honeydew, добавленный плагином, затем добавьте собственную конечную точку, следуя инструкциям ниже.

MCP-сервер Honeydew подключает Claude.ai к Honeydew Semantic Layer для исследования моделей, запроса данных, управления моделями и доступа к документации.

Примечание

Если ваша организация использует собственное имя хоста Honeydew, замените https://mcp.honeydew.cloud/mcp на имя хоста вашего тенанта. Имя хоста можно найти в Settings > MCP Server в Honeydew Studio.

Чтобы добавить MCP-сервер Honeydew:

  1. Перейдите в Настройки -> Коннекторы -> Добавить пользовательский коннектор
  2. Введите honeydew в поле Имя
  3. Введите https://mcp.honeydew.cloud/mcp в поле URL удаленного MCP-сервера
  4. Нажмите Добавить

При первом подключении вам будет предложено пройти аутентификацию через OAuth в Honeydew.

Honeydew Documentation MCP (необязательно)

MCP-сервер Honeydew уже включает инструменты доступа к документации, поэтому отдельный сервер документации не требуется. Добавляйте Honeydew Documentation MCP только в том случае, если вам нужен доступ к документации без подключения к Honeydew. Аутентификация не требуется.

  1. Перейдите в Настройки -> Коннекторы -> Добавить пользовательский коннектор
  2. Введите honeydew-docs в поле Имя
  3. Введите https://honeydew.ai/docs/mcp в поле URL удаленного MCP-сервера
  4. Нажмите Добавить

Удаление MCP-сервера

Чтобы удалить MCP-сервер Honeydew:

  1. Перейдите в Настройки -> Коннекторы
  2. Найдите коннектор honeydew и нажмите значок удаления

Чтобы удалить MCP-сервер Honeydew Documentation:

  1. Перейдите в Настройки -> Коннекторы
  2. Найдите коннектор honeydew-docs и нажмите значок удаления

Cortex Code CLI

#### Установка плагина

Примечание

Требуется Git. Установка плагина из GitHub клонирует репозиторий локально, поэтому Git должен быть установлен и находиться в вашем PATH. Если Git отсутствует, установка плагина завершится ошибкой. Установите Git или используйте шаги ручной настройки MCP вашего клиента для прямой настройки сервера вместо плагина.

Honeydew предоставляет репозиторий плагинов с навыками и инструментами для создания семантических моделей и анализа данных с помощью естественного общения. Установка плагина автоматически настраивает MCP-серверы Honeydew.

Запустите Cortex Code CLI с cortex, затем установите плагин:

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

Настройка MCP

Используйте этот раздел, если ваша организация использует пользовательскую конечную точку Honeydew, или если вы предпочитаете настраивать MCP-серверы без установки плагина. Отключите подключение MCP Honeydew, добавленное плагином, затем добавьте свою пользовательскую конечную точку, следуя инструкциям ниже.

MCP-сервер Honeydew подключает Cortex Code CLI к Honeydew Semantic Layer для исследования моделей, запросов данных, управления моделями и доступа к документации.

Примечание

Если ваша организация использует пользовательское имя хоста Honeydew, замените https://mcp.honeydew.cloud/mcp на имя хоста вашего тенанта. Имя хоста можно найти в Настройки > MCP-сервер в Honeydew Studio.

```bash theme={null} cortex mcp add honeydew \ https://mcp.honeydew.cloud/mcp \ --type http ``` 
      Запустите Cortex Code CLI с `cortex`.
      Вам будет предложено пройти аутентификацию
      через OAuth в 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">
  Сохраните следующее в `honeydew-mcp.json`:

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

      Затем зарегистрируйте его с помощью:

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

      Запустите Cortex Code CLI с `cortex`.
      Вам будет предложено пройти аутентификацию
      через OAuth в 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>"
        }
      }
      ```

      Затем зарегистрируйте его с помощью:

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

<Tab title="mcp.json">
  Добавьте следующее в
  `~/.snowflake/cortex/mcp.json`:

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

      Запустите Cortex Code CLI с `cortex`.
      Вам будет предложено пройти аутентификацию
      через OAuth в 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 (необязательно)

MCP-сервер Honeydew уже включает инструменты доступа к документации, поэтому отдельный сервер документации не требуется. Добавляйте Honeydew Documentation MCP только в том случае, если вам нужен доступ к документации без подключения к Honeydew. Аутентификация не требуется.

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

Удаление MCP-сервера

Чтобы удалить MCP-сервер Honeydew:

cortex mcp remove honeydew

Чтобы удалить MCP-сервер Honeydew Documentation:

cortex mcp remove honeydew-docs

Cortex Code Desktop

#### Установка плагина

Примечание

Требуется Git. Установка плагина из GitHub клонирует репозиторий локально, поэтому Git должен быть установлен и находиться в вашем PATH. Если Git отсутствует, установка плагина завершится ошибкой. Установите Git или используйте шаги ручной настройки MCP вашего клиента для прямой настройки сервера вместо плагина.

Honeydew предоставляет репозиторий плагинов с навыками и инструментами для создания семантических моделей и анализа данных с помощью естественного общения. Установка плагина автоматически настраивает MCP-серверы Honeydew.

  1. Перейдите в Настройки -> Плагины
  2. Нажмите Добавить плагин, выберите Добавить из GitHub и вставьте репозиторий плагина Honeydew: honeydew-ai/honeydew-ai-coding-agents-plugins
  3. Следуйте инструкциям и подтвердите шаги в Установщике плагинов GitHub

Настройка MCP

Используйте этот раздел, если ваша организация использует пользовательскую конечную точку Honeydew, или если вы предпочитаете настраивать MCP-серверы без установки плагина. Отключите подключение MCP Honeydew, добавленное плагином, затем добавьте свою пользовательскую конечную точку, следуя инструкциям ниже.

MCP-сервер Honeydew подключает Cortex Code Desktop к Honeydew Semantic Layer для исследования моделей, запросов данных, управления моделями и доступа к документации.

Чтобы добавить сервер, перейдите в MCP -> Создать, выберите Область конфигурации (например, ~/.snowflake/cortex/mcp.json для глобальной), заполните форму, затем нажмите Сохранить. Используйте вкладку Форма или JSON для ввода конфигурации.

Примечание

Если ваша организация использует пользовательское имя хоста Honeydew, замените https://mcp.honeydew.cloud/mcp на имя хоста вашего тенанта. Имя хоста можно найти в Настройки > MCP-сервер в Honeydew Studio.

Добавьте сервер Honeydew MCP:

1. **Имя сервера**: `honeydew` 2. **Тип сервера**: **Удаленный (HTTP)** 3. **URL сервера**: `https://mcp.honeydew.cloud/mcp` 4. Нажмите **Сохранить** 
      При первом подключении вам будет предложено пройти аутентификацию
      через OAuth в Honeydew.
    </Tab>

    <Tab title="API Key">
      1. **Имя сервера**: `honeydew`
      2. **Тип сервера**: **Удаленный (HTTP)**
      3. **URL сервера**: `https://mcp.honeydew.cloud/mcp`
      4. В разделе **Заголовки** нажмите **Добавить заголовок** и задайте имя
         `Authorization` и значение
         `Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET>`
      5. Нажмите **Сохранить**
    </Tab>
  </Tabs>
</Tab>

<Tab title="JSON">
  Переключитесь на вкладку **JSON** и вставьте конфигурацию:

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

      При первом подключении вам будет предложено пройти аутентификацию
      через OAuth в Honeydew.
    </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 (необязательно)

MCP-сервер Honeydew уже включает инструменты доступа к документации, поэтому отдельный сервер документации не требуется. Если вам нужен доступ к документации без подключения к Honeydew, добавьте MCP-сервер Honeydew Documentation таким же способом, используя Имя сервера honeydew-docs, Тип сервера Удаленный (HTTP) и URL сервера https://honeydew.ai/docs/mcp. Аутентификация не требуется.

Удаление MCP-сервера

Чтобы удалить сервер, перейдите в MCP, найдите сервер honeydew (или honeydew-docs) и удалите его.

Cursor

#### Установка плагина

Honeydew предоставляет репозиторий плагинов с навыками и инструментами для создания семантических моделей и анализа данных с помощью естественного общения. Установка плагина автоматически настраивает MCP-серверы Honeydew.

  1. В настройках вашей команды или организации перейдите на cursor.com/dashboard/plugins (или нажмите Плагины в меню слева)
  2. Прокрутите вниз до Рыночные площадки команды и либо выберите существующую площадку, либо нажмите Добавить площадку, чтобы создать новую. При создании новой введите имя и создайте её.
  3. На площадке нажмите Добавить плагин, вставьте путь к репозиторию плагина Honeydew на GitHub: https://github.com/honeydew-ai/honeydew-ai-coding-agents-plugins и нажмите Добавить 1 плагин
  4. При желании включите автообновление на странице площадки, чтобы плагин обновлялся автоматически при выходе новых версий.
  5. Вернитесь на страницу плагинов (cursor.com/dashboard/plugins), найдите плагин Honeydew и нажмите Добавить

Настройка MCP

Используйте этот раздел, если ваша организация использует пользовательскую конечную точку Honeydew, или если вы предпочитаете настраивать MCP-серверы без установки плагина. Отключите подключение MCP Honeydew, добавленное плагином, затем добавьте свою пользовательскую конечную точку, следуя инструкциям ниже.

MCP-сервер Honeydew подключает Cursor к Honeydew Semantic Layer для исследования моделей, запросов данных, управления моделями и доступа к документации.

Примечание

Если ваша организация использует пользовательское имя хоста Honeydew, замените https://mcp.honeydew.cloud/mcp на имя хоста вашего тенанта. Имя хоста можно найти в Настройки > MCP-сервер в Honeydew Studio.

Чтобы добавить Honeydew MCP:

  1. Откройте приложение Cursor

  2. Перейдите в Настройки -> Настройки Cursor -> Инструменты и MCP

  3. Нажмите Новый MCP-сервер

  4. Добавьте следующую конфигурацию:

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

  5. Нажмите Сохранить

Honeydew Documentation MCP (необязательно)

MCP-сервер Honeydew уже включает инструменты доступа к документации, поэтому отдельный сервер документации не требуется. Добавляйте Honeydew Documentation MCP только в том случае, если вам нужен доступ к документации без подключения к Honeydew. Аутентификация не требуется.

  1. Перейдите в Настройки -> Настройки Cursor -> Инструменты и MCP
  2. Нажмите Новый MCP-сервер
  3. Добавьте следующую конфигурацию: 
    {
  "name": "honeydew-docs",
  "type": "http",
  "url": "https://honeydew.ai/docs/mcp"
}
  4. Нажмите Сохранить

Удаление MCP-сервера

Чтобы удалить MCP-сервер Honeydew:

  1. Перейдите в Настройки -> Настройки Cursor -> Инструменты и MCP
  2. Найдите honeydew в списке и нажмите значок удаления

Чтобы удалить MCP-сервер Honeydew Documentation:

  1. Перейдите в Настройки -> Настройки Cursor -> Инструменты и MCP
  2. Найдите honeydew-docs в списке и нажмите значок удаления

Databricks Genie Code

> **Примечание** > > MCP-серверы поддерживаются только в режиме агента Genie Code. > Дополнительные сведения см. в > [документации Databricks MCP](https://docs.databricks.com/aws/en/generative-ai/mcp/).

Предварительные требования:

  • Genie Code включен в вашем рабочем пространстве Databricks
  • Привилегия CREATE CONNECTION в метастор Unity Catalog
1. Перейдите в **Каталог** → **Подключения** → **Создать подключение** 2. На экране **Основные сведения о подключении**: * Установите **Имя подключения** в `honeydew-mcp` * Установите **Тип подключения** в **HTTP** * Установите **Тип аутентификации** в **Динамическая регистрация клиента** * Нажмите **Далее** 3. На экране **Аутентификация**: * Установите **Хост** в `https://mcp.honeydew.cloud` * Оставьте **Порт** как `443` * Установите **Область OAuth** в `openid` * Нажмите **Далее** 4. На экране **Сведения о подключении**: * Установите флажок **Является MCP-подключением** * Установите **Базовый путь** в `/mcp` * Нажмите **Создать подключение** 
    <Tab title="SQL">
      Выполните следующий SQL в блокноте Databricks или в редакторе 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>

Примечание

Если ваша организация использует пользовательское имя хоста Honeydew, замените https://mcp.honeydew.cloud на имя хоста вашего тенанта. Вы можете найти имя хоста в Настройки > MCP-сервер в Honeydew Studio. 

<Step title="Log in to the connection">
  Перейдите в **Каталог** → **Подключения** → `honeydew-mcp`
  и нажмите **Войти** в правом верхнем углу,
  чтобы пройти аутентификацию и проверить подключение.
</Step>

<Step title="Grant connection access">
  Предоставьте привилегию `USE CONNECTION` любым пользователям или ролям,
  которым нужен доступ к 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. Откройте Genie Code и нажмите на значок шестеренки
  2. Перейдите в **MCP-серверы** → **Добавить сервер**
  3. Выберите **Внешний MCP-сервер**
  4. Выберите созданное вами подключение `honeydew-mcp`
  5. Войдите в подключение при появлении запроса
  6. Нажмите **Сохранить**

Примечание

Databricks ограничивает MCP 20 инструментами на всех настроенных серверах. Если вам нужно настроить доступные инструменты Honeydew, используйте настройки MCP в Genie Code, чтобы включить или отключить конкретные инструменты.

Удаление MCP-сервера

Чтобы удалить MCP-сервер Honeydew из Genie Code:

  1. Откройте Genie Code и нажмите на значок шестеренки
  2. Перейдите в MCP-серверы
  3. Найдите honeydew-mcp и нажмите Удалить

Чтобы также удалить базовое подключение Unity Catalog, выполните следующий SQL:

DROP CONNECTION `honeydew-mcp`;

Devin

#### MCP-сервер

Devin подключается к удаленным MCP-серверам через свой MCP Marketplace.

Примечание

Если ваша организация использует пользовательское имя хоста Honeydew, замените https://mcp.honeydew.cloud/mcp на имя хоста вашего тенанта. Вы можете найти имя хоста в Настройки > MCP-сервер в Honeydew Studio.

Чтобы добавить MCP-сервер Honeydew:

  1. Перейдите в Настройки -> Подключения -> MCP-серверы

  2. Нажмите Добавить пользовательский MCP

  3. Введите honeydew в поле Имя сервера

  4. При желании добавьте значок и Краткое описание

  5. Выберите HTTP в качестве типа транспорта

  6. Введите https://mcp.honeydew.cloud/mcp в поле URL сервера

  7. Настройте аутентификацию:

    Выберите **OAuth** в качестве метода аутентификации. Devin предложит вам пройти аутентификацию с Honeydew во время первого сеанса. 
    <Tab title="API Key">
  Выберите **Заголовок аутентификации** в качестве метода аутентификации.
  Оставьте ключ заголовка как `Authorization` и установите значение в
  `Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET>`
  (см. [Аутентификация](#authentication)).
</Tab>

  8. Нажмите Сохранить, затем нажмите Проверить инструменты списка, чтобы проверить подключение

Документация Honeydew MCP (необязательно)

MCP-сервер Honeydew уже включает инструменты доступа к документации, поэтому отдельный сервер документации не требуется. Добавляйте документацию Honeydew MCP только в том случае, если вам нужен доступ к документации без подключения к Honeydew. Аутентификация не требуется.

  1. Перейдите в Настройки -> Подключения -> MCP-серверы
  2. Нажмите Добавить пользовательский MCP
  3. Введите honeydew-docs в поле Имя сервера
  4. Выберите HTTP в качестве типа транспорта
  5. Введите https://honeydew.ai/docs/mcp в поле URL сервера
  6. Установите метод аутентификации в Нет
  7. Нажмите Сохранить

Удаление MCP-сервера

Чтобы удалить MCP-сервер Honeydew:

  1. Перейдите в Настройки -> Подключения -> MCP-серверы
  2. Найдите сервер honeydew и удалите его

Чтобы удалить сервер документации Honeydew MCP:

  1. Перейдите в Настройки -> Подключения -> MCP-серверы
  2. Найдите сервер honeydew-docs и удалите его

GitHub Copilot CLI

#### MCP-сервер

Примечание

Если ваша организация использует пользовательское имя хоста Honeydew, замените https://mcp.honeydew.cloud/mcp на имя хоста вашего тенанта. Вы можете найти имя хоста в Настройки > MCP-сервер в Honeydew Studio.

  1. Запустите GitHub Copilot CLI с copilot

  2. Введите /mcp add, чтобы открыть форму настройки сервера

  3. Заполните следующие поля:

    • Имя: honeydew

    • Тип: http

    • URL: https://mcp.honeydew.cloud/mcp

    • HTTP-заголовки:

      Для OAuth дополнительные заголовки не требуются. ```json theme={null} { "Authorization": "Basic " } ```

  4. Нажмите Ctrl+S, чтобы сохранить

Используйте /mcp show, чтобы проверить, что сервер подключен.

Плагины AI-агента кодирования

Примечание

Требуется Git. Установка плагина из GitHub клонирует репозиторий локально, поэтому Git должен быть установлен и находиться в вашем PATH. Если Git отсутствует, установка плагина завершится ошибкой. Установите Git или используйте ручные шаги настройки MCP вашего клиента для прямой настройки сервера вместо плагина.

Honeydew предоставляет репозиторий плагинов с навыками и инструментами для создания семантических моделей и анализа данных через естественный диалог.

Добавьте маркетплейс в Copilot CLI:

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

Затем установите плагин Honeydew из маркетплейса:

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

Документация Honeydew MCP (необязательно)

MCP-сервер Honeydew уже включает инструменты доступа к документации, поэтому отдельный сервер документации не требуется. Добавляйте документацию Honeydew MCP только в том случае, если вам нужен доступ к документации без подключения к Honeydew. Аутентификация не требуется.

  1. Запустите GitHub Copilot CLI с copilot
  2. Введите /mcp add, чтобы открыть форму настройки сервера
  3. Заполните следующие поля:
    • Имя: honeydew-docs
    • Тип: http
    • URL: https://honeydew.ai/docs/mcp
  4. Нажмите Ctrl+S, чтобы сохранить

Удаление MCP-сервера

Чтобы удалить MCP-сервер Honeydew, запустите GitHub Copilot CLI с copilot, затем введите:

/mcp remove honeydew

Чтобы удалить сервер документации Honeydew MCP:

/mcp remove honeydew-docs

Gemini CLI

#### Установка расширения

Примечание

Требуется Git. Установка плагина из GitHub клонирует репозиторий локально, поэтому Git должен быть установлен и находиться в вашем PATH. Если Git отсутствует, установка плагина завершится ошибкой. Установите Git или используйте ручные шаги настройки MCP вашего клиента для прямой настройки сервера вместо плагина.

Honeydew предоставляет репозиторий плагинов с навыками и инструментами для создания семантических моделей и анализа данных через естественный диалог. Установка расширения автоматически настраивает MCP-серверы Honeydew.

Выполните следующую команду для установки расширения Honeydew:

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

Флаг --auto-update обеспечивает автоматическое обновление расширения.

Настройка MCP

Используйте этот раздел, если ваша организация использует пользовательскую конечную точку Honeydew, или если вы предпочитаете настраивать MCP-серверы без установки расширения. Отключите MCP-подключение Honeydew, добавленное расширением, затем добавьте вашу пользовательскую конечную точку, используя инструкции ниже.

MCP-сервер Honeydew подключает Gemini CLI к Honeydew Semantic Layer для исследования моделей, запросов данных, управления моделями и доступа к документации.

Примечание

Если ваша организация использует пользовательское имя хоста Honeydew, замените https://mcp.honeydew.cloud/mcp на имя хоста вашего тенанта. Вы можете найти имя хоста в Настройки > MCP-сервер в Honeydew Studio.

Выполните следующую команду для добавления MCP-сервера Honeydew:

```bash theme={null} gemini mcp add --transport http honeydew \ https://mcp.honeydew.cloud/mcp ``` 
  Запустите Gemini CLI с `gemini`.
  Вам будет предложено пройти аутентификацию с OAuth для 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 MCP (необязательно)

MCP-сервер Honeydew уже включает инструменты доступа к документации, поэтому отдельный сервер документации не требуется. Добавляйте документацию Honeydew MCP только в том случае, если вам нужен доступ к документации без подключения к Honeydew. Аутентификация не требуется.

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

Удаление MCP-сервера

Чтобы удалить MCP-сервер Honeydew:

gemini mcp remove honeydew

Чтобы удалить сервер документации Honeydew MCP:

gemini mcp remove honeydew-docs

VS Code и GitHub Copilot

#### Установка плагина

Honeydew предоставляет репозиторий плагинов с навыками и инструментами для создания семантических моделей и анализа данных через естественный диалог. Установка плагина автоматически настраивает MCP-серверы Honeydew.

Добавьте маркетплейс Honeydew

  1. Откройте ваш settings.json в VS Code (откройте палитру команд с помощью CMD+Shift+P на macOS или Ctrl+Shift+P на Windows/Linux, затем выберите Настройки: Открыть пользовательские настройки (JSON))
  2. Добавьте маркетплейс Honeydew в настройку chat.plugins.marketplaces: 
    "chat.plugins.marketplaces": [
  "honeydew-ai/honeydew-ai-coding-agents-plugins"
]

Установите плагин

  1. Откройте представление расширений (CMD+Shift+X на macOS или Ctrl+Shift+X на Windows/Linux)
  2. Введите @agentPlugins в поле поиска
  3. Найдите плагин Honeydew AI и нажмите Установить

При первой установке плагина из нового маркетплейса VS Code показывает запрос доверия — проверьте источник маркетплейса перед подтверждением.

Обновите плагин

Если extensions.autoUpdate включен в настройках VS Code, плагин обновляется автоматически. Для ручного обновления откройте палитру команд и выполните Расширения: Проверить наличие обновлений расширений.

MCP-сервер

Используйте этот раздел, если ваша организация использует пользовательскую конечную точку Honeydew, или если вы предпочитаете настраивать MCP-серверы без установки плагина. Отключите MCP-подключение Honeydew, добавленное плагином, затем добавьте вашу пользовательскую конечную точку, используя инструкции ниже.

MCP-сервер Honeydew подключает VS Code к Honeydew Semantic Layer для исследования моделей, запросов данных, управления моделями и доступа к документации.

Примечание

Если ваша организация использует пользовательское имя хоста Honeydew, замените https://mcp.honeydew.cloud/mcp на имя хоста вашего тенанта. Вы можете найти имя хоста в Настройки > MCP-сервер в Honeydew Studio.

  1. Откройте палитру команд с помощью CMD+Shift+P (macOS) или Ctrl+Shift+P (Windows/Linux)
  2. Выберите MCP: Добавить сервер...
  3. Выберите HTTP (HTTP или Server-Sent Events)
  4. Введите URL MCP-сервера Honeydew: https://mcp.honeydew.cloud/mcp
  5. Введите honeydew в качестве имени сервера

Это добавит сервер в ваш файл .vscode/mcp.json. Откройте файл и добавьте заголовки по мере необходимости:

```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 (необязательно)

MCP-сервер Honeydew уже включает инструменты доступа к документации, поэтому отдельный сервер документации не требуется. Добавляйте Honeydew Documentation MCP только в том случае, если вам нужен доступ к документации без подключения к Honeydew. Аутентификация не требуется.

Добавьте следующее в ваш .vscode/mcp.json:

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

Удаление MCP-сервера

Чтобы удалить MCP-сервер Honeydew, откройте .vscode/mcp.json и удалите запись honeydew из объекта servers. Чтобы удалить MCP-сервер Honeydew Documentation, удалите запись honeydew-docs из того же файла.

Codex CLI

#### Установка плагина

Примечание

Требуется Git. Установка плагина из GitHub клонирует репозиторий локально, поэтому Git должен быть установлен и находиться в вашем PATH. Если Git отсутствует, установка плагина завершится ошибкой. Установите Git или используйте шаги ручной настройки MCP вашего клиента для прямой настройки сервера вместо плагина.

Honeydew предоставляет репозиторий плагинов с навыками и инструментами для создания семантических моделей и анализа данных через естественный диалог. Установка плагина автоматически настраивает MCP-серверы Honeydew.

Добавьте маркетплейс в Codex:

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

Затем запустите Codex с codex и введите /plugins, чтобы просмотреть и установить плагин Honeydew AI.

Обновление плагинов

Чтобы обновить маркетплейс Honeydew, выполните:

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

Затем запустите Codex и введите /plugins, чтобы применить обновления.

Настройка MCP

Используйте этот раздел, если ваша организация использует пользовательскую конечную точку Honeydew, или если вы предпочитаете настраивать MCP-серверы без установки плагина. Отключите подключение MCP Honeydew, добавленное плагином, затем добавьте вашу пользовательскую конечную точку, используя инструкции ниже.

MCP-сервер Honeydew подключает Codex к семантическому слою Honeydew для исследования моделей, запросов данных, управления моделями и доступа к документации.

Примечание

Если ваша организация использует пользовательское имя хоста Honeydew, замените https://mcp.honeydew.cloud/mcp на имя хоста вашего тенанта. Имя хоста можно найти в Настройки > MCP Server в Honeydew Studio.

Командная строка

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

Затем запустите Codex с codex. Вам будет предложено пройти аутентификацию через OAuth в Honeydew.

После добавления сервера откройте файл конфигурации по адресу ~/.codex/config.toml и добавьте заголовки в раздел [mcp_servers.honeydew] по мере необходимости.

Конфигурация TOML

Добавьте следующее в ~/.codex/config.toml (или .codex/config.toml в доверенном проекте):

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

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

Установите переменную окружения HONEYDEW_AUTH в Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET> (см. Аутентификация).

Honeydew Documentation MCP (необязательно)

MCP-сервер Honeydew уже включает инструменты доступа к документации, поэтому отдельный сервер документации не требуется. Добавляйте Honeydew Documentation MCP только в том случае, если вам нужен доступ к документации без подключения к Honeydew. Аутентификация не требуется.

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

Удаление MCP-сервера

Чтобы удалить MCP-сервер Honeydew:

codex mcp remove honeydew

Чтобы удалить MCP-сервер Honeydew Documentation:

codex mcp remove honeydew-docs

Codex

#### Установка плагина

Примечание

Требуется Git. Установка плагина из GitHub клонирует репозиторий локально, поэтому Git должен быть установлен и находиться в вашем PATH. Если Git отсутствует, установка плагина завершится ошибкой. Установите Git или используйте шаги ручной настройки MCP вашего клиента для прямой настройки сервера вместо плагина.

Honeydew предоставляет репозиторий плагинов с навыками и инструментами для создания семантических моделей и анализа данных через естественный диалог. Установка плагина автоматически настраивает MCP-серверы Honeydew.

Добавьте маркетплейс в Codex:

  1. Откройте Плагины
  2. Нажмите стрелку раскрывающегося списка и выберите Добавить маркетплейс
  3. Добавьте honeydew-ai/honeydew-ai-coding-agents-plugins

Примечание

Вы также можете добавить маркетплейс из Codex CLI:

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

Затем установите плагин:

  1. Откройте Плагины
  2. Выберите маркетплейс Honeydew AI
  3. Установите плагин Honeydew

Настройка MCP

Используйте этот раздел, если ваша организация использует пользовательскую конечную точку Honeydew, или если вы предпочитаете настраивать MCP-серверы без установки плагина. Отключите подключение MCP Honeydew, добавленное плагином, затем добавьте вашу пользовательскую конечную точку, используя инструкции ниже.

Примечание

Если ваша организация использует пользовательское имя хоста Honeydew, замените https://mcp.honeydew.cloud/mcp на имя хоста вашего тенанта. Имя хоста можно найти в Настройки > MCP Server в Honeydew Studio.

Honeydew MCP

  1. Откройте приложение Codex

  2. Перейдите в Настройки -> MCP-серверы

  3. В разделе Пользовательские серверы нажмите Добавить сервер

  4. Установите имя сервера honeydew

  5. Выберите Streamable HTTP в качестве типа транспорта

  6. Установите URL на https://mcp.honeydew.cloud/mcp

  7. Оставьте поле Переменная окружения токена Bearer пустым

  8. Настройте аутентификацию следующим образом:

    Аутентификация OAuth

    Codex перенаправит вас для аутентификации в Honeydew при подключении. Дополнительная настройка не требуется.

    Базовая аутентификация HTTP

    Добавьте заголовок Authorization в список заголовков выше со значением Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET> (см. Аутентификация).

Устранение неполадок аутентификации MCP

Если MCP-сервер Honeydew не аутентифицирован в Codex и опция «Аутентифицировать» не появляется:

  1. Установите Codex CLI
  2. Выполните codex mcp login honeydew

Honeydew Documentation MCP (необязательно)

MCP-сервер Honeydew уже включает инструменты доступа к документации, поэтому отдельный сервер документации не требуется. Добавляйте Honeydew Documentation MCP только в том случае, если вам нужен доступ к документации без подключения к Honeydew. Аутентификация не требуется.

  1. Перейдите в Настройки -> MCP-серверы
  2. В разделе Пользовательские серверы нажмите Добавить сервер
  3. Установите имя сервера honeydew-docs
  4. Выберите Streamable HTTP в качестве типа транспорта
  5. Установите URL на https://honeydew.ai/docs/mcp

Удаление MCP-сервера

Чтобы удалить MCP-сервер Honeydew:

  1. Перейдите в Настройки -> MCP-серверы
  2. Найдите honeydew в разделе Пользовательские серверы и нажмите Удалить

Чтобы удалить MCP-сервер Honeydew Documentation:

  1. Перейдите в Настройки -> MCP-серверы
  2. Найдите honeydew-docs в разделе Пользовательские серверы и нажмите Удалить

Antigravity

#### MCP-сервер

Примечание

Если ваша организация использует пользовательское имя хоста Honeydew, замените https://mcp.honeydew.cloud/mcp на имя хоста вашего тенанта. Имя хоста можно найти в Настройки > MCP Server в Honeydew Studio.

  1. Откройте редактор Antigravity

  2. Нажмите раскрывающийся список ... в верхней части панели агента

  3. Нажмите Управление MCP-серверами

  4. Нажмите Просмотреть необработанную конфигурацию

  5. Добавьте следующее в 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>

  6. Сохраните файл

Honeydew Documentation MCP (необязательно)

MCP-сервер Honeydew уже включает инструменты доступа к документации, поэтому отдельный сервер документации не требуется. Добавляйте Honeydew Documentation MCP только в том случае, если вам нужен доступ к документации без подключения к Honeydew. Аутентификация не требуется.

  1. Откройте редактор Antigravity
  2. Нажмите раскрывающийся список ... в верхней части панели агента
  3. Нажмите Управление MCP-серверами
  4. Нажмите Просмотреть необработанную конфигурацию
  5. Добавьте следующее в mcp_config.json: 
    {
  "name": "honeydew-docs",
  "type": "http",
  "url": "https://honeydew.ai/docs/mcp"
}
  6. Сохраните файл

Удаление MCP-сервера

Чтобы удалить MCP-сервер Honeydew:

  1. Откройте редактор Antigravity
  2. Нажмите раскрывающийся список ... в верхней части панели агента
  3. Нажмите Управление MCP-серверами
  4. Нажмите Просмотреть необработанную конфигурацию
  5. Удалите записи honeydew и honeydew-docs из mcp_config.json
  6. Сохраните файл

OpenCode

#### MCP-сервер

Примечание

Если ваша организация использует пользовательское имя хоста Honeydew, замените https://mcp.honeydew.cloud/mcp на имя хоста вашего тенанта. Имя хоста можно найти в Настройки > MCP Server в Honeydew Studio.

Выполните следующую команду и следуйте интерактивным подсказкам: 
  ```bash theme={null}
  opencode mcp add
  ```

  При появлении запроса введите следующие значения:

  1. **Расположение**: Выберите предпочтительную область (текущий проект или глобальная)
  2. **Имя MCP-сервера**: `honeydew`
  3. **Тип MCP-сервера**: `Remote`
  4. **URL MCP-сервера**: `https://mcp.honeydew.cloud/mcp`
  5. **Аутентификация OAuth**: `Yes`
  6. **Предварительно зарегистрированный идентификатор клиента**: `No`
</Tab>

<Tab title="JSON configuration">
  Добавьте следующее в ваш файл `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": {}
          }
        }
      }
      ```

      Затем пройдите аутентификацию в Honeydew:

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

      Это откроет окно браузера для завершения процесса аутентификации 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>

Повторная аутентификация

Чтобы пройти повторную аутентификацию, сначала проверьте свой статус и выйдите из системы:

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

Honeydew Documentation MCP (необязательно)

MCP-сервер Honeydew уже включает инструменты доступа к документации, поэтому отдельный сервер документации не требуется. Добавляйте Honeydew Documentation MCP только в том случае, если вам нужен доступ к документации без подключения к Honeydew. Аутентификация не требуется.

Выполните `opencode mcp add` и введите следующие значения: 
  1. **Имя MCP-сервера**: `honeydew-docs`
  2. **Тип MCP-сервера**: `Remote`
  3. **URL MCP-сервера**: `https://honeydew.ai/docs/mcp`
  4. **Аутентификация OAuth**: `No`
</Tab>

<Tab title="JSON configuration">
  Добавьте следующее в ваш файл `opencode.jsonc`:

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

Удаление MCP-сервера

Чтобы удалить MCP-сервер Honeydew, удалите запись honeydew из вашего файла opencode.jsonc. Чтобы удалить MCP-сервер Honeydew Documentation, удалите запись honeydew-docs из того же файла.

Kiro

IDE Kiro и CLI Kiro используют одни и те же файлы конфигурации MCP, поэтому приведенные ниже шаги применимы к обоим.

MCP-сервер

Kiro считывает MCP-серверы из двух файлов конфигурации:

  • Рабочая область: .kiro/settings/mcp.json (специфично для текущего проекта)
  • Пользователь: ~/.kiro/settings/mcp.json (применяется ко всем рабочим областям)

Если оба файла существуют, конфигурация рабочей области имеет приоритет.

Примечание

Если ваша организация использует пользовательское имя хоста Honeydew, замените https://mcp.honeydew.cloud/mcp на имя хоста вашего тенанта. Имя хоста можно найти в Настройки > MCP Server в Honeydew Studio.

Добавьте MCP-сервер Honeydew в один из этих файлов mcp.json (рабочая область или пользователь):

```json theme={null} { "mcpServers": { "honeydew": { "url": "https://mcp.honeydew.cloud/mcp" } } } ``` 
  При первом подключении к Honeydew Kiro предоставляет URL для аутентификации.
  Откройте его в браузере, чтобы завершить процесс аутентификации OAuth.
</Tab>
```json theme={null} { "mcpServers": { "honeydew": { "url": "https://mcp.honeydew.cloud/mcp", "headers": { "Authorization": "Basic " } } } } ```

В CLI Kiro выполните /mcp, чтобы убедиться, что сервер подключен. В IDE Kiro сервер отображается на панели MCP.

Honeydew Documentation MCP (необязательно)

MCP-сервер Honeydew уже включает инструменты доступа к документации, поэтому отдельный сервер документации не требуется. Добавляйте Honeydew Documentation MCP только в том случае, если вам нужен доступ к документации без подключения к Honeydew. Аутентификация не требуется.

Добавьте следующее в ваш mcp.json:

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

Удаление MCP-сервера

Чтобы удалить MCP-сервер Honeydew, удалите запись honeydew из вашего mcp.json. Чтобы удалить MCP-сервер Honeydew Documentation, удалите запись honeydew-docs из того же файла.

Snowflake Intelligence

Snowflake подключается к внешним MCP-серверам через [коннекторы MCP](https://docs.snowflake.com/en/user-guide/snowflake-cortex/cortex-agents-mcp-connectors), что делает инструменты Honeydew доступными для Snowflake Intelligence и Cortex Agents.

Предварительные требования:

  • Роль с привилегией CREATE INTEGRATION на аккаунте
  • Роль с привилегией CREATE MCP SERVER на целевой схеме

По умолчанию только роль ACCOUNTADMIN обладает этими привилегиями.

Примечание

Если ваша организация использует пользовательское имя хоста Honeydew, замените https://mcp.honeydew.cloud/mcp на имя хоста вашего тенанта. Имя хоста можно найти в Settings > MCP Server в 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">
  Внешний MCP-сервер — это объект уровня схемы,
  который ссылается на интеграцию 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">
  Предоставьте доступ (usage) как к интеграции, так и к MCP-серверу
  всем ролям, которым нужен доступ к 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">
  Добавьте MCP-сервер `honeydew` как инструмент в Cortex Agent
  или агент Snowflake Intelligence.
  При первом использовании пользователям будет предложено пройти аутентификацию через OAuth в Honeydew.
</Step>

Примечание

Автономный MCP-сервер Honeydew Documentation не поддерживается в Snowflake, поскольку внешние MCP-серверы Snowflake требуют аутентификацию OAuth, а сервер документации не требует аутентификации. Доступ к документации доступен через инструменты документации MCP-сервера Honeydew.

Удаление MCP-сервера

Сначала удалите MCP-сервер, затем интеграцию API:

DROP MCP SERVER honeydew;
DROP INTEGRATION honeydew_mcp_integration;

Другие клиенты

Любой MCP-совместимый клиент может подключиться к MCP-серверу Honeydew с использованием стандартного HTTP-транспорта.

Используйте следующую JSON-конфигурацию в качестве отправной точки:

Примечание

Если ваша организация использует пользовательское имя хоста Honeydew, замените https://mcp.honeydew.cloud/mcp на имя хоста вашего тенанта. Имя хоста можно найти в Settings > MCP Server в 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 " } } ```

См. Server URL, Authentication и Configuration для получения подробной информации о каждом параметре.

Пример использования

После подключения вы можете задавать вашему ИИ-ассистенту вопросы, например:

  • «Какие сущности доступны в семантической модели?»
  • «Покажи атрибуты и метрики для сущности orders»
  • «Какие домены определены в модели?»
  • «Какие таблицы находятся в схеме analytics?»
  • «Сколько заказов было размещено в прошлом месяце?»
  • «Создай новую метрику для общей выручки по сущности orders»
  • «Какова средняя стоимость заказа по регионам за последний квартал?»

Устранение неполадок

Проблемы с аутентификацией OAuth

Убедитесь, что ваш клиент поддерживает OAuth, проверьте наличие необходимых разрешений в рабочем пространстве Honeydew и попробуйте повторно пройти аутентификацию через интерфейс управления MCP вашего клиента.

Повторная аутентификация в Claude Code

Введите /mcp, выберите Honeydew MCP из списка, выберите «Clear authentication» или «Authenticate», затем следуйте инструкциям OAuth в браузере, чтобы повторно подключиться к Honeydew.

Проблемы с подключением

Убедитесь, что URL MCP-сервера соответствует https://mcp.honeydew.cloud/mcp, и проверьте правильность синтаксиса конфигурации MCP вашего клиента. Если ваша организация использует пользовательское имя хоста, проверьте, что URL соответствует имени хоста вашего тенанта, указанному в Settings > MCP Server в Honeydew Studio.

Отсутствующие инструменты

Проверьте, что аутентификация прошла успешно, проверьте разрешения доступа к рабочему пространству Honeydew и просмотрите консоль вашего клиента на наличие сообщений об ошибках.

Вывод превышает максимально допустимое количество токенов (Claude)

В Claude Code, Claude Desktop и Claude.ai вызов инструмента может завершиться ошибкой, указывающей, что вывод превышает максимально допустимое количество токенов. Инструменты анализа Honeydew, такие как monitor_analysis и get_analysis_step_details, могут возвращать большие результаты, превышающие лимит вывода MCP в Claude.

Claude предупреждает, когда вывод MCP-инструмента превышает 10 000 токенов, и отклоняет вывод выше стандартного лимита в 25 000 токенов. Чтобы увеличить лимит, установите переменную окружения MAX_MCP_OUTPUT_TOKENS перед запуском Claude:

export MAX_MCP_OUTPUT_TOKENS=50000
claude

См. MCP output limits and warnings в документации Claude для получения подробной информации.

Для дополнительной поддержки обратитесь в службу поддержки Honeydew по адресу support@honeydew.ai.

Доступные инструменты

Инструменты, помеченные как только для чтения, не изменяют семантическую модель или хранилище данных.

Совет

Чтобы предоставить доступ только к инструментам чтения, установите заголовок ReadonlyToolsOnly: true в конфигурации вашего MCP-сервера. При включении сервер возвращает только инструменты, которые не изменяют семантическую модель или хранилище данных.

Сессия и рабочее пространство

list_workspaces

только для чтения

Список всех доступных рабочих пространств. Возвращает имя рабочего пространства и тип хранилища данных (snowflake, databricks или bigquery). Используйте тип хранилища данных для информирования о реализации семантической модели.

list_workspace_branches

только для чтения

Список всех веток, доступных для рабочего пространства.

Имя рабочего пространства.

get_session_workspace_and_branch

только для чтения

Получить рабочее пространство и ветку, установленные для текущей сессии.

set_session_workspace_and_branch

только для чтения

Установить рабочее пространство и ветку для текущей сессии. Все последующие вызовы инструментов в сессии используют это рабочее пространство и ветку.

Имя рабочего пространства. Ветка для использования.

create_workspace_branch

Создать новую ветку для существующего рабочего пространства. Ветка создается из текущего состояния ветки prod рабочего пространства. Если рабочее пространство не закреплено через заголовки, сессия автоматически переключается на новую ветку.

Имя рабочего пространства, для которого создается ветка. Имя новой ветки для создания.

delete_workspace_branch

Удалить ветку из рабочего пространства. Это деструктивная, необратимая операция. Всегда подтверждайте имя рабочего пространства и имя ветки с пользователем перед вызовом этого инструмента. Ветка prod не может быть удалена. Если удаленная ветка является текущей веткой сессии, сессия автоматически переключается на prod.

Имя рабочего пространства, содержащего ветку для удаления. Имя ветки для удаления.

get_branch_history

только для чтения

Получить историю изменений для ветки текущей сессии. Возвращает список изменений, показывающий, какие семантические объекты были изменены, кем и когда.

Максимальное количество изменений для возврата.

create_pr_for_working_branch

Создать запрос на включение изменений (pull request) для рабочей ветки текущей сессии. Возвращает URL PR при успехе.

Заголовок для запроса на включение изменений. Описание для запроса на включение изменений.

Вопросы и анализ

initiate_analysis

только для чтения

Начать или продолжить анализ данных. Возвращает conversation_id — используйте monitor_analysis для опроса о ходе выполнения и результатах, и abort_analysis для преждевременной остановки. См. Deep Analysis для получения дополнительной информации.

Вопрос на естественном языке. Имя агента для нового разговора. Опустите для уточняющих вопросов — агент наследуется из существующего разговора. Идентификатор существующего разговора для продолжения, или опустите, чтобы начать новый разговор.

monitor_analysis

только для чтения

Опрос новых сообщений о ходе выполнения от текущего анализа. Каждый вызов возвращает только сообщения с момента последнего вызова. Опрашивайте повторно, пока status не станет DONE или NO_CHAT_CURRENTLY_RUNNING.

Идентификатор разговора, возвращенный `initiate_analysis`. Максимальное количество сообщений для возврата за один вызов. Идентификатор сообщения для воспроизведения. Используйте `last_received_message_id` из предыдущего результата, чтобы восстановить пропущенные сообщения.

get_analysis_step_details

только для чтения

Получить полные сведения о конкретном шаге анализа, включая семантический запрос, SQL-оператор, использованный контекст и данные, полученные на этом шаге.

Идентификатор разговора, возвращенный `initiate_analysis`. Идентификатор шага из `monitor_analysis` (например, `STEP/0`).

abort_analysis

только для чтения

Прервать текущий анализ. Можно возобновить с точки прерывания с помощью initiate_analysis.

Идентификатор разговора, возвращенный `initiate_analysis`.

list_analysis_chats

только для чтения

Возвращает постраничный список разговоров анализа для текущего рабочего пространства, отсортированных по времени создания (сначала новые). Администраторы видят все разговоры; не-администраторы — только свои. Каждая запись включает идентификатор разговора, заголовок, отзыв пользователя, домен, агента, время создания и отображаемое имя пользователя, создавшего разговор.

Максимальное количество разговоров для возврата. Количество разговоров для пропуска при пагинации.

provide_analysis_feedback

Установить или очистить отзыв о конкретном разговоре анализа. Для каждого разговора существует одна запись отзыва (не на каждый вопрос) — она должна отражать общее качество всего потока разговора.

Вызывайте этот инструмент после завершения monitor_analysis и выражения пользователем удовлетворенности или неудовлетворенности результатом. Используйте короткую утвердительную строку для положительного отзыва (например, Good), или формат <Reason>: <details> для отрицательного отзыва, где Reason — одно из Chart Issue, Data Issue, Wrong Judgement или Other.

Идентификатор разговора анализа. Текст отзыва для сохранения или `null` для очистки существующего отзыва.

get_stored_conversation

только для чтения

Возвращает все сообщения из существующего разговора анализа. Используйте это для просмотра полного содержания предыдущего разговора. is_complete в ответе указывает, достиг ли разговор конечного состояния.

Идентификатор разговора из `list_analysis_chats`. Если `true`, включите записи о ходе выполнения `step_start` и `step_insight`. Если `false`, возвращайте только финальные ответы и сообщения плана/интерпретации.

Обзор и обнаружение

list_entities

только для чтения

Список всех сущностей в семантической модели с их именами, описаниями и ключами.

get_entity

только для чтения

Получить подробную информацию о сущности, включая ее атрибуты, метрики, наборы данных, связи и YAML-определение.

Имя сущности.

get_field

только чтение

Получить подробную информацию о конкретном поле (атрибуте или метрике) внутри сущности, включая его YAML-определение.

Имя сущности, содержащей поле. Имя поля.

list_domains

только чтение

Перечислить все домены в семантической модели с их именами, описаниями и сущностями.

get_domain

только чтение

Получить подробную информацию о домене, включая его сущности, фильтры, параметры и YAML-определение.

Имя домена.

search_model

только чтение

Выполнить поиск по семантической модели для поиска сущностей, атрибутов, метрик, наборов данных, динамических наборов данных, доменов и глобальных параметров, соответствующих строке запроса.

Используйте синтаксис entity.field для ограничения поиска полями в пределах конкретной сущности. Например, customers.balance находит поле balance в сущностях, соответствующих customers; customers. возвращает все поля соответствующих сущностей. В режиме OR/AND частичные совпадения применяются как к части сущности, так и к части поля — cust.bal соответствует customers.balance.

Строка поискового запроса. Управляет способом сопоставления запроса:
  • OR — разделяет по пробелам, возвращает объекты, соответствующие любому слову.
  • AND — разделяет по пробелам, возвращает только объекты, соответствующие всем словам.
  • EXACT — использует полную строку как есть, возвращает объекты, чьё имя, отображаемое имя или метка точно совпадают.

Обнаружение хранилища данных

list_databases

только чтение

Перечислить все базы данных, доступные в подключённом хранилище данных.

list_schemas

только чтение

Перечислить все схемы в конкретной базе данных подключённого хранилища данных.

Имя базы данных.

list_tables

только чтение

Перечислить таблицы/представления в конкретной базе данных и схеме подключённого хранилища данных.

Имя базы данных. Имя схемы.

get_table_info

только чтение

Получить подробную информацию о таблице/представлении хранилища данных, включая его столбцы и метаданные.

Имя базы данных. Имя схемы. Имя таблицы.

Семантическая модель

import_tables

Импортировать таблицы из подключённого хранилища данных в семантическую модель. Каждая таблица становится сущностью, а её столбцы — атрибутами.

Список полностью квалифицированных имён таблиц в формате `database.schema.table`.

create_entity

Создать новую сущность в семантической модели из YAML-определений.

YAML-определение сущности. YAML-определение набора данных.

create_object

Создать новый объект семантической модели из YAML-определения. Поддерживаемые типы: вычисляемый атрибут, метрика, динамический набор данных, домен и глобальный параметр.

YAML-определение объекта. Создать объект, даже если проверка выдаёт ошибки.

update_object

Обновить существующий объект семантической модели из YAML-определения. Поддерживаемые типы: сущность, вычисляемый атрибут, метрика, набор данных, динамический набор данных, домен и глобальный параметр.

YAML-определение объекта. Ключ объекта для обновления. Обновить объект, даже если проверка выдаёт ошибки.

validate_object

только чтение

Проверить YAML-определение объекта семантической модели без создания или обновления. Поддерживаемые типы: сущность, вычисляемый атрибут, метрика, набор данных, динамический набор данных, домен и глобальный параметр.

YAML-определение для проверки. Ключ объекта для проверки.

delete_object

Удалить объект семантической модели по его ключу.

Ключ объекта для удаления. Удалить объект, даже если проверка выдаёт ошибки.

Агенты

list_agents

только чтение

Перечислить всех агентов с их именами, описаниями, доменами и ссылками на контекст.

get_agent

только чтение

Получить подробную информацию об агенте, включая его YAML-определение во frontmatter.

Имя агента для получения.

create_agent

Создать нового агента.

Метаданные для нового агента. Иерархическое имя (например, `growth-analyst`, `finance/budget-analyst`). 
<ParamField body="display_name" type="string" required>
  Человекочитаемое имя, отображаемое в интерфейсе.
</ParamField>

<ParamField body="description" type="string" required>
  Описание назначения и возможностей агента.
</ParamField>

<ParamField body="domain" type="string" required>
  Домен, в котором работает этот агент.
</ParamField>

<ParamField body="welcome_message" type="string">
  Приветственное сообщение, показываемое при начале сеанса пользователем.
</ParamField>

<ParamField body="sample_questions" type="string[]">
  Примеры вопросов, показываемые пользователям.
</ParamField>

<ParamField body="context" type="string[]">
  Имена элементов контекста или glob-шаблоны для загрузки в сеансы
  (например, `skills/**`, `knowledge/marketing/**`).
</ParamField>

<ParamField body="owner" type="string">
  Идентификатор владельца агента.
</ParamField>
Markdown-текст, добавляемый после frontmatter. Этот текст внедряется в подсказку перед каждым сеансом анализа. Создать агента, даже если проверка выдаёт ошибки.

update_agent

Обновить существующего агента.

Имя агента для обновления. Полное обновлённое определение агента. Все обязательные поля из `create_agent` должны быть указаны — это полная замена, а не частичное обновление. Обновлённый Markdown-текст для агента. Обновить агента, даже если проверка выдаёт ошибки.

delete_agent

Удалить агента по имени.

Имя агента для удаления.

Элементы контекста

list_context_items

только чтение

Перечислить все элементы контекста с их типами, именами, заголовками и значениями подтипов.

get_context_item

только чтение

Получить элемент контекста по имени.

Имя элемента контекста для получения.

create_context_item

Создать новый элемент контекста. Поддерживаются типы инструкций и памяти.

Метаданные для нового элемента контекста. Должно быть `instruction`. 
<ParamField body="name" type="string" required>
  Иерархическое имя
  (например, `knowledge/customer/churn-analysis`, `skills/reporting`).
</ParamField>

<ParamField body="subtype" type="string" required>
  Одно из `knowledge`, `skill` или `instruction`.
</ParamField>

<ParamField body="title" type="string" required>
  Человекочитаемый заголовок для элемента контекста.
</ParamField>

<ParamField body="apply" type="string" required>
  Когда применять контекст: `always` или `on_demand`.
</ParamField>

<ParamField body="description" type="string">
  Описание, используемое ИИ для решения, когда загружать этот элемент
  (обязательно, когда `apply` равно `on_demand`).
</ParamField>

<ParamField body="owner" type="string">
  Идентификатор владельца.
</ParamField>

<ParamField body="labels" type="string[]">
  Метки для организации элементов контекста.
</ParamField>

<ParamField body="related_objects" type="object[]">
  Семантические объекты, к которым относится этот элемент контекста.
  Каждый объект имеет `name` (строка) и `type` (`domain`, `entity` или `field`).
</ParamField>

<ParamField body="external_source" type="object">
  Внешний источник для получения содержимого (для подтипа `knowledge`).
  Имеет `tool` (имя MCP-инструмента), `resource_id` (идентификатор во внешнем инструменте)
  и необязательный `cache_max_age_in_seconds` (по умолчанию: `3600`).
</ParamField>
Должно быть `memory`. 
<ParamField body="name" type="string" required>
  Иерархическое имя (например, `events/q4-launch`, `2024/pricing-decision`).
</ParamField>

<ParamField body="subtype" type="string" required>
  Одно из `event` или `decision_trace`.
</ParamField>

<ParamField body="title" type="string" required>
  Человекочитаемый заголовок для элемента контекста.
</ParamField>

<ParamField body="apply" type="string" required>
  Когда применять контекст: `always` или `on_demand`.
</ParamField>

<ParamField body="from_date" type="string" required>
  Дата начала периода памяти в формате ISO (например, `2024-01-01`).
</ParamField>

<ParamField body="to_date" type="string">
  Дата окончания периода памяти в формате ISO.
</ParamField>

<ParamField body="description" type="string">
  Описание, используемое ИИ для решения, когда загружать этот элемент
  (обязательно, когда `apply` равно `on_demand`).
</ParamField>

<ParamField body="owner" type="string">
  Идентификатор владельца.
</ParamField>

<ParamField body="labels" type="string[]">
  Метки для организации элементов контекста.
</ParamField>

<ParamField body="related_objects" type="object[]">
  Семантические объекты, к которым относится этот элемент контекста.
  Каждый объект имеет `name` (строка) и `type` (`domain`, `entity` или `field`).
</ParamField>

<ParamField body="external_source" type="object">
  Внешний источник для получения содержимого.
  Имеет `tool` (имя MCP-инструмента), `resource_id` (идентификатор во внешнем инструменте)
  и необязательный `cache_max_age_in_seconds` (по умолчанию: `3600`).
</ParamField>
Markdown-текст для содержимого элемента контекста. Создать элемент контекста, даже если проверка выдаёт ошибки.

update_context_item

Обновить существующий элемент контекста.

Имя элемента контекста для обновления. Полное обновлённое определение элемента контекста. Все обязательные поля из `create_context_item` должны быть указаны — это полная замена, а не частичное обновление. Обновлённый Markdown-текст для элемента контекста. Обновить элемент контекста, даже если проверка выдаёт ошибки.

delete_context_item

Удалить элемент контекста по имени.

Имя элемента контекста для удаления.

Запрос и предпросмотр

get_sql_from_fields

только чтение

Сгенерировать SQL-запрос для запроса семантического слоя, определённого атрибутами, метриками и фильтрами. Возвращает SQL без его выполнения.

Полностью квалифицированные имена атрибутов (`entity.attribute_name`). Поддерживаются псевдонимы: `entity.attribute_name as alias_name`. Полностью квалифицированные имена метрик (`entity.metric_name`) или SQL-выражения (например, `SUM(entity.field)`). Поддерживаются псевдонимы: `SUM(entity.field) as total`. Условия фильтрации (например, `entity.field = 'value'`, `entity.date_field > '2024-01-01'`). Список полей для сортировки. Формат: `entity.field_name` или `entity.field_name DESC`. Направление по умолчанию — ASC. При использовании псевдонимов сортируйте по имени псевдонима. Домен, по которому выполняется запрос. Максимальное количество строк для возврата. Количество строк для пропуска при пагинации. Добавьте [отчёт о предварительной агрегации](/docs/performance/aggregate-awareness#debugging-aggregate-matching) в начало возвращаемого SQL, указывая для каждой предварительной агрегации в рабочей области, какой CTE её использовал или почему она не могла быть использована.

get_data_from_fields

только чтение

Выполняет запрос к семантическому слою, определённый атрибутами, метриками и фильтрами, и возвращает результирующие данные.

Полностью квалифицированные имена атрибутов (`entity.attribute_name`). Поддерживаются псевдонимы: `entity.attribute_name as alias_name`. Полностью квалифицированные имена метрик (`entity.metric_name`) или SQL-выражения (например, `SUM(entity.field)`). Поддерживаются псевдонимы: `SUM(entity.field) as total`. Условия фильтрации (например, `entity.field = 'value'`, `entity.date_field > '2024-01-01'`). Список полей для сортировки. Формат: `entity.field_name` или `entity.field_name DESC`. Направление по умолчанию — ASC. При использовании псевдонимов сортируйте по имени псевдонима. Домен, к которому выполняется запрос. Максимальное количество строк для возврата. Количество строк для пропуска при пагинации.

list_query_history

только чтение

Выводит список запросов, ранее выполненных через семантический слой Honeydew, сначала самые последние. Используйте его для поиска и разбора неудачных запросов и понимания причин их сбоя. Вызывающие без прав администратора видят только свои запросы.

Каждый запрос включает его статус, сообщение об ошибке, владельца, клиента, домен, исходный входной SQL (SQL, отправленный пользователем для запросов через SQL-интерфейс), временные метки компиляции и выполнения в хранилище, идентификатор запроса в хранилище данных и ссылку для открытия в приложении Honeydew.

Фильтр по статусу запроса (`FAILED`, `SUCCESS`, `RUNNING` или `CANCELED`). Фильтр по клиенту, выполнившему запрос (например, `Snowflake`, `MCP`). Фильтр по имени домена. Фильтр по владельцу запроса (электронная почта пользователя или имя API-ключа). Учитывается только для вызовов администратора; пользователи без прав администратора ограничены своими запросами. Только запросы, выполненные в это время или позже (ISO 8601). Только запросы, выполненные в это время или раньше (ISO 8601). Также возвращает семантическое YAML-определение каждого запроса (атрибуты, метрики, фильтры). Включите, чтобы воспроизвести или изменить запрос. Также возвращает скомпилированный SQL каждого запроса для хранилища (большой объём). Включите для отладки конкретного запроса на стороне хранилища. Максимальное количество запросов для возврата. Количество запросов для пропуска при пагинации.

Документация

search_docs

только чтение

Выполняет поиск в базе знаний документации Honeydew для получения релевантной информации, примеров кода, ссылок на API и руководств. Возвращает контекстное содержимое с заголовками и ссылками на страницы документации. Чтобы прочитать полное содержимое страницы, используйте query_docs_filesystem.

Поисковый запрос.

query_docs_filesystem

только чтение

Выполняет команду, подобную shell-команде, только для чтения, в виртуализированной файловой системе в памяти, содержащей страницы документации Honeydew и спецификации OpenAPI. Поддерживает команды, такие как rg, grep, find, tree, ls, cat, head и tail. Используйте для точного сопоставления ключевых слов или регулярных выражений, структурного исследования или чтения полного содержимого конкретной страницы по пути.

Команда shell для выполнения (например, `rg -il "keyword" /`, `tree / -L 2`, `head -80 /path/page.mdx`).

Часто задаваемые вопросы

Какие инструменты нужны для глубокого анализа?

Для запуска глубокого анализа требуется:

Чтобы просмотреть прошлые разговоры анализа, также включите list_analysis_chats и get_stored_conversation.

Ограничение агента этими инструментами полезно, когда:

  • Ваши целевые пользователи выполняют только рабочие процессы глубокого анализа
  • Вы хотите, чтобы агент был сосредоточен на задачах анализа
  • Ваш клиент ограничивает количество включаемых инструментов (например, Databricks Genie Code)

Для других случаев использования предоставьте больше инструментов из списка Доступные инструменты — агент выберет подходящий инструмент для каждой задачи.