화면: AI, MCP 와 보안

AI Assistant

AI Assistant 패널은 선택한 DB 스키마를 근거로 AI 에게 질문하고, AI 가 만든 SQL 을 바로 실행하는 대화창입니다. 질문은 내가 등록한 API 키로 AI 제공자에게 갑니다. 무엇이 기기 외부로 나가는지는 AI 와 MCP 에서 먼저 확인하세요.

사용할 수 있는 곳웹데스크톱로그인 없이로그인로컬 프로젝트계정 프로젝트

로그인하지 않으면 로컬 프로젝트에서 이 기기의 API 키 묶음의 키를 사용합니다. 패널은 프로젝트 화면 오른쪽 레일의

프로젝트 레일AI Assistant 버튼으로 열고 닫습니다. `Ctrl+I`(macOS 는 `Cmd+I`)로도 열고 닫을 수 있고, SQL 편집기 안에서도 사용할 수 있습니다.

화면 구성

번호이름설명
1AI 모델 칸대화에 사용할 API 키입니다. 목록에는 [제공자] 이름 으로 보이고, 기본 Key에는 ★ 가 붙습니다. 처음에는 기본 Key가 선택되어 있습니다. 목록 아래의 AI 모델 추가 버튼은 키를 등록하는 화면을 엽니다.
2새 대화 버튼지금 대화를 이력에 남기고 빈 대화를 시작합니다. 응답을 받는 동안에는 클릭할 수 없습니다.
3대화 이력 버튼프로젝트의 지난 대화 목록을 엽니다(아래 '대화 이력').
4고정 버튼클릭하면 패널이 작업 영역을 줄이지 않고 작업 영역 위에 표시되어 고정됩니다. 표시되어 있는 패널은 위쪽 막대를 드래그해 옮기고, 가장자리를 드래그해 크기를 변경합니다.
5도구 활동AI 가 답하기 전에 DB 에서 확인한 것입니다. 테이블 목록 확인, 테이블 정보 확인, 실행 계획 확인, 데이터 조회 같은 줄을 클릭하면 요청과 응답이 펼쳐집니다.
6SQL 카드AI 가 만든 SQL 한 문장입니다. 번호, 문장 종류, 제목과 실행, SQL 편집기 열기, 복사 버튼이 있습니다.
7실행 결과 표시카드의 SQL 을 실행한 결과입니다. 반환한 행 수나 영향을 준 행 수가 함께 보이고, 클릭하면 결과 표가 펼쳐집니다. 표에는 처음 100행까지 보입니다.
8컨텍스트 표시이번 질문에서 AI 가 볼 수 있는 스키마입니다. 마우스를 올리면 커넥션, 데이터베이스, 스키마 전체가 보이고, × 로 제외합니다. 자물쇠 표시는 편집기, ERD 에서 맡긴 일의 대상이라 제외할 수 없습니다.
9Database Schema 선택 버튼컨텍스트를 선택하는 창을 엽니다.
10전송 버튼메시지를 보냅니다. 응답을 받는 동안에는 응답 생성 중지 버튼으로 변경됩니다.
  • 입력란에서 Enter 는 보내기, Shift+Enter 는 줄 바꿈입니다(Enter 전송 · Shift+Enter 줄바꿈 안내). 입력란이 비어 있을 때 ↑, ↓ 를 클릭하면 대화에서 보낸 메시지를 다시 불러옵니다.
  • 등록한 키가 하나도 없으면 빈 대화 자리에 AI 모델 추가 버튼이 보이고, 입력란은 사용할 수 없습니다.

자연어로 SQL 받기

  1. 프로젝트 레일AI Assistant 버튼을 클릭하거나 `Ctrl+I` 를 누릅니다.
  2. AI 모델 칸(1)에서 사용할 키를 선택합니다. 기본 Key로 충분하면 그대로 둡니다.
  3. Database Schema 선택 버튼(9)을 클릭해 질문에 사용할 스키마를 선택하고 적용 버튼을 클릭합니다(아래 '컨텍스트 선택하기').
  4. 입력란에 하고 싶은 일을 적고 Enter 를 누릅니다. 예: "지난달 매출이 가장 많은 상품 5개", "리뷰가 없는 고객 목록".
  5. AI 가 필요한 테이블을 확인한 뒤(5) 설명과 SQL 카드(6)로 답합니다.
  6. 응답이 끝나면 SELECT 카드는 바로 실행되어 결과(7)가 붙습니다. 데이터나 스키마를 변경하는 카드는 아래 표의 조건에 따라 기다리거나 실행됩니다.
  • 컨텍스트를 선택하지 않고 보내면 AI가 참고할 DB를 선택해 주세요 창이 표시됩니다. DB 선택 버튼을 클릭하면 컨텍스트 창이 열리고, 선택한 뒤 다시 보내면 됩니다.
  • 응답을 받는 동안에는 키와 컨텍스트를 변경할 수 없습니다. 멈추려면 응답 생성 중지 버튼을 클릭합니다.
  • AI 에게 함께 보내는 지난 대화는 대화의 최근 메시지 29개까지입니다. 그보다 오래된 내용은 AI 가 보지 못합니다.
  • 응답 언어와 모든 응답에 붙일 공통 지침은 제공자 및 API 키 의 마이페이지일반 설정 화면에서 정합니다.

컨텍스트 선택하기

컨텍스트는 이번 질문에서 AI 가 볼 수 있는 범위의 전부입니다. AI 의 도구는 선택하지 않은 스키마에 접근하지 않습니다.

번호이름설명
1검색 칸커넥션이나 스키마 이름으로 목록을 줄입니다(Connection 또는 Schema 검색).
2전체 선택, 전체 해제 버튼보이는 스키마를 모두 선택하거나 모두 해제합니다.
3커넥션, 데이터베이스, 스키마 목록커넥션이나 데이터베이스의 체크 상자는 아래 항목을 한꺼번에 선택합니다.
4적용 버튼선택한 것을 입력란의 컨텍스트 표시로 옮깁니다. 취소 버튼은 변경한 것을 버립니다.
  • 목록에는 프로젝트 AI 설정 에서 사용 항목을 활성화한 커넥션의, 커넥션 설정에서 선택한 스키마만 나옵니다. 비활성화한 커넥션과 DB 접속 정보가 없는 설계 전용 커넥션은 나오지 않습니다. 선택할 것이 없으면 사용 가능한 Schema가 없습니다. 안내가 보입니다.
  • 새 대화는 프로젝트 AI 설정에서 기본 항목으로 정한 스키마를 미리 선택해 둡니다. 정한 것이 없으면 빈 채로 시작합니다.

SQL 카드 실행

응답이 끝나면 NeoSQL 은 카드를 위에서부터 차례로 살펴 아래 조건에 맞는 카드를 실행합니다. 실행하지 않은 카드는 실행 버튼으로 직접 실행합니다.

문장응답이 끝났을 때실행 버튼을 클릭하면
SELECT바로 실행합니다다시 실행합니다
INSERT, UPDATE, DELETE 같은 데이터 변경커넥션의 데이터 변경 항목이 활성화되어 있으면 실행하고, 비활성화되어 있으면(기본) 기다립니다실행 확인 창에서 실행 버튼을 클릭하면 실행합니다. 창의 SQL 보기 버튼으로 전체 SQL 을 볼 수 있습니다
CREATE, ALTER, DROP 같은 스키마 변경스키마 변경 항목이 활성화되어 있으면 실행하고, 비활성화되어 있으면(기본) 기다립니다실행 확인 창에서 실행 버튼을 클릭하면 실행합니다
종류를 알 수 없는 문장실행하지 않습니다실행하지 않습니다
  • 위 표보다 커넥션의 보호 모드 항목이 먼저입니다. 읽기 전용 (SELECT 외 차단) 항목이면 SELECT 가 아닌 문장은 실행하지 않고, 확인 (DDL + 위험 DML) 항목이면 정책과 상관없이 실행 전에 확인합니다. 계정 프로젝트에서 DDL 제한 권한이 걸린 사용자는 스키마 변경을 실행할 수 없습니다.
  • 카드의 SQL 은 카드에 적힌 커넥션, 데이터베이스, 스키마에서 자동 커밋으로 실행합니다. SQL 편집기 탭의 트랜잭션과 상관없이 바로 반영되므로 되돌릴 수 없습니다.
  • 실행 결과는 패널에만 남고 AI 제공자로 보내지 않습니다. 실행한 SQL 은 SQL 이력과 저장된 SQL 에 AI 가 실행한 것으로 남습니다.
  • SQL 편집기 열기 버튼은 카드의 SQL 을 담은 새 SQL 문서를 같은 커넥션, 스키마로 만들어 엽니다. 수정해서 실행하거나 보관할 때 사용합니다.

실제 데이터 조회 승인

AI 가 답을 만들려고 실제 행의 값을 읽어야 할 때, 커넥션의 데이터 전송 허용 항목이 비활성화되어 있으면 대화에 승인 카드가 표시됩니다. 새 커넥션에서는 기본으로 활성화되어 있으므로, 처음에는 카드 없이 조회합니다.

번호이름설명
1조회 SQLAI 가 실행하려는 SELECT 한 문장입니다. 승인하면 결과가 AI 제공자로 갑니다.
2이후 조회 자동 승인 체크 상자활성화하고 승인하면 프로젝트를 열어 둔 동안 다음 조회부터 카드 없이 승인합니다. 저장되지 않아 프로젝트를 다시 열면 다시 묻습니다.
3승인, 거절 버튼거절하면 응답 만들기가 멈춥니다. 새 메시지를 보내 대화를 이어 갈 수 있습니다.
  • AI 가 직접 실행하는 조회는 읽기 전용 SELECT 한 문장, 최대 10행, 30초 제한입니다.
  • 계정 프로젝트에서 이후 조회 자동 승인 체크 상자는 프로젝트 소유자에게 보이고, 소유자가 아닌 멤버에게는 프로젝트 AI 설정의 프로젝트 비소유자의 데이터 전송 지속 승인을 허용 항목이 활성화되어 있을 때만 보입니다.

HTML 응답 열기

보고서나 차트처럼 화면으로 보는 결과를 요청하면 AI 가 HTML 문서로 답하기도 합니다. 응답에는 문서 제목과 HTML 열기 버튼이 보입니다.

  1. 응답의 HTML 열기 버튼을 클릭합니다. 작업 영역에 문서 탭HTML 미리보기 탭이 열립니다.
  2. 탭 위에 마우스를 올리면 오른쪽 위에 버튼이 나타납니다. 브라우저에서 열기 버튼(1), HTML 다운로드 버튼(2), 인쇄 버튼(3)이 있습니다.
  • 미리보기는 격리된 틀 안에서 그립니다. 문서의 스크립트는 실행되지만 외부 파일을 읽거나 네트워크로 통신하지 못합니다.
  • 브라우저에서 열기 버튼은 데스크톱에서는 운영체제의 기본 HTML 앱으로, 웹에서는 브라우저의 새 탭으로 엽니다.
  • HTML 탭은 저장되지 않습니다. 남겨 두려면 HTML 다운로드 버튼으로 파일을 받으세요.

ERD 로 테이블 설계하기

"주문 반품을 관리할 테이블을 ERD 에 설계해 줘" 처럼 ERD 에 만들어 달라고 분명히 요청하면, AI 는 SQL 대신 ERD 도구를 사용합니다. 도구 활동에 ERD 테이블 생성 줄이나 ERD 테이블 수정 줄이 남습니다.

  • 결과는 대화와 커넥션, 스키마마다 새로 만드는 ERD 에 저장되고, ERD 가 열립니다. 같은 대화에서 다시 요청하면 같은 ERD 에 더합니다.
  • ERD 도구는 DB 를 변경하지 않습니다. 검토한 뒤 DB 반영 으로 실제 DB 에 만드세요.
  • ERD 에 만들지 DB 에 만들지 분명하지 않으면 AI 가 되묻습니다.

대화 이력

패널 위쪽의 대화 이력 버튼을 클릭하면 패널이 프로젝트의 지난 대화 목록으로 변경됩니다. 대화마다 제목과 마지막 활동 시각이 보입니다.

  • 두 번 클릭하거나 Enter 를 누르면 대화를 엽니다.
  • Ctrl(macOS 는 Cmd)을 누른 채 클릭하면 여러 개를, Shift 를 누른 채 클릭하면 범위를 선택합니다.
  • 우클릭하면 이름 변경 항목과 대화 삭제 항목이 있습니다. 삭제는 되돌릴 수 없습니다.
  • 대화는 계정 프로젝트면 내 계정(NeoSQL 서버)에, 로컬 프로젝트면 기기에 저장됩니다.

주의할 점

  • SELECT 카드는 응답이 끝나자마자 DB 에서 실행됩니다. 큰 테이블을 훑는 SELECT 도 그대로 실행되므로, 운영 DB 의 커넥션에서는 보호 모드 항목을 사용하거나 권한이 좁은 DB 계정으로 연결하세요(운영 DB 안전장치).
  • AI 가 실행한 SQL 은 자동 커밋입니다. 데이터 변경 항목과 스키마 변경 항목을 활성화하면 변경 SQL 도 확인 없이 바로 반영됩니다.
  • 데이터 전송 허용 항목은 새 커넥션에서 활성화되어 있습니다. 실제 행의 값이 AI 제공자로 가는 것을 매번 확인하려면 프로젝트 AI 설정 에서 비활성화하세요.
  • 질문에 비밀번호, 토큰, 개인정보를 직접 적지 마세요. 질문과 지난 대화는 그대로 AI 제공자로 갑니다.
  • 웹에서는 http 주소나 localhost, 사설 IP 주소를 사용하는 키가 AI 모델 칸에 나오지 않습니다. 데스크톱에서만 사용하는 키입니다.

관련 화면