화면: AI, MCP 와 보안

제공자 및 API 키

AI Assistant 는 내가 등록한 API 키로 AI 제공자의 모델을 호출하고, 비용도 등록한 키에서 나갑니다. 마이페이지AI 설정 메뉴에서 키를 등록하고, 응답 언어를 정하고, 사용량을 봅니다. 키가 저장되는 곳과 AI 제공자로 넘어가는 데이터는 AI 와 MCP 에서 설명합니다.

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

마이페이지는 헤더 오른쪽의 사용자 표시를 클릭하고 마이페이지 항목을 클릭해 엽니다. 마이페이지AI 설정 메뉴를 펼치면

마이페이지일반 설정 화면, 마이페이지제공자 및 API 키 화면, 마이페이지사용량 화면이 있습니다. 로그인하지 않아도 세 화면은 잠기지 않습니다. AI Assistant 패널의 키 목록 아래 AI 모델 추가 버튼을 클릭해도 마이페이지제공자 및 API 키 화면이 열리고, 등록한 키가 하나도 없으면 바로 등록 창이 표시됩니다.

화면 구성

번호이름설명
1마이페이지AI 설정 메뉴펼치면 하위 화면 세 개가 보입니다.
2계정 API 키 묶음내 계정에 암호화되어 저장되는 키입니다. 로그인했을 때만 보입니다. 다른 기기와 웹에서도 같은 키를 사용합니다.
3키 카드제공자, 이름, 기본 Key 표시(★), 끝 네 자리만 보이는 키, 편집 버튼과 삭제 버튼이 있습니다. 빈 별(☆)을 클릭한 키가 묶음의 기본 Key가 됩니다. 비활성화해 둔 키에는 비활성 표시가 붙습니다.
4설정키로 호출할 모델, 한 번에 받을 응답 길이의 상한(Max output tokens), 월 예산 항목(계정 API 키 묶음만), 직접 지정한 주소입니다.
5최근 30일 사용량키의 호출 수, 추정 비용, 입력, 출력 토큰입니다. 계정 API 키 묶음의 키에 월 예산이 있으면 이번 달 비용과 예산의 막대가 보입니다.
6이 기기의 API 키 묶음기기에만 저장되는 키입니다. 데스크톱에서만 보입니다. 키 원문은 운영체제의 보안 저장소에 둡니다.
7Key 추가 버튼묶음에 키를 등록하는 창을 엽니다.

환경마다 보이는 묶음과 AI Assistant 에서 선택할 수 있는 키가 다릅니다. 프로젝트 종류와는 상관없습니다.

환경보이는 묶음AI Assistant 에서 선택할 수 있는 키
웹계정 API 키 묶음계정 API 키 묶음. 단 http 주소나 localhost, 사설 IP 주소를 사용하는 키는 빠집니다
데스크톱, 로그인하지 않음이 기기의 API 키이 기기의 API 키
데스크톱, 로그인계정 API 키 묶음과 이 기기의 API 키둘 다
  • 기본 Key는 묶음마다 하나입니다. AI Assistant 는 계정 API 키 묶음의 기본 Key를 먼저 사용하고, 없으면 이 기기의 API 키 묶음의 기본 Key를 사용합니다.
  • 비활성화해 둔 키는 AI Assistant 의 키 목록에 나오지 않습니다.

API 키 등록하기

  1. 키를 둘 묶음의 Key 추가 버튼(7)을 클릭합니다. 묶음에 키가 없으면 가운데의 첫 Provider 추가 버튼을 클릭합니다.
  2. 제공자를 선택하고 API 키를 붙여 넣습니다. 키 칸 아래 링크로 제공자의 키 발급 화면을 열 수 있습니다.
  3. 사용 모델 칸에서 모델을 선택합니다. 목록은 선택한 제공자의 모델입니다. 날짜가 붙은 고정 버전까지 보려면 snapshot 체크 상자를 활성화합니다.
  4. 필요하면 별칭 (선택) 칸, Max output tokens 칸, 월 예산 칸(계정 API 키 묶음만)을 적습니다.
  5. 연결 테스트 버튼으로 키와 주소가 맞는지 확인하고 저장 버튼을 클릭합니다.
번호이름설명
1활성화 스위치비활성화하면 키로 AI 를 호출하지 않습니다. 기본 Key는 비활성화할 수 없습니다.
2기본 Key로 설정 스위치활성화하면 묶음의 기본 Key가 됩니다. 묶음의 첫 키는 자동으로 기본 Key가 됩니다.
3Provider 칸이 기기의 API 키 묶음의 키는 OpenAI, Claude(Anthropic), Gemini(Google), Ollama 가운데 선택합니다. 계정 API 키 묶음의 키는 NeoSQL 서버가 주는 목록에서 선택합니다. 등록한 뒤에는 변경할 수 없습니다.
4사설 endpoint 칸Ollama 는 서버 주소가 필요합니다. 다른 제공자는 사내 게이트웨이나 프록시처럼 기본 주소가 아닌 곳을 거칠 때만 적습니다. 데스크톱 전용 주소를 적으면 칸 옆에 안내가 붙습니다.
5사용 모델 칸AI Assistant 가 키로 호출할 모델입니다. 이 기기의 API 키 묶음의 키와 Ollama 는 목록에 없는 모델 이름도 직접 적을 수 있습니다.
6Max output tokens 칸AI 가 한 번에 만드는 응답 길이의 상한입니다. 너무 작으면 SQL 이 잘리고, 크면 비용과 시간이 늘어납니다. 칸 옆 도움말은 4096 을 권합니다.
  • 편집할 때 API Key 칸을 비워 두면 저장된 키를 그대로 사용합니다. 새 값을 적으면 변경됩니다.
  • 기본 Key는 삭제할 수 없습니다. 다른 키를 기본 Key로 정한 뒤 삭제하세요. 삭제한 키의 지난 사용 기록은 보존됩니다.
  • 월 예산 항목은 미국 달러로 적고, 비우면 제한이 없습니다. 월 추정 비용이 예산을 넘으면 키로 AI 를 호출하지 못합니다. 이 기기의 API 키 묶음의 키에는 예산이 없습니다.

기기나 사내에서 실행하는 모델 사용하기

Ollama 처럼 기기나 사내 서버에서 실행하는 모델도 키로 등록합니다. Ollama 는 Ollama 연결 방식 항목에서 직접 호스팅 항목과 Ollama Cloud 항목 가운데 선택합니다.

  1. Provider 칸에서 Ollama 를 선택하고 Ollama 연결 방식 항목을 직접 호스팅 항목으로 둡니다.
  2. 사설 endpoint 칸에 서버 주소를 적습니다. 기기의 Ollama 는 http://localhost:11434 입니다.
  3. 모델 조회 버튼을 클릭해 서버의 모델 목록을 읽고, 사용 모델 칸에서 선택합니다. 모델 정보 영역을 펼치면 처리 위치 항목, 크기 항목, 최대 컨텍스트 (토큰) 항목이 보입니다.
  4. 서버에 인증이 걸려 있으면 서버 인증 사용 체크 상자를 활성화하고 접근 키를 적은 뒤 저장합니다.

AI 를 호출하는 요청은 데스크톱에서는 기기에서, 웹에서는 NeoSQL 서버에서 나갑니다. 사용할 AI 서버의 주소에 맞는 환경을 선택합니다.

주소사용하는 환경
https 공개 주소웹과 데스크톱
http 주소데스크톱
localhost, 사설 IP(10.x, 192.168.x 등)해당 주소에 접속할 수 있는 기기의 데스크톱 앱
  • http, localhost, 사설 IP 주소도 계정 API 키 묶음에 등록할 수 있습니다. 등록 창에 데스크톱 전용 안내가 붙고, 등록한 키는 데스크톱에서만 모델 조회와 AI 호출에 사용합니다.
  • 직접 호스팅한 Ollama 도 Cloud 모델을 호출할 수 있습니다. 주소만으로 처리 위치가 기기라고 보장되지 않으니 모델 정보 영역의 처리 위치 항목을 확인하세요.
  • AI Assistant 에는 도구 호출을 지원하는 모델을 사용합니다. 지원 여부는 모델 정보 영역에서 확인합니다.
  • Ollama 의 사용량은 토큰과 호출 수로 확인합니다.

응답 언어와 공통 지침

마이페이지일반 설정 화면에서 AI 응답에 함께 적용할 설정을 정합니다.
항목설명
응답 언어 칸자동 항목이면 질문한 언어로 답합니다. 언어를 선택하면 질문의 언어와 상관없이 선택한 언어로 답합니다. SQL 과 식별자는 변경되지 않습니다.
응답 지침 칸모든 응답에 덧붙일 지침입니다. NeoSQL 의 기본 지침 뒤에 붙고, 보안 정책이나 실행 제한, 응답 언어는 변경하지 못합니다.
  • 저장 버튼을 클릭하면 다음 요청부터 적용됩니다.
  • 로그인하면 내 계정에, 로그인하지 않으면 기기에 저장됩니다.

사용량 보기

마이페이지사용량 화면은 최근 30일의 AI 호출을 모아 보여 줍니다.
번호이름설명
1계정 API 키 묶음 사용량계정 API 키 묶음의 활성 키 항목, 30일 호출 항목, 30일 비용 (추정) 항목, 이번 달 산정 비용 항목입니다. 모든 키에 월 예산이 있으면 예산 합계 대비 막대가 보입니다. 로그인했을 때만 보입니다.
2기능별 표기능은 자연어로 SQL 생성, Query Tuning, Sample Data 생성, SQL 오류 질문 항목으로 나뉩니다. 기능마다 호출 열, 입력 열, 캐시 읽기 열, 출력 열, 추론 열, 비용 (추정) 열입니다. 캐시 읽기 열과 추론 열은 입력, 출력 열에 들어가지 않는 별도 값입니다.
3이 기기의 API 키 사용량이 기기의 API 키 묶음의 키로 호출한 30일 호출 항목과 토큰을 모델별로 보여 줍니다. 데스크톱에서만 보입니다. 비용은 계산하지 않습니다.
  • 사용량은 NeoSQL 이 기록한 요청과 응답으로 집계합니다. 비용은 추정이므로 실제 청구액은 제공자의 콘솔에서 확인하세요.
  • MCP 로 외부 AI 가 NeoSQL 을 호출한 것은 NeoSQL 이 모델을 호출하지 않으므로 여기에 기록되지 않습니다.

주의할 점

  • 계정 API 키 묶음의 키는 NeoSQL 서버에 암호화되어 저장되고, 웹과 로그인한 모든 기기에서 사용됩니다. 로그아웃해도 계정에 보존됩니다.
  • 이 기기의 API 키 묶음의 키는 운영체제 보안 저장소에만 있습니다. 다른 기기로 옮겨지지 않고, 웹에서는 사용할 수 없습니다.
  • 운영체제 보안 저장소를 사용할 수 없는 환경(키체인이 없는 Linux 등)에서는 이 기기의 API 키 묶음의 키가 평문으로 저장됩니다. 이때는 저장하기 전에 API 키가 암호화되지 않습니다 확인 창이 표시됩니다.
  • 월 예산 항목은 NeoSQL 이 추정한 비용으로 판단합니다. 제공자의 실제 청구와 다를 수 있으니 제공자 쪽에도 한도를 걸어 두세요.
  • 키를 등록한 묶음은 나중에 변경할 수 없습니다. 계정 API 키 묶음의 키를 이 기기의 API 키 묶음으로 옮기려면 이 기기의 API 키 묶음에 새로 등록하세요.

관련 화면