0. 목차

 

[대표 이미지: 시리즈 제목 카드]

 

CLAUDE CODE × MySQL MCP 실습 시리즈

Claude Code에게 재고 관리 프로그램을
구현시키고 검증하는 법

 

이 시리즈는 VS Code의 Claude Code와 읽기 전용 MySQL MCP를 사용해, 자연어 요구사항만으로 실제 재고 관리 프로그램을 구현하는 과정을 다룹니다. 하나의 inventory-mysql-app 프로젝트를 1강부터 이어서 확장하며, 실습 환경 구축과 계정 분리(1~4강), 데이터베이스 문서 자동 생성(5강), VS Code 통합 개발 환경 전환(6강), Python 조회 기능 구현(7강), PySide6 화면 통합(8강), 스키마 변경 대응(9강)까지 완성합니다.

MySQL 기본 SQL, VS Code 사용법, Claude Code 설치는 이미 익힌 상태를 가정합니다. 이 시리즈의 목표는 기능을 많이 만드는 것이 아니라, 자연어 요구사항을 Claude Code가 구현하면 diff 화면으로 검토·승인하고, 실행 결과와 실제 데이터베이스 조회 결과로 검증하는 습관을 만드는 것입니다.

 

1~4강 실습 환경 구축과 계정 분리
    ↓
5강 데이터베이스 문서 자동 생성
    ↓
6강 VS Code에 Claude Code 연동하기
    ↓
7강 Python 재고 조회 기능 구현
    ↓
8강 PySide6 재고 목록 화면 구현
    ↓
9강 스키마 변경과 문서 재생성 대응

 

💡 링크 연결 안내: 아래 표의 각 강의명은 게시 후 해당 글 주소로 링크를 연결하세요. 티스토리 기본모드에서 강의명을 드래그해 선택하고 링크 버튼으로 URL을 지정하면 됩니다.

 

1. 본 강의 (필수)

→ 1강부터 순서대로 진행하며, 앞 강의에서 만든 프로젝트와 DB를 그대로 이어서 사용합니다.

강	강의명 · 한 줄 설명	유형	시간
1강	실습 준비 — 실습 DB와 기준 데이터 구축 inventory DB와 products·stock_logs·operation_requests 테이블, 기준 데이터를 구축합니다.	실습 중심	약 100분 (1~4강 전체)
2강	실습 준비 — DB 관리자 권한과 계정 분리 관리자 연결 권한을 확인하고, 역할별 최소 권한 계정(inventory_reader·inventory_operator·inventory_app)을 만들어 분리합니다.	실습 중심	1강에 포함
3강	실습 준비 — MCP 연결 Claude Code에 읽기 전용 inventory_reader 계정으로 MySQL MCP를 연결합니다.	실습 중심	1강에 포함
4강	실습 준비 — MCP 계정 권한 검증하기 MCP 조회 성공과 UPDATE 차단, inventory_operator의 DELETE·DDL 차단을 직접 확인합니다.	실습 중심	1강에 포함
5강	테이블 명세서와 AI 프로젝트 Context 생성하기 실제 스키마를 조회해 사람 검토용 테이블 명세서와 Claude Code용 schema.md를 함께 생성합니다.	실습 중심	약 60분
6강	VS Code에 Claude Code를 연동하여 개발 환경 전환하기 터미널 중심 작업 방식을 VS Code 통합 환경으로 전환하고, diff 화면으로 파일 변경을 검토하는 습관을 만듭니다.	환경 전환	약 40분
7강	Claude Code가 테이블 명세서와 MySQL 스키마를 사용하여 Python 재고 조회 기능 구현하기 요구사항을 조건·정렬·결과로 정리해 Claude Code에 전달하고, 재고 부족 상품 조회 기능을 구현·검증합니다.	실습 중심	약 60분
8강	Claude Code에 Python 조회 모듈과 PySide6 화면 통합을 요청하여 재고 목록 완성하기 7강의 조회 기능을 PySide6 화면에 연결해, 재고 부족 상품을 표로 확인합니다.	실습 중심	약 70분
9강	상품 테이블에 컬럼을 추가하고 문서와 AI 문맥을 다시 생성하기 실제 스키마를 변경한 뒤 5강 절차를 다시 실행해, 문서와 코드가 실제 데이터베이스와 계속 일치하는지 확인합니다.	실습 중심	약 50분

 

2. 선택 부록

→ 필수 과정은 1~9강만으로 완료됩니다. 부록은 Claude Desktop을 다른 MCP Host로 비교하거나, MySQL root 계정의 인증 방식을 전환해야 하는 경우에만 진행합니다.

부록	제목 · 한 줄 설명	유형	시간
부록 A	Ubuntu에 Claude Desktop 설치하기 공식 apt 저장소로 Claude Desktop을 설치하고, 다음 부록에서 사용할 설정 위치를 찾습니다.	실습 중심	약 20분
부록 B	Claude Desktop에 읽기 전용 MySQL MCP 연결하기 Claude Code와 Claude Desktop 두 Host에서 같은 MCP·DB를 조회해 역할과 결과를 비교합니다.	실습 중심	약 35분
부록 C	MySQL root 계정의 인증 방식을 sudo mysql과 mysql -u root -p 사이에서 전환하기 root 계정의 두 접속 방식과, 어떤 상황에서 어느 쪽으로 전환해야 하는지 정리합니다.	실습 중심	약 35분

 

→ 여기서 시작하세요: 준비물은 Ubuntu·VS Code·Claude Code·MySQL 8.x입니다. 1강에서 빈 프로젝트로 시작해, 1~9강(총 약 380분)을 마치면 자연어 요구사항을 Claude Code에게 구현시키고, diff 화면으로 검토하고, 실행 결과와 실제 MySQL 데이터로 검증하는 전체 과정을 스스로 반복할 수 있습니다.