Genie Code에 AI Dev Kit 구성하기

소요 시간: ~5분 참조: AI Dev Kit GitHub

​

왜 이 구성이 필요한가?

​

구성 방식: AI Builder App + --enable-mcp

​

전제조건

​

Step 1: AI Dev Kit 클론 & Builder App 배포

# AI Dev Kit 메인 레포 클론
git clone https://github.com/databricks-solutions/ai-dev-kit.git
cd ai-dev-kit/databricks-builder-app

# Builder App + MCP 서버 배포 (앱 이름은 반드시 mcp- 접두사!)
./scripts/deploy.sh mcp-builder-app --enable-mcp --profile <PROFILE>

<PROFILE>은 Databricks CLI 프로필명입니다. databricks auth profiles로 확인하세요.

1. 앱 생성 (mcp-builder-app) — mcp- 접두사로 Genie Code에서 인식
2. 소스 코드 업로드 및 배포 — Builder UI + MCP 서버
3. 서비스 프린시펄(SP) 권한 부여 — Workspace, SQL Warehouse
4. Skills 배포 — Genie Code에서 도메인 지식 자동 참조
5. MCP 엔드포인트 활성화 — /mcp 경로로 도구 노출

참고 --enable-mcp 옵션: 이 플래그를 추가하면 Builder App이 듀얼 모드로 동작합니다. 웹 브라우저에서는 Builder UI로, Genie Code에서는 MCP 서버로 사용됩니다. 플래그 없이 배포하면 Builder UI만 제공됩니다.

​

Step 2: 카탈로그 GRANT 실행

-- deploy.sh 출력에서 복사 (SP Client ID는 자동으로 채워져 있음)
GRANT USE CATALOG ON CATALOG lge_smart_tv TO `<SP_CLIENT_ID>`;
GRANT USE SCHEMA ON CATALOG lge_smart_tv TO `<SP_CLIENT_ID>`;
GRANT SELECT ON CATALOG lge_smart_tv TO `<SP_CLIENT_ID>`;
GRANT CREATE TABLE ON CATALOG lge_smart_tv TO `<SP_CLIENT_ID>`;
GRANT CREATE SCHEMA ON CATALOG lge_smart_tv TO `<SP_CLIENT_ID>`;

<SP_CLIENT_ID>는 deploy.sh 출력 마지막에 표시됩니다. 그대로 복사하세요.

​

Step 3: Genie Code에서 MCP 서버 연결

1. Databricks Workspace 접속 → 아무 노트북 열기
2. 우측 상단 Genie Code 아이콘(✨) 클릭
3. 하단에서 Agent Mode 선택
4. 하단 ⚙️ Settings 클릭
5. MCP Servers → ”+ Add Server”
6. 드롭다운에서 mcp-builder-app 선택 → Save

mcp-builder-app이 안 보이면: 앱 상태가 RUNNING인지 확인 (databricks apps get mcp-builder-app)

주의 mcp- 접두사 필수: 앱 이름이 mcp-로 시작해야 Genie Code Settings에서 MCP 서버로 인식됩니다. 이 접두사 없이 생성된 앱은 드롭다운에 나타나지 않습니다.

​

Step 4: 도구 선택 — 필요한 것만 켜기

Genie Code가 이미 잘 하는 것은 OFF, AI Dev Kit 고유 기능만 ON

​

워크샵 권장: 올라운드 15개

​

OFF 권장 (Genie Code OOB와 중복)

​

Step 5: 테스트

​

테스트 1: Skills 자동 로딩 확인

Spark Declarative Pipeline으로 medallion 아키텍처를 구성하려면 어떻게 해야 돼?

Genie Code가 SDP 관련 Skill을 자동으로 참조하여 답변하면 성공

​

테스트 2: MCP 도구 — Genie Space 생성

gold 스키마의 테이블 2개로 테스트용 Genie Space를 만들어줘.
이름은 "테스트 분석 공간"으로 해줘.

Genie Code가 manage_genie MCP 도구를 호출하여 Genie Space를 생성하면 성공

​

테스트 3: 크로스 프로덕트 오케스트레이션

다음 3가지를 한번에 해줘:
1. gold 스키마 테이블들로 Genie Space 생성
2. 같은 데이터로 대시보드 만들기
3. 매일 오전 6시에 데이터를 리프레시하는 Job 설정

한 대화에서 Genie Space + 대시보드 + Job이 모두 생성되면 성공

​

테스트 4: Builder App 웹 UI (선택)

# Builder App URL 확인
databricks apps get mcp-builder-app -o json | jq -r .url

브라우저에서 URL을 열면 Builder UI가 표시됩니다. 자연어로 앱을 만들 수 있습니다.

​

(선택) Genie Space 접근 권한 부여

SPACE_ID="<genie_space_id>"
TOKEN=$(databricks auth token | jq -r .access_token)
HOST=$(databricks auth env | jq -r .env.DATABRICKS_HOST)
SP_CLIENT_ID=$(databricks apps get mcp-builder-app -o json | jq -r .service_principal_client_id)

curl -X PATCH "$HOST/api/2.0/permissions/genie/$SPACE_ID" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d "{\"access_control_list\": [{
    \"service_principal_name\": \"$SP_CLIENT_ID\",
    \"permission_level\": \"CAN_RUN\"
  }]}"

<genie_space_id> 찾는 법: Genie Space URL에서 /genie/spaces/ 뒤의 문자열이 ID입니다. 또는 Genie Code에 현재 워크스페이스의 Genie Space 목록과 각 ID를 알려줘라고 물어보세요.

​

트러블슈팅

​

구성 시 문제

​

워크샵 실습 중 MCP 도구 문제

​

MCP 문제 발생 시 대안 경로

워크샵의 핵심은 Genie Code로 코드를 생성하는 것이고, MCP는 편의 기능입니다.

​

핵심 정리

​

다음 단계

• Section 4: Smart TV E2E
• Section 5: 가전 IoT E2E