외부 AI 클라이언트(예: Claude Code)와 대화하며 데모 상점에 찜 목록 테이블을 설계하고 DB 에 반영하는 순서를 따라 합니다. 끝나면 customer 와 product 를 참조하는 wishlist 테이블이 ERD 와 DB 에 함께 있습니다. 외부 AI 는 NeoSQL 을 도구로 불러 스키마를 읽고 ERD 를 수정하지만, DB 에 반영하는 단계는 NeoSQL 화면에서 직접 확인합니다. MCP 가 무엇이고 어떤 안전장치가 걸리는지는 AI 와 MCP 에서 설명합니다.
사용할 수 있는 곳웹데스크톱로그인 없이로그인로컬 프로젝트계정 프로젝트
준비
- 데스크톱 앱이 필요합니다. MCP 서버는 같은 기기의 데스크톱 앱에 요청을 넘깁니다. MCP 는 데스크톱 앱에서 사용합니다. 로그인하지 않았으면 로컬 프로젝트만 다룹니다.
- 외부 AI 클라이언트를 실행하는 기기에 Node.js 20 이상이 있어야 합니다. 클라이언트가
npx로 NeoSQL MCP 서버를 실행하기 때문입니다. - 데모 상점의
shop-db커넥션이 있는 프로젝트를 엽니다. ERD 설계만 하려면 DB 접속 정보가 없는 커넥션으로도 가능합니다. DB 에 반영하려면 접속 정보가 있어야 합니다. - 반영할 DB 는 운영 DB 가 아닌 개발 DB 로 하세요. 운영 DB 라면 먼저 운영 DB 를 안전하게 연결하기 의 순서로 장치를 거세요.
커넥션 정책을 정하고 클라이언트에 등록하기
외부 AI 가 어느 커넥션을 사용하고 무엇을 변경할 수 있는지를 먼저 정한 뒤 클라이언트에 등록합니다. 등록이 끝나면 클라이언트는 바로 도구를 호출할 수 있기 때문입니다.
- 프로젝트 화면 위쪽의 AI 설정 버튼을 클릭합니다.
shop-db의 사용 항목(1)을 활성화하고 기본 항목(2)을 선택합니다. 결과: 외부 AI 가 대상을 적지 않고 도구를 호출하면 기본으로 선택한 커넥션을 사용합니다. 사용 항목이 비활성화된 커넥션은 외부 AI 에게 보이지 않습니다. - 스키마 변경 항목(3)은 비활성화해 둔 채 저장 버튼을 클릭합니다. 결과: 외부 AI 가 DDL 을 실행하려 하면 NeoSQL 에 확인 창이 표시됩니다. ERD 를 수정하는 도구는 스키마 변경 항목과 상관없이 DB 를 변경하지 않습니다.
- 창이 닫히면 AI 설정 버튼을 다시 클릭하고, 표 아래의 MCP 클라이언트 설정 버튼(7)을 클릭합니다. 결과: MCP 클라이언트 설정 창이 열립니다.
- 설정 범위 칸(1)에서 전역 항목을 선택하고, 사용하는 클라이언트(4)를 선택합니다. 결과: 선택한 클라이언트의 전역 설정 파일에 넣을 내용이 미리보기에 보입니다. 계정이나 DB 의 비밀번호는 들어가지 않습니다.
- 전역 등록 버튼(6)을 클릭하고, 확인 창에서 수정할 파일의 경로와 내용을 확인한 뒤 버튼을 클릭합니다. 결과: 설정 파일에 NeoSQL 항목만 더해지고 다른 설정은 그대로 보존됩니다. 작업 폴더에만 두는 방법은 MCP 클라이언트 설정 에서 설명합니다.
연결 확인하기
- 외부 AI 클라이언트를 다시 시작하고, MCP 서버 목록에
neosql이 연결되어 있는지 확인합니다(Claude Code 는/mcp). 결과: 클라이언트가 NeoSQL MCP 서버를 실행했습니다. 아직 데스크톱 앱까지 연결됐는지는 모릅니다. - 대화창에서 "NeoSQL 의
shop-db에 있는 테이블 목록을 보여 줘" 라고 요청합니다. 결과: 클라이언트가list-tables도구를 호출하고customer,orders,product같은 테이블 이름을 받습니다. 데스크톱 앱까지 연결된 것입니다.
- 데스크톱 앱이 종료되어 있으면 MCP 서버가 앱을 띄우고 준비될 때까지 기다립니다. 실패하면 앱을 직접 실행한 뒤 다시 요청하세요.
- 연결되지 않을 때 볼 곳은 MCP 클라이언트 설정 의 '주의할 점' 에 있습니다.
대화로 테이블 만들기
- 대화창에서 원하는 테이블을 설명합니다. 예: "
shop-db에 고객의 찜 목록을 담는wishlist테이블을 설계해 줘.customer와product를 참조하고, 같은 고객이 같은 상품을 두 번 담지 못하게 하고, 담은 시각을 기록해 줘." 결과: 외부 AI 가get-table-details로customer와product의 키와 타입을 먼저 읽고, 그에 맞춰 컬럼과 외래 키를 정합니다. - 외부 AI 가
erd-create-tables도구를 호출하면, 클라이언트의 도구 승인 창에서 넘길 테이블 정의를 확인하고 승인합니다. 결과: NeoSQL 에MCP:로 시작하는 ERD 탭이 열리고wishlist테이블이 이름이 초록색인 새 테이블로 보입니다. ERD 에는 만든 테이블만 들어가므로 아직 관계선은 없습니다. 탐색기에도 새 테이블이 나타납니다. - 관계를 함께 보려면 탐색기에서
customer와product를 우클릭하고 메뉴를 선택합니다. 결과: 두 테이블이MCP:ERD 에 놓이고wishlist와 관계선으로 이어집니다.
- 여기까지 DB 는 변경되지 않았습니다.
wishlist는 ERD 와 프로젝트의 설계에만 있고, 아직 DB 에 반영하지 않은 변경으로 표시됩니다 (ERD 와 실제 DB). MCP:ERD 는 MCP 세션과 커넥션, 스키마마다 하나씩 생깁니다. 같은 대화에서 테이블을 더 만들면 같은 ERD 에 더해집니다.- 여러 테이블을 한 번에 요청해도 됩니다. 이미 있는 이름의 테이블은 건너뜁니다.
검토하고 수정하기
외부 AI 의 설계는 반영하기 전에 사람이 읽어야 합니다. DB 에 반영한 뒤의 변경은 데이터가 있는 테이블을 수정하는 일이 되어 더 어렵기 때문입니다.
- NeoSQL 의
MCP:ERD 에서wishlist테이블을 클릭해 상세 패널을 엽니다. 컬럼 타입, NULL 허용, 기본 키, 외래 키, 유니크 인덱스를 확인합니다. 결과: 패널의 항목은 테이블 상세 패널 에서 설명합니다. - 수정할 것이 있으면 대화창에서 요청합니다. 예: "
wishlist에note컬럼을 200자 문자열로 더하고,created_at은added_at으로 이름을 변경해 줘." 결과: 외부 AI 가erd-modify-tables도구로 같은 ERD 를 수정합니다. 변경된 컬럼은 변경 표시로 보입니다. DB 는 이때도 변경되지 않습니다. - 작은 수정은 NeoSQL 의 상세 패널에서 직접 수정하고 저장해도 됩니다. 결과: 외부 AI 가 다음에
get-table-details로 읽을 때 직접 수정한 설계를 봅니다. - 설계의 근거를 데이터로 확인하려면 조회를 요청합니다. 예: "같은 고객이 같은 상품을 여러 번 주문한 경우가 있는지
orders와order_item으로 세어 줘." 결과: 외부 AI 가execute-query로SELECT를 실행하고 결과를 받습니다. SQL 은 NeoSQL 의MCP:SQL 편집기 탭에 남고, 결과는 최대 200행까지 돌려줍니다.
- 조회 결과는 외부 클라이언트를 거쳐 클라이언트가 사용하는 모델 제공자로 갈 수 있습니다. 개인정보가 있는 테이블을 조회하게 할 때는 조심하세요.
DB 에 반영하기
반영하는 길은 둘입니다. NeoSQL 화면에서 반영하면 실행할 DDL 을 모두 보고 선택할 수 있어 권하는 길입니다.
- NeoSQL 의
MCP:ERD 정보 패널에서 변경사항 DB 반영... 버튼을 클릭합니다. 결과: ERD 에서 반영하지 않은 변경이 있는 테이블이 목록(3)에 들어오고, 실행할 DDL 이 미리보기(4)에 보입니다. - DDL 을 끝까지 읽고 DDL 실행 버튼(6)을 클릭한 뒤 확인합니다. 결과:
wishlist가 DB 에 만들어지고, NeoSQL 이 DB 에서 다시 읽어 변경 표시가 사라집니다. 창의 옵션은 DB 반영 에서 설명합니다. - 외부 AI 에게 "방금 반영한
wishlist의 구조를 다시 읽어 처음 요청과 맞는지 확인해 줘" 라고 요청합니다. 결과: 외부 AI 가get-table-details로 DB 에서 다시 읽은 구조를 받아 요청과 비교합니다.
다른 길은 외부 AI 가 execute-query 로 DDL 을 직접 보내는 것입니다. 요청은 NeoSQL 의 실행 확인 절차를 거칩니다.
| 조건 | 결과 |
|---|---|
| 계정 프로젝트에서 DDL 제한 권한이 걸린 사용자 | 거절합니다. NeoSQL 화면에서 승인을 요청하세요(DDL 승인) |
| 커넥션 보호 모드가 읽기 전용 (SELECT 외 차단) 항목 | 거절합니다 |
| 보호 모드가 확인 (DDL + 위험 DML) 항목이거나 스키마 변경 항목이 비활성화 | NeoSQL 에 확인 창을 띄우고, 실행을 클릭해야 실행합니다. 45초 안에 답이 없으면 실행하지 않습니다 |
| 그 밖 | 바로 실행합니다 |
- 확인 창은 NeoSQL 화면에 표시됩니다. 외부 AI 에게 실행을 맡길 때는 NeoSQL 창을 볼 수 있는 곳에 두세요.
- 거절되면 외부 AI 는 실행되지 않았다는 것과 다시 시도하지 말라는 안내를 받고, NeoSQL 화면에도 MCP 실행 요청 거절됨 알림이 표시됩니다.
- 이 길은 NeoSQL 의 DB 반영 창을 거치지 않습니다. 반영한 뒤 ERD 에 변경 표시가 남아 있는지 확인하세요.
다음에 할 일
- MCP 도구: 도구마다 받는 값과 돌려주는 값을 봅니다.
- AI 와 MCP: 외부 AI 에게 넘어가는 데이터와 커넥션 정책을 정리합니다.
- 운영 DB 를 안전하게 연결하기: 운영 DB 커넥션의 보호 모드와 AI 정책을 겁니다.
- 팀과 함께 설계하기: 계정 프로젝트에서 외부 AI 로 만든 설계를 팀 ERD 와 DDL 승인으로 넘깁니다.