커넥터 업데이트 이력

사내망에 설치된 Connector 도커 이미지 의 버전별 변경 사항입니다.
새 버전 사용을 위해선 이미지 재설치 가 필요합니다 (설치 절차: Connector 설치 가이드 — "재설치 · 업데이트" 절).

이미지 pull: ghcr.io/chain-partners/mcp-hub-connector:<버전> (누구나 pull 가능한 공개 이미지)
서비스(Studio · Hub) 자체의 업데이트 이력은 → 제품 업데이트 이력 참고

v0.2.23 (2026-10-20) — 파수 FED 문서 보안

파수 FED 로 보호된 문서를 웍스AI 에서 열 수 있습니다. 문서 보안 도입 문의를 주신 회사에 열어 드리며, 커넥터 서버에 파수 사이드카를 함께 설치합니다 — 파수 FED 연결 가이드
접속 정보 · 툴킷 · secrets 는 그대로입니다.

v0.2.22 (2026-10-16) — Microsoft Fabric · Azure SQL 연결

Microsoft Fabric 과 Azure SQL 에 Entra 앱으로 연결하실 수 있습니다. 툴킷 만들기의 데이터베이스 종류에서 「Microsoft Fabric / Azure SQL」 을 고르시면 됩니다. 이 버전이 필요합니다.
- Microsoft Entra 에 앱을 등록하고, Fabric 워크스페이스에 그 앱을 뷰어로 추가해 주세요. 커넥터에서 login.microsoftonline.com(443) 으로 나갈 수 있어야 합니다 — DB 연동 가이드 3-7
- 워크스페이스 역할은 그 워크스페이스의 모든 Lakehouse · Warehouse 를 엽니다. AI 에게 보여도 되는 것만 담은 워크스페이스에 앱을 추가해 주세요.
- 접속 주소에 ?authentication=… 을 붙여 만드신 툴킷은 연결되지 않습니다. 새로 만들어 주시고, 그때 접속 주소에 client secret 값을 그대로 넣으셨다면 그 secret 은 폐기하고 새로 발급해 주세요.
SQL Server 조회 결과의 100행 상한을 커넥터가 직접 지킵니다. Fabric 처럼 상한 명령을 무시하는 데이터베이스에서도 100행에서 멈춥니다. 기존 SQL Server 의 조회 결과는 같습니다.
- 이 버전으로 올린 뒤 SQL Server 조회에 문제가 보이면 이전 버전(0.2.21) 이미지로 다시 설치해 주시고 알려 주세요.
Fabric 에서 부서별 데이터 열람 권한은 SQL database 에서만 쓰실 수 있습니다. SQL database 는 그 안에 앱 사용자를 만들고 실행 계획을 볼 권한(GRANT SHOWPLAN)을 주셔야 합니다. Lakehouse · Warehouse 의 표를 제한하시면 그 툴킷의 조회가 모두 실행되지 않습니다 — 데이터 열람 권한 가이드
문서 보안(AIP 게이트웨이) 연결 확인이 실패 원인을 알려 드립니다. 지금까지는 게이트웨이가 거절하면 「시험 파일을 처리하지 못했습니다」 로만 보였는데, 이제 라이선스 · 시스템 ID · 공유 폴더 계정 · 공유 폴더 권한 · 공유 폴더 경로 중 무엇이 문제인지 짚어 드립니다. 게이트웨이의 오류 문구 원문은 커넥터 밖으로 보내지 않습니다.
접속 정보 · 툴킷 · secrets 는 그대로입니다. Fabric · Azure SQL 을 쓰지 않으시면 할 일이 없습니다.

v0.2.21 (2026-10-14) — 부서별 데이터 열람 권한

부서별로 볼 수 있는 표를 정하실 수 있습니다. [설정 › 데이터 열람 권한] 에서 제한한 표는, 볼 수 없는 부서의 사람이 조회하면 커넥터가 실행하기 전에 데이터베이스에 실행 계획을 물어 확인하고 거절합니다. 표의 값은 회사 밖으로 나가지 않습니다.
- 표를 제한하시려면 이 버전이 필요합니다. 그 전 커넥터를 쓰는 툴킷의 표를 제한하시면, 부서가 막히는 사람의 조회는 커넥터를 올려 달라는 안내와 함께 실행되지 않습니다.
- SQL Server 는 조회 계정에 GRANT SHOWPLAN TO <조회 계정> 이 필요합니다. 뷰·별칭을 거쳐 조회하려면 VIEW DEFINITION 도 필요합니다. MySQL · MariaDB 는 뷰를 거쳐 조회하려면 SHOW VIEW 가 필요합니다 — 데이터 열람 권한 가이드
- 제한을 정하지 않으시면 아무것도 바뀌지 않습니다. 실행 계획을 묻는 것도 제한한 표가 있는 툴킷에서만 합니다.
- 완전한 차단은 데이터베이스 계정 권한으로 해주세요 — 이 기능은 그 위의 편의 장치입니다.
v0.2.20 에서 개선했습니다 — 뷰만 조회할 수 있게 해 둔 조회 계정에서, 뷰를 거치는 조회가 판단되지 않아 제한과 상관없는 조회까지 실행되지 않던 것을 고쳤습니다. 표를 제한하고 계시면 이 버전으로 올려 주세요.
MariaDB 도 표를 제한하실 수 있습니다. v0.2.20 에서는 지원하지 않았습니다.
뷰를 거쳐 조회하신다면 뷰 정의를 볼 권한을 스키마 단위로 주세요 — MySQL · MariaDB 는 GRANT SHOW VIEW ON <스키마>.*, SQL Server 는 GRANT VIEW DEFINITION ON SCHEMA::<스키마>. 뷰마다 따로 주셨거나 뷰가 다른 스키마를 읽는데 그 스키마에 권한이 없으면, 그 뷰를 거치는 조회는 판단할 수 없어 실행되지 않습니다.
- 뷰마다 따로 주신 계정은 제한과 상관없는 뷰 조회도 실행되지 않습니다. 스키마 단위로 바꿔 주세요.
- 제한 대상으로 고르신 뷰가 이런 뷰라면, 그 데이터베이스 툴킷의 조회가 모두 실행되지 않습니다. 제한하시기 전에 권한을 먼저 맞춰 주세요.
접속 정보 · 툴킷 · secrets 는 그대로입니다.

v0.2.20 (2026-10-13) — 부서별 데이터 열람 권한

부서별로 볼 수 있는 표를 정하실 수 있습니다. [설정 › 데이터 열람 권한] 에서 제한한 표는, 볼 수 없는 부서의 사람이 조회하면 커넥터가 실행하기 전에 데이터베이스에 실행 계획을 물어 확인하고 거절합니다. 표의 값은 회사 밖으로 나가지 않습니다.
- 표를 제한하시려면 이 버전이 필요합니다. 그 전 커넥터를 쓰는 툴킷의 표를 제한하시면, 부서가 막히는 사람의 조회는 커넥터를 올려 달라는 안내와 함께 실행되지 않습니다.
- SQL Server 는 조회 계정에 GRANT SHOWPLAN TO <조회 계정> 이 필요합니다. 뷰·별칭을 거쳐 조회하려면 VIEW DEFINITION 도 필요합니다. MySQL 은 뷰를 거쳐 조회하려면 SHOW VIEW 가 필요합니다. MariaDB 는 아직 지원하지 않습니다 — 데이터 열람 권한 가이드
- 제한을 정하지 않으시면 아무것도 바뀌지 않습니다. 실행 계획을 묻는 것도 제한한 표가 있는 툴킷에서만 합니다.
- 완전한 차단은 데이터베이스 계정 권한으로 해주세요 — 이 기능은 그 위의 편의 장치입니다.
접속 정보 · 툴킷 · secrets 는 그대로입니다.

v0.2.19 (2026-10-12) — Microsoft Purview(MIP) 문서 보안 직접 연결

Microsoft Purview 민감도 레이블로 보호된 문서를 게이트웨이 없이 웍스AI 에서 열 수 있습니다.
- 문서를 올린 사람에게 그 문서의 내용을 꺼낼(복사 · 추출) 권한이 있을 때만 엽니다. 권한이 없으면 웍스AI 가 이 문서를 AI 에 올릴 권한이 없다고 안내합니다.
- 쓰시려면 커넥터 서버에 MIP 사이드카 컨테이너를 하나 더 실행하고, 커넥터 secrets 에 DRM_MIP_TOKEN 을 넣어 주세요. Microsoft 365 앱 등록과 권한 설정이 먼저 필요합니다 — MIP 직접 연결 가이드
- Microsoft 365 접속 정보는 회사 서버의 사이드카에만 둡니다. 저희 서버로 보내지 않습니다.
MIP 를 쓰지 않으시면 아무것도 바뀌지 않습니다. 에이원정보 AIP 게이트웨이 연결, 데이터베이스 · API 툴킷, 기존 설정은 그대로입니다.

v0.2.18 (2026-10-09) — 민감 컬럼 가리기 · 문서 보안(DRM) 지원

민감한 컬럼을 「가리기」로 정할 수 있습니다. 조회는 되지만 값은 회사 안의 커넥터에서 일부 가려진 채 나갑니다(예: 010-1234-5678 → ***-****-**78). 원래 값은 회사 밖으로 나가지 않습니다.
- 커넥터를 올리신 뒤 스키마 탭의 컬럼 정책에서 「허용 · 가리기 · 차단」 중에 고르시면 됩니다.
- 가리기를 쓰지 않으시면 아무것도 바뀌지 않습니다. 이미 정해 두신 허용 · 차단도 그대로입니다.
- 완전한 차단은 데이터베이스 계정 권한으로 해주세요 — 이 기능은 그 위의 편의 장치입니다.
사내 DRM 으로 보호된 문서를 웍스AI 에서 열 수 있습니다 (에이원정보 AIP 게이트웨이).
- AI 가 만든 파일을 회사 기본 보안 등급으로 암호화해 내려보낼 수도 있습니다 — 연결 설정의 「암호화 기본 레이블 ID」와 「문서 소유자 도메인」을 정하시면 됩니다. 비워 두시면 지금처럼 원래 파일을 내려보냅니다.
- 쓰시려면 공유 폴더를 커넥터에 연결해야 합니다 — 문서 보안(DRM) 연동 가이드 · 커넥터 서버 권장 사양
- 쓰지 않으시면 아무것도 바뀌지 않습니다. 이 커넥터에서 아예 막으려면 환경변수 MCP_DRM_ENABLED=off 를 넣어 주세요.
SQL Server 에서 같은 조건을 두 번 쓰는 조회가 실패하던 것을 고쳤습니다.
사내 파일 서버(NAS)에서 파일을 받을 때와 대화 이미지를 저장할 때 별도 연결을 씁니다. 큰 파일을 받는 동안에도 다른 요청이 그 뒤에서 기다리지 않습니다.
- 커넥터를 올리시면 됩니다. 설정 · 주소 · secrets 는 그대로입니다.
- 커넥터를 올리기 전까지는 지금과 똑같이 동작합니다 — 저희 서버가 커넥터 버전에 맞춰 알아서 고릅니다.
- 파일 공유 · 이미지 저장을 쓰지 않으시면 아무것도 바뀌지 않습니다.
데이터베이스 조회의 읽기 전용 검사를 강화했고, 커넥터에서도 한 번 더 합니다. 같은 검사를 저희 서버가 먼저 하고 있어 따로 하실 일은 없습니다.
나중에 저희 서버를 늘릴 때 커넥터를 다시 올리지 않아도 되도록 미리 준비했습니다. 지금 바뀌는 것은 없습니다.
PostgreSQL · Oracle 과 기존 설정(접속 정보 · 툴킷 · secrets)은 그대로입니다.

v0.2.17 (2026-09-17) — 사내 파일 서버(NAS)를 AI 가 찾아볼 수 있습니다

커넥터에 사내 파일 서버를 붙이면, AI 가 필요한 파일을 찾아 줍니다. 폴더 목록을 보고, 이름·확장자·수정일로 찾습니다. 찾은 파일의 내용은 WRKS AI 가 따로 내려받아 답변에 씁니다.
- 커넥터를 다시 띄우실 때 공유 폴더를 연결하는 두 줄이 필요합니다. 툴킷을 만드실 때 화면이 명령을 통째로 만들어 드리니 그대로 실행하시면 됩니다. 자세한 절차는 파일 공유(NAS) 연동 가이드 를 봐 주세요.
- 읽기 전용입니다. 파일을 만들거나 고치거나 지우지 않습니다. 마운트도 :ro 로 붙이시길 권해 드립니다.
- 공유 서버(Samba)에 wide links = yes 가 켜져 있으면 공유 폴더 바깥을 가리키는 바로가기가 따라가집니다. 대부분의 NAS 는 기본이 꺼짐이라 그대로 두시면 되고, 켜 두셨다면 담당자와 확인 부탁드립니다.
파일 공유를 쓰지 않으시면 아무것도 바뀌지 않습니다. 기존 데이터베이스·API 툴킷, 접속 정보, secrets 는 그대로입니다. 공유 폴더를 연결하지 않은 커넥터에서는 이 기능이 아예 켜지지 않습니다.

v0.2.16 (2026-09-08) — 표가 아주 많은 데이터베이스에서 스키마 읽기가 실패하던 것을 고쳤습니다

표가 수천 개인 데이터베이스에서 "스키마 다시 읽기" 가 시간 초과로 실패하던 문제를 고쳤습니다 (Oracle · PostgreSQL). 고르신 표를 줄이셔도 풀리지 않던 문제입니다 — 걸리는 시간이 고르신 표의 수가 아니라 데이터베이스 전체의 표 수에 따라 늘어나고 있었기 때문입니다. 저희 시험 환경(표 3,000개)에서 25초 시간 초과로 실패하던 것이 4초에 끝납니다.
PostgreSQL 에서 관계가 실제보다 부풀려 잡히던 것을 고쳤습니다. 여러 항목이 함께 하나의 관계를 이루는 경우(예: 주문(지점코드, 주문번호) → 지점주문(지점코드, 번호)), 항목 짝이 뒤섞여 있지도 않은 관계가 함께 만들어졌습니다. 이 가짜 관계는 ERD 와 AI 의 조인 추천에 그대로 쓰였습니다.
PostgreSQL 에서 기본키가 스키마에 채워집니다. 지금까지 읽기 전용 계정에서는 기본키가 하나도 잡히지 않았습니다 — 연결 가이드가 권해 드리는 계정이 바로 그 경우라, 사실상 모든 고객사가 해당됐습니다. 기본키가 비면 AI 가 표를 이어 붙일 때 결과를 부풀릴 수 있습니다(한 건이어야 할 답이 여러 건으로).
위 두 가지는 커넥터를 올리신 뒤 스키마를 한 번 다시 읽으셔야 반영됩니다.
읽기 전용 계정의 권한 범위는 그대로입니다 — SELECT 권한을 드리지 않은 표의 이름·항목·관계는 지금처럼 저희에게 오지 않습니다.
MySQL · SQL Server 는 아무것도 바뀌지 않습니다. 기존 설정(접속 정보 · 툴킷 · secrets)도 그대로 유지됩니다.

v0.2.15 (2026-09-04) — 대화에 첨부한 이미지를 데이터베이스에 바로 저장할 수 있습니다

WRKS AI 대화에 이미지를 첨부하시면 그대로 데이터베이스에 저장됩니다. 지금까지 사람이 따로 올려야 했던 이미지를 대화 안에서 바로 남기실 수 있습니다.
- 쓰기 뷰에 이미지 자리를 만들어 두셔야 나타납니다. 만들지 않으신 툴킷에서는 이 기능이 아예 보이지 않고, 지금과 똑같이 동작합니다.
- 이미지는 저희 서버에 남지 않습니다. 사내망의 커넥터가 잠깐 들고 있다가 저장하면 곧바로 지웁니다.
- 사진을 넣을 때만 넣도록 만드실 수 있습니다. 뷰를 만드실 때 이미지 자리를 비워도 되는 자리로 지정해 두시면, 사진이 있으면 함께 저장하고 없으면 나머지만 저장합니다. 사진이 있는 경우와 없는 경우로 도구를 나누지 않으셔도 됩니다.
- 한 번에 한 장, 5MB 까지 저장하실 수 있습니다. JPEG · PNG · GIF · WebP 를 받습니다.
- 첨부한 이미지는 그 대화에서만, 한 번만 쓰입니다. 10분 안에 쓰지 않으면 사라지고, 저장한 뒤에는 다시 쓸 수 없습니다.
- 기존 쓰기 규칙은 하나도 바뀌지 않습니다 — 미리 승인해 두신 문장, 건수 제한, 쓰기 전용 계정, 미리보기 모두 그대로입니다.
기존 설정(접속 정보 · 툴킷 · secrets)은 그대로 유지됩니다.

v0.2.14 (2026-09-02) — AI 가 구조를 살펴볼 표를 직접 고를 수 있습니다

AI 가 구조를 살펴볼 표를 골라 두실 수 있습니다. 표가 아주 많은 데이터베이스(전사 ERP 등)를 하나의 툴킷으로 연결하시고, 실제로 쓰실 표만 골라 두시면 됩니다. 툴킷을 만드실 때 바로 고르실 수 있고, 만드신 뒤에는 설정 탭에서 언제든 바꾸거나 푸실 수 있습니다.
- 이건 조회를 막는 장치가 아닙니다. 여기서 고르는 것은 AI 가 구조를 살펴볼 범위입니다. 고르지 않으신 표도 접속 계정에 권한이 있으면 조회됩니다 — 실제 경계는 데이터베이스 계정 권한이니, 보여주면 안 되는 자료는 계정 권한에서 빼 주세요 (DB 연결 가이드 의 "조회 계정 권한" 절).
- 고르지 않으시면 지금과 똑같이 동작합니다. 이미 쓰고 계신 툴킷은 따로 하실 일이 없습니다.
표가 아주 많아도 목록을 다 보여 드립니다. 예전에는 목록이 중간에서 끊겨 그 뒤의 표는 고르실 수 없었습니다.
구조가 잘려도 표가 반쪽으로 나가지 않습니다. 예전에는 잘리는 자리에 걸친 표의 열이 일부만 실려, AI 가 실제로 있는 열을 없다고 여길 수 있었습니다. 이제 다 담기지 않는 표는 싣지 않고 몇 개를 뺐는지 알려 드립니다. 스키마 사전도 같습니다.
스키마 사전에 훨씬 많은 표가 담기고, 다시 읽기가 빨라졌습니다.
여러 조직의 자료가 한 데이터베이스에 함께 들어 있는 경우, 볼 자료를 고르실 수 있습니다. SAP 처럼 운영·테스트·교육용 자료를 같은 표에 나란히 담는 데이터베이스가 여기 해당합니다. 설정 탭에서 볼 자료를 하나 고르시면 AI 의 모든 조회가 그 자료로만 좁혀집니다.
- 고르지 않으시면 지금과 똑같이 동작합니다. 다만 고르지 않으면 조회가 실패하는 것이 아니라 여러 조직의 숫자가 합쳐져서 나오므로, 화면이 표를 고르시기 전에 먼저 여쭤 봅니다.
SAP 을 쓰시는 경우 — 읽어도 뜻을 알 수 없는 표는 목록에서 빼 드리고, 표와 항목의 우리말 이름을 자동으로 가져옵니다. 데이터베이스에 직접 적어 두신 설명이 있으면 그쪽이 우선입니다. 자세한 내용은 SAP 연동 안내 를 참고해 주세요.
표를 하나도 못 읽었을 때 이유를 알려 드립니다. 오라클(Oracle)에서 데이터베이스가 소유한 계정(예: SYSTEM)으로 연결하신 경우가 여기 해당합니다.
표가 아주 많아도 구조를 끝까지 읽습니다. 나눠서 이어 읽어, 예전에 중간에서 멈추던 규모도 전부 담습니다.
- 읽는 중에 어디까지 왔는지 보여 드립니다. 표가 많으면 몇 분 걸립니다.
- 중간에 실패해도 사전은 전혀 바뀌지 않습니다. 실패한 부분만 잠시 뒤 다시 읽고, 계속 실패하면 일찍 멈추고 알려 드립니다.
기존 설정(접속 정보 · 툴킷 · secrets)은 그대로 유지됩니다.

v0.2.13 (2026-08-26) — 표준 private IP 가 아닌 사내용 public IP 도 DB SSL/TLS 없이 연결할 수 있습니다

사내망 전용 주소를 지정해 두면 암호화 없이 연결됩니다. 사내망 대역(10. · 172.16~31. · 192.168.)이 아닌 주소를 사내에서 쓰시는 경우가 여기 해당합니다. secrets 폴더에 한 줄만 넣으시면 됩니다.
```
# 예시 — 실제 사용하시는 주소로 바꿔 주세요
echo 'MCP_DB_PLAINTEXT_ALLOW_HOSTS=10.xx.xx.5' | sudo tee -a /etc/mcp-connector/secrets/db.env
```
여러 개면 쉼표로 나눕니다. 대역 전체(/24 같은 표기)는 받지 않으니 쓰시는 주소만 하나씩 적어 주세요. 커넥터를 다시 시작하지 않으셔도 반영되고, 이미지를 새로 받으셔도 설정은 남습니다.
스튜디오에서도 확인이 필요합니다 — 툴킷 설정 → 연결 정보 에서 "이 주소는 사내망 전용입니다" 를 확인해 주세요. 두 곳 모두 설정해야 연결됩니다.

설정 전에 꼭 확인해 주세요. 그 주소가 정말 사내망에서만 닿아야 합니다. 회사 밖 회선(예: 휴대폰 테더링)에서 접속이 되면 인터넷에도 열려 있는 것이므로 암호화 없이 쓰시면 안 됩니다.

데이터베이스 구조를 읽을 때 컬럼의 자료형도 함께 읽습니다. 코드값을 사람이 읽는 이름으로 바꿔 보여 주는 기능이 씁니다. 저장되는 것은 자료형 이름뿐이며 데이터 값은 저장되지 않습니다.
기존 설정(접속 정보 · 툴킷 · secrets)은 그대로 유지됩니다.

v0.2.12 (2026-08-24) — 뷰도 사전에 담고, 오래 걸리는 조회를 덜 끊습니다

뷰(View)도 스키마 사전에 담습니다 — 지금까지는 화면에 보이는데도 사전에는 들어오지 않아, AI 가 그 뷰의 컬럼 뜻이나 기본키를 모른 채 조회했습니다. 그 결과 같은 자료가 여러 번 세어져 건수가 부풀려지는 일이 있었습니다. 업데이트 후 [스키마 다시 읽기] 를 한 번 눌러 주세요.
조회 시간 상한이 5초 → 15초 — 여러 표를 잇는 무거운 집계가 5초에 끊기던 문제가 줄어듭니다. 툴킷 상세 설정 → 응답 대기 시간 에서 툴킷마다 따로 정할 수도 있습니다 (최대 120초). 짧게 쓰고 싶으시면 낮추셔도 됩니다.
스키마를 다시 읽을 때 넉넉히 기다립니다 — 표가 많은 데이터베이스에서 다시 읽기가 시간 초과로 실패하던 문제를 고쳤습니다. 지시문에 "시간 초과 시 다시 시도" 같은 안내를 넣어 두셨다면 이제 지우셔도 됩니다.
설명(주석)으로 시작하는 조회가 막히던 문제 — AI 가 쿼리 앞에 -- 로 의도를 적으면 실행이 거부되던 문제를 고쳤습니다. 안전 검사는 그대로입니다 — 조회가 아닌 문장은 여전히 차단됩니다.
기존 설정(접속 정보 · 툴킷 · secrets)은 그대로 유지됩니다.

v0.2.11 (2026-08-20) — 데이터베이스에 적어 두신 설명을 읽어옵니다

테이블과 컬럼에 적어 두신 설명(한글 이름)을 읽어옵니다 — AI 가 ORDER_MASTER 같은 영문 이름 대신 "주문", "재고" 같은 업무 용어로 테이블을 찾을 수 있습니다. 설명이 없는 테이블도 그동안의 조회 이력에서 테이블 사이의 연결을 찾아 채웁니다.
설명과 테이블 구조만 읽어오며, 데이터 값은 가져오지 않습니다.
이 기능은 툴킷마다 꺼져 있는 것이 기본이고, 켜야 동작합니다.
기존 설정 그대로 · 재설치 후 즉시 반영.

v0.2.10 (2026-08-19) — 조회·입력 도구를 화면에서 바로 만들기

서버 설정 파일에 붙여넣는 단계가 없어졌습니다 — 조회·입력 도구를 Studio 에서 만들면 그대로 사용할 수 있습니다. db-views.json 을 열어 복사·붙여넣기 하실 필요가 없습니다.
도구 삭제 — 더 이상 쓰지 않는 조회·입력 도구를 화면에서 지울 수 있습니다. 등록한 정의도 화면에서 언제든 확인할 수 있습니다.
⚠️ 예전 방식으로 만든 도구는 다시 만들어 주세요. 이 버전부터 커넥터는 db-views.json 을 읽지 않습니다. 업데이트 후 그 파일로 만든 도구를 호출하면 "예전 방식으로 만들어진 도구입니다" 안내와 함께 실패합니다 — 도구 목록에서 삭제한 뒤 화면에서 다시 만들어 주세요. 파일은 정리하셔도 됩니다.
쓰기 도구의 안전장치(관리자가 승인한 INSERT 문만 · 행 수 상한 · 쓰기 전용 계정 최소권한)는 그대로입니다.
기존 설정(접속 정보 · 툴킷 · secrets)은 그대로 유지됩니다.

v0.2.9 (2026-08-14) — DB 쓰기 뷰 + 접속 계정 권한 자동 점검

DB 쓰기 뷰 지원 — AI 는 관리자가 미리 정의하고 승인한 그 INSERT 문만, 뷰에 정한 행 수 상한(기본 1행) 안에서만 실행합니다. 상한을 넘으면 확정 전에 되돌립니다.
- 쓰기 전용 계정을 따로 두고 대상 테이블 INSERT 권한만 주세요 — 권한 설정 방법은 DB 연동 가이드 참고.
- MySQL 은 InnoDB 테이블에서만 실행됩니다. 되돌리기가 안 되는 예전 엔진(MyISAM 등)은 실행을 거절합니다.
접속 계정 권한 자동 점검 — 연결한 계정에 불필요하게 강한 권한이 있는지 확인해 Studio 에 안내합니다. 점검이 안 될 때는 "접속이 안 됨" 과 "권한을 확정 못 함" 을 구분해 알려드립니다. 이 점검은 참고용이며 100% 확정이 아니니, DB 계정의 실제 권한은 꼭 직접 확인해 주세요.
조회 안전장치가 더 촘촘해졌습니다 — 위험한 함수·구문을 더 넓게 막습니다.
- ⚠️ 업데이트 후 한 번 확인해 주세요. 등록해 두신 조회 뷰(db-views.json)도 이번부터 같은 검사를 받습니다. 걸리는 뷰가 있으면 해당 도구만 실패하니, 업데이트 직후 주요 조회를 한 번씩 실행해 보시길 권합니다.
응답이 아주 큰 호출에 크기 상한이 생겼습니다 (기본 8MB) — 큰 응답이 커넥터를 멈추게 하지 않습니다. 결과가 잘린 경우 행 수 때문인지 크기 때문인지 구분해서 표시합니다. 상한은 환경변수 MCP_CONNECTOR_MAX_RESPONSE_BYTES 로 조정할 수 있습니다.
- 다만 조회 한 건의 결과 자체가 수백 MB 인 경우는 이 상한이 커넥터를 지켜주지 못합니다 — 조회 전용 복제본 연결 등 데이터베이스 쪽에서 막아 주시는 것이 확실합니다.
오래 걸리는 조회에 시간 제한이 생겼습니다 (기본 5초) — 무거운 정기 리포트처럼 오래 걸리는 조회가 있으면 툴킷 설정에서 늘려 주세요.
데이터베이스 연결이 끊겨도 커넥터가 스스로 회복합니다 (PostgreSQL · MySQL · SQL Server 실제 확인). 예전에는 커넥터를 직접 재시작해야 했습니다.
오라클 개선 — 큰 텍스트(CLOB) 컬럼이 있는 테이블을 조회할 수 있고, 다른 스키마의 테이블도 목록에 나옵니다(ERP_OWNER.ORDERS 형태). 계정이 볼 수 있는 범위는 예전과 같습니다.
뷰 설정 파일(db-views.json) 형식이 잘못되면 로그로 알려줍니다 — 예전에는 조용히 무시돼 "파일이 잘못됨" 과 "아직 안 만듦" 이 구분되지 않았습니다. Studio 의 [뷰 정의 복사] 는 기존 파일 안에 끼워 넣는 조각이라 바깥 { } 가 없습니다 — 파일을 처음 만드실 때는 [파일 전체 복사] 를 쓰세요.
기존 설정(접속 정보 · 툴킷 · secrets)은 그대로 유지됩니다.

v0.2.8 (2026-08-13) — SQL Server(MSSQL) 정렬 쿼리 오류 수정

SQL Server 에서 ORDER BY(정렬)가 포함된 조회가 오류 없이 실행되고, 요청한 정렬 순서도 결과에 그대로 반영됩니다.
다른 DB·기존 설정에는 영향 없음 · 재설치 후 즉시 반영.

v0.2.7 (2026-07-31) — 대용량 응답 자동 압축 + 사내 서버 부하 절감

응답이 큰 API 호출이 훨씬 빨라집니다 — 사내 API 가 텍스트/JSON 을 크게 돌려주는 경우 (수십 KB ~ 수 MB), 커넥터가 자동으로 압축해 전송하고 저희 서버에서 압축을 풀어드립니다. 네트워크 전송 시간이 통상 60~80% 줄어듭니다.
응답이 오래 걸리는 API 의 사내 서버 부하 감소 — 대기 시간(timeout) 초과로 호출이 중단될 때, 커넥터가 사내 API 호출도 즉시 취소하도록 개선했습니다. 이전엔 저희 쪽만 포기하고 사내 API 는 계속 응답을 만들다가 버려지는 자원 낭비가 있었습니다.
별도 설정 필요 없음 · 기존 설정 그대로 · 재설치 후 즉시 반영.

v0.2.6 (2026-07-30) — 시스템 계정 인증(M2M) Basic Auth 방식 지원

OAuth Client Credentials 방식에 Basic Auth 헤더 옵션 추가 — Oracle APEX ORDS · Ping 등 Basic 방식만 허용하는 사내 IdP 연동 가능.

v0.2.5 (2026-07-25) — 사용자별 로그인(OAuth per-user) 지원

Google · Microsoft 등 사용자 계정으로 도구 호출 — 팀 공용 계정이 아닌 호출한 개인 계정 으로 실행하는 OAuth 방식(Authorization Code + PKCE) 지원.
세션 자동 갱신 — Access Token 만료 시 Refresh Token 으로 자동 재발급, 재로그인 없이 도구 호출 연속성 유지.
MCP 2025-11-25 스펙 · OAuth 표준 전면 준수 — RFC 8414 Discovery, RFC 7591 Dynamic Client Registration, RFC 9728 Protected Resource Metadata, RFC 8707 Resource Indicators.

v0.2.4 (2026-07-22) — 시스템 계정 인증(M2M) + 보안 하드닝

OAuth 2.0 Client Credentials(M2M) 지원 — Auth0 · Salesforce · Oracle APEX 등 시스템 대 시스템(M2M) 인증. Client secret 은 커넥터 내부에서만 저장·요청, 사내망 밖으로 나가지 않음.
커넥터 secrets 를 호스트 저장소에 보관 — /etc/mcp-connector/secrets 를 bind mount 로 저장. 컨테이너를 삭제·재설치해도 secrets 보존 (신규 설치자는 설치 가이드 참고).
토큰 URL SSRF 방지 — http/https 스킴만 허용, token endpoint 302 redirect 자동 추종 차단.
provider rate-limit 폭주 방지 — 동시 요청 시 single-flight 캐시로 대량 호출 방지.
감사 로그 비밀번호 마스킹 — DB connection string 의 비밀번호 자동 마스킹.

v0.2.3 (2026-06-03) — 지원 시스템 확대 (SAP · Oracle · MSSQL)

SAP ECC 등 Basic 인증 REST API 지원 — 환경변수 placeholder 로 계정 주입, secret 은 커넥터에만 저장.
SAP OData $metadata → OpenAPI 자동 변환 — SAP 표준 스펙만으로 툴킷 생성 가능.
Oracle DB 커넥터 — Thin 모드, ROWNUM LIMIT.
SQL Server (MSSQL) DB 커넥터.
사내망 OpenAPI URL 자동 수집 — Hub 가 OpenAPI/Swagger URL 을 커넥터 경유로 직접 가져와 툴킷 생성. 파일 업로드 불필요.

v0.2.2 (2026-06-01) — 업데이트 재시작 안정화

재시작 시 pairing 토큰 누락 크래시 수정 — docker run 으로 업데이트 재기동 시 MCP_HUB_PAIRING_TOKEN 없이도 정상 재개.

v0.2.1 (2026-06-01) — DB 연결 SSL/TLS 강화

DB 툴킷 SSL/TLS 모드 지원 (disable / require / verify) — RDS 등 매니지드 DB 정상 접속. 신규 DB 툴킷은 require 가 기본.
평문 연결 안전장치 — 공인 호스트에 SSL 없이 연결 시도 시 자동 차단.

v0.2.0 (2026-05-29) — Text-to-SQL 지원 + 자동 복구

PostgreSQL · MySQL DB 커넥터 — 자연어 → SQL 실행 (Text-to-SQL) 지원.
연결 자동 복구 — 노트북 슬립 등으로 조용히 끊긴 연결 60초 내 자동 재연결.
컨테이너/호스트 재기동 자동 복구 — restart policy 개선.
에러 메시지 비밀번호 자동 마스킹 — URL 에 담긴 userinfo 오류 노출 방지.
자동 생성 도구 이름 정돈 — CamelCase 분리, path parameter suffix 제거 (기존 AI 클라이언트 등록 도구는 재등록 필요).
production 이미지 source map 제거 — 역공학 표면 축소.

v0.1.0 (2026-05-12) — 최초 출시

커넥터 도커 이미지 초기 릴리즈.
Hub 와 mTLS 페어링 절차 제공.
oauth_user Bearer passthrough 인증 지원 (호출자 access token 을 upstream 으로 그대로 전달).

앞으로의 업데이트

새 커넥터 릴리즈가 배포되면 이 페이지 상단에 새 섹션이 자동으로 추가됩니다. 이전 버전을 계속 사용해도 무방하지만, 보안 픽스가 포함될 수 있으니 정기적으로 업데이트를 권장합니다.

업데이트 절차 → Connector 설치 가이드 — "재설치 · 업데이트" 절
호환성 확인 → 스튜디오 상단 배너에 "새 커넥터 버전" 이 뜨면 릴리즈 노트 확인 후 진행