# 사내 데이터 연동 (MCP Hub)

> Source: https://docs.wrks.ai/admin-guide/integrations/mcp-hub · Last updated: 2026-10-07

사내 ERP·그룹웨어·DB를 웍스AI에 연결해 대화만으로 조회하고 처리할 수 있어요.

**사내 ERP·SCM·그룹웨어·사내 API·DB를 웍스AI에 연결**하면, 직원들이 대화만으로 사내 데이터를 조회하고 업무를 처리할 수 있어요.

개발 프로젝트 없이 **관리자 화면에서 직접 설정**하실 수 있습니다. 시작은 관리자 화면의 **\[사내 에이전트] > \[에이전트 도구 관리]** 메뉴에 있는 **\[MCP Hub 신청]** 버튼에서 하시면 돼요.


지금까지 이런 요청을 실현하려면 두 가지 벽이 있었습니다. **보안팀이 외부에서 사내로 들어오는 연결을 열어주지 않고**, **사내 시스템 연동이 수개월짜리 프로젝트**가 되기 때문입니다. MCP Hub 는 이 두 가지를 모두 해결합니다.


### 개발 프로젝트가 필요 없어요

API 명세(OpenAPI/Swagger)만 등록하면 **명세에 정의된 기능들이 자동으로 AI 도구로 만들어집니다.** 명세가 없어도 API 를 한 번 호출해보는 것만으로 도구가 자동 생성됩니다.

> SAP S/4HANA Business Partner API 연동 시, **5분 만에 440개 기능이 자동으로 도구화**된 사례가 있습니다.

필요한 도구만 켜고 나머지는 꺼둘 수 있어, 회사에서 실제로 쓸 기능만 골라 운영하실 수 있어요.

### 보안은 이렇게 지킵니다

| 항목                | 내용                                       |
| ----------------- | ---------------------------------------- |
| **방화벽 인바운드 개방**   | 불필요 — 커넥터가 밖으로 나가는 통신(outbound 443)만 씁니다 |
| **API 키·DB 비밀번호** | 사내 커넥터 안에만 보관 — 웍스 클라우드에 저장되지 않습니다       |
| **통신 암호화**        | 커넥터 ↔ Hub 간 mTLS 양방향 인증                  |
| **데이터 저장**        | 매 호출마다 사내에서 즉시 조회 — 클라우드에 영구 저장하지 않습니다   |
| **감사 로그**         | 어떤 도구를 언제 누가 호출했는지 관리자 화면에서 확인           |

DMZ뿐 아니라 **NAT 뒤 사내망, 클라우드 VPC 내부**에서도 동작합니다.

### 통제권은 관리자에게 있습니다

* 부서·사용자 단위로 도구 사용 권한 설정
* 문제가 생기면 **일시중지 버튼으로 즉시 차단**
* 개발용·운영용 엔드포인트를 나눠 운영 가능

### 어떻게 동작하나요 — 3단계

**1단계 · 커넥터 설치 (최초 1회)**

관리자 화면에서 커넥터를 추가하면 설치 명령어가 자동으로 만들어집니다. 사내 담당자가 서버에서 **명령어 한 줄만 실행**하면 설치가 끝나요.

* 필요 환경: Docker 가 설치된 서버 1대 (최소 2 vCPU / 2 GB RAM)
* 방화벽: outbound 443 허용 (`mcp-hub.wrks.ai`, `ghcr.io`) — 인바운드 개방 불필요

**2단계 · 툴킷 생성 (연동할 시스템 등록)**

연동할 시스템의 API 명세를 등록하거나 DB 접속 정보를 설정하면 MCP 서버(툴킷)가 자동으로 만들어집니다. API 키·비밀번호는 **사내 커넥터에만 저장**하고, 화면에는 변수명만 입력합니다.

* 지원 DB: **PostgreSQL / MySQL / MS SQL / Oracle**
* 지원 인증: **API Key / OAuth / OAuth Client Credentials(M2M) / DCR**

**3단계 · 웍스AI에 연결**

발급된 엔드포인트를 웍스AI 에이전트에 등록하면 완료입니다. 등록은 관리자 화면의 **\[사내 에이전트] > \[에이전트 도구 관리]** 메뉴에서 **\[+ 도구 추가]** 버튼을 누른 뒤, '**도구 링크**' 항목에 발급된 엔드포인트를 **Remote MCP 서버 URL**(https\://)로 입력하시면 돼요. 이후 직원들은 대화창에서 자연어로 사내 데이터를 조회하고 업무를 처리할 수 있어요.

> 커넥터 설치 이후 2·3단계는 **5분 이내**에 끝납니다.


도구를 등록한 뒤의 운영 — 허용 여부 관리, 도구별 사용 권한 지정 등 — 은 [에이전트 도구 관리](https://docs.wrks.ai/admin-guide/admin-agents/mcp-tools) 페이지에서 안내하고 있어요. 이 페이지는 그중 **MCP Hub 로 사내 시스템을 연결하는 방법**을 다룹니다.


### 이렇게 쓰실 수 있어요

| 부서    | 활용 시나리오                                       |
| ----- | --------------------------------------------- |
| 영업    | "지난주 거래처별 매출 추이 정리해줘" — ERP 조회 후 요약           |
| 구매·물류 | "A자재 현재 재고와 입고 예정 알려줘" — SCM 조회               |
| 인사·총무 | "내 휴가 잔여일수 알려줘", "결재 진행 현황 확인해줘" — 그룹웨어 조회    |
| 경영지원  | "이번 달 부서별 비용 집행 현황 리포트 만들어줘" — DB 조회 후 리포트 생성 |

연결한 사내 데이터를 **워크플로우**와 함께 쓰면, 매일 아침 사내 데이터를 조회해 리포트를 만들거나 특정 조건에서 후속 처리를 하는 **반복 업무 자동화**로 넓힐 수 있어요.

### 준비하실 사항

도입을 결정하셨다면 사내 담당자와 아래 정도만 확인하시면 됩니다.

* [ ] Docker 설치 서버 1대 (사내망 또는 VPC 내부)
* [ ] 방화벽 outbound 443 허용 (`mcp-hub.wrks.ai`, `ghcr.io`)
* [ ] 연동할 시스템의 API 명세(OpenAPI/Swagger) 또는 DB 접속 정보
* [ ] 연동 계정 권한 정리 (DB는 read-only 계정 권장)

### 상세 가이드

역할별 단계별 가이드가 준비돼 있어요. **로그인 없이 열람·공유 가능**하니 사내 담당자분께 그대로 전달하시면 됩니다.

| 가이드                                                                          | 대상      | 내용                                              |
| ---------------------------------------------------------------------------- | ------- | ----------------------------------------------- |
| [Connector 설치 가이드](https://mcp-studio.wrks.ai/guides/connector-installation) | 운영자     | 사내망에 커넥터 설치 및 Hub 페어링                           |
| [환경별 Connector 설치](https://mcp-studio.wrks.ai/guides/connector-environments) | 인프라     | Nutanix, vSphere, AWS, Azure, NCP, Windows+WSL2 |
| [Toolkit 사용 가이드](https://mcp-studio.wrks.ai/guides/toolkit-usage)            | 운영자     | 툴킷 생성부터 엔드포인트 발급, MCP 연결까지                      |
| [DB 연동 가이드](https://mcp-studio.wrks.ai/guides/db-connection)                 | 인프라/DBA | DB별 read-only 계정 설정                             |

### 문의

도입을 검토하시거나 궁금한 점이 있으시면 **<support@wrks.ai>** 로 연락 주세요.