마켓플레이스란?
마켓플레이스에는 두 종류의 서비스가 있습니다. 종류에 따라 연결 방식과 에이전트에 붙는 위치가 다릅니다.문서 생성기
PPT·Word·Excel·HTML 문서를 만드는 기능입니다. 팔레트·템플릿·포맷을 지정해 여러 개의 기능(인스턴스) 을 만들고, 에이전트의 스킬 섹션에 붙입니다.
외부 연동 (MCP)
Google Workspace·Microsoft 365를 에이전트 도구로 연결합니다. 각 사용자가 본인 계정으로 로그인(SSO) 하며, 에이전트의 마켓플레이스 도구 섹션에 붙습니다.
카탈로그 서비스
| 서비스 | 종류 | 설명 |
|---|---|---|
| PPT Generator | 문서 생성기 | 발표자료(.pptx). 13종 슬라이드 레이아웃, 네이티브 차트, 팔레트 12종 |
| Word Generator | 문서 생성기 | 구조화된 문서(.docx). 제목·목록·표·차트·페이지 나눔 |
| Excel Generator | 문서 생성기 | 서식 있는 스프레드시트(.xlsx). 다중 시트·수식·차트 |
| HTML Report Generator | 문서 생성기 | 자체 완결형 HTML 리포트. SVG 차트·KPI 카드·라이트/다크 테마 |
| Google Workspace | 외부 연동 | Gmail·Calendar·Drive·Docs·Sheets·Slides 등 |
| Microsoft 365 | 외부 연동 | Outlook·Teams·OneDrive·SharePoint·Calendar 등 |
탭 이름은 “마켓플레이스”지만, 워크스페이스 > 마켓플레이스 첫 화면은 내가 만든 연결·기능 목록입니다. 새로 추가하려면 우측 상단 새 연결 버튼을 눌러 카탈로그로 이동하세요.
관리자 사전 설정
마켓플레이스를 사용하려면 관리자가 먼저 다음을 설정해야 합니다. 하나라도 빠지면 서비스가 보이지 않거나 동작하지 않습니다.서비스 컨테이너 배포
문서 생성기는 코드 실행(Jupyter) 컨테이너가, 외부 연동은 각 MCP 서비스 컨테이너가 필요합니다. 이들은 Cloosphere와 별개로 배포되는 사이드카 컨테이너입니다.
연결 설정
관리자 설정 > 마켓플레이스에서 각 서비스의 URL을 입력하고 연결 테스트 후 활성화합니다.
- 문서 생성기: Jupyter URL + 토큰 입력 → 코드 실행 엔진 활성화
- MCP 서비스: 서비스 URL 입력 → 활성화(연결 생성)
문서 생성기는 코드 실행 엔진이 준비되지 않으면 카탈로그에서 비활성으로 표시됩니다(“관리자 > 설정 > 코드 실행에서 설정하세요” 안내). 외부 연동(MCP)은 관리자가 URL을 설정하고 연결해야 카탈로그에 나타납니다.
문서 생성기 만들기
하나의 생성기(예: PPT Generator)에서 여러 개의 문서 생성 기능을 만들 수 있습니다. 예를 들어 “회사 표준 덱”과 “고객 제안용 덱”을 각각 다른 색·템플릿으로 준비할 수 있습니다.만든 문서 생성 기능은 워크스페이스 > 스킬 목록에도 함께 표시됩니다(내부적으로 스킬이기 때문). 색상·템플릿 등 설정은 마켓플레이스 편집 화면에서만 수정할 수 있습니다.
외부 연동 (MCP) 연결
Google Workspace·Microsoft 365를 에이전트 도구로 연결합니다.사용자 SSO 인증
MCP 연결은 각 사용자의 SSO 액세스 토큰을 매 호출에 자동 주입합니다. 별도 API 키가 필요 없으며, 사용자는 해당 제공자(Google / Microsoft)로 로그인하기만 하면 됩니다. 즉 사용자마다 본인 권한 범위에서 도구가 동작합니다.읽기 / 쓰기 승인 (HITL)
각 도구는 읽기/쓰기로 분류됩니다.| 분류 | 동작 |
|---|---|
| 읽기 (Read) | 자동 승인 — 조회성 작업 |
| 쓰기 (Write) | 사용자 승인 필요 — 메일 발송, 파일 생성 등 변경 작업 |
에이전트에 연결
마켓플레이스 서비스는 종류에 따라 에이전트 편집기의 서로 다른 섹션에서 연결합니다.| 서비스 종류 | 에이전트 편집기 섹션 |
|---|---|
| 문서 생성기 (PPT·Word·Excel·HTML) | 스킬 |
| 외부 연동 (Google Workspace·Microsoft 365) | 마켓플레이스 도구 |
채팅에서 활용
에이전트에 연결된 마켓플레이스 서비스는 대화 중 자동으로 활용됩니다.문서 생성 결과는 답변 위에
📎 다운로드 링크로 먼저 표시됩니다. “슬라이드 3만 굵게 바꿔줘” 처럼 이어서 요청하면, 전체를 다시 만들지 않고 해당 부분만 정밀하게 수정합니다.외부 연동(Google Workspace 등)의 쓰기 작업(메일 발송 등)은 실행 전 사용자 승인을 요청합니다.
접근 권한과 라이선스
| 구분 | 설명 |
|---|---|
| 라이선스 | 마켓플레이스는 별도 유상 애드온. 기능 키가 없으면(강제 모드에서) 모든 마켓플레이스 기능이 차단됩니다 |
| 권한 | 그룹별 마켓플레이스 접근(없음/읽기/쓰기). 기본 잠금. 쓰기 권한이 있어야 연결·기능을 만들 수 있습니다 |
| 공유 | 각 연결·기능은 공개/비공개 및 그룹·조직 단위 읽기/쓰기 권한을 설정할 수 있습니다 |
트러블슈팅
카탈로그에 서비스가 없어요
카탈로그에 서비스가 없어요
| 원인 | 해결 방법 |
|---|---|
| 문서 생성기 비활성 | 관리자가 코드 실행(Jupyter)을 설정해야 합니다 |
| MCP 서비스 미표시 | 관리자가 서비스 URL을 설정하고 연결해야 합니다 |
| 라이선스 없음 | 마켓플레이스 애드온 라이선스를 확인하세요 |
| 권한 없음 | 관리자에게 마켓플레이스 접근 권한을 요청하세요 |
문서가 생성되지 않아요
문서가 생성되지 않아요
코드 실행 엔진(Jupyter)이 준비되어야 합니다. 관리자 설정 > 마켓플레이스의 문서 생성기 상태가 “연결 가능”인지 확인하세요.
Google/Microsoft 도구가 권한 부족이라고 나와요
Google/Microsoft 도구가 권한 부족이라고 나와요
해당 카테고리의 OAuth 스코프가 부여되지 않았습니다. 관리자 동의 또는 재로그인이 필요할 수 있습니다. 상세 화면의 카테고리별 스코프 표시를 확인하세요.
연결·기능을 비활성화/삭제할 수 없어요
연결·기능을 비활성화/삭제할 수 없어요
사용 중인 에이전트가 있으면 차단됩니다. 사용 중인 에이전트 수가 표시되며, 그래도 진행하려면 강제 확인 절차를 거칩니다.
FAQ
문서 생성기와 스킬은 무슨 관계인가요?
문서 생성기와 스킬은 무슨 관계인가요?
문서 생성기 기능은 내부적으로 실행형 스킬입니다. 그래서 워크스페이스 > 스킬 목록에도 나타나고, 에이전트의 스킬 섹션에서 연결합니다. 차이는 색상·템플릿 등 설정을 마켓플레이스 편집 화면에서 관리한다는 점입니다.
같은 생성기로 여러 스타일을 만들 수 있나요?
같은 생성기로 여러 스타일을 만들 수 있나요?
네. 하나의 PPT Generator에서 팔레트·템플릿이 다른 여러 기능(인스턴스)을 만들 수 있습니다. 각각 별도로 에이전트에 연결하세요.
외부 연동은 안전한가요?
외부 연동은 안전한가요?
각 사용자의 SSO 토큰으로 본인 권한 범위에서만 동작하며, 쓰기 작업은 사용자 승인을 거칩니다. 공유 API 키를 저장하지 않습니다.
템플릿 파일을 올리면 무엇이 달라지나요?
템플릿 파일을 올리면 무엇이 달라지나요?
업로드한 템플릿을 기반으로 문서가 생성됩니다. 회사 표준 서식·표지가 있는 템플릿을 올리면 그 형식을 유지한 채 내용만 채워 만듭니다.
다음 단계
스킬
직접 작성하는 재사용 지침서로 에이전트의 작업 방식을 표준화합니다
에이전트에 연결
문서 생성기와 외부 연동을 에이전트에 붙여 활용합니다