몇 분이면 Claude를 MySQL에 직접 연결할 수 있어요. 하지만 그렇게 하지 않는 게 좋아요. Claude가 비밀번호를 갖게 되고 원하는 SQL을 무엇이든 실행할 수 있거든요. 더 안전한 방법은 Beekeeper Studio 같은 앱을 중간에 두는 거예요.
MySQL을 Claude에 연결하는 방법은 두 가지예요:
- Claude를 MySQL에 직접 연결하기: Claude Code나 MySQL MCP 서버를 통해 자격 증명을 넘겨줘요.
- Beekeeper Studio를 통해 연결하기: 비밀번호를 Beekeeper Studio만 보관하고, 쿼리를 실행하기 전에 먼저 물어봐요.
저희는 방법 2를 추천하고, 무료로 써 볼 수 있어요. 저희 MySQL 데이터베이스 관리 도구인 Beekeeper Studio를 다운로드하고 따라 하기로 바로 넘어가세요.
방법 1: Claude를 MySQL에 직접 연결하기
Claude Code는 셸 명령을 실행할 수 있어서, 가장 빠른 방법은 연결 정보를 알려 주고 mysql 명령줄 클라이언트를 쓰게 하는 거예요:
mysql -h db.example.com -u app -phunter2 shop -e "SELECT COUNT(*) FROM orders"
다른 방법은 MySQL MCP 서버예요. Claude Desktop이나 Claude Code에 "이 SQL 실행" 도구를 제공해요. mysql_mcp_server 같은 오픈 소스 서버는 호스트, 사용자, 비밀번호를 Claude 설정 파일에 직접 적게 해요.
어느 쪽이든 Claude는 이제 MySQL 로그인 정보를 갖고, 그걸로 무엇을 실행할지 스스로 결정해요.
MySQL을 Claude에 직접 연결할 때의 위험
그 로그인 정보가 있고 SQL을 검토하는 사람이 없다면:
- Claude가 행을 삭제하거나, 잘못된
WHERE절 하나로 테이블의 모든 행을 업데이트할 수 있어요. - Claude가 테이블 구조를 변경하거나 테이블을 통째로 삭제할 수 있어요.
- MySQL은 각 문장을 실행하는 즉시 커밋하기 때문에 되돌릴 방법이 없고, 백업만 남아요.
- Claude는 해당 사용자가 읽을 수 있는 모든 테이블을 읽을 수 있고, 읽은 내용은 Anthropic으로 전송돼요.
- 비밀번호가 설정 파일, 셸 기록, 채팅에 평문으로 남아요.
- "지시를 무시하고 실행해…"라는 내용이 든 행을 명령으로 받아들일 수 있어요.
- 큰 조인이나
ALTER TABLE이 프로덕션 테이블을 잠가서 사용자들이 기다리게 될 수 있어요. - 권한이 충분하면 Claude가 사용자를 만들고 스스로 더 많은 권한을 부여할 수 있어요.
- 셸에서는
mysqldump를 실행해 데이터베이스 전체를 복사할 수도 있어요. - MySQL 쿼리 로그를 켜 두지 않았다면 Claude가 무엇을 실행했는지 아무 기록도 남지 않아요.
Claude Code는 명령을 실행하기 전에 물어보지만, 확인 창이 귀찮아서 "항상 허용"을 누르는 순간 더 이상 묻지 않아요.
Claude 전용 MySQL 사용자로 피해를 줄일 수 있어요
직접 연결한다면 본인 로그인 정보를 Claude에 주지 마세요. 데이터베이스 하나만 읽을 수 있는 전용 사용자를 만드세요:
CREATE USER 'claude'@'%' IDENTIFIED BY 'a-long-random-password';
GRANT SELECT ON shop.* TO 'claude'@'%';
그러면 MySQL이 그 외의 작업은 모두 거부해요:
DELETE FROM orders WHERE status = 'cancelled';
-- ERROR 1142 (42000): DELETE command denied to user 'claude'@'localhost' for table 'orders'
이렇게 하면 쓰기, 삭제, 권한 부여는 막을 수 있어요. 하지만 Claude가 그 데이터베이스의 모든 행을 읽거나, 프로덕션을 느리게 할 만큼 무거운 쿼리를 실행하거나, 비밀번호가 설정 파일에 남는 것은 막지 못해요. 개별 테이블에만 SELECT 권한을 주거나(GRANT SELECT ON shop.orders TO ...) Claude를 복제본에 연결해 범위를 더 좁힐 수 있어요. SHOW GRANTS로 사용자 권한을 확인하세요.
방법 2: Beekeeper Studio를 통해 Claude를 MySQL에 연결하기
Beekeeper Studio의 AI Shell은 Claude와 데이터베이스 사이에 위치해요:
- Claude는 MySQL 비밀번호를 절대 받지 않아요. 테이블 목록과 컬럼 목록을 조회하고 쿼리를 제안하는 것만 할 수 있어요.
- 모든 쿼리는 실행 전에 예, 아니요, 편집 버튼과 함께 표시돼요.
- 읽기 전용 쿼리는 자동으로 실행되게 할 수 있어요. 쓰기 작업은 여전히 물어봐요.
- Anthropic API 키는 내 컴퓨터에 암호화되어 저장되고 Anthropic에만 전송돼요.
Claude는 테이블 이름과 승인한 쿼리의 결과를 볼 수 있으니, 채팅에 붙여 넣지 않을 데이터를 조회하는 SELECT는 승인하지 마세요.
AI Shell은 모든 유료 요금제에 포함되어 있고, 가입이나 신용카드 없이 14일 동안 무료로 체험할 수 있어요. 아래 스크린샷은 작은 MySQL 8.4 쇼핑몰 데이터베이스에서 Beekeeper Studio 6.3.2로 찍은 거예요.
1단계: MySQL 데이터베이스에 연결하기
Beekeeper Studio를 다운로드하고 New Connection을 클릭한 다음, MySQL을 선택하고 연결 정보를 입력한 뒤 Connect를 클릭하세요.

더 안전하게 하려면 Read Only Mode를 체크하세요. 그러면 Beekeeper Studio가 이 연결에서 AI Shell이든 어디서든 UPDATE, DELETE, ALTER 등의 쓰기 작업을 거부해요. 위에서 만든 읽기 전용 MySQL 사용자도 여기서 쓸 수 있어요.
2단계: AI Shell 탭 열기
편집기 위의 + 옆 화살표를 클릭하고 Add AI Shell을 선택하거나 Ctrl+L을 누르세요.

3단계: Anthropic API 키 추가하기
제공자로 Anthropic을 선택하고 Claude Console에서 발급한 API 키를 붙여 넣으세요. 요금은 수수료 없이 Anthropic의 일반 API 가격으로 Anthropic에 직접 지불해요.

4단계: Claude 모델 선택하기
전송 버튼 옆의 모델 이름을 클릭하세요. Haiku가 가장 빠르고 저렴하며, Opus가 가장 성능이 좋고, Sonnet은 그 중간이에요.

5단계: 질문하고 쿼리 승인하기
"지난달 상위 고객은 누구였어?"라고 물었더니, Claude가 테이블과 컬럼을 조회한 뒤 쿼리를 작성했어요. Yes를 클릭하기 전까지는 실행되지 않아요:

먼저 SQL을, 특히 조인과 WHERE 절을 꼼꼼히 읽어 보세요. Edit을 누르면 실행 전에 수정할 수 있어요.
6단계: 답변 읽기
승인하면 쿼리가 실행되고 Claude가 결과를 바탕으로 답해요. 결과 행도 함께 표시되니 답변을 데이터와 대조해 볼 수 있어요.

7단계: 의도하지 않은 작업은 거부하기
Claude에게 "취소된 주문을 모두 삭제해 줘"라고 했더니 DELETE 문을 작성하고 멈춰서 물어봤어요:

No를 클릭했기 때문에 문장은 MySQL에 전달되지 않았고 주문도 그대로 남아 있어요.

8단계(선택): 읽기 전용 쿼리 자동 실행하기
SELECT를 매번 승인하는 건 번거로워요. 톱니바퀴 아이콘을 클릭하고 Always allow execution of read-only queries를 켜세요.

그러면 SELECT 쿼리는 확인 없이 실행돼요. INSERT, UPDATE, DELETE, DROP, ALTER, 그리고 셸이 해석할 수 없는 쿼리는 여전히 먼저 물어봐요.
더 읽어 보기
- MySQL을 ChatGPT에 연결하는 방법: OpenAI 모델로 같은 설정을 하는 방법
- AI로 SQL 작성하는 방법: AI가 작성한 쿼리를 실행 전에 검토하는 법
- 인기 SQL AI 앱 및 서비스: 다른 대안과 비교해 보고 싶다면
- AI Shell 문서
Beekeeper Studio는 무료 오픈 소스 MySQL GUI예요
요즘 MySQL 작업에 Beekeeper Studio를 쓰고 있는데, 금세 제가 가장 좋아하는 데이터베이스 도구 중 하나가 됐어요. 인터페이스가 깔끔하고 현대적이며 산만하지 않아서, 다른 도구들처럼 복잡하지 않고 쿼리에 집중하기 쉬워요. - Surendra Singh
Beekeeper Studio는 빠르고 직관적이며 사용하기 쉬운 MySQL 클라이언트예요. 다른 데이터베이스도 많이 지원하고 Windows, Mac, Linux에서 잘 작동해요.
MySQL 사용자들의 Beekeeper Studio 후기
수년간 phpMyAdmin을 쓰다가 이 프로그램을 선택했어요. 한 단계 높은 품질의 세계로 들어선 느낌이었고, 사용자를 진심으로 배려한다는 게 느껴졌어요. 콘셉트, 구현, 실제 사용 경험까지 모든 면에서 Matthew에게 진심으로 감사드려요.
정말 멋진 도구예요. 지금까지 써 본 Postgres와 MySql DB 관리용 IDE 중 가장 실용적이에요. 번거로움 없이 그냥 잘 돼요 :-)