Honeydew Semantic Layer

公式

Honeydew semantic layerは、管理されたビジネスフレンドリーなデータモデルを提供し、ソース間でメトリクス、ディメンション、リレーションシップを統合することで、一貫したセルフサービス分析とAIを活用したデータアクセスを実現します。

honeydew.ai で表示

Honeydew Semantic Layer MCPで何ができますか？

  • ウェアハウスのテーブルとスキーマを発見 — 自然な会話を通じてデータウェアハウスの構造とセマンティックモデルの定義を探索します。
  • セマンティックモデルの構築と保守 — create_workspace_branch およびその他のセッションツールを使用してセマンティックモデルの定義を作成または更新します。
  • 自然言語でデータをクエリ — SQLを書かずにデータに関する質問をして回答を得ます。
  • Honeydewのドキュメントを検索 — MCP互換のアシスタントから直接製品ドキュメントを参照します。

ドキュメント

MCP サーバー

MCP とは？

Model Context Protocol (MCP) は、AI アプリケーションを外部システムやツールに安全に接続するためのオープンソース標準です。 Honeydew は、AI コーディングアシスタントを Honeydew Semantic Layer に接続する MCP サーバーを提供します。

使用するタイミング

  • ウェアハウスのテーブル、スキーマ、セマンティックモデル定義の検出と探索
  • 自然な会話を通じたセマンティックモデルの構築と保守
  • MCP 互換のアシスタントから自然言語でデータをクエリ
  • Honeydew ドキュメントの検索と閲覧

インストール

サーバー URL

Honeydew は MCP サーバー API を以下の場所で公開しています： https://mcp.honeydew.cloud/mcp

組織でカスタム Honeydew ホスト名を使用している場合は、 デフォルト URL をテナントのホスト名に置き換えてください。 ホスト名は Honeydew UI の **Settings > MCP Server** で確認できます。

認証

Honeydew MCP サーバーで認証する方法は2つあります： OAuth または HTTP Basic 認証です。

OAuth 認証（推奨）

ほとんどのクライアントは OAuth 認証をサポートしています。 初回接続時に、以下の手順が求められます：

  1. Honeydew アカウントでログイン
  2. OAuth 認可を承認

その後、クライアントは後続のリクエストにアクセストークンを安全に提供します。

HTTP Basic 認証

HTTP Basic 認証モードの MCP サーバーでは、 認証に API キー が必要です。

API キーと API シークレットを API_KEY:API_SECRET の形式で Base64 エンコードした文字列を提供する必要があります。

MCP サーバーアクセス用に新しい API キーを作成する場合、 作成時に Honeydew Studio UI から Base64 エンコードされた文字列をコピーできます。

次のコマンドを使用して 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 サーバーに接続した後、AI アシスタントからこれらのツールを呼び出してください。

オプションで、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 は、 自然な会話を通じてセマンティックモデルを構築し、データを分析するためのスキルとツールを備えた プラグインリポジトリ を提供しています。 プラグインをインストールすると、Honeydew MCP サーバーが自動的にセットアップされます。

claude で Claude Code を起動し、マーケットプレイスを追加します：

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

次に、マーケットプレイスから Honeydew プラグインをインストールします：

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

その後、プラグインをリロードして有効にします：

/reload-plugins

プラグインの更新

Honeydew マーケットプレイスプラグインを更新するには、claude で Claude Code を起動し、次の手順を実行します：

  1. /plugin と入力し、上部のセレクターで Marketplaces を選択します
  2. honeydew-ai-coding-agents-plugins を選択します
  3. Update marketplace をクリックします

更新を自動的に受け取るには、マーケットプレイス設定で Enable auto-update を選択します。

MCP セットアップ

組織でカスタム Honeydew エンドポイントを使用している場合、 またはプラグインをインストールせずに MCP サーバーを設定する場合は、このセクションを使用してください。 プラグインによって追加された Honeydew MCP 接続を無効にし、以下の手順を使用して カスタムエンドポイントを追加します。

Honeydew MCP サーバーは、モデル探索、データクエリ、モデル管理、 ドキュメントアクセスのために、Claude Code を Honeydew Semantic Layer に接続します。

次のいずれかの方法を使用して、Honeydew MCP サーバーを追加します：

組織でカスタム Honeydew ホスト名を使用している場合は、 `https://mcp.honeydew.cloud/mcp` をテナントのホスト名に置き換えてください。 ホスト名は Honeydew Studio の **Settings > MCP Server** で確認できます。 ```bash theme={null} claude mcp add --transport http honeydew \ https://mcp.honeydew.cloud/mcp ``` 
      `claude` で Claude Code を起動します。
      Honeydew への OAuth 認証を求められます。
    </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` で Claude Code を起動します。
      Honeydew への OAuth 認証を求められます。
    </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` で Claude Code を起動します。
      Honeydew への OAuth 認証を求められます。
    </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}` 構文を使用した
[環境変数の展開](https://code.claude.com/docs/en/mcp#environment-variable-expansion-in-mcp-json) をサポートしています。

`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}` 参照を解決します。

Honeydew ドキュメント MCP（オプション）

Honeydew MCP サーバーには既にドキュメントアクセスツールが含まれているため、 個別のドキュメントサーバーは必要ありません。 Honeydew に接続せずにドキュメントアクセスのみが必要な場合にのみ、 Honeydew ドキュメント MCP を追加してください。認証は不要です。

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

MCP サーバーの削除

Honeydew MCP サーバーを削除するには：

claude mcp remove honeydew

Honeydew ドキュメント MCP サーバーを削除するには：

claude mcp remove honeydew-docs

Claude Desktop

#### プラグインのインストール **Git が必要です。** GitHub からプラグインをインストールすると、リポジトリがローカルにクローンされるため、 [Git](https://git-scm.com/downloads) がインストールされ、 `PATH` に含まれている必要があります。Git がない場合、プラグインのインストールは失敗します。Git をインストールするか、 クライアントの手動 MCP セットアップ手順を使用して、プラグインの代わりにサーバーを直接設定してください。

Honeydew は、 自然な会話を通じてセマンティックモデルを構築し、データを分析するためのスキルとツールを備えた プラグインリポジトリ を提供しています。 プラグインをインストールすると、Honeydew MCP サーバーが自動的にセットアップされます。

  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 サーバーを設定する場合は、このセクションを使用してください。 プラグインによって追加された Honeydew MCP 接続を無効にし、以下の手順を使用して カスタムエンドポイントを追加します。

Honeydew MCP サーバーは、モデル探索、データクエリ、モデル管理、 ドキュメントアクセスのために、Claude Desktop を Honeydew Semantic Layer に接続します。

Claude Code モード

Claude Desktop を Claude Code モードで使用する場合は、 代わりに Claude Code CLI の手順に従ってください。

組織でカスタム Honeydew ホスト名を使用している場合は、 `https://mcp.honeydew.cloud/mcp` をテナントのホスト名に置き換えてください。 ホスト名は Honeydew Studio の **Settings > MCP Server** で確認できます。

Cowork モードで Honeydew MCP を追加するには：

  1. Settings -> Connectors -> Add custom connector に移動します
  2. Name フィールドに honeydew を入力します
  3. Remote MCP server URL フィールドに https://mcp.honeydew.cloud/mcp を入力します
  4. Add をクリックします

初回接続時に、Honeydew への OAuth 認証を求められます。

Honeydew ドキュメント MCP（オプション）

Honeydew MCP サーバーには既にドキュメントアクセスツールが含まれているため、 個別のドキュメントサーバーは必要ありません。 Honeydew に接続せずにドキュメントアクセスのみが必要な場合にのみ、 Honeydew ドキュメント MCP を追加してください。認証は不要です。

  1. Settings -> Connectors -> Add custom connector に移動します
  2. Name フィールドに honeydew-docs を入力します
  3. Remote MCP server URL フィールドに https://honeydew.ai/docs/mcp を入力します
  4. Add をクリックします

MCP サーバーの削除

Cowork モードで Honeydew MCP サーバーを削除するには：

  1. Settings -> Connectors に移動します
  2. honeydew コネクターを見つけ、削除アイコンをクリックします

Honeydew ドキュメント MCP サーバーを削除するには：

  1. Settings -> Connectors に移動します
  2. honeydew-docs コネクターを見つけ、削除アイコンをクリックします

Claude.ai

#### プラグインのインストール

Honeydew は、 自然な会話を通じてセマンティックモデルを構築し、データを分析するためのスキルとツールを備えた プラグインリポジトリ を提供しています。 プラグインをインストールすると、Honeydew MCP サーバーと Honeydew ドキュメント MCP サーバーの両方が自動的にセットアップされます。

  1. プラグイン zip をダウンロードします： honeydew-ai-claude.zip
  2. Claude.ai で、Settings -> Plugins -> Add plugin -> Upload zip に移動します
  3. zip をアップロードします — プラグインがプライベートマーケットプレイスに表示されます

MCP セットアップ

組織でカスタム Honeydew エンドポイントを使用している場合、 またはプラグインをインストールせずに MCP サーバーを設定する場合は、このセクションを使用してください。 プラグインによって追加された Honeydew MCP コネクターを削除し、以下の手順を使用して カスタムエンドポイントを追加します。

Honeydew MCP サーバーは、モデル探索、データクエリ、モデル管理、 ドキュメントアクセスのために、Claude.ai を Honeydew Semantic Layer に接続します。

組織でカスタム Honeydew ホスト名を使用している場合は、 `https://mcp.honeydew.cloud/mcp` をテナントのホスト名に置き換えてください。 ホスト名は Honeydew Studio の **Settings > MCP Server** で確認できます。

Honeydew MCP サーバーを追加するには：

  1. Settings -> Connectors -> Add custom connector に移動します
  2. Name フィールドに honeydew と入力します
  3. Remote MCP server URL フィールドに https://mcp.honeydew.cloud/mcp と入力します
  4. Add をクリックします

初回接続時に、Honeydew への OAuth 認証を求められます。

Honeydew Documentation MCP (オプション)

Honeydew MCP サーバーにはドキュメントアクセスツールが既に含まれているため、 個別のドキュメントサーバーは不要です。 Honeydew に接続せずにドキュメントアクセスのみが必要な場合にのみ、 Honeydew Documentation MCP を追加してください。認証は不要です。

  1. Settings -> Connectors -> Add custom connector に移動します
  2. Name フィールドに honeydew-docs と入力します
  3. Remote MCP server URL フィールドに https://honeydew.ai/docs/mcp と入力します
  4. Add をクリックします

MCP サーバーの削除

Honeydew MCP サーバーを削除するには:

  1. Settings -> Connectors に移動します
  2. honeydew コネクターを見つけ、削除アイコンをクリックします

Honeydew Documentation MCP サーバーを削除するには:

  1. Settings -> Connectors に移動します
  2. honeydew-docs コネクターを見つけ、削除アイコンをクリックします

Cortex Code CLI

#### プラグインのインストール **Git が必要です。** GitHub からプラグインをインストールすると、リポジトリがローカルにクローンされるため、 [Git](https://git-scm.com/downloads) がインストールされ、`PATH` に含まれている必要があります。 Git がない場合、プラグインのインストールは失敗します。Git をインストールするか、 プラグインの代わりにクライアントの手動 MCP セットアップ手順を使用してサーバーを直接設定してください。

Honeydew は、 セマンティックモデルの構築や自然な会話によるデータ分析のためのスキルとツールを備えた プラグインリポジトリ を提供しています。 プラグインをインストールすると、Honeydew MCP サーバーが自動的にセットアップされます。

cortex で Cortex Code CLI を起動し、プラグインをインストールします:

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

MCP セットアップ

組織でカスタム Honeydew エンドポイントを使用している場合や、 プラグインをインストールせずに MCP サーバーを設定したい場合は、このセクションを使用してください。 プラグインによって追加された Honeydew MCP 接続を無効にし、 以下の手順に従ってカスタムエンドポイントを追加します。

Honeydew MCP サーバーは、モデル探索、データクエリ、モデル管理、 ドキュメントアクセスのために Cortex Code CLI を Honeydew Semantic Layer に接続します。

組織でカスタム Honeydew ホスト名を使用している場合は、 `https://mcp.honeydew.cloud/mcp` をテナントのホスト名に置き換えてください。 ホスト名は Honeydew Studio の **Settings > MCP Server** で確認できます。 ```bash theme={null} cortex mcp add honeydew \ https://mcp.honeydew.cloud/mcp \ --type http ``` 
      `cortex` で Cortex Code CLI を起動します。
      Honeydew への OAuth 認証を求められます。
    </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` で Cortex Code CLI を起動します。
      Honeydew への OAuth 認証を求められます。
    </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` で Cortex Code CLI を起動します。
      Honeydew への OAuth 認証を求められます。
    </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 (オプション)

Honeydew MCP サーバーにはドキュメントアクセスツールが既に含まれているため、 個別のドキュメントサーバーは不要です。 Honeydew に接続せずにドキュメントアクセスのみが必要な場合にのみ、 Honeydew Documentation MCP を追加してください。認証は不要です。

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

MCP サーバーの削除

Honeydew MCP サーバーを削除するには:

cortex mcp remove honeydew

Honeydew Documentation MCP サーバーを削除するには:

cortex mcp remove honeydew-docs

Cortex Code Desktop

#### プラグインのインストール **Git が必要です。** GitHub からプラグインをインストールすると、リポジトリがローカルにクローンされるため、 [Git](https://git-scm.com/downloads) がインストールされ、`PATH` に含まれている必要があります。 Git がない場合、プラグインのインストールは失敗します。Git をインストールするか、 プラグインの代わりにクライアントの手動 MCP セットアップ手順を使用してサーバーを直接設定してください。

Honeydew は、 セマンティックモデルの構築や自然な会話によるデータ分析のためのスキルとツールを備えた プラグインリポジトリ を提供しています。 プラグインをインストールすると、Honeydew MCP サーバーが自動的にセットアップされます。

  1. Settings -> Plugins に移動します
  2. Add Plugin をクリックし、Add from GitHub を選択して、 Honeydew プラグインリポジトリを貼り付けます: honeydew-ai/honeydew-ai-coding-agents-plugins
  3. フローに従い、GitHub Plugin Installer Setup の手順を承認します

MCP セットアップ

組織でカスタム Honeydew エンドポイントを使用している場合や、 プラグインをインストールせずに MCP サーバーを設定したい場合は、このセクションを使用してください。 プラグインによって追加された Honeydew MCP 接続を無効にし、 以下の手順に従ってカスタムエンドポイントを追加します。

Honeydew MCP サーバーは、モデル探索、データクエリ、モデル管理、 ドキュメントアクセスのために Cortex Code Desktop を Honeydew Semantic Layer に接続します。

サーバーを追加するには、MCP -> New に移動し、Configuration Scope (例: Global の場合は ~/.snowflake/cortex/mcp.json) を選択し、フォームに入力して、 Save をクリックします。Form または JSON タブを使用して設定を入力します。

組織でカスタム Honeydew ホスト名を使用している場合は、 `https://mcp.honeydew.cloud/mcp` をテナントのホスト名に置き換えてください。 ホスト名は Honeydew Studio の **Settings > MCP Server** で確認できます。

Honeydew MCP サーバーを追加します:

1. **Server Name**: `honeydew` 2. **Server Type**: **Remote (HTTP)** 3. **Server URL**: `https://mcp.honeydew.cloud/mcp` 4. **Save** をクリックします 
      初回接続時に、Honeydew への OAuth 認証を求められます。
    </Tab>

    <Tab title="API Key">
      1. **Server Name**: `honeydew`
      2. **Server Type**: **Remote (HTTP)**
      3. **Server URL**: `https://mcp.honeydew.cloud/mcp`
      4. **Headers** で **Add Header** をクリックし、名前を
         `Authorization`、値を
         `Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET>` に設定します
      5. **Save** をクリックします
    </Tab>
  </Tabs>
</Tab>

<Tab title="JSON">
  **JSON** タブに切り替えて、設定を貼り付けます:

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

      初回接続時に、Honeydew への OAuth 認証を求められます。
    </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 (オプション)

Honeydew MCP サーバーにはドキュメントアクセスツールが既に含まれているため、 個別のドキュメントサーバーは不要です。 Honeydew に接続せずにドキュメントアクセスのみが必要な場合は、 同様に Honeydew Documentation MCP サーバーを追加してください。Server Name に honeydew-docs、Server Type に Remote (HTTP)、Server URL に https://honeydew.ai/docs/mcp を使用します。認証は不要です。

MCP サーバーの削除

サーバーを削除するには、MCP に移動し、honeydew (または honeydew-docs) サーバーを見つけて削除します。

Cursor

#### プラグインのインストール

Honeydew は、 セマンティックモデルの構築や自然な会話によるデータ分析のためのスキルとツールを備えた プラグインリポジトリ を提供しています。 プラグインをインストールすると、Honeydew MCP サーバーが自動的にセットアップされます。

  1. チームまたは組織の設定で、 cursor.com/dashboard/plugins に移動します (または左側のメニューで Plugins をクリックします)
  2. Team Marketplaces までスクロールし、既存の Marketplace をクリックするか、 Add Marketplace をクリックして新規作成します。 新規作成する場合は、名前を入力して作成します。
  3. Marketplace 内で Add Plugin をクリックし、 Honeydew プラグインの GitHub リポジトリパスを貼り付けます: https://github.com/honeydew-ai/honeydew-ai-coding-agents-plugins そして Add 1 plugin をクリックします
  4. オプションで、Marketplace ページで auto-refresh を有効にすると、 新しいバージョンがリリースされたときにプラグインが自動的に更新されます。
  5. プラグインページ (cursor.com/dashboard/plugins) に戻り、 Honeydew プラグインを検索して Add をクリックします

MCP セットアップ

組織でカスタム Honeydew エンドポイントを使用している場合や、 プラグインをインストールせずに MCP サーバーを設定したい場合は、このセクションを使用してください。 プラグインによって追加された Honeydew MCP 接続を無効にし、 以下の手順に従ってカスタムエンドポイントを追加します。

Honeydew MCP サーバーは、モデル探索、データクエリ、モデル管理、 ドキュメントアクセスのために Cursor を Honeydew Semantic Layer に接続します。

組織でカスタム Honeydew ホスト名を使用している場合は、 `https://mcp.honeydew.cloud/mcp` をテナントのホスト名に置き換えてください。 ホスト名は Honeydew Studio の **Settings > MCP Server** で確認できます。

Honeydew MCP を追加するには:

  1. Cursor アプリケーションを開きます

  2. Settings -> Cursor Settings -> Tools & MCP に移動します

  3. New MCP Server をクリックします

  4. 次の設定を追加します:

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

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

  5. Save をクリックします

Honeydew Documentation MCP (オプション)

Honeydew MCP サーバーにはドキュメントアクセスツールが既に含まれているため、 個別のドキュメントサーバーは不要です。 Honeydew に接続せずにドキュメントアクセスのみが必要な場合にのみ、 Honeydew Documentation MCP を追加してください。認証は不要です。

  1. Settings -> Cursor Settings -> Tools & MCP に移動します
  2. New MCP Server をクリックします
  3. 次の設定を追加します: 
    {
  "name": "honeydew-docs",
  "type": "http",
  "url": "https://honeydew.ai/docs/mcp"
}
  4. Save をクリックします

MCP サーバーの削除

Honeydew MCP サーバーを削除するには:

  1. Settings -> Cursor Settings -> Tools & MCP に移動します
  2. リストで honeydew を見つけ、削除アイコンをクリックします

Honeydew Documentation MCP サーバーを削除するには:

  1. Settings -> Cursor Settings -> Tools & MCP に移動します
  2. リストで honeydew-docs を見つけ、削除アイコンをクリックします

Databricks Genie Code

MCP サーバーは Genie Code Agent モードでのみサポートされています。 詳細については、 [Databricks MCP ドキュメント](https://docs.databricks.com/aws/en/generative-ai/mcp/) を参照してください。

前提条件:

  • Databricks ワークスペースで Genie Code が有効になっていること

  • Unity Catalog メタストアに対する CREATE CONNECTION 権限

    1. **カタログ** → **接続** → **接続の作成** に移動します 2. **接続の基本** 画面で: * **接続名** を `honeydew-mcp` に設定します * **接続タイプ** を **HTTP** に設定します * **認証タイプ** を **動的クライアント登録** に設定します * **次へ** をクリックします 3. **認証** 画面で: * **ホスト** を `https://mcp.honeydew.cloud` に設定します * **ポート** は `443` のままにします * **OAuth スコープ** を `openid` に設定します * **次へ** をクリックします 4. **接続の詳細** 画面で: * **MCP 接続** をチェックします * **ベースパス** を `/mcp` に設定します * **接続の作成** をクリックします 
    <Tab title="SQL">
  Databricks ノートブックまたは SQL エディターで次の 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` をテナントのホスト名に置き換えてください。 ホスト名は、Honeydew Studio の **設定 > MCP サーバー** で確認できます。 **カタログ** → **接続** → `honeydew-mcp` に移動し、 右上隅にある **ログイン** をクリックして 認証し、接続を確認します。 Honeydew MCP サーバーへのアクセスが必要なユーザーまたはロールに `USE CONNECTION` 権限を付与します: 
    GRANT USE CONNECTION ON CONNECTION `honeydew-mcp` TO <user-or-role>;
    1. Genie Code を開き、歯車アイコンをクリックします 2. **MCP サーバー** → **サーバーの追加** に移動します 3. **外部 MCP サーバー** を選択します 4. 作成した `honeydew-mcp` 接続を選択します 5. プロンプトが表示されたら接続にログインします 6. **保存** をクリックします Databricks では、設定されたすべてのサーバーで MCP ツールが 20 個に制限されています。 利用可能な Honeydew ツールを調整する必要がある場合は、 Genie Code の MCP 設定を使用して特定のツールを有効または無効にします。

MCP サーバーの削除

Genie Code から Honeydew MCP サーバーを削除するには:

  1. Genie Code を開き、歯車アイコンをクリックします
  2. MCP サーバー に移動します
  3. honeydew-mcp を見つけて 削除 をクリックします

基盤となる Unity Catalog 接続も削除するには、 次の SQL を実行します:

DROP CONNECTION `honeydew-mcp`;

Devin

#### MCP サーバー

Devin は、MCP マーケットプレイス を通じてリモート MCP サーバーに接続します。

組織でカスタム Honeydew ホスト名を使用している場合は、 `https://mcp.honeydew.cloud/mcp` をテナントのホスト名に置き換えてください。 ホスト名は、Honeydew Studio の **設定 > MCP サーバー** で確認できます。

Honeydew MCP サーバーを追加するには:

  1. 設定 -> 接続 -> MCP サーバー に移動します

  2. カスタム MCP を追加 をクリックします

  3. サーバー名 フィールドに honeydew を入力します

  4. 必要に応じてアイコンと 簡単な説明 を追加します

  5. トランスポートタイプとして HTTP を選択します

  6. サーバー URL フィールドに https://mcp.honeydew.cloud/mcp を入力します

  7. 認証を設定します:

    認証方法として **OAuth** を選択します。 最初のセッション中に、Devin が Honeydew での認証を求めるプロンプトを表示します。 
    <Tab title="API Key">
  認証方法として **認証ヘッダー** を選択します。
  ヘッダーキーは `Authorization` のままにして、値を
  `Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET>` に設定します
  ([認証](#authentication) を参照)。
</Tab>

  8. 保存 をクリックし、ツール一覧のテスト をクリックして接続を確認します

Honeydew ドキュメント MCP (オプション)

Honeydew MCP サーバーにはドキュメントアクセスツールが既に含まれているため、 個別のドキュメントサーバーは必要ありません。 Honeydew に接続せずにドキュメントアクセスのみが必要な場合にのみ、 Honeydew ドキュメント MCP を追加してください。認証は不要です。

  1. 設定 -> 接続 -> MCP サーバー に移動します
  2. カスタム MCP を追加 をクリックします
  3. サーバー名 フィールドに honeydew-docs を入力します
  4. トランスポートタイプとして HTTP を選択します
  5. サーバー URL フィールドに https://honeydew.ai/docs/mcp を入力します
  6. 認証方法を なし に設定します
  7. 保存 をクリックします

MCP サーバーの削除

Honeydew MCP サーバーを削除するには:

  1. 設定 -> 接続 -> MCP サーバー に移動します
  2. honeydew サーバーを見つけて削除します

Honeydew ドキュメント MCP サーバーを削除するには:

  1. 設定 -> 接続 -> MCP サーバー に移動します
  2. honeydew-docs サーバーを見つけて削除します

GitHub Copilot CLI

#### MCP サーバー 組織でカスタム Honeydew ホスト名を使用している場合は、 `https://mcp.honeydew.cloud/mcp` をテナントのホスト名に置き換えてください。 ホスト名は、Honeydew Studio の **設定 > MCP サーバー** で確認できます。

  1. copilot で GitHub Copilot CLI を起動します

  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](https://git-scm.com/downloads) がインストールされ、`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 (オプション)

Honeydew MCP サーバーにはドキュメントアクセスツールが既に含まれているため、 個別のドキュメントサーバーは必要ありません。 Honeydew に接続せずにドキュメントアクセスのみが必要な場合にのみ、 Honeydew ドキュメント MCP を追加してください。認証は不要です。

  1. copilot で GitHub Copilot CLI を起動します
  2. /mcp add と入力してサーバー設定フォームを開きます
  3. 次のフィールドに入力します:
    • 名前: honeydew-docs
    • タイプ: http
    • URL: https://honeydew.ai/docs/mcp
  4. Ctrl+S を押して保存します

MCP サーバーの削除

Honeydew MCP サーバーを削除するには、 copilot で GitHub Copilot CLI を起動し、次のように入力します:

/mcp remove honeydew

Honeydew ドキュメント 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 Semantic Layer に接続します。

組織でカスタム Honeydew ホスト名を使用している場合は、 `https://mcp.honeydew.cloud/mcp` をテナントのホスト名に置き換えてください。 ホスト名は、Honeydew Studio の **設定 > MCP サーバー** で確認できます。

次のコマンドを実行して Honeydew MCP サーバーを追加します:

```bash theme={null} gemini mcp add --transport http honeydew \ https://mcp.honeydew.cloud/mcp ``` 
  `gemini` で Gemini CLI を起動します。
  Honeydew への OAuth 認証を求めるプロンプトが表示されます。
</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 (オプション)

Honeydew MCP サーバーにはドキュメントアクセスツールが既に含まれているため、 個別のドキュメントサーバーは必要ありません。 Honeydew に接続せずにドキュメントアクセスのみが必要な場合にのみ、 Honeydew ドキュメント MCP を追加してください。認証は不要です。

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

MCP サーバーの削除

Honeydew MCP サーバーを削除するには:

gemini mcp remove honeydew

Honeydew ドキュメント MCP サーバーを削除するには:

gemini mcp remove honeydew-docs

VS Code と GitHub Copilot

#### プラグインのインストール

Honeydew は、セマンティックモデルの構築と自然な会話によるデータ分析のための スキルとツールを備えた プラグインリポジトリ を提供しています。 プラグインをインストールすると、Honeydew MCP サーバーが自動的にセットアップされます。

Honeydew マーケットプレイスを追加する

  1. VS Code の settings.json を開きます (macOS では CMD+Shift+P、Windows/Linux では Ctrl+Shift+P でコマンドパレットを開き、 基本設定: ユーザー設定を開く (JSON) を選択します)
  2. chat.plugins.marketplaces 設定に Honeydew マーケットプレイスを追加します: 
    "chat.plugins.marketplaces": [
  "honeydew-ai/honeydew-ai-coding-agents-plugins"
]

プラグインをインストールする

  1. 拡張機能ビューを開きます (macOS では CMD+Shift+X、Windows/Linux では Ctrl+Shift+X)
  2. 検索フィールドに @agentPlugins を入力します
  3. Honeydew AI プラグインを見つけて インストール をクリックします

新しいマーケットプレイスからプラグインを初めてインストールする場合、 VS Code は信頼プロンプトを表示します — 確認する前にマーケットプレイスのソースを確認してください。

プラグインを更新する

VS Code の設定で extensions.autoUpdate が有効になっている場合、 プラグインは自動的に更新されます。 手動で更新するには、コマンドパレットを開き、 拡張機能: 拡張機能の更新を確認する を実行します。

MCP サーバー

組織でカスタム Honeydew エンドポイントを使用している場合、 またはプラグインをインストールせずに MCP サーバーを設定する場合は、このセクションを使用してください。 プラグインによって追加された Honeydew MCP 接続を無効にしてから、 以下の手順を使用してカスタムエンドポイントを追加します。

Honeydew MCP サーバーは、モデル探索、データクエリ、モデル管理、 ドキュメントアクセスのために VS Code を Honeydew Semantic Layer に接続します。

組織でカスタム Honeydew ホスト名を使用している場合は、 `https://mcp.honeydew.cloud/mcp` をテナントのホスト名に置き換えてください。 ホスト名は、Honeydew Studio の **設定 > MCP サーバー** で確認できます。 1. コマンドパレットを開きます: `CMD+Shift+P` (macOS) または `Ctrl+Shift+P` (Windows/Linux) 2. **MCP: サーバーを追加...** を選択します 3. **HTTP (HTTP または Server-Sent Events)** を選択します 4. Honeydew MCP サーバーの URL を入力します: `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 ドキュメント MCP (オプション)

Honeydew MCP サーバーにはドキュメントアクセスツールが既に含まれているため、 別途ドキュメントサーバーは必要ありません。 Honeydew に接続せずにドキュメントアクセスのみが必要な場合にのみ、 Honeydew ドキュメント MCP を追加してください。認証は不要です。

.vscode/mcp.json に以下を追加します:

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

MCP サーバーの削除

Honeydew MCP サーバーを削除するには、 .vscode/mcp.json を開き、servers オブジェクトから honeydew エントリを削除します。 Honeydew ドキュメント 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 Semantic Layer に接続します。

組織でカスタム Honeydew ホスト名を使用している場合は、 `https://mcp.honeydew.cloud/mcp` をテナントのホスト名に置き換えてください。 ホスト名は、Honeydew Studio の **Settings > MCP Server** で確認できます。

コマンドライン

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

次に、codex で Codex を起動します。 Honeydew への OAuth 認証を求められます。

サーバーを追加した後、 ~/.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 ドキュメント MCP (オプション)

Honeydew MCP サーバーにはドキュメントアクセスツールが既に含まれているため、 別途ドキュメントサーバーは必要ありません。 Honeydew に接続せずにドキュメントアクセスのみが必要な場合にのみ、 Honeydew ドキュメント MCP を追加してください。認証は不要です。

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

MCP サーバーの削除

Honeydew MCP サーバーを削除するには:

codex mcp remove honeydew

Honeydew ドキュメント MCP サーバーを削除するには:

codex mcp remove honeydew-docs

Codex

#### プラグインのインストール **Git が必要です。** GitHub からプラグインをインストールすると、リポジトリがローカルにクローンされるため、 [Git](https://git-scm.com/downloads) がインストールされ、`PATH` に含まれている必要があります。 Git がない場合、プラグインのインストールは失敗します。Git をインストールするか、 クライアントの手動 MCP セットアップ手順を使用して、プラグインの代わりにサーバーを直接設定してください。

Honeydew は、 セマンティックモデルの構築や自然な会話によるデータ分析のためのスキルとツールを備えた プラグインリポジトリ を提供しています。 プラグインをインストールすると、Honeydew MCP サーバーが自動的にセットアップされます。

Codex でマーケットプレイスを追加します:

  1. プラグイン を開きます
  2. ドロップダウン矢印をクリックし、マーケットプレイスを追加 を選択します
  3. honeydew-ai/honeydew-ai-coding-agents-plugins を追加します
[Codex CLI](#codex-cli) からマーケットプレイスを追加することもできます: 
```
codex plugin marketplace add honeydew-ai/honeydew-ai-coding-agents-plugins
```

次にプラグインをインストールします:

  1. プラグイン を開きます
  2. Honeydew AI マーケットプレイスを選択します
  3. Honeydew プラグインをインストールします

MCP セットアップ

組織でカスタム Honeydew エンドポイントを使用している場合、 またはプラグインをインストールせずに MCP サーバーを設定する場合は、このセクションを使用してください。 プラグインによって追加された Honeydew MCP 接続を無効にしてから、 以下の手順を使用してカスタムエンドポイントを追加します。

組織でカスタム Honeydew ホスト名を使用している場合は、 `https://mcp.honeydew.cloud/mcp` をテナントのホスト名に置き換えてください。 ホスト名は、Honeydew Studio の **Settings > MCP Server** で確認できます。

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

    上記のヘッダーリストに、値 Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET> を持つ Authorization ヘッダーを追加します (認証 を参照)。

MCP 認証のトラブルシューティング

Codex で Honeydew MCP サーバーが認証されておらず、 "Authenticate" オプションが表示されない場合:

  1. Codex CLI をインストールします
  2. codex mcp login honeydew を実行します

Honeydew ドキュメント MCP (オプション)

Honeydew MCP サーバーにはドキュメントアクセスツールが既に含まれているため、 別途ドキュメントサーバーは必要ありません。 Honeydew に接続せずにドキュメントアクセスのみが必要な場合にのみ、 Honeydew ドキュメント MCP を追加してください。認証は不要です。

  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. Custom servers の下で honeydew を見つけ、Remove をクリックします

Honeydew ドキュメント MCP サーバーを削除するには:

  1. Settings -> MCP Servers に移動します
  2. Custom servers の下で honeydew-docs を見つけ、Remove をクリックします

Antigravity

#### MCP サーバー 組織でカスタム Honeydew ホスト名を使用している場合は、 `https://mcp.honeydew.cloud/mcp` をテナントのホスト名に置き換えてください。 ホスト名は、Honeydew Studio の **Settings > MCP Server** で確認できます。

  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 ドキュメント MCP (オプション)

Honeydew MCP サーバーにはドキュメントアクセスツールが既に含まれているため、 別途ドキュメントサーバーは必要ありません。 Honeydew に接続せずにドキュメントアクセスのみが必要な場合にのみ、 Honeydew ドキュメント MCP を追加してください。認証は不要です。

  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. mcp_config.json から honeydew と honeydew-docs のエントリを削除します
  6. ファイルを保存します

OpenCode

#### MCP サーバー 組織でカスタム Honeydew ホスト名を使用している場合は、 `https://mcp.honeydew.cloud/mcp` をテナントのホスト名に置き換えてください。 ホスト名は、Honeydew Studio の **Settings > MCP Server** で確認できます。 次のコマンドを実行し、 対話形式のプロンプトに従います: 
  ```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 ドキュメント MCP (オプション)

Honeydew MCP サーバーにはドキュメントアクセスツールが既に含まれているため、 別途ドキュメントサーバーは必要ありません。 Honeydew に接続せずにドキュメントアクセスのみが必要な場合にのみ、 Honeydew ドキュメント MCP を追加してください。認証は不要です。

`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 サーバーを削除するには、 opencode.jsonc ファイルから honeydew エントリを削除します。 Honeydew ドキュメント MCP サーバーを削除するには、 同じファイルから honeydew-docs エントリを削除します。

Kiro

Kiro IDE と Kiro CLI は同じ MCP 設定ファイルを共有するため、 以下の手順は両方に適用されます。

MCP サーバー

Kiro は 2 つの設定ファイルから MCP サーバーを読み取ります:

  • ワークスペース: .kiro/settings/mcp.json (現在のプロジェクトに固有)
  • ユーザー: ~/.kiro/settings/mcp.json (すべてのワークスペースに適用)

両方のファイルが存在する場合は、ワークスペース設定が優先されます。 組織でカスタムのHoneydewホスト名を使用している場合は、 https://mcp.honeydew.cloud/mcp をテナントのホスト名に置き換えてください。 ホスト名はHoneydew Studioの Settings > MCP Server で確認できます。

以下のいずれかの mcp.json ファイル（ワークスペースまたはユーザー）にHoneydew MCPサーバーを追加します。

```json theme={null} { "mcpServers": { "honeydew": { "url": "https://mcp.honeydew.cloud/mcp" } } } ``` 
  Honeydewへの初回接続時に、Kiroが認証URLを提供します。
  ブラウザでその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（オプション）

Honeydew MCPサーバーには既にドキュメントアクセスツールが含まれているため、 個別のドキュメントサーバーは必要ありません。 Honeydewに接続せずにドキュメントアクセスのみが必要な場合にのみ、 Honeydew Documentation MCPを追加してください。認証は不要です。

以下を mcp.json に追加してください。

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

MCPサーバーの削除

Honeydew MCPサーバーを削除するには、 mcp.json から honeydew エントリを削除します。 Honeydew Documentation MCPサーバーを削除するには、 同じファイルから honeydew-docs エントリを削除します。

Snowflake Intelligence

Snowflakeは [MCPコネクタ](https://docs.snowflake.com/en/user-guide/snowflake-cortex/cortex-agents-mcp-connectors) を通じて外部MCPサーバーに接続し、 HoneydewのツールをSnowflake IntelligenceやCortex Agentで利用できるようにします。

前提条件:

  • アカウントに対する CREATE INTEGRATION 権限を持つロール
  • ターゲットスキーマに対する CREATE MCP SERVER 権限を持つロール

デフォルトでは、ACCOUNTADMIN ロールのみがこれらの権限を持ちます。

組織でカスタムのHoneydewホスト名を使用している場合は、 `https://mcp.honeydew.cloud/mcp` をテナントのホスト名に置き換えてください。 ホスト名はHoneydew Studioの **Settings > MCP Server** で確認できます。 ```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">
  Honeydewへのアクセスが必要なすべてのロールに対して、
  統合とMCPサーバーの両方に対する使用権限を付与します。

  ```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">
  `honeydew` MCPサーバーをツールとしてCortex Agent
  またはSnowflake Intelligenceエージェントに追加します。
  ユーザーは初回使用時にOAuthでHoneydewに対する認証を求められます。
</Step>
Snowflakeの外部MCPサーバーはOAuth認証を必要とし、 ドキュメントサーバーは認証不要であるため、 スタンドアロンのHoneydew Documentation MCPサーバーはSnowflakeではサポートされていません。 ドキュメントアクセスは、Honeydew MCPサーバーのドキュメントツールを通じて利用できます。

MCPサーバーの削除

最初にMCPサーバーを削除し、次にAPI統合を削除します。

DROP MCP SERVER honeydew;
DROP INTEGRATION honeydew_mcp_integration;

その他のクライアント

標準のHTTPトランスポートを使用して、 MCP互換の任意のクライアントがHoneydew MCPサーバーに接続できます。

出発点として、次のJSON設定を使用してください。

組織でカスタムのHoneydewホスト名を使用している場合は、 `https://mcp.honeydew.cloud/mcp` をテナントのホスト名に置き換えてください。 ホスト名はHoneydew Studioの **Settings > MCP Server** で確認できます。 ```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を選択し、 「認証をクリア」または「認証」を選択し、 ブラウザのOAuthプロンプトに従ってHoneydewに再接続します。

接続の問題

MCPサーバーのURLが https://mcp.honeydew.cloud/mcp と一致することを確認し、 クライアントのMCP設定構文が正しいことを確認してください。 組織でカスタムホスト名を使用している場合は、URLがHoneydew Studioの Settings > MCP Server に表示されるテナントホスト名と一致することを確認してください。

ツールが見つからない

認証が成功したことを確認し、Honeydewワークスペースのアクセス権限を確認し、 クライアントのコンソールでエラーメッセージを確認してください。

出力が最大許容トークン数を超える (Claude)

Claude Code、Claude Desktop、Claude.aiでは、ツール呼び出しが出力の最大許容トークン数を超えたというエラーで失敗することがあります。 monitor_analysis や get_analysis_step_details などのHoneydew分析ツールは、 ClaudeのMCP出力制限を超える大きな結果を返す可能性があります。

Claudeは、MCPツールの出力が10,000トークンを超えると警告し、デフォルトの制限である25,000トークンを超える出力を拒否します。 制限を引き上げるには、Claudeを起動する前に MAX_MCP_OUTPUT_TOKENS 環境変数を設定します。

export MAX_MCP_OUTPUT_TOKENS=50000
claude

詳細については、Claudeドキュメントの MCP output limits and warnings を参照してください。

その他のサポートについては、support@honeydew.ai までHoneydewサポートにお問い合わせください。

利用可能なツール

読み取り専用 とマークされたツールは、 セマンティックモデルやデータウェアハウスを変更しません。

読み取り専用ツールのみを公開するには、MCPサーバー設定で `ReadonlyToolsOnly: true` ヘッダーを設定します。 有効にすると、サーバーはセマンティックモデルやデータウェアハウスを変更しないツールのみを返します。

セッションとワークスペース

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

現在のセッションの作業ブランチのプルリクエストを作成します。 成功するとPR URLを返します。

プルリクエストのタイトル。 プルリクエストの説明。

質問と分析

initiate_analysis

読み取り専用

データ分析を開始または続行します。conversation_id を返します。 monitor_analysis を使用して進行状況と結果をポーリングし、 abort_analysis を使用して早期に停止します。 詳細については、Deep Analysis を参照してください。

尋ねる自然言語の質問。 新しい会話のエージェント名。 フォローアップの質問の場合は省略します。エージェントは既存の会話から継承されます。 続行する既存の会話ID、または新しい会話を開始する場合は省略します。

monitor_analysis

読み取り専用

進行中の分析から新しい進捗メッセージをポーリングします。 各呼び出しは、前回の呼び出し以降のメッセージのみを返します。 status が DONE または NO_CHAT_CURRENTLY_RUNNING になるまで繰り返しポーリングします。

`initiate_analysis` によって返された会話ID。 呼び出しごとに返すメッセージの最大数。 リプレイを開始するメッセージID。見逃したメッセージを回復するには、前回の結果の `last_received_message_id` を使用します。

get_analysis_step_details

読み取り専用

特定の分析ステップの完全な詳細（セマンティッククエリ、SQLステートメント、使用されたコンテキスト、 そのステップで取得されたデータを含む）を取得します。

`initiate_analysis` によって返された会話ID。 `monitor_analysis` からのステップID（例：`STEP/0`）。

abort_analysis

読み取り専用

進行中の分析を中止します。 initiate_analysis を使用して、中止されたポイントから再開できます。

`initiate_analysis` によって返された会話ID。

list_analysis_chats

読み取り専用

現在のワークスペースの分析会話のページ分割されたリストを、作成時刻でソートして返します（新しい順）。 管理者はすべての会話を表示し、管理者以外は自分の会話のみを表示します。 各エントリには、会話ID、タイトル、ユーザーフィードバック、ドメイン、エージェント、 作成時刻、およびそれを作成したユーザーの表示名が含まれます。

返す会話の最大数。 ページネーションのためにスキップする会話の数。

provide_analysis_feedback

特定の分析会話に対するフィードバックを設定またはクリアします。 会話ごとに1つのフィードバックエントリがあります（質問ごとではありません）。 会話フロー全体の全体的な品質を反映する必要があります。

monitor_analysis が完了し、ユーザーが結果に対する満足または不満足を表明した後に、これを呼び出します。 肯定的なフィードバックには短い肯定的な文字列（例：Good）を使用し、 否定的なフィードバックには <Reason>: <details> の形式を使用します。 ここで Reason は Chart Issue、Data Issue、Wrong Judgement、または Other のいずれかです。

分析会話の会話ID。 保存するフィードバックテキスト、または既存のフィードバックをクリアする場合は `null`。

get_stored_conversation

読み取り専用 既存の分析会話からすべてのメッセージを返します。 以前の会話の全内容を確認するために使用します。 レスポンス内の is_complete は、会話が 終了状態に達したかどうかを示します。

`list_analysis_chats` からの会話ID。 `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 は customers に一致するエンティティ上の balance フィールドを検索し、 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>
  UIに表示される人間が読める名前。
</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>
frontmatterの後に追加されるMarkdown本文。 このテキストは、すべての分析セッションの前にプロンプトに挿入されます。 バリデーションでエラーが発生してもエージェントを作成します。

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">
  AIがこのアイテムをロードするタイミングを決定するために使用する説明
  （`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">
  AIがこのアイテムをロードするタイミングを決定するために使用する説明
  （`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）、 コンパイルとウェアハウス実行のタイムスタンプ、データウェアハウス クエリID、およびHoneydewアプリで開くためのリンクが含まれます。

クエリステータスでフィルタリング（`FAILED`、`SUCCESS`、`RUNNING`、または`CANCELED`）。 クエリを実行したクライアントでフィルタリング（例：`Snowflake`、`MCP`）。 ドメイン名でフィルタリング。 クエリ所有者でフィルタリング（ユーザーのメールアドレス、または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`）。