관리자 › 설정 › 마켓플레이스
- 문서 생성기(코드 실행 엔진), 외부 연동(Google Workspace·Microsoft 365 MCP), 도면분석의 URL을 지정하고, 테스트한 뒤 활성화합니다.
관리자 > 설정 > 마켓플레이스 — 연결 상태(서비스별 URL · 연결 테스트 · 활성화)
활성화됨 / 비활성화됨 배지로 표시되고, 그 옆의 새로고침으로 각 서비스의 도달 여부를 다시 확인할 수 있습니다.
전체 구조
마켓플레이스는 카탈로그 메타데이터와 연결 설정만 저장합니다.- 실제 작업을 수행하는 컨테이너(사이드카)는 관리자가 별도로 배포하며, 이 화면은 그 컨테이너의 URL을 가리키기만 합니다.
이미지는 사설 ACR
acrcloosphere.azurecr.io에서 배포됩니다. 고객 VM 배포는 docker compose + .env(ACR 토큰 필수, JUPYTER_TOKEN 권장)로 진행합니다. 문서 생성만 사용한다면 Jupyter 사이드카만 있으면 됩니다.문서 생성기 (코드 실행)
PPT·Word·Excel·HTML 문서 생성 스킬은 Jupyter 코드 실행 엔진에서 번들 스크립트를 실행해 파일을 만듭니다.1
Jupyter URL · 토큰 입력
문서 생성기 카드에 Jupyter 서비스 URL(예:
http://jupyter:8888)과 인증 토큰(JUPYTER_TOKEN)을 입력합니다.2
연결 테스트
연결 테스트를 눌러 Jupyter가 응답하는지 확인합니다. 성공해야 활성화할 수 있습니다.
3
활성화 · 저장
활성화 스위치를 켜고 저장하면 코드 실행 엔진이 켜집니다. 내부적으로
ENABLE_CODE_EXECUTION, CODE_EXECUTION_ENGINE=jupyter, URL·토큰이 기록됩니다.이 설정은 코드 실행 설정과 동일한 엔진을 공유합니다. 한쪽에서 Jupyter를 켜면 문서 생성 스킬과 사용자 코드 인터프리터가 함께 사용합니다.
외부 연동 (MCP 서비스)
Google Workspace·Microsoft 365를 에이전트 도구로 노출합니다.1
서비스 URL 입력
각 MCP 서비스 카드에 컨테이너 URL을 입력합니다(예:
http://gws-mcp:8000/mcp, http://m365-mcp:8001/mcp). 끝에 슬래시를 붙이지 마세요.2
연결 테스트
연결 테스트로 서비스 도달 여부를 확인합니다. 인증이 필요한 MCP 서버는 토큰 없는 프로브에서 401/403이 정상이며 “도달 가능”으로 처리됩니다.
3
활성화
활성화하면 해당 서비스의 마켓플레이스 연결이 생성되어, 워크스페이스 ▸ 마켓플레이스와 에이전트의 마켓플레이스 도구 섹션에 나타납니다.
MCP 사이드카는 passthrough 인증을 사용합니다 — 자체 OAuth를 돌리지 않고 각 사용자의 SSO 토큰을 그대로 신뢰합니다. 따라서 Google OAuth 클라이언트는 Cloosphere 로그인과 동일해야 하며, 서비스별 카테고리는 사용자에게 부여된 OAuth 스코프에 따라 사용 가능 여부가 결정됩니다.
도면분석
DWG/DXF 도면을 코딩 에이전트가 분석하는 자체 서비스입니다. 사용자의 질문에 맞춰 BOM·자재표 재구성, 수량·중량·재질 조회, 도면↔BOM 정합성 교차검증, 노트·리비전·참조도면 확인 등을 수행하고 근거와 함께 답합니다. 연결 방식은 다른 서비스와 같습니다 — 서비스 URL과 토큰을 입력하고 연결 테스트 후 활성화합니다.도면분석 같은 capability 는 마켓플레이스 애드온과 또 별개로 라이선스됩니다. 해당 capability 키가 없으면 카드가
라이선스 없음으로 표시되고 활성화할 수 없습니다 — 라이선스를 참고하세요.상태 배지
각 서비스 카드는 실시간 상태를 표시합니다.
카드 아래에는 현재 상태를 설명하는 안내문이 함께 표시됩니다.
배지는 관리자가 입력한 URL에 지금 도달할 수 있는지만 나타냅니다. 도구가 실제로 동작하는지는 워크스페이스 ▸ 마켓플레이스에서 연결을 만들어 도구 목록을 조회할 때 확인됩니다.
권한 부여
관리자가 서비스를 연결한 뒤, 사용자가 마켓플레이스를 쓰려면 그룹 권한이 필요합니다.- 관리자 설정 > 사용자 > 그룹에서 그룹에 마켓플레이스 접근(없음/읽기/쓰기)을 부여합니다. 기본값은 잠금입니다.
- 연결·기능을 생성하려면 쓰기 권한이 필요합니다.
- 문서 생성기(스킬)를 쓰는 사용자에게는 필요 시 스킬 접근 권한도 부여하세요.
관련 문서
마켓플레이스 (사용자)
사용자가 문서 생성 기능과 MCP 연동을 만들고 에이전트에 붙이는 방법
코드 실행
문서 생성기가 공유하는 코드 실행 엔진(Jupyter) 설정
라이선스
마켓플레이스 애드온 기능 키 등록
스킬 (사용자)
재사용 지침서와 실행형 스킬 개념