AI 설정 창은 프로젝트의 커넥션마다 AI 를 어디까지 허용할지 정하는 표입니다. NeoSQL 안의 AI Assistant 와 외부 AI 가 호출하는 MCP 가 표를 함께 따릅니다. 두 기능의 차이는 AI 와 MCP 에서 설명합니다.
사용할 수 있는 곳웹데스크톱로그인 없이로그인로컬 프로젝트계정 프로젝트
프로젝트 화면 위쪽의 AI 설정 버튼을 클릭하면 열립니다. 로컬 프로젝트에서는 기기에 저장하고, 계정 프로젝트에서는 NeoSQL 서버에 저장해 프로젝트 멤버가 함께 따릅니다.
화면 구성
| 번호 | 이름 | 설명 |
|---|---|---|
| 1 | 프로젝트 및 공개 Connection 영역 | 프로젝트 정책과 공개 커넥션의 정책입니다. 계정 프로젝트에서는 프로젝트 소유자만 변경할 수 있고, 다른 멤버에게는 프로젝트 Owner만 공개 Connection의 AI 설정을 변경할 수 있습니다. 안내가 보입니다. 로컬 프로젝트에서는 공개, 개인 구분이 없어 이 자리에 Connection 영역이 보이고, 모든 커넥션이 여기에 있습니다. |
| 2 | 프로젝트 비소유자의 데이터 전송 지속 승인을 허용 항목 | 활성화하면 소유자가 아닌 멤버도 데이터 조회 승인 카드에서 이후 조회 자동 승인 항목을 사용할 수 있습니다. 계정 프로젝트에만 있습니다. |
| 3 | 사용 열 | 커넥션을 AI 에 사용할지 정합니다. 비활성화하면 AI Assistant 의 컨텍스트로 선택할 수 없고, MCP 도 커넥션을 대상으로 한 호출을 거절합니다. 커넥션 설정에서 선택한 스키마가 없으면 활성화할 수 없습니다. |
| 4 | 기본 열 | 체크하고 옆 목록에서 데이터베이스와 스키마를 선택하면, 새 대화가 선택한 스키마를 컨텍스트로 선택해 둔 채 시작합니다. MCP 도구가 대상을 적지 않았을 때도 정한 스키마를 사용합니다. 공개 커넥션과 개인 커넥션에 하나씩만 정할 수 있고, 공개 쪽이 먼저입니다. |
| 5 | 스키마 변경 열 | 활성화하면 AI 가 만든 CREATE, ALTER, DROP 같은 문장을 확인 없이 실행합니다. 비활성화하면 실행 전에 확인합니다. |
| 6 | 데이터 변경 열 | 활성화하면 AI 가 만든 INSERT, UPDATE, DELETE 같은 문장을 확인 없이 실행합니다. MCP 에서는 자동 커밋 여부를 정합니다. |
| 7 | 데이터 전송 허용 열 | 활성화하면 AI 가 답을 만들려고 실제 행을 조회할 때 승인 카드 없이 조회하고, 결과를 AI 제공자로 보냅니다. 비활성화하면 조회마다 승인 카드가 표시됩니다. |
| 8 | 민감정보 항상 마스킹 열 | 활성화하면 AI 와 MCP 로 보내는 결과에서 민감정보로 지정한 컬럼을 사용자의 역할과 상관없이 마스킹합니다. 비활성화하면 사용자의 역할에 따라 마스킹합니다. 로컬 프로젝트에서는 사용할 수 없습니다. |
| 9 | 개인 Connection 영역 | 내가 소유한 개인 커넥션의 정책입니다. 소유자가 아니어도 변경할 수 있습니다. 개인 커넥션이 없으면 보이지 않습니다. |
| 10 | MCP 클라이언트 설정 버튼 | 외부 AI 클라이언트에 NeoSQL MCP 를 등록하는 창을 엽니다. 데스크톱에만 있습니다. |
| 11 | 저장 버튼 | 변경한 것을 저장합니다. 아직 변경한 것이 없으면 흐리게 보이고, 변경할 수 있는 것이 하나도 없으면 보이지 않습니다. |
- 표의 열 머리에 마우스를 올리면 각 정책의 설명이 보입니다.
- 설계 전용 표시가 붙은 커넥션은 DB 접속 정보 없이 DBMS 만 선택한 커넥션입니다. 외부 MCP 의 ERD 설계 도구에서만 사용되고, AI Assistant 와 쿼리 실행에는 사용되지 않습니다. 그래서 실행 정책 칸은 사용할 수 없습니다.
- 사용 항목을 비활성화하면 같은 줄의 다른 정책 칸도 변경할 수 없습니다.
처음 값
커넥션을 만들면 정책이 아래 값으로 함께 만들어집니다.
| 정책 | 처음 값 |
|---|---|
| 사용 | 활성화 |
| 기본 | 정하지 않음 |
| 스키마 변경 | 비활성화 |
| 데이터 변경 | 비활성화 |
| 데이터 전송 허용 | 활성화 |
| 민감정보 항상 마스킹 | 계정 프로젝트는 활성화. 로컬 프로젝트는 사용하지 않음 |
| 프로젝트 비소유자의 데이터 전송 지속 승인을 허용 | 활성화(계정 프로젝트) |
- 처음에는 AI 가 실제 행의 값을 묻지 않고 조회해 AI 제공자로 보냅니다. 매번 확인하려면 데이터 전송 허용 항목을 비활성화하세요.
커넥션의 AI 정책 변경하기
- 프로젝트 화면 위쪽의 AI 설정 버튼을 클릭합니다.
- 변경할 커넥션 줄에서 칸을 활성화하거나 비활성화합니다. 새 대화의 기본 컨텍스트를 정하려면 기본 칸(4)을 체크하고 옆 목록에서 스키마를 선택합니다.
- 저장 버튼(11)을 클릭합니다. 저장하면 창이 닫히고, 다음 요청부터 적용됩니다.
- 저장하지 않고 닫으려 하면 저장하지 않은 변경사항 창이 표시됩니다.
- 계정 프로젝트에서 공개 영역과 개인 영역은 따로 저장됩니다. 한쪽만 저장되면 일부 설정만 저장했습니다. 저장하지 못한 변경사항은 그대로 유지됩니다. 안내가 보이고, 저장하지 못한 변경은 창에 남습니다.
- 창을 연 사이에 권한이나 커넥션 목록이 변경되면 저장하지 못하고 프로젝트를 새로고침하라는 안내가 보입니다.
- 기본 항목을 정한 커넥션의 사용 항목을 비활성화하면 기본도 함께 해제됩니다. 묻지 않습니다.
- 기본은 영역마다 하나입니다. 다른 커넥션의 기본 칸을 체크하면 같은 영역의 앞선 기본이 해제됩니다.
누가 변경할 수 있나
| 프로젝트 | 공개 커넥션과 프로젝트 정책 | 개인 커넥션 |
|---|---|---|
| 로컬 프로젝트 | 기기의 사용자 | 구분하지 않습니다(모두 공개 영역) |
| 계정 프로젝트 | 프로젝트 소유자만. NeoSQL 서버도 소유자가 아니면 저장을 거절합니다 | 커넥션의 소유자. 다른 사람의 개인 커넥션은 보이지 않습니다 |
- 계정 프로젝트에 공개 커넥션이 하나라도 있으면 개인 커넥션의 기본 칸은 변경할 수 없습니다. 공개 커넥션의 기본이 먼저이기 때문입니다.
정책이 함께 따르는 것
AI 설정 표의 정책만으로 실행이 정해지지 않습니다. 아래가 표보다 먼저입니다.
- 커넥션의 보호 모드 항목이 읽기 전용 (SELECT 외 차단) 항목이면 AI 는 SELECT 가 아닌 문장을 실행하지 않고, 확인 (DDL + 위험 DML) 항목이면 스키마 변경 항목이나 데이터 변경 항목이 활성화되어 있어도 실행 전에 확인합니다(커넥션 프로파일).
- 계정 프로젝트에서 DDL 제한 권한이 걸린 사용자는 AI 로도 스키마 변경을 실행하지 못합니다.
- 계정 프로젝트의 민감정보 마스킹은 역할별 권한 탭에서 지정한 민감 컬럼을 기준으로 합니다(컬럼 마스킹). 민감정보 항상 마스킹 항목은 마스킹을 역할과 상관없이 AI, MCP 전송에 항상 적용할지만 정합니다.
주의할 점
- AI 설정 표는 MCP 에도 적용됩니다. AI Assistant 를 위해 스키마 변경 항목을 활성화하면 외부 AI 가 MCP 로 보낸 DDL 도 확인 없이 실행됩니다.
- 운영 DB 의 커넥션에서는 스키마 변경 항목과 데이터 변경 항목을 활성화하지 마세요. AI 가 실행한 SQL 은 자동 커밋이라 되돌릴 수 없습니다.
- 데이터 전송 허용 항목이 활성화되어 있으면 AI 가 조회한 실제 행(한 번에 최대 10행)이 묻지 않고 AI 제공자로 갑니다. 개인정보가 있는 DB 라면 비활성화하거나 사용 항목을 비활성화하세요.
- 로컬 프로젝트에는 마스킹이 없습니다. 민감한 값이 있는 DB 는 로컬 프로젝트에서 AI 에 연결하지 않는 편이 안전합니다.
관련 화면
- AI Assistant: 정책에 따라 컨텍스트를 선택하고 SQL 카드를 실행하는 패널입니다.
- AI 와 MCP: AI Assistant 와 MCP 가 정책을 각각 어떻게 사용하는지 표로 정리했습니다.
- MCP 클라이언트 설정: MCP 클라이언트 설정 버튼이 여는 창입니다.
- 컬럼 마스킹: 계정 프로젝트에서 민감 컬럼을 지정합니다.
- 커넥션 프로파일: 커넥션의 보호 모드 항목으로 AI 의 실행을 차단하거나 확인하게 합니다.