> For the complete documentation index, see [llms.txt](https://docs.wrks.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.wrks.ai/admin-guide/integrations/undefined.md).

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

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

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

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

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

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

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분 이내**에 끝납니다.

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

## 이렇게 쓰실 수 있어요

| 부서    | 활용 시나리오                                       |
| ----- | --------------------------------------------- |
| 영업    | "지난주 거래처별 매출 추이 정리해줘" — 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>** 로 연락 주세요.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.wrks.ai/admin-guide/integrations/undefined.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.