> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloosphere.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 마켓플레이스

> PPT·Word·Excel·HTML 문서 생성기와 Google Workspace·Microsoft 365 연동을 에이전트에 추가하는 Cloosphere 자체 서비스 카탈로그

마켓플레이스(Marketplace)는 **Cloosphere 자체(1st-party) 애드온 서비스 카탈로그**입니다.
문서 생성기(PPT·Word·Excel·HTML)와 외부 SaaS 연동(Google Workspace·Microsoft 365)을 에이전트에 붙여 능력을 확장합니다.

```mermaid theme={null}
flowchart TD
    CAT[마켓플레이스 카탈로그<br/>Cloosphere 자체 서비스] --> K{서비스 종류}
    K -->|문서 생성기| SK[PPT · Word · Excel · HTML]
    K -->|외부 연동| MCP[Google Workspace · Microsoft 365]
    SK --> INST[문서 생성 기능 인스턴스 생성<br/>팔레트 · 템플릿 · 포맷 지정]
    MCP --> CONN[사용자 SSO로 연결]
    INST --> AGENT[에이전트에 연결]
    CONN --> AGENT
    AGENT --> CHAT[채팅에서 자동 활용]
```

<Warning>
  마켓플레이스는 **별도 유상 애드온**입니다. 라이선스에 마켓플레이스 기능이 포함되어 있어야 사용할 수 있으며, 관리자가 [사전 설정](#관리자-사전-설정)을 완료해야 합니다.
</Warning>

***

## 마켓플레이스란?

마켓플레이스에는 두 종류의 서비스가 있습니다. 종류에 따라 연결 방식과 에이전트에 붙는 위치가 다릅니다.

<Columns cols={2}>
  <Card title="문서 생성기" icon="file-lines">
    PPT·Word·Excel·HTML 문서를 만드는 기능입니다. 팔레트·템플릿·포맷을 지정해 **여러 개의 기능(인스턴스)** 을 만들고, 에이전트의 **스킬** 섹션에 붙입니다.
  </Card>

  <Card title="외부 연동 (MCP)" icon="plug">
    Google Workspace·Microsoft 365를 에이전트 도구로 연결합니다. 각 사용자가 **본인 계정으로 로그인(SSO)** 하며, 에이전트의 **마켓플레이스 도구** 섹션에 붙습니다.
  </Card>
</Columns>

### 카탈로그 서비스

| 서비스                       | 종류     | 설명                                           |
| ------------------------- | ------ | -------------------------------------------- |
| **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 등 |

<Note>
  탭 이름은 "마켓플레이스"지만, **워크스페이스 > 마켓플레이스** 첫 화면은 *내가 만든 연결·기능 목록*입니다. 새로 추가하려면 우측 상단 **새 연결** 버튼을 눌러 카탈로그로 이동하세요.
</Note>

***

## 관리자 사전 설정

마켓플레이스를 사용하려면 관리자가 먼저 다음을 설정해야 합니다. 하나라도 빠지면 서비스가 보이지 않거나 동작하지 않습니다.

<Steps>
  <Step title="라이선스 등록">
    **관리자 설정 > 라이선스**에서 마켓플레이스 애드온 기능 키를 등록합니다. 마켓플레이스는 요금제에 포함되지 않는 별도 유상 기능입니다.
  </Step>

  <Step title="서비스 컨테이너 배포">
    문서 생성기는 **코드 실행(Jupyter)** 컨테이너가, 외부 연동은 각 **MCP 서비스** 컨테이너가 필요합니다. 이들은 Cloosphere와 별개로 배포되는 사이드카 컨테이너입니다.
  </Step>

  <Step title="연결 설정">
    **관리자 설정 > 마켓플레이스**에서 각 서비스의 URL을 입력하고 **연결 테스트** 후 **활성화**합니다.

    * 문서 생성기: Jupyter URL + 토큰 입력 → 코드 실행 엔진 활성화
    * MCP 서비스: 서비스 URL 입력 → 활성화(연결 생성)
  </Step>

  <Step title="권한 부여">
    **관리자 설정 > 사용자 > 그룹**에서 그룹에 **마켓플레이스 접근** 권한(읽기/쓰기)을 부여합니다. 기본값은 잠금입니다.
  </Step>
</Steps>

<Note>
  문서 생성기는 **코드 실행 엔진이 준비되지 않으면 카탈로그에서 비활성**으로 표시됩니다(“관리자 > 설정 > 코드 실행에서 설정하세요” 안내). 외부 연동(MCP)은 관리자가 URL을 설정하고 연결해야 카탈로그에 나타납니다.
</Note>

***

## 문서 생성기 만들기

하나의 생성기(예: PPT Generator)에서 **여러 개의 문서 생성 기능**을 만들 수 있습니다. 예를 들어 "회사 표준 덱"과 "고객 제안용 덱"을 각각 다른 색·템플릿으로 준비할 수 있습니다.

<Steps>
  <Step title="카탈로그에서 생성기 선택">
    **워크스페이스 > 마켓플레이스 > 새 연결**에서 원하는 문서 생성기 카드를 클릭합니다.
  </Step>

  <Step title="기능 생성">
    이름·설명·접근 권한을 입력하고 저장합니다. 곧바로 설정 화면으로 이동합니다.
  </Step>

  <Step title="포맷 설정">
    설정 화면에서 색상·템플릿·포맷 지시문을 지정합니다.

    | 설정         | 설명                                                      |
    | ---------- | ------------------------------------------------------- |
    | **색상**     | 기본값 / 프리셋 팔레트 / 커스텀 색상 중 선택 (프리셋과 커스텀은 동시 사용 불가)        |
    | **배경 테마**  | 라이트 / 다크 (PPT·HTML만)                                    |
    | **템플릿 파일** | 생성물의 기반이 될 템플릿 업로드 (PPT=.pptx, Word=.docx, Excel=.xlsx) |
    | **포맷 지시문** | 문서의 톤·구조·섹션 등을 자유 텍스트로 지정 (최대 4000자)                    |
  </Step>
</Steps>

<Tip>
  **포맷 지시문**은 생성 품질에 큰 영향을 줍니다. "표지 → 목차 → 핵심 요약 → 상세 → 결론 순서로, 각 슬라이드는 3개 이내 불릿" 처럼 구체적으로 적으세요.
</Tip>

<Note>
  만든 문서 생성 기능은 **워크스페이스 > 스킬** 목록에도 함께 표시됩니다(내부적으로 스킬이기 때문). 색상·템플릿 등 설정은 **마켓플레이스 편집 화면에서만** 수정할 수 있습니다.
</Note>

***

## 외부 연동 (MCP) 연결

Google Workspace·Microsoft 365를 에이전트 도구로 연결합니다.

<Steps>
  <Step title="카탈로그에서 서비스 선택">
    **새 연결**에서 Google Workspace 또는 Microsoft 365 카드를 클릭합니다.
  </Step>

  <Step title="연결 생성">
    이름·설명·접근 권한을 입력해 연결을 만듭니다. URL은 관리자가 설정한 값을 상속합니다.
  </Step>

  <Step title="도구 구성">
    상세 화면에서 **연결 테스트**를 눌러 사용 가능한 도구 목록을 불러오고, 사용할 도구를 선택합니다.
  </Step>
</Steps>

### 사용자 SSO 인증

MCP 연결은 **각 사용자의 SSO 액세스 토큰**을 매 호출에 자동 주입합니다. 별도 API 키가 필요 없으며, 사용자는 해당 제공자(Google / Microsoft)로 로그인하기만 하면 됩니다. 즉 사용자마다 본인 권한 범위에서 도구가 동작합니다.

### 읽기 / 쓰기 승인 (HITL)

각 도구는 읽기/쓰기로 분류됩니다.

| 분류             | 동작                               |
| -------------- | -------------------------------- |
| **읽기 (Read)**  | 자동 승인 — 조회성 작업                   |
| **쓰기 (Write)** | 사용자 승인 필요 — 메일 발송, 파일 생성 등 변경 작업 |

<Tip>
  도구 목록에서 **AI로 분류** 버튼을 누르면 읽기/쓰기를 자동으로 판별합니다. 카테고리별로 OAuth 스코프 권한이 부여됐는지도 함께 표시됩니다.
</Tip>

***

## 에이전트에 연결

마켓플레이스 서비스는 종류에 따라 에이전트 편집기의 **서로 다른 섹션**에서 연결합니다.

| 서비스 종류                                 | 에이전트 편집기 섹션   |
| -------------------------------------- | ------------- |
| 문서 생성기 (PPT·Word·Excel·HTML)           | **스킬**        |
| 외부 연동 (Google Workspace·Microsoft 365) | **마켓플레이스 도구** |

<Warning>
  "마켓플레이스에서 전부 추가"하는 단일 버튼은 없습니다. 문서 생성기는 **스킬 섹션**에서, MCP 서비스는 **마켓플레이스 도구 섹션**에서 각각 선택하세요.
</Warning>

***

## 채팅에서 활용

에이전트에 연결된 마켓플레이스 서비스는 대화 중 자동으로 활용됩니다.

```
사용자: 3분기 실적을 발표자료로 만들어줘

에이전트: [PPT 생성 기능 실행 중...]

📎 다운로드: [3분기 실적 발표.pptx](링크)

3분기 실적 발표자료를 생성했습니다. 표지, 핵심 지표 요약,
부문별 상세, 결론 순으로 12장을 구성했습니다.
```

<Note>
  문서 생성 결과는 답변 위에 **`📎 다운로드`** 링크로 먼저 표시됩니다. "슬라이드 3만 굵게 바꿔줘" 처럼 이어서 요청하면, 전체를 다시 만들지 않고 해당 부분만 정밀하게 수정합니다.
</Note>

<Note>
  외부 연동(Google Workspace 등)의 쓰기 작업(메일 발송 등)은 실행 전 사용자 승인을 요청합니다.
</Note>

***

## 접근 권한과 라이선스

| 구분       | 설명                                                              |
| -------- | --------------------------------------------------------------- |
| **라이선스** | 마켓플레이스는 별도 유상 애드온. 기능 키가 없으면(강제 모드에서) 모든 마켓플레이스 기능이 차단됩니다       |
| **권한**   | 그룹별 **마켓플레이스 접근**(없음/읽기/쓰기). 기본 잠금. 쓰기 권한이 있어야 연결·기능을 만들 수 있습니다 |
| **공유**   | 각 연결·기능은 공개/비공개 및 그룹·조직 단위 읽기/쓰기 권한을 설정할 수 있습니다                 |

***

## 트러블슈팅

<AccordionGroup>
  <Accordion title="카탈로그에 서비스가 없어요" icon="store-slash">
    | 원인          | 해결 방법                         |
    | ----------- | ----------------------------- |
    | 문서 생성기 비활성  | 관리자가 코드 실행(Jupyter)을 설정해야 합니다 |
    | MCP 서비스 미표시 | 관리자가 서비스 URL을 설정하고 연결해야 합니다   |
    | 라이선스 없음     | 마켓플레이스 애드온 라이선스를 확인하세요        |
    | 권한 없음       | 관리자에게 **마켓플레이스 접근** 권한을 요청하세요 |
  </Accordion>

  <Accordion title="문서가 생성되지 않아요" icon="file-slash">
    코드 실행 엔진(Jupyter)이 준비되어야 합니다. **관리자 설정 > 마켓플레이스**의 문서 생성기 상태가 "연결 가능"인지 확인하세요.
  </Accordion>

  <Accordion title="Google/Microsoft 도구가 권한 부족이라고 나와요" icon="key">
    해당 카테고리의 OAuth 스코프가 부여되지 않았습니다. 관리자 동의 또는 재로그인이 필요할 수 있습니다. 상세 화면의 카테고리별 스코프 표시를 확인하세요.
  </Accordion>

  <Accordion title="연결·기능을 비활성화/삭제할 수 없어요" icon="lock">
    사용 중인 에이전트가 있으면 차단됩니다. 사용 중인 에이전트 수가 표시되며, 그래도 진행하려면 강제 확인 절차를 거칩니다.
  </Accordion>
</AccordionGroup>

***

## FAQ

<AccordionGroup>
  <Accordion title="문서 생성기와 스킬은 무슨 관계인가요?" icon="circle-question">
    문서 생성기 기능은 내부적으로 **실행형 스킬**입니다. 그래서 워크스페이스 > 스킬 목록에도 나타나고, 에이전트의 스킬 섹션에서 연결합니다. 차이는 색상·템플릿 등 설정을 마켓플레이스 편집 화면에서 관리한다는 점입니다.
  </Accordion>

  <Accordion title="같은 생성기로 여러 스타일을 만들 수 있나요?" icon="circle-question">
    네. 하나의 PPT Generator에서 팔레트·템플릿이 다른 여러 기능(인스턴스)을 만들 수 있습니다. 각각 별도로 에이전트에 연결하세요.
  </Accordion>

  <Accordion title="외부 연동은 안전한가요?" icon="circle-question">
    각 사용자의 SSO 토큰으로 본인 권한 범위에서만 동작하며, 쓰기 작업은 사용자 승인을 거칩니다. 공유 API 키를 저장하지 않습니다.
  </Accordion>

  <Accordion title="템플릿 파일을 올리면 무엇이 달라지나요?" icon="circle-question">
    업로드한 템플릿을 기반으로 문서가 생성됩니다. 회사 표준 서식·표지가 있는 템플릿을 올리면 그 형식을 유지한 채 내용만 채워 만듭니다.
  </Accordion>
</AccordionGroup>

***

## 다음 단계

<Columns cols={2}>
  <Card title="스킬" icon="wand-magic-sparkles" href="/ko/workspace/skills">
    직접 작성하는 재사용 지침서로 에이전트의 작업 방식을 표준화합니다
  </Card>

  <Card title="에이전트에 연결" icon="robot" href="/ko/workspace/agents">
    문서 생성기와 외부 연동을 에이전트에 붙여 활용합니다
  </Card>
</Columns>