화면: AI, MCP 와 보안

프로젝트 AI 설정

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 영역내가 소유한 개인 커넥션의 정책입니다. 소유자가 아니어도 변경할 수 있습니다. 개인 커넥션이 없으면 보이지 않습니다.
10MCP 클라이언트 설정 버튼외부 AI 클라이언트에 NeoSQL MCP 를 등록하는 창을 엽니다. 데스크톱에만 있습니다.
11저장 버튼변경한 것을 저장합니다. 아직 변경한 것이 없으면 흐리게 보이고, 변경할 수 있는 것이 하나도 없으면 보이지 않습니다.
  • 표의 열 머리에 마우스를 올리면 각 정책의 설명이 보입니다.
  • 설계 전용 표시가 붙은 커넥션은 DB 접속 정보 없이 DBMS 만 선택한 커넥션입니다. 외부 MCP 의 ERD 설계 도구에서만 사용되고, AI Assistant 와 쿼리 실행에는 사용되지 않습니다. 그래서 실행 정책 칸은 사용할 수 없습니다.
  • 사용 항목을 비활성화하면 같은 줄의 다른 정책 칸도 변경할 수 없습니다.

처음 값

커넥션을 만들면 정책이 아래 값으로 함께 만들어집니다.

정책처음 값
사용활성화
기본정하지 않음
스키마 변경비활성화
데이터 변경비활성화
데이터 전송 허용활성화
민감정보 항상 마스킹계정 프로젝트는 활성화. 로컬 프로젝트는 사용하지 않음
프로젝트 비소유자의 데이터 전송 지속 승인을 허용활성화(계정 프로젝트)
  • 처음에는 AI 가 실제 행의 값을 묻지 않고 조회해 AI 제공자로 보냅니다. 매번 확인하려면 데이터 전송 허용 항목을 비활성화하세요.

커넥션의 AI 정책 변경하기

  1. 프로젝트 화면 위쪽의 AI 설정 버튼을 클릭합니다.
  2. 변경할 커넥션 줄에서 칸을 활성화하거나 비활성화합니다. 새 대화의 기본 컨텍스트를 정하려면 기본 칸(4)을 체크하고 옆 목록에서 스키마를 선택합니다.
  3. 저장 버튼(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 의 실행을 차단하거나 확인하게 합니다.