Honeydew Semantic Layer

официальный

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

Смотреть на honeydew.ai

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

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

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

MCP-сервер

Что такое MCP?

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

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

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

Установка

URL-адрес сервера

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

Если ваша организация использует пользовательское имя хоста Honeydew, замените URL-адрес по умолчанию на имя хоста вашего тенанта. Вы можете найти имя хоста в пользовательском интерфейсе Honeydew в разделе **Настройки > MCP-сервер**.

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

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

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

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

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

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

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

MCP-сервер в режиме базовой HTTP-аутентификации требует 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. Вызывайте эти инструменты из вашего ИИ-ассистента после подключения к MCP-серверу.

При желании вы можете указать следующие заголовки в конфигурации вашего MCP-сервера:

  • Workspace: Зафиксировать рабочую область для всех запросов (необязательно)
  • Branch: Зафиксировать конкретную ветку рабочей области для всех запросов (необязательно, по умолчанию prod, если рабочая область задана)
  • Honeydew-Client: Идентифицировать MCP-клиент (необязательно, автоматически определяется из подключенного инструмента). Передайте этот заголовок, чтобы указать конкретный идентификатор клиента.
  • ReadonlyToolsOnly: Установите значение true, чтобы предоставить только инструменты только для чтения (необязательно)
MCP-сервер использует заголовок ответа `Mcp-Session-Id` для поддержания состояния сессии, включая активную рабочую область и ветку. Подробнее см. в [спецификации управления сессиями MCP](https://modelcontextprotocol.io/specification/2025-06-18/basic/transports#session-management).

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

Claude Code CLI

#### Установка плагина **Требуется Git.** Установка плагина из GitHub клонирует репозиторий локально, поэтому [Git](https://git-scm.com/downloads) должен быть установлен и находиться в вашем `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 и выберите Маркетплейсы в селекторе вверху
  2. Выберите honeydew-ai-coding-agents-plugins
  3. Нажмите Обновить маркетплейс

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

Настройка MCP

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

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

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

Если ваша организация использует пользовательское имя хоста Honeydew, замените `https://mcp.honeydew.cloud/mcp` на имя хоста вашего тенанта. Вы можете найти имя хоста в разделе **Настройки > MCP-сервер** в 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 поддерживает
[расширение переменных окружения](https://code.claude.com/docs/en/mcp#environment-variable-expansion-in-mcp-json)
с использованием синтаксиса `${VAR_NAME}`.

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

```bash theme={null}
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](https://git-scm.com/downloads) должен быть установлен и находиться в вашем `PATH`. Если Git отсутствует, установка плагина завершится неудачей. Установите Git или используйте шаги ручной настройки MCP вашего клиента, чтобы настроить сервер напрямую, а не через плагин.

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

  1. Перейдите в Настройки -> Настройка
  2. Нажмите Обзор плагинов
  3. Перейдите на вкладку Личные
  4. Нажмите значок + и выберите Добавить маркетплейс из GitHub
  5. Введите honeydew-ai/honeydew-ai-coding-agents-plugins в поле ввода
  6. Появится плагин Honeydew AI. Установите его.

Настройка MCP

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

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

Режим Claude Code

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

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

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

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

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

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

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

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

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

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

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

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

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

Claude.ai

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

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

  1. Загрузите zip-архив плагина: honeydew-ai-claude.zip
  2. В Claude.ai перейдите в Настройки -> Плагины -> Добавить плагин -> Загрузить zip
  3. Загрузите zip-архив — плагин появится в вашем частном маркетплейсе

Настройка MCP

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

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

Если ваша организация использует пользовательское имя хоста Honeydew, замените `https://mcp.honeydew.cloud/mcp` на имя хоста вашего тенанта. Вы можете найти имя хоста в разделе **Настройки > MCP-сервер** в 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](https://git-scm.com/downloads) должен быть установлен и находиться в вашем `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 для исследования моделей, запросов данных, управления моделями и доступа к документации.

Если ваша организация использует пользовательское имя хоста 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](https://git-scm.com/downloads) должен быть установлен и находиться в вашем `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 для исследования моделей, запросов данных, управления моделями и доступа к документации.

Чтобы добавить сервер, перейдите в 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, добавьте сервер Honeydew Documentation MCP аналогичным образом, используя Имя сервера 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 для исследования моделей, запросов данных, управления моделями и доступа к документации.

Если ваша организация использует пользовательское имя хоста 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 Agent. Подробнее см. в [документации Databricks MCP](https://docs.databricks.com/aws/en/generative-ai/mcp/).

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

  • Genie Code включён в вашем рабочем пространстве Databricks

  • Привилегия CREATE CONNECTION на метасторе Unity Catalog

    1. Перейдите в **Catalog** → **Connections** → **Create a connection** 2. На экране **Connection basics**: * Установите **Connection name** как `honeydew-mcp` * Установите **Connection type** как **HTTP** * Установите **Auth type** как **Dynamic Client Registration** * Нажмите **Next** 3. На экране **Authentication**: * Установите **Host** как `https://mcp.honeydew.cloud` * Оставьте **Port** как `443` * Установите **OAuth scope** как `openid` * Нажмите **Next** 4. На экране **Connection details**: * Отметьте **Is MCP connection** * Установите **Base path** как `/mcp` * Нажмите **Create connection** 
    <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>
    Если ваша организация использует пользовательское имя хоста Honeydew, замените `https://mcp.honeydew.cloud` на имя хоста вашего тенанта. Вы можете найти имя хоста в **Settings > MCP Server** в Honeydew Studio. Перейдите в **Catalog** → **Connections** → `honeydew-mcp` и нажмите **Login** в правом верхнем углу, чтобы аутентифицироваться и проверить соединение. Предоставьте привилегию `USE CONNECTION` любым пользователям или ролям, которым нужен доступ к серверу Honeydew MCP: 
    GRANT USE CONNECTION ON CONNECTION `honeydew-mcp` TO <user-or-role>;
    1. Откройте Genie Code и нажмите значок шестеренки 2. Перейдите в **MCP Servers** → **Add Server** 3. Выберите **External MCP server** 4. Выберите созданное вами соединение `honeydew-mcp` 5. Войдите в соединение при появлении запроса 6. Нажмите **Save** Databricks ограничивает MCP до 20 инструментов на всех настроенных серверах. Если вам нужно настроить, какие инструменты Honeydew доступны, используйте настройки Genie Code MCP, чтобы включить или отключить определенные инструменты.

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

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

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

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

DROP CONNECTION `honeydew-mcp`;

Devin

#### Сервер MCP

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

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

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

  1. Перейдите в Settings -> Connections -> MCP servers

  2. Нажмите Add a custom MCP

  3. Введите honeydew в поле Server Name

  4. При желании добавьте иконку и Short Description

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

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

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

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

  8. Нажмите Save, затем нажмите Test listing tools, чтобы проверить соединение

Honeydew Documentation MCP (опционально)

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

  1. Перейдите в Settings -> Connections -> MCP servers
  2. Нажмите Add a custom MCP
  3. Введите honeydew-docs в поле Server Name
  4. Выберите HTTP в качестве типа транспорта
  5. Введите https://honeydew.ai/docs/mcp в поле Server URL
  6. Установите метод аутентификации None
  7. Нажмите Save

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

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

  1. Перейдите в Settings -> Connections -> MCP servers
  2. Найдите сервер honeydew и удалите его

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

  1. Перейдите в Settings -> Connections -> MCP servers
  2. Найдите сервер honeydew-docs и удалите его

GitHub Copilot CLI

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

  1. Запустите GitHub Copilot CLI с помощью copilot

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

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

    • Name: honeydew

    • Type: http

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

    • HTTP Headers:

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

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

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

Плагины AI Coding Agent

**Требуется Git.** Установка плагина из GitHub клонирует репозиторий локально, поэтому [Git](https://git-scm.com/downloads) должен быть установлен и находиться в вашем `PATH`. Если Git отсутствует, установка плагина завершится неудачей. Установите Git или используйте шаги ручной настройки MCP вашего клиента, чтобы настроить сервер напрямую, а не через плагин.

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

Добавьте marketplace в Copilot CLI:

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

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

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

Honeydew Documentation MCP (опционально)

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

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

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

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

/mcp remove honeydew

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

/mcp remove honeydew-docs

Gemini CLI

#### Установка расширения **Требуется Git.** Установка плагина из GitHub клонирует репозиторий локально, поэтому [Git](https://git-scm.com/downloads) должен быть установлен и находиться в вашем `PATH`. Если Git отсутствует, установка плагина завершится неудачей. Установите Git или используйте шаги ручной настройки MCP вашего клиента, чтобы настроить сервер напрямую, а не через плагин.

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

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

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

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

Настройка MCP

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

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

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

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

```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 Documentation MCP (опционально)

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

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

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

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

gemini mcp remove honeydew

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

gemini mcp remove honeydew-docs

VS Code и GitHub Copilot

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

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

Добавьте marketplace Honeydew

  1. Откройте ваш VS Code settings.json (откройте палитру команд с помощью CMD+Shift+P на macOS или Ctrl+Shift+P на Windows/Linux, затем выберите Preferences: Open User Settings (JSON))
  2. Добавьте marketplace 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 и нажмите Install

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

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

Если в настройках VS Code включен параметр extensions.autoUpdate, плагин обновляется автоматически. Чтобы обновить вручную, откройте палитру команд и выполните Extensions: Check for Extension Updates.

Сервер MCP

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

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

Если ваша организация использует пользовательское имя хоста Honeydew, замените `https://mcp.honeydew.cloud/mcp` на имя хоста вашего тенанта. Вы можете найти имя хоста в **Settings > MCP Server** в Honeydew Studio. 1. Откройте палитру команд с помощью `CMD+Shift+P` (macOS) или `Ctrl+Shift+P` (Windows/Linux) 2. Выберите **MCP: Add Server...** 3. Выберите **HTTP (HTTP or Server-Sent Events)** 4. Введите URL сервера Honeydew MCP: `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 (опционально)

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

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

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

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

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

Codex CLI

#### Установка плагина **Требуется Git.** Установка плагина из GitHub клонирует репозиторий локально, поэтому [Git](https://git-scm.com/downloads) должен быть установлен и находиться в вашем `PATH`. Если Git отсутствует, установка плагина завершится ошибкой. Установите Git или используйте шаги ручной настройки MCP вашего клиента для прямой настройки сервера вместо плагина.

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

Добавьте маркетплейс в 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 без установки плагина. Отключите подключение Honeydew MCP, добавленное плагином, затем добавьте свою пользовательскую конечную точку, следуя инструкциям ниже.

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

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

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

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

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

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

codex mcp remove honeydew

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

codex mcp remove honeydew-docs

Codex

#### Установка плагина **Требуется Git.** Установка плагина из GitHub клонирует репозиторий локально, поэтому [Git](https://git-scm.com/downloads) должен быть установлен и находиться в вашем `PATH`. Если Git отсутствует, установка плагина завершится ошибкой. Установите Git или используйте шаги ручной настройки MCP вашего клиента для прямой настройки сервера вместо плагина.

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

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

  1. Откройте Plugins
  2. Нажмите стрелку выпадающего списка и выберите Add marketplace
  3. Добавьте honeydew-ai/honeydew-ai-coding-agents-plugins
Вы также можете добавить маркетплейс из [Codex CLI](#codex-cli): 
```
codex plugin marketplace add honeydew-ai/honeydew-ai-coding-agents-plugins
```

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

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

Настройка MCP

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

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

Honeydew MCP

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

  2. Перейдите в Settings -> MCP Servers

  3. В разделе Custom servers нажмите Add Server

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

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

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

  7. Оставьте поле Bearer token environment variable пустым

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

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

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

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

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

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

Если сервер Honeydew MCP не аутентифицирован в Codex и опция "Authenticate" не появляется:

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

Honeydew Documentation MCP (опционально)

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

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

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

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

  1. Перейдите в Settings -> MCP Servers
  2. Найдите honeydew в разделе Custom servers и нажмите Remove

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

  1. Перейдите в Settings -> MCP Servers
  2. Найдите honeydew-docs в разделе Custom servers и нажмите Remove

Antigravity

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

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

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

  3. Нажмите Manage MCP Servers

  4. Нажмите View raw config

  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 (опционально)

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

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

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

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

  1. Откройте редактор Antigravity
  2. Нажмите выпадающий список ... в верхней части панели агента
  3. Нажмите Manage MCP Servers
  4. Нажмите View raw config
  5. Удалите записи honeydew и honeydew-docs из mcp_config.json
  6. Сохраните файл

OpenCode

#### Сервер MCP Если ваша организация использует пользовательское имя хоста Honeydew, замените `https://mcp.honeydew.cloud/mcp` на имя хоста вашего тенанта. Имя хоста можно найти в **Settings > MCP Server** в Honeydew Studio. Выполните следующую команду и следуйте интерактивным подсказкам: 
  ```bash theme={null}
  opencode mcp add
  ```

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

  1. **Location**: Выберите предпочитаемую область (текущий проект или глобальная)
  2. **MCP server name**: `honeydew`
  3. **MCP server type**: `Remote`
  4. **MCP server URL**: `https://mcp.honeydew.cloud/mcp`
  5. **OAuth authentication**: `Yes`
  6. **Preregistered client ID**: `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 (опционально)

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

Выполните `opencode mcp add` и введите следующие значения: 
  1. **MCP server name**: `honeydew-docs`
  2. **MCP server type**: `Remote`
  3. **MCP server URL**: `https://honeydew.ai/docs/mcp`
  4. **OAuth authentication**: `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

Чтобы удалить сервер Honeydew MCP, удалите запись honeydew из вашего файла opencode.jsonc. Чтобы удалить сервер Honeydew Documentation MCP, удалите запись 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 на имя хоста вашего тенанта. Имя хоста можно найти в разделе Settings > MCP Server в Honeydew Studio.

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

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

В Kiro CLI выполните /mcp, чтобы убедиться, что сервер подключен. В Kiro IDE сервер отображается на панели 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.

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

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

  • "Какие сущности доступны в семантической модели?"
  • "Покажи атрибуты и метрики для сущности 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.

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

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

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

Сессия и рабочая область

list_workspaces

read-only

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

list_workspace_branches

read-only

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

Имя рабочей области.

get_session_workspace_and_branch

read-only

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

set_session_workspace_and_branch

read-only

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

Имя рабочей области. Используемая ветка.

create_workspace_branch

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

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

delete_workspace_branch

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

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

get_branch_history

read-only

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

Максимальное количество возвращаемых изменений.

create_pr_for_working_branch

Создает pull request для рабочей ветки текущей сессии. В случае успеха возвращает URL-адрес PR.

Заголовок pull request. Описание pull request.

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

initiate_analysis

read-only

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

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

monitor_analysis

read-only

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

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

get_analysis_step_details

read-only

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

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

abort_analysis

read-only

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

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

list_analysis_chats

read-only

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

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

provide_analysis_feedback

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

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

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

get_stored_conversation

read-only Возвращает все сообщения из существующего диалога анализа. Используйте это для просмотра полного содержимого предыдущего диалога. 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. При использовании псевдонимов сортируйте по имени псевдонима. Домен, к которому выполняется запрос. Максимальное количество возвращаемых строк. Количество строк, пропускаемых для пагинации.

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`). Фильтр по имени домена. Фильтр по владельцу запроса (email пользователя или имя API-ключа). Учитывается только для администраторов; пользователи без прав администратора ограничены своими запросами. Только запросы, выполненные в это время или позже (ISO 8601). Только запросы, выполненные в это время или раньше (ISO 8601). Также возвращать семантическое YAML-определение каждого запроса (атрибуты, метрики, фильтры). Включите для воспроизведения или изменения запроса. Также возвращать скомпилированный SQL для хранилища каждого запроса (большой объем). Включите для отладки конкретного запроса на стороне хранилища. Максимальное количество возвращаемых запросов. Количество запросов, пропускаемых для пагинации.

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

search_docs

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

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

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

query_docs_filesystem

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

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

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