Honeydew Semantic Layer

공식

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

honeydew.ai에서 보기

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

  • 웨어하우스 테이블 및 스키마 검색 — 자연어 대화를 통해 데이터 웨어하우스 구조와 시맨틱 모델 정의를 탐색합니다.
  • 시맨틱 모델 구축 및 유지 관리 — create_workspace_branch 및 기타 세션 도구를 사용하여 시맨틱 모델 정의를 생성하거나 업데이트합니다.
  • 자연어로 데이터 쿼리 — SQL을 작성하지 않고 데이터에 대한 질문을 하고 답변을 얻습니다.
  • Honeydew 문서 검색 — MCP 호환 어시스턴트에서 직접 제품 문서를 조회합니다.

문서

MCP 서버

MCP란 무엇인가요?

모델 컨텍스트 프로토콜(MCP)은 AI 애플리케이션을 외부 시스템 및 도구에 안전하게 연결하기 위한 오픈소스 표준입니다. Honeydew는 AI 코딩 어시스턴트를 Honeydew 시맨틱 레이어에 연결하는 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 세션 관리 사양](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를 입력하고 상단의 선택기에서 마켓플레이스를 선택합니다.
  2. honeydew-ai-coding-agents-plugins을 선택합니다.
  3. 마켓플레이스 업데이트를 클릭합니다.

자동으로 업데이트를 받으려면 마켓플레이스 설정에서 자동 업데이트 활성화를 선택합니다.

MCP 설정

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

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

다음 방법 중 하나를 사용하여 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}` 구문을 사용한 [환경 변수 확장](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. 설정 -> 사용자 지정으로 이동합니다.
  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 시맨틱 레이어에 연결합니다.

Claude Code 모드

Claude Code 모드에서 Claude Desktop을 사용하는 경우 대신 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 시맨틱 레이어에 연결합니다.

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

Honeydew MCP 서버를 추가하려면:

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

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

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](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 시맨틱 레이어에 연결합니다.

조직에서 사용자 지정 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](https://git-scm.com/downloads)이 설치되어 있고 `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. **저장**을 클릭합니다. 
      처음 연결할 때 OAuth로 Honeydew에 인증하라는 메시지가 표시됩니다.
    </Tab>

    <Tab title="API Key">
      1. **서버 이름**: `honeydew`
      2. **서버 유형**: **원격 (HTTP)**
      3. **서버 URL**: `https://mcp.honeydew.cloud/mcp`
      4. **헤더**에서 **헤더 추가**를 클릭하고 이름을
         `Authorization`(으)로, 값을
         `Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET>`(으)로 설정합니다.
      5. **저장**을 클릭합니다.
    </Tab>
  </Tabs>
</Tab>

<Tab title="JSON">
  **JSON** 탭으로 전환하여 구성을 붙여넣습니다:

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

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

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

Honeydew 문서 MCP (선택 사항)

Honeydew MCP 서버에는 이미 문서 접근 도구가 포함되어 있으므로 별도의 문서 서버가 필요하지 않습니다. Honeydew에 연결하지 않고 문서에 접근하려면 동일한 방식으로 Honeydew 문서 MCP 서버를 추가하되, 서버 이름은 honeydew-docs, 서버 유형은 원격 (HTTP), 서버 URL은 https://honeydew.ai/docs/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 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 시맨틱 레이어에 연결합니다.

조직에서 사용자 지정 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 시맨틱 레이어에 연결합니다.

조직에서 사용자 지정 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 시맨틱 레이어에 연결합니다.

조직에서 사용자 지정 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 문서 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의 **설정 > 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 <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET>인 Authorization 헤더를 추가합니다 (인증 참조).

MCP 인증 문제 해결

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

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

Honeydew 문서 MCP (선택 사항)

Honeydew MCP 서버에는 이미 문서 접근 도구가 포함되어 있으므로 별도의 문서 서버는 필요하지 않습니다. Honeydew에 연결하지 않고 문서에 접근하려는 경우에만 Honeydew 문서 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 문서 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 문서 MCP (선택 사항)

Honeydew MCP 서버에는 이미 문서 접근 도구가 포함되어 있으므로 별도의 문서 서버는 필요하지 않습니다. Honeydew에 연결하지 않고 문서에 접근하려는 경우에만 Honeydew 문서 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 문서 MCP (선택 사항)

Honeydew MCP 서버에는 이미 문서 접근 도구가 포함되어 있으므로 별도의 문서 서버는 필요하지 않습니다. Honeydew에 연결하지 않고 문서에 접근하려는 경우에만 Honeydew 문서 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 문서 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을 제공합니다.
  브라우저에서 이 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 문서 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 서버에 연결하여 Snowflake Intelligence 및 Cortex Agent에서 Honeydew 도구를 사용할 수 있도록 합니다.

전제 조건:

  • 계정에 대한 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>
Snowflake 외부 MCP 서버는 OAuth 인증이 필요하고 문서 서버는 인증되지 않으므로, 독립형 Honeydew 문서 MCP 서버는 Snowflake에서 지원되지 않습니다. 문서 접근은 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>
전문 뒤에 추가되는 마크다운 본문입니다. 이 텍스트는 모든 분석 세션 전에 프롬프트에 주입됩니다. 유효성 검사에서 오류가 발생해도 에이전트를 생성합니다.

update_agent

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

업데이트할 에이전트의 이름입니다. 완전히 업데이트된 에이전트 정의입니다. `create_agent`의 모든 필수 필드를 제공해야 합니다. 이는 부분 업데이트가 아닌 전체 교체입니다. 에이전트에 대해 업데이트된 마크다운 본문입니다. 유효성 검사에서 오류가 발생해도 에이전트를 업데이트합니다.

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>
컨텍스트 항목 콘텐츠에 대한 마크다운 본문입니다. 유효성 검사에서 오류가 발생해도 컨텍스트 항목을 생성합니다.

update_context_item

기존 컨텍스트 항목을 업데이트합니다.

업데이트할 컨텍스트 항목의 이름입니다. 완전히 업데이트된 컨텍스트 항목 정의입니다. `create_context_item`의 모든 필수 필드를 제공해야 합니다. 이는 부분 업데이트가 아닌 전체 교체입니다. 컨텍스트 항목에 대해 업데이트된 마크다운 본문입니다. 유효성 검사에서 오류가 발생해도 컨텍스트 항목을 업데이트합니다.

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