> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sifi.life/llms.txt
> Use this file to discover all available pages before exploring further.

# AI Dev Kit 설치 & 구성

> **사전 조건**:
>
> * **방법 1 (Claude Code 로컬)**: Databricks CLI 인증 완료 ([claude-code.md Step 2](claude-code) 참조)
> * **방법 2 (Genie Code MCP)**: [Section 2: AI Builder App 배포](../section-2-ai-builder-app/README) 완료

***

## AI Dev Kit이란?

Databricks의 모든 기능을 \*\*외부 AI 도구(Claude Code, Cursor 등)\*\*에서 사용할 수 있게 하는 MCP 서버 + Skills 패키지입니다.

| 구성 요소      | 수량  | 설명                                                  |
| ---------- | --- | --------------------------------------------------- |
| **MCP 도구** | 44개 | Genie Space 생성, 대시보드, Job, Agent Bricks, Lakebase 등 |
| **Skills** | 25개 | SDP 패턴, ML 워크플로우, 벡터 서치 등 도메인 지식                    |

***

## 설치 방법 1: Claude Code에서 사용 (로컬)

```bash theme={null}
# 원라인 설치
bash <(curl -sL https://raw.githubusercontent.com/databricks-solutions/ai-dev-kit/main/install.sh)

# 설치 확인
claude
# → "Databricks AI Dev Kit already set up." 메시지 확인
```

> 💡 **화면 참고**: AI Dev Kit 설치 완료 메시지

***

## 설치 방법 2: Genie Code에서 사용 (Builder App + MCP)

Genie Code에서 AI Dev Kit을 사용하려면 **Builder App을 `--enable-mcp` 옵션으로 배포**합니다.

```bash theme={null}
git clone https://github.com/databricks-solutions/ai-dev-kit.git
cd ai-dev-kit/databricks-builder-app
./scripts/deploy.sh mcp-builder-app --enable-mcp --profile <PROFILE>
```

전체 절차는 \*\*[Section 2: AI Builder App 배포 핸즈온](../section-2-ai-builder-app/overview)\*\*에서 단계별로 상세히 안내합니다.

> **핵심 포인트**: 앱 이름은 반드시 `mcp-` 접두사로 시작해야 Genie Code Settings에서 MCP 서버로 인식됩니다.

***

## Skills 배포 (Workspace)

Skills는 MCP와 달리 Workspace에 파일만 올리면 **자동으로 로딩**됩니다.

```bash theme={null}
# AI Dev Kit Skills 클론
git clone --depth 1 https://github.com/databricks-solutions/ai-dev-kit.git /tmp/ai-dev-kit

# Skills를 Workspace에 업로드
TARGET="/Workspace/.assistant/skills"
for skill_dir in /tmp/ai-dev-kit/databricks-skills/*/; do
  skill_name=$(basename "$skill_dir")
  [ "$skill_name" = "TEMPLATE" ] && continue
  databricks workspace mkdirs "$TARGET/$skill_name"
  for f in "$skill_dir"*; do
    [ -f "$f" ] || continue
    databricks workspace import "$TARGET/$skill_name/$(basename $f)" \
      --file "$f" --format RAW --overwrite
  done
  echo "✓ $skill_name"
done

# 배포 확인
databricks workspace list /Workspace/.assistant/skills/
```

> 💡 **화면 참고**: Skills 배포 완료 목록

### Skills 배포 확인 프롬프트

Genie Code에서 Skills가 정상 로딩되는지 확인합니다:

```
현재 활성화된 Skills 목록을 보여줘.
SDP 파이프라인 관련 Skill이 있으면 내용을 요약해줘.
```

***

## 주요 문서 링크

| 주제                    | URL                                                                                                   |
| --------------------- | ----------------------------------------------------------------------------------------------------- |
| AI Dev Kit GitHub     | [github.com/databricks-solutions/ai-dev-kit](https://github.com/databricks-solutions/ai-dev-kit)      |
| Custom MCP Server 호스팅 | [docs.databricks.com/mcp/custom-mcp](https://docs.databricks.com/aws/en/generative-ai/mcp/custom-mcp) |
| Genie Code + MCP 연결   | [docs.databricks.com/genie-code/mcp](https://docs.databricks.com/aws/en/genie-code/mcp)               |
| Databricks Apps 문서    | [docs.databricks.com/apps](https://docs.databricks.com/en/dev-tools/databricks-apps/index.html)       |

***

## 다음 단계

* **[Genie Code + AI Dev Kit 연결](genie-code-aidevkit)** — MCP 서버를 Genie Code에 연결하고 테스트
