커스텀 앱 연결하기

그룹웨어, ERP처럼 회사 시스템을 모노클 AI에 연결합니다. 시스템 쪽에 MCP 서버가 있으면, 모노클에는 주소만 등록하면 됩니다.

이 페이지는 워크스페이스 관리자용입니다. MCP 서버 개발은 연동 준비 가이드 (IT 담당자용)를 개발팀이나 시스템 업체에 전달하세요.

연결 구조

모노클 AI는 HTTPS로 MCP 서버에 요청하고, MCP 서버가 기존 API·DB를 통해 사내 시스템과 연결됩니다

MCP 서버는 AI가 쓸 수 있는 기능(도구)을 공개하는 연결 창구입니다. 기존 시스템은 그대로 두고 앞에 창구만 추가합니다.

사내 DB 연결과 비교

	사내 DB 연결	커스텀 앱
할 수 있는 일	관리자가 등록한 SQL 실행 (주로 조회)	서버가 공개한 기능 (조회·등록·실행)
개발	필요 없음	MCP 서버 개발 필요
이럴 때	DB에 접속할 수 있고 조회만 필요할 때	DB를 열 수 없거나 시스템 기능이 필요할 때

조회만 필요하면 사내 DB 연결이 더 빠릅니다.

준비할 것

MCP 서버 주소: https://로 시작, 인터넷에서 접속 가능. 예: https://mcp.groupware.example.co.kr/mcp
로그인 방식: 인증 없음 / OAuth / API 키 중 무엇인지 개발 담당자에게 확인

추가하기

1. + 앱 추가 › 커스텀 앱

관리자에게만 보입니다. 추가한 앱은 워크스페이스의 모든 사용자에게 보입니다. 아래 '4. 사용 범위'를 먼저 확인하세요.

① 「+ 앱 추가」 ② 「커스텀 앱」

2. 서버 정보 입력

「커스텀 앱 추가」 창

항목	내용
① 이름	목록과 채팅에 표시될 이름. 예: 사내 그룹웨어
② 서버 주소	MCP 서버의 `https://` 주소
Icon URL	앱 아이콘 이미지 주소 (선택)
③ 로그인 방식	`Advanced: sign-in (optional)`을 펼쳐 선택 (아래 3번)
④ Client ID · Secret	OAuth일 때만. 모르면 비워 두세요
⑤ 추가	눌러서 등록

3. 로그인 방식 선택

로그인 방식 비교 — 인증 없음, OAuth(권장), API 키

인증 없음: 주소를 아는 누구나 호출할 수 있습니다. 사내 데이터를 다루는 서버에는 쓰지 마세요.
OAuth: Client ID·Secret을 비워 두면 모노클이 서버의 로그인 방식을 자동으로 감지합니다. 연결이 안 되면 개발 담당자에게 Client ID·Secret을 받아 입력하세요. 직원은 연결할 때 본인 계정으로 한 번 로그인합니다.
API 키: 모든 직원이 이 키 하나로, 같은 권한으로 접속합니다. 키는 직원에게 보이지 않습니다. 개인 키 대신 권한을 줄인 연동 전용 키를 쓰세요.

① 「API 키」 선택 ② 전용 API 키 입력

4. 사용 범위

커스텀 앱은 추가하면 워크스페이스의 모든 사용자에게 보입니다. 사내 DB 연결과 달리 부서·역할로 제한하는 접근 정책은 아직 없습니다. 직원마다 볼 수 있는 범위를 다르게 하려면 OAuth 방식을 쓰고, MCP 서버가 로그인한 직원 기준으로 권한을 적용하도록 만드세요.

사용하기

등록부터 사용까지 — 관리자가 등록·범위 설정, 직원이 연결 후 채팅에서 사용

앱 메뉴에서 커스텀 앱을 열고 연결 (OAuth면 본인 계정으로 로그인)
채팅 입력창의 앱 버튼에서 켜기
"이번 주 결재 대기 문서 요약해줘"처럼 질문

MCP 서버는 누가 만드나요?

회사 개발팀이나 시스템 업체가 만듭니다. 시스템에 API가 있다면 그 API를 감싸는 형태로 만들 수 있습니다. 외부 업체 제품을 쓰고 있다면 업체에 MCP 서버 제공 여부를 먼저 문의하세요. 이미 있으면 주소만 등록하면 됩니다.

개발 담당자에게는 연동 준비 가이드 (IT 담당자용)를 전달하세요. 서버 요건, 예제 코드, 보안 체크리스트가 있습니다.

문제 해결

증상	해결 방법
"원격 커넥터에는 https:// URL이 필요합니다"	`https://`로 시작하는 전체 주소를 입력하세요.
"같은 이름의 서버가 이미 있습니다"	다른 이름을 쓰세요.
서버 연결 실패 · 도구 호출 실패	서버가 인터넷에서 접속되는지, 방화벽에서 모노클 서버 IP를 허용했는지 확인하세요.
로그인 창이 안 열림	팝업 차단을 해제하고, 서버의 로그인 방식을 확인하세요.
연결이 잠시 후 끊김	다시 연결하고, 서버가 토큰 갱신(refresh token)을 지원하는지 확인하세요.

자주 묻는 질문

Q. 모노클 쪽에서도 개발이 필요한가요?

아니요. 주소와 로그인 방식만 등록하면 됩니다.

Q. 데이터 수정도 할 수 있나요?

서버가 그런 도구를 공개하면 가능합니다. 처음엔 조회 기능부터 여는 것을 권합니다.

Q. 직원마다 보는 범위를 다르게 하고 싶어요.

OAuth를 쓰고, MCP 서버가 로그인한 직원 기준으로 원래 시스템의 권한을 적용하도록 만들면 됩니다.

Q. 주소나 키를 바꾸고 싶어요.

앱 카드 ⋯ › 편집에서 바꿉니다. 로그인 정보를 바꾸면 직원들은 다시 연결해야 합니다.

기능 소개