.md

사내 데이터 연동 (MCP Hub)

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

도구를 등록한 뒤의 운영 — 허용 여부 관리, 도구별 사용 권한 지정 등 — 은 에이전트 도구 관리 페이지에서 안내하고 있어요. 이 페이지는 그중 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 설치 가이드 운영자 사내망에 커넥터 설치 및 Hub 페어링
환경별 Connector 설치 인프라 Nutanix, vSphere, AWS, Azure, NCP, Windows+WSL2
Toolkit 사용 가이드 운영자 툴킷 생성부터 엔드포인트 발급, MCP 연결까지
DB 연동 가이드 인프라/DBA DB별 read-only 계정 설정

문의

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

Last updated