Honeydew Semantic Layer

공식

Honeydew 시맨틱 레이어는 소스 전반에 걸쳐 메트릭, 차원 및 관계를 통합하는 관리되고 비즈니스 친화적인 데이터 모델을 제공하여 일관된 셀프 서비스 분석과 AI 기반 데이터 액세스를 가능하게 합니다.

honeydew.ai에서 보기이 MCP 사용해 보기스폰서

Honeydew Semantic Layer MCP(으)로 무엇을 할 수 있나요?

  • 웨어하우스 메타데이터 탐색 — 어시스턴트에게 웨어하우스 전반의 테이블, 스키마, 시맨틱 모델 정의를 발견하도록 요청하세요.
  • 시맨틱 모델 관리 — 자연어 대화를 통해 시맨틱 모델을 구축하고 유지 관리하며, create_workspace_branch로 워크스페이스 브랜치를 생성하는 것도 포함됩니다.
  • 대화형 데이터 쿼리 — MCP 호환 어시스턴트에서 자연어를 사용하여 데이터를 쿼리하세요.
  • 세션 컨텍스트 구성 — list_workspaces 및 list_workspace_branches로 사용 가능한 옵션을 확인한 후, set_session_workspace_and_branch로 활성 워크스페이스와 브랜치를 설정하세요.
  • Honeydew 문서 접근 — MCP 서버에 내장된 문서 도구를 통해 Honeydew 문서를 직접 검색하고 읽을 수 있습니다.

문서

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의 설정 > MCP 서버에서 확인할 수 있습니다.

인증

Honeydew MCP 서버에 인증하는 방법은 두 가지입니다: OAuth 또는 HTTP 기본 인증.

OAuth 인증 (권장)

대부분의 클라이언트는 OAuth 인증을 지원합니다. 처음 연결할 때 다음 단계를 수행하라는 메시지가 표시됩니다:

  1. Honeydew 계정으로 로그인
  2. OAuth 권한 부여 수락

그러면 클라이언트는 이후 요청에 대한 액세스 토큰을 안전하게 제공합니다.

HTTP 기본 인증

HTTP 기본 인증 모드의 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 세션 관리 사양을 참조하세요.

지원되는 클라이언트

Claude Code CLI

#### 플러그인 설치

참고

Git 필요. GitHub에서 플러그인을 설치하면 저장소를 로컬에 복제하므로 Git이 설치되어 있고 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를 입력하고 상단의 선택기에서 마켓플레이스를 선택하세요
  2. honeydew-ai-coding-agents-plugins를 선택하세요
  3. 마켓플레이스 업데이트를 클릭하세요

자동 업데이트를 받으려면 마켓플레이스 설정에서 자동 업데이트 활성화를 선택하세요.

MCP 설정

조직에서 사용자 지정 Honeydew 엔드포인트를 사용하거나, 플러그인을 설치하지 않고 MCP 서버를 구성하려는 경우 이 섹션을 사용하세요. 플러그인에서 추가한 Honeydew MCP 연결을 비활성화한 다음, 아래 지침에 따라 사용자 지정 엔드포인트를 추가하세요.

Honeydew MCP 서버는 모델 탐색, 데이터 쿼리, 모델 관리 및 문서 액세스를 위해 Claude Code를 Honeydew Semantic Layer에 연결합니다.

다음 방법 중 하나를 사용하여 Honeydew MCP 서버를 추가하세요:

참고

조직에서 사용자 지정 Honeydew 호스트 이름을 사용하는 경우, https://mcp.honeydew.cloud/mcp를 테넌트 호스트 이름으로 바꾸세요. 호스트 이름은 Honeydew Studio의 설정 > MCP 서버에서 확인할 수 있습니다.

```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} 구문을 사용한 환경 변수 확장을 지원합니다.

HONEYDEW_API_KEY 환경 변수를 설정한 다음 구성에서 참조하세요:

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이 설치되어 있고 PATH에 있어야 합니다. Git이 없으면 플러그인 설치가 실패합니다. Git을 설치하거나, 플러그인 대신 클라이언트의 수동 MCP 설정 단계를 사용하여 서버를 직접 구성하세요.

Honeydew는 시맨틱 모델 구축 및 자연어 대화를 통한 데이터 분석을 위한 스킬과 도구가 포함된 플러그인 저장소를 제공합니다. 플러그인을 설치하면 Honeydew MCP 서버가 자동으로 설정됩니다.

  1. 설정 -> 사용자 지정으로 이동
  2. 플러그인 찾아보기 클릭
  3. 개인 탭으로 이동
  4. + 아이콘을 클릭하고 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의 설정 > MCP 서버에서 확인할 수 있습니다.

Cowork 모드에서 Honeydew MCP를 추가하려면:

  1. 설정 -> 커넥터 -> 사용자 지정 커넥터 추가로 이동
  2. 이름 필드에 honeydew를 입력
  3. 원격 MCP 서버 URL 필드에 https://mcp.honeydew.cloud/mcp를 입력
  4. 추가 클릭

처음 연결할 때 Honeydew에 OAuth로 인증하라는 메시지가 표시됩니다.

Honeydew 문서 MCP (선택 사항)

Honeydew MCP 서버에는 이미 문서 액세스 도구가 포함되어 있으므로 별도의 문서 서버가 필요하지 않습니다. Honeydew에 연결하지 않고 문서 액세스만 원하는 경우에만 Honeydew 문서 MCP를 추가하세요. 인증은 필요하지 않습니다.

  1. 설정 -> 커넥터 -> 사용자 지정 커넥터 추가로 이동
  2. 이름 필드에 honeydew-docs를 입력
  3. 원격 MCP 서버 URL 필드에 https://honeydew.ai/docs/mcp를 입력
  4. 추가 클릭

MCP 서버 제거

Cowork 모드에서 Honeydew MCP 서버를 제거하려면:

  1. 설정 -> 커넥터로 이동
  2. honeydew 커넥터를 찾아 삭제 아이콘을 클릭

Honeydew 문서 MCP 서버를 제거하려면:

  1. 설정 -> 커넥터로 이동
  2. honeydew-docs 커넥터를 찾아 삭제 아이콘을 클릭

Claude.ai

#### 플러그인 설치

Honeydew는 시맨틱 모델 구축 및 자연어 대화를 통한 데이터 분석을 위한 스킬과 도구가 포함된 플러그인 저장소를 제공합니다. 플러그인을 설치하면 Honeydew MCP 서버와 Honeydew 문서 MCP 서버가 모두 자동으로 설정됩니다.

  1. 플러그인 zip 다운로드: honeydew-ai-claude.zip
  2. Claude.ai에서 설정 -> 플러그인 -> 플러그인 추가 -> zip 업로드로 이동
  3. zip을 업로드하면 플러그인이 개인 마켓플레이스에 나타납니다

MCP 설정

조직에서 사용자 지정 Honeydew 엔드포인트를 사용하거나, 플러그인을 설치하지 않고 MCP 서버를 구성하려는 경우 이 섹션을 사용하세요. 플러그인에서 추가한 Honeydew MCP 커넥터를 제거한 다음, 아래 지침에 따라 사용자 지정 엔드포인트를 추가하세요.

Honeydew MCP 서버는 모델 탐색, 데이터 쿼리, 모델 관리 및 문서 액세스를 위해 Claude.ai를 Honeydew Semantic Layer에 연결합니다.

참고

조직에서 사용자 지정 Honeydew 호스트 이름을 사용하는 경우, https://mcp.honeydew.cloud/mcp를 테넌트 호스트 이름으로 바꾸세요. 호스트 이름은 Honeydew Studio의 설정 > MCP 서버에서 확인할 수 있습니다.

Honeydew MCP 서버를 추가하려면:

  1. 설정 -> 커넥터 -> 사용자 지정 커넥터 추가로 이동합니다.
  2. 이름 필드에 honeydew을 입력합니다.
  3. 원격 MCP 서버 URL 필드에 https://mcp.honeydew.cloud/mcp을 입력합니다.
  4. 추가를 클릭합니다.

처음 연결할 때 Honeydew에 OAuth로 인증하라는 메시지가 표시됩니다.

Honeydew 문서 MCP (선택 사항)

Honeydew MCP 서버에는 이미 문서 접근 도구가 포함되어 있으므로 별도의 문서 서버가 필요하지 않습니다. Honeydew에 연결하지 않고 문서 접근만 원하는 경우에만 Honeydew 문서 MCP를 추가하세요. 인증은 필요하지 않습니다.

  1. 설정 -> 커넥터 -> 사용자 지정 커넥터 추가로 이동합니다.
  2. 이름 필드에 honeydew-docs을 입력합니다.
  3. 원격 MCP 서버 URL 필드에 https://honeydew.ai/docs/mcp을 입력합니다.
  4. 추가를 클릭합니다.

MCP 서버 제거

Honeydew MCP 서버를 제거하려면:

  1. 설정 -> 커넥터로 이동합니다.
  2. honeydew 커넥터를 찾아 삭제 아이콘을 클릭합니다.

Honeydew 문서 MCP 서버를 제거하려면:

  1. 설정 -> 커넥터로 이동합니다.
  2. honeydew-docs 커넥터를 찾아 삭제 아이콘을 클릭합니다.

Cortex Code CLI

#### 플러그인 설치

참고

Git이 필요합니다. GitHub에서 플러그인을 설치하면 저장소를 로컬에 복제하므로 Git이 설치되어 있고 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 의미 계층에 연결합니다.

참고

조직에서 사용자 지정 Honeydew 호스트 이름을 사용하는 경우 https://mcp.honeydew.cloud/mcp을 테넌트 호스트 이름으로 바꾸세요. 호스트 이름은 Honeydew Studio의 설정 > MCP 서버에서 찾을 수 있습니다.

```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 문서 MCP (선택 사항)

Honeydew MCP 서버에는 이미 문서 접근 도구가 포함되어 있으므로 별도의 문서 서버가 필요하지 않습니다. Honeydew에 연결하지 않고 문서 접근만 원하는 경우에만 Honeydew 문서 MCP를 추가하세요. 인증은 필요하지 않습니다.

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

MCP 서버 제거

Honeydew MCP 서버를 제거하려면:

cortex mcp remove honeydew

Honeydew 문서 MCP 서버를 제거하려면:

cortex mcp remove honeydew-docs

Cortex Code Desktop

#### 플러그인 설치

참고

Git이 필요합니다. GitHub에서 플러그인을 설치하면 저장소를 로컬에 복제하므로 Git이 설치되어 있고 PATH에 있어야 합니다. Git이 없으면 플러그인 설치가 실패합니다. Git을 설치하거나 클라이언트의 수동 MCP 설정 단계를 사용하여 플러그인 대신 서버를 직접 구성하세요.

Honeydew는 의미 모델 구축 및 자연어 대화를 통한 데이터 분석을 위한 스킬과 도구가 포함된 플러그인 저장소를 제공합니다. 플러그인을 설치하면 Honeydew MCP 서버가 자동으로 설정됩니다.

  1. 설정 -> 플러그인으로 이동합니다.
  2. 플러그인 추가를 클릭하고 GitHub에서 추가를 선택한 후 Honeydew 플러그인 저장소를 붙여넣습니다: honeydew-ai/honeydew-ai-coding-agents-plugins
  3. 흐름을 따라 GitHub 플러그인 설치 프로그램 설정에서 단계를 승인합니다.

MCP 설정

조직에서 사용자 지정 Honeydew 엔드포인트를 사용하거나 플러그인을 설치하지 않고 MCP 서버를 구성하려는 경우 이 섹션을 사용하세요. 플러그인이 추가한 Honeydew MCP 연결을 비활성화한 후 아래 지침에 따라 사용자 지정 엔드포인트를 추가하세요.

Honeydew MCP 서버는 모델 탐색, 데이터 쿼리, 모델 관리, 문서 접근을 위해 Cortex Code Desktop을 Honeydew 의미 계층에 연결합니다.

서버를 추가하려면 MCP -> 새로 만들기로 이동하고 구성 범위를 선택한 후 (예: 전역의 경우 ~/.snowflake/cortex/mcp.json), 양식을 작성하고 저장을 클릭합니다. 양식 또는 JSON 탭을 사용하여 구성을 입력합니다.

참고

조직에서 사용자 지정 Honeydew 호스트 이름을 사용하는 경우 https://mcp.honeydew.cloud/mcp을 테넌트 호스트 이름으로 바꾸세요. 호스트 이름은 Honeydew Studio의 설정 > MCP 서버에서 찾을 수 있습니다.

Honeydew MCP 서버를 추가합니다:

1. **서버 이름**: `honeydew` 2. **서버 유형**: **원격(HTTP)** 3. **서버 URL**: `https://mcp.honeydew.cloud/mcp` 4. **저장**을 클릭합니다. 
      처음 연결할 때 Honeydew에 OAuth로 인증하라는 메시지가 표시됩니다.
    </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"
        }
      }
      ```

      처음 연결할 때 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 문서 MCP (선택 사항)

Honeydew MCP 서버에는 이미 문서 접근 도구가 포함되어 있으므로 별도의 문서 서버가 필요하지 않습니다. Honeydew에 연결하지 않고 문서 접근만 원하는 경우 서버 이름 honeydew-docs, 서버 유형 원격(HTTP), 서버 URL https://honeydew.ai/docs/mcp을 사용하여 동일한 방식으로 Honeydew 문서 MCP 서버를 추가하세요. 인증은 필요하지 않습니다.

MCP 서버 제거

서버를 제거하려면 MCP로 이동하여 honeydew (또는 honeydew-docs) 서버를 찾아 제거합니다.

Cursor

#### 플러그인 설치

Honeydew는 의미 모델 구축 및 자연어 대화를 통한 데이터 분석을 위한 스킬과 도구가 포함된 플러그인 저장소를 제공합니다. 플러그인을 설치하면 Honeydew MCP 서버가 자동으로 설정됩니다.

  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 서버를 구성하려는 경우 이 섹션을 사용하세요. 플러그인이 추가한 Honeydew MCP 연결을 비활성화한 후 아래 지침에 따라 사용자 지정 엔드포인트를 추가하세요.

Honeydew MCP 서버는 모델 탐색, 데이터 쿼리, 모델 관리, 문서 접근을 위해 Cursor를 Honeydew 의미 계층에 연결합니다.

참고

조직에서 사용자 지정 Honeydew 호스트 이름을 사용하는 경우 https://mcp.honeydew.cloud/mcp을 테넌트 호스트 이름으로 바꾸세요. 호스트 이름은 Honeydew Studio의 설정 > MCP 서버에서 찾을 수 있습니다.

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 문서 MCP (선택 사항)

Honeydew MCP 서버에는 이미 문서 접근 도구가 포함되어 있으므로 별도의 문서 서버가 필요하지 않습니다. Honeydew에 연결하지 않고 문서 접근만 원하는 경우에만 Honeydew 문서 MCP를 추가하세요. 인증은 필요하지 않습니다.

  1. 설정 -> Cursor 설정 -> 도구 및 MCP로 이동합니다.
  2. 새 MCP 서버를 클릭합니다.
  3. 다음 구성을 추가합니다: 
    {
  "name": "honeydew-docs",
  "type": "http",
  "url": "https://honeydew.ai/docs/mcp"
}
  4. 저장을 클릭합니다.

MCP 서버 제거

Honeydew MCP 서버를 제거하려면:

  1. 설정 -> Cursor 설정 -> 도구 및 MCP로 이동합니다.
  2. 목록에서 honeydew을 찾아 삭제 아이콘을 클릭합니다.

Honeydew 문서 MCP 서버를 제거하려면:

  1. 설정 -> Cursor 설정 -> 도구 및 MCP로 이동합니다.
  2. 목록에서 honeydew-docs을 찾아 삭제 아이콘을 클릭합니다.

Databricks Genie Code

> **참고** > > MCP 서버는 Genie Code 에이전트 모드에서만 지원됩니다. > 자세한 내용은 > [Databricks MCP 문서](https://docs.databricks.com/aws/en/generative-ai/mcp/)를 참조하세요.

전제 조건:

  • Databricks 작업 영역에서 Genie Code 활성화
  • Unity Catalog metastore에 대한 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>
  </Tabs>

참고

조직에서 사용자 지정 Honeydew 호스트 이름을 사용하는 경우 https://mcp.honeydew.cloud을(를) 테넌트 호스트 이름으로 바꾸세요. 호스트 이름은 Honeydew Studio의 설정 > MCP 서버에서 확인할 수 있습니다. 

<Step title="Log in to the connection">
  **카탈로그** → **연결** → `honeydew-mcp`(으)로 이동한 다음
  오른쪽 상단의 **로그인**을 클릭하여
  인증하고 연결을 확인합니다.
</Step>

<Step title="Grant connection access">
  Honeydew MCP 서버에 액세스해야 하는 모든 사용자 또는 역할에
  `USE CONNECTION` 권한을 부여합니다.

  ```sql theme={null}
  GRANT USE CONNECTION ON CONNECTION `honeydew-mcp` TO <user-or-role>;
  ```
</Step>

<Step title="Add the MCP server in Genie Code">
  1. Genie Code를 열고 톱니바퀴 아이콘을 클릭합니다.
  2. **MCP 서버** → **서버 추가**로 이동합니다.
  3. **외부 MCP 서버**를 선택합니다.
  4. 생성한 `honeydew-mcp` 연결을 선택합니다.
  5. 메시지가 표시되면 연결에 로그인합니다.
  6. **저장**을 클릭합니다.

참고

Databricks는 구성된 모든 서버에서 MCP를 20개 도구로 제한합니다. 사용 가능한 Honeydew 도구를 조정해야 하는 경우 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이 설치되어 있고 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이 설치되어 있고 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 Documentation MCP (선택 사항)

Honeydew MCP 서버에는 이미 문서 접근 도구가 포함되어 있으므로 별도의 문서 서버는 필요하지 않습니다. Honeydew에 연결하지 않고 문서 접근만 원하는 경우에만 Honeydew Documentation MCP를 추가하세요. 인증은 필요하지 않습니다.

다음을 .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이 설치되어 있고 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의 설정 > MCP 서버에서 찾을 수 있습니다.

명령줄

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 Documentation MCP (선택 사항)

Honeydew MCP 서버에는 이미 문서 접근 도구가 포함되어 있으므로 별도의 문서 서버는 필요하지 않습니다. Honeydew에 연결하지 않고 문서 접근만 원하는 경우에만 Honeydew Documentation MCP를 추가하세요. 인증은 필요하지 않습니다.

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이 설치되어 있고 PATH에 있어야 합니다. Git이 없으면 플러그인 설치가 실패합니다. Git을 설치하거나 클라이언트의 수동 MCP 설정 단계를 사용하여 플러그인 대신 서버를 직접 구성하세요.

Honeydew는 플러그인 저장소를 제공하며 자연어 대화를 통해 시맨틱 모델을 구축하고 데이터를 분석하기 위한 스킬과 도구가 포함되어 있습니다. 플러그인을 설치하면 Honeydew MCP 서버가 자동으로 설정됩니다.

Codex에서 마켓플레이스를 추가하세요:

  1. 플러그인을 엽니다
  2. 드롭다운 화살표를 클릭하고 마켓플레이스 추가를 선택합니다
  3. honeydew-ai/honeydew-ai-coding-agents-plugins을 추가합니다

참고

Codex CLI에서도 마켓플레이스를 추가할 수 있습니다:

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

그런 다음 플러그인을 설치하세요:

  1. 플러그인을 엽니다
  2. Honeydew AI 마켓플레이스를 선택합니다
  3. Honeydew 플러그인을 설치합니다

MCP 설정

조직에서 사용자 지정 Honeydew 엔드포인트를 사용하거나 플러그인을 설치하지 않고 MCP 서버를 직접 구성하려는 경우 이 섹션을 사용하세요. 플러그인으로 추가된 Honeydew MCP 연결을 비활성화한 후 아래 지침에 따라 사용자 지정 엔드포인트를 추가하세요.

참고

조직에서 사용자 지정 Honeydew 호스트 이름을 사용하는 경우 https://mcp.honeydew.cloud/mcp을 테넌트 호스트 이름으로 바꾸세요. 호스트 이름은 Honeydew Studio의 설정 > MCP 서버에서 찾을 수 있습니다.

Honeydew MCP

  1. Codex 애플리케이션을 엽니다

  2. 설정 -> MCP 서버로 이동합니다

  3. 사용자 지정 서버에서 서버 추가를 클릭합니다

  4. 서버 이름을 honeydew으로 설정합니다

  5. 전송 유형으로 Streamable HTTP를 선택합니다

  6. URL을 https://mcp.honeydew.cloud/mcp으로 설정합니다

  7. Bearer 토큰 환경 변수 필드는 비워 둡니다

  8. 인증을 다음과 같이 구성합니다:

    OAuth 인증

    Codex는 연결 시 Honeydew로 인증하도록 리디렉션합니다. 추가 구성은 필요하지 않습니다.

    HTTP Basic 인증

    위의 헤더 목록에 Authorization 헤더를 값 Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET>과 함께 추가하세요 (인증 참조).

MCP 인증 문제 해결

Codex에서 Honeydew MCP 서버가 인증되지 않고 "인증" 옵션이 표시되지 않는 경우:

  1. Codex CLI를 설치합니다
  2. codex mcp login honeydew을 실행합니다

Honeydew Documentation MCP (선택 사항)

Honeydew MCP 서버에는 이미 문서 접근 도구가 포함되어 있으므로 별도의 문서 서버는 필요하지 않습니다. Honeydew에 연결하지 않고 문서 접근만 원하는 경우에만 Honeydew Documentation MCP를 추가하세요. 인증은 필요하지 않습니다.

  1. 설정 -> MCP 서버로 이동합니다
  2. 사용자 지정 서버에서 서버 추가를 클릭합니다
  3. 서버 이름을 honeydew-docs으로 설정합니다
  4. 전송 유형으로 Streamable HTTP를 선택합니다
  5. URL을 https://honeydew.ai/docs/mcp으로 설정합니다

MCP 서버 제거

Honeydew MCP 서버를 제거하려면:

  1. 설정 -> MCP 서버로 이동합니다
  2. 사용자 지정 서버에서 honeydew을 찾아 제거를 클릭합니다

Honeydew Documentation MCP 서버를 제거하려면:

  1. 설정 -> MCP 서버로 이동합니다
  2. 사용자 지정 서버에서 honeydew-docs을 찾아 제거를 클릭합니다

Antigravity

#### MCP 서버

참고

조직에서 사용자 지정 Honeydew 호스트 이름을 사용하는 경우 https://mcp.honeydew.cloud/mcp을 테넌트 호스트 이름으로 바꾸세요. 호스트 이름은 Honeydew Studio의 설정 > MCP 서버에서 찾을 수 있습니다.

  1. Antigravity 편집기를 엽니다

  2. 에이전트 패널 상단의 ... 드롭다운을 클릭합니다

  3. MCP 서버 관리를 클릭합니다

  4. 원시 구성 보기를 클릭합니다

  5. 다음을 mcp_config.json에 추가합니다:

    ```json theme={null} { "name": "honeydew", "type": "http", "url": "https://mcp.honeydew.cloud/mcp" } ``` 
    <Tab title="API Key">
  ```json theme={null}
  {
    "name": "honeydew",
    "type": "http",
    "url": "https://mcp.honeydew.cloud/mcp",
    "headers": {
      "Authorization": "Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET>"
    }
  }
  ```
</Tab>

  6. 파일을 저장합니다

Honeydew Documentation MCP (선택 사항)

Honeydew MCP 서버에는 이미 문서 접근 도구가 포함되어 있으므로 별도의 문서 서버는 필요하지 않습니다. Honeydew에 연결하지 않고 문서 접근만 원하는 경우에만 Honeydew Documentation MCP를 추가하세요. 인증은 필요하지 않습니다.

  1. Antigravity 편집기를 엽니다
  2. 에이전트 패널 상단의 ... 드롭다운을 클릭합니다
  3. MCP 서버 관리를 클릭합니다
  4. 원시 구성 보기를 클릭합니다
  5. 다음을 mcp_config.json에 추가합니다: 
    {
  "name": "honeydew-docs",
  "type": "http",
  "url": "https://honeydew.ai/docs/mcp"
}
  6. 파일을 저장합니다

MCP 서버 제거

Honeydew MCP 서버를 제거하려면:

  1. Antigravity 편집기를 엽니다
  2. 에이전트 패널 상단의 ... 드롭다운을 클릭합니다
  3. MCP 서버 관리를 클릭합니다
  4. 원시 구성 보기를 클릭합니다
  5. mcp_config.json에서 honeydew 및 honeydew-docs 항목을 제거합니다
  6. 파일을 저장합니다

OpenCode

#### MCP 서버

참고

조직에서 사용자 지정 Honeydew 호스트 이름을 사용하는 경우 https://mcp.honeydew.cloud/mcp을 테넌트 호스트 이름으로 바꾸세요. 호스트 이름은 Honeydew Studio의 설정 > MCP 서버에서 찾을 수 있습니다.

다음 명령을 실행하고 대화형 프롬프트를 따르세요: 
  ```bash theme={null}
  opencode mcp add
  ```

  프롬프트가 표시되면 다음 값을 입력하세요:

  1. **위치**: 원하는 범위를 선택하세요 (현재 프로젝트 또는 전역)
  2. **MCP 서버 이름**: `honeydew`
  3. **MCP 서버 유형**: `Remote`
  4. **MCP 서버 URL**: `https://mcp.honeydew.cloud/mcp`
  5. **OAuth 인증**: `Yes`
  6. **사전 등록된 클라이언트 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에 연결하지 않고 문서 접근만 원하는 경우에만 Honeydew Documentation MCP를 추가하세요. 인증은 필요하지 않습니다.

`opencode mcp add`을 실행하고 다음 값을 입력하세요: 
  1. **MCP 서버 이름**: `honeydew-docs`
  2. **MCP 서버 유형**: `Remote`
  3. **MCP 서버 URL**: `https://honeydew.ai/docs/mcp`
  4. **OAuth 인증**: `No`
</Tab>

<Tab title="JSON configuration">
  `opencode.jsonc` 파일에 다음을 추가하세요:

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

MCP 서버 제거

Honeydew MCP 서버를 제거하려면 opencode.jsonc 파일에서 honeydew 항목을 제거하세요. Honeydew Documentation MCP 서버를 제거하려면 같은 파일에서 honeydew-docs 항목을 제거하세요.

Kiro

Kiro IDE와 Kiro CLI는 동일한 MCP 구성 파일을 공유하므로 아래 단계는 둘 다에 적용됩니다.

MCP 서버

Kiro는 두 구성 파일에서 MCP 서버를 읽습니다:

  • 작업공간: .kiro/settings/mcp.json (현재 프로젝트에 한정)
  • 사용자: ~/.kiro/settings/mcp.json (모든 작업공간에 적용)

두 파일이 모두 존재하면 작업공간 구성이 우선합니다.

참고

조직에서 사용자 지정 Honeydew 호스트 이름을 사용하는 경우 https://mcp.honeydew.cloud/mcp을 테넌트 호스트 이름으로 바꾸세요. 호스트 이름은 Honeydew Studio의 설정 > MCP 서버에서 찾을 수 있습니다.

다음 mcp.json 파일(작업공간 또는 사용자) 중 하나에 Honeydew MCP 서버를 추가하세요:

```json theme={null} { "mcpServers": { "honeydew": { "url": "https://mcp.honeydew.cloud/mcp" } } } ``` 
  Honeydew에 처음 연결할 때 Kiro가 인증 URL을 제공합니다.
  브라우저에서 열어 OAuth 인증 흐름을 완료하세요.
</Tab>
```json theme={null} { "mcpServers": { "honeydew": { "url": "https://mcp.honeydew.cloud/mcp", "headers": { "Authorization": "Basic " } } } } ```

Kiro CLI에서 /mcp를 실행하여 서버가 연결되었는지 확인합니다. Kiro IDE에서는 서버가 MCP 패널 아래에 표시됩니다.

Honeydew 문서 MCP (선택 사항)

Honeydew MCP 서버에는 이미 문서 접근 도구가 포함되어 있으므로 별도의 문서 서버가 필요하지 않습니다. Honeydew에 연결하지 않고 문서 접근만 원하는 경우에만 Honeydew 문서 MCP를 추가하세요. 인증은 필요하지 않습니다.

mcp.json에 다음을 추가하세요:

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

MCP 서버 제거

Honeydew MCP 서버를 제거하려면 mcp.json에서 honeydew 항목을 삭제하세요. Honeydew 문서 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 Agents에서 사용할 수 있게 합니다.

전제 조건:

  • 계정에 대해 CREATE INTEGRATION 권한이 있는 역할
  • 대상 스키마에 대해 CREATE MCP SERVER 권한이 있는 역할

기본적으로 ACCOUNTADMIN 역할만 이러한 권한을 보유합니다.

참고

조직에서 사용자 지정 Honeydew 호스트 이름을 사용하는 경우 https://mcp.honeydew.cloud/mcp를 테넌트 호스트 이름으로 바꾸세요. 호스트 이름은 Honeydew Studio의 설정 > MCP 서버에서 찾을 수 있습니다.

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

참고

독립형 Honeydew 문서 MCP 서버는 Snowflake에서 지원되지 않습니다. Snowflake 외부 MCP 서버는 OAuth 인증이 필요하고 문서 서버는 인증되지 않기 때문입니다. 문서 접근은 Honeydew MCP 서버의 문서 도구를 통해 사용할 수 있습니다.

MCP 서버 제거

먼저 MCP 서버를 삭제한 다음 API 통합을 삭제하세요:

DROP MCP SERVER honeydew;
DROP INTEGRATION honeydew_mcp_integration;

기타 클라이언트

모든 MCP 호환 클라이언트는 표준 HTTP 전송을 사용하여 Honeydew MCP 서버에 연결할 수 있습니다.

다음 JSON 구성을 시작점으로 사용하세요:

참고

조직에서 사용자 지정 Honeydew 호스트 이름을 사용하는 경우 https://mcp.honeydew.cloud/mcp를 테넌트 호스트 이름으로 바꾸세요. 호스트 이름은 Honeydew Studio의 설정 > MCP 서버에서 찾을 수 있습니다.

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

각 매개변수에 대한 자세한 내용은 서버 URL, 인증, 및 구성을 참조하세요.

사용 예시

연결이 완료되면 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의 설정 > MCP 서버에 표시된 테넌트 호스트 이름과 일치하는지 확인하세요.

도구 누락

인증이 성공했는지 확인하고, 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 출력 한도 및 경고를 참조하세요.

추가 지원이 필요하면 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를 사용하세요. 자세한 내용은 심층 분석을 참조하세요.

질문할 자연어 질문. 새 대화의 에이전트 이름. 후속 질문의 경우 생략하세요 — 에이전트는 기존 대화에서 상속됩니다. 계속할 기존 대화 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

특정 분석 대화에 대한 피드백을 설정하거나 지웁니다. 대화당 피드백 항목은 하나입니다(질문당이 아님) — 전체 대화 흐름의 전반적인 품질을 반영해야 합니다.

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 프론트매터 정의를 포함하여 가져옵니다.

검색할 에이전트의 이름입니다.

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>
프론트매터 뒤에 추가되는 Markdown 본문입니다. 이 텍스트는 모든 분석 세션 전에 프롬프트에 주입됩니다. 검증에서 오류가 발생해도 에이전트를 생성합니다.

update_agent

기존 에이전트를 업데이트합니다.

업데이트할 에이전트의 이름입니다. 전체 업데이트된 에이전트 정의입니다. `create_agent`의 모든 필수 필드를 제공해야 합니다 — 이는 부분 업데이트가 아닌 전체 교체입니다. 에이전트의 업데이트된 Markdown 본문입니다. 검증에서 오류가 발생해도 에이전트를 업데이트합니다.

delete_agent

이름으로 에이전트를 삭제합니다.

삭제할 에이전트의 이름입니다.

컨텍스트 항목

list_context_items

읽기 전용

모든 컨텍스트 항목을 유형, 이름, 제목 및 하위 유형 값과 함께 나열합니다.

get_context_item

읽기 전용

이름으로 컨텍스트 항목을 가져옵니다.

검색할 컨텍스트 항목의 이름입니다.

create_context_item

새 컨텍스트 항목을 생성합니다. instruction 및 memory 유형을 지원합니다.

새 컨텍스트 항목의 메타데이터입니다. `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입니다. 별칭을 사용할 때는 별칭 이름으로 정렬합니다. 쿼리할 도메인입니다. 반환할 최대 행 수입니다. 페이지네이션을 위해 건너뛸 행 수입니다. 반환된 SQL 상단에 [사전 집계 보고서](/docs/performance/aggregate-awareness#debugging-aggregate-matching)를 추가하여, 워크스페이스의 모든 사전 집계에 대해 어떤 CTE가 이를 사용했는지 또는 사용할 수 없었던 이유를 명시합니다.

get_data_from_fields

읽기 전용

속성, 측정항목 및 필터로 정의된 시맨틱 레이어 쿼리를 실행하고 결과 데이터를 반환합니다.

정규화된 속성 이름(`entity.attribute_name`). 별칭 지원: `entity.attribute_name as alias_name`. 정규화된 측정항목 이름(`entity.metric_name`) 또는 SQL 표현식 (예: `SUM(entity.field)`). 별칭 지원: `SUM(entity.field) as total`. 필터 조건 (예: `entity.field = 'value'`, `entity.date_field > '2024-01-01'`). 정렬할 필드 목록. 형식: `entity.field_name` 또는 `entity.field_name DESC`. 기본 방향은 ASC입니다. 별칭을 사용하는 경우 별칭 이름으로 정렬합니다. 쿼리할 도메인. 반환할 최대 행 수. 페이지네이션을 위해 건너뛸 행 수.

list_query_history

읽기 전용

Honeydew 시맨틱 레이어를 통해 이전에 실행된 쿼리를 최신순으로 나열합니다. 실패한 쿼리를 찾아 분류하고 실패 원인을 이해하는 데 사용합니다. 관리자가 아닌 호출자는 자신의 쿼리만 볼 수 있습니다.

각 쿼리에는 상태, 오류 메시지, 소유자, 클라이언트, 도메인, 원본 입력 SQL(SQL 인터페이스 쿼리의 사용자 제출 SQL), 컴파일 및 웨어하우스 실행 타임스탬프, 데이터 웨어하우스 쿼리 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`).

FAQ

심층 분석에는 어떤 도구가 필요합니까?

심층 분석 실행에는 다음이 필요합니다:

이전 분석 대화를 검토하려면 list_analysis_chats 및 get_stored_conversation도 활성화하세요.

에이전트를 이러한 도구로 제한하는 것이 유용한 경우:

  • 의도한 사용자가 심층 분석 워크플로우만 실행하는 경우
  • 에이전트를 분석 작업에 집중시키려는 경우
  • 클라이언트가 활성화할 수 있는 도구 수를 제한하는 경우 (예: Databricks Genie Code)

다른 사용 사례의 경우 사용 가능한 도구 아래에 나열된 더 많은 도구를 노출하세요 — 에이전트가 각 작업에 적합한 도구를 선택합니다.