> For the complete documentation index, see [llms.txt](https://orbitron.gitbook.io/orbitron-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://orbitron.gitbook.io/orbitron-docs/documentation/ko/user-guide/orbitron-web.md).

# Orbitron Web

🔗 <https://orbitron.megaone.com/ko/dashboard>

**🧭 접근 및 관리**

1. 방문: [https://orbitron.megaone.com](https://orbitron.megaone.com/)
2. 구글 로그인

***

### 🖥️ 메뉴 및 권한 구성

Orbitron Web은 사용자의 권한(관리자/일반 멤버)에 따라 접근 가능한 메뉴가 다르게 표시됩니다.

#### 1. 관리자 (소유자)

조직의 소유자 권한을 가진 사용자는 모든 메뉴에 접근하여 조직, 사용자, 사용량 데이터까지 관리할 수 있습니다.

<table><thead><tr><th width="189.09375">메뉴 항목</th><th>설명</th></tr></thead><tbody><tr><td><strong>컨텍스트 관리</strong></td><td>개인 및 조직의 컨텍스트를 생성, 수정, 삭제하고 검색합니다.</td></tr><tr><td><strong>조직 컨텍스트 승인 관리</strong></td><td>조직 내 컨텍스트 승인 요청을 승인/거절 버튼으로 처리하고 관리합니다.</td></tr><tr><td><strong>MCP 관리</strong></td><td>MCP(Model Context Protocol) 설정을 생성, 수정, 삭제하고 관리합니다.</td></tr><tr><td><strong>조직 및 사용자 관리</strong></td><td>조직 설정, 멤버 초대, 역할, 권한 등의 변경 및 사용자 상태를 관리합니다.</td></tr><tr><td><strong>사용량 분석</strong></td><td>일별/모델별 사용량 추이와 사용 통계를 모니터링합니다.</td></tr></tbody></table>

#### 2. 일반 사용자

일반 사용자는 본인의 컨텍스트를 주도적으로 관리하고 조직 컨텍스트에 동기화를 요청할 수 있습니다.

<table><thead><tr><th width="189.09375">메뉴 항목</th><th>설명</th></tr></thead><tbody><tr><td><strong>컨텍스트 관리</strong></td><td>개인 컨텍스트를 생성, 수정, 삭제할 수 있으며, 조직 컨텍스트를 확인합니다.</td></tr><tr><td><strong>조직 컨텍스트 관리</strong></td><td>본인이 생성 요청한 조직 컨텍스트의 승인의 상태(대기중/처리됨)를 확인합니다.</td></tr><tr><td><strong>MCP 관리</strong></td><td>MCP 설정을 생성, 수정, 삭제하고 관리합니다.</td></tr></tbody></table>

***

#### 📊 대시보드 <a href="#register-context" id="register-context"></a>

대시보드 진입 시 메뉴에 노출되는 핵심 지표로, 컨텍스트의 현황을 직관적으로 확인할 수 있습니다.

<div align="left"><figure><img src="/files/wGhsurstLZa8WuBdDvQ0" alt="" width="291"><figcaption></figcaption></figure></div>

* 전체 컨텍스트 : 조직 전체에 등록된 컨텍스트의 총 개수입니다. (개인/조직별)
* 대기 중인 요청 : 승인을 기다리고 있는 동기화 요청 건수입니다.

***

### 📝 컨텍스트 관리

Orbitron의 핵심 기능인 **컨텍스트**를 목록으로 조회하고, 직접 생성 및 수정하는 메뉴입니다.

컨텍스트는 프로젝트 목표, 구성 요약, 문서화 및 기타 핵심 지식을 참조하여 Orbitron이 더 정확하고 관련성 높은 응답을 제공하도록 설정할 수 있습니다.

#### 1. 컨텍스트 목록 조회

등록된 모든 컨텍스트를 목록으로 확인합니다. 상단 검색바를 통해 원하는 컨텍스트를 빠르게 찾을 수 있습니다.

<figure><img src="/files/bdbu2ssJIUNmmPIhETZm" alt="컨텍스트 목록"><figcaption></figcaption></figure>

* 카테고리 : 컨텍스트의 성격을 분류하는 항목입니다. (예: `devops`, `infra` 등)
* 제목 : 식별 가능한 컨텍스트의 이름입니다.
* 버전 : 해당 컨텍스트의 버전 정보입니다.
* 조직 : 컨텍스트가 조직 컨텍스트일때, 소속된 조직명입니다.
* 생성일 : 컨텍스트가 처음 생성된 날짜입니다.
* 태그 : 사용자가 컨텍스트를 쉽게 검색하고 식별할 수 있도록 직접 설정하는 태그입니다.

#### 2. 컨텍스트 상세 및 기능

컨텍스트 목록에서 항목을 클릭하여 상세 페이지로 이동하면 다음과 같은 작업을 수행할 수 있습니다.

<figure><img src="/files/FveK1Cq7nlurx0lmpZ7I" alt="컨텍스트 상세"><figcaption></figcaption></figure>

* 컨텍스트 복사 : 현재 보고 있는 컨텍스트의 내용을 클립보드에 복사할 수 있습니다.
* 다운로드 링크 : 컨텍스트를 다운로드할 수 있는 링크가 복사됩니다.
* 다운로드 : 컨텍스트 내용을 로컬 파일(Markdown 등)로 다운로드하여 백업하거나 편집기에서 활용합니다.
* 수정 : 내 소유의 컨텍스트의 본문 내용, 카테고리, 태그 등을 수정하고 버전을 업데이트합니다.
* 삭제 : 내 소유의 더 이상 사용하지 않는 컨텍스트를 삭제합니다.

<figure><img src="/files/C5QxFU4q52tZHeXo5XBU" alt="컨텍스트 버전"><figcaption></figcaption></figure>

* **버전 비교**: 이전 버전의 컨텍스트를 선택하여 현재 버전과의 차이점(Diff)을 시각적으로 비교하고 변경 이력을 확인합니다.

#### 3. 컨텍스트 생성 및 수정

`새 컨텍스트` 버튼을 눌러 새로운 컨텍스트를 생성합니다.

<figure><img src="/files/T0czzXEFCCQxpkvqnOUS" alt="컨텍스트 생성"><figcaption></figcaption></figure>

* 컨텍스트 타입 : 생성할 컨텍스트의 유형을 선택합니다.
  * 개인 컨텍스트 – 본인에게만 보임
  * 조직 컨텍스트 – 팀이나 조직에 공유
* 제목 : 컨텍스트의 제목을 입력합니다.
* 카테고리 : 컨텍스트의 분류를 선택합니다. (예: `인프라관리, 클라우드 운영, 보안 검사, 취약점 검사` 등)
* 태그 : 검색과 식별을 돕기 위해 태그를 입력하고 Enter 키를 눌러 추가합니다. (예: `aws`, `terraform`, `cost-optimization`)
* 내용 : Orbitron이 참조할 핵심 지식 내용을 마크다운(Markdown) 형식으로 작성합니다.

#### 💡 Tip: 터미널에서 빠른 접근

Orbitron Web에서 설정한 컨텍스트와 메타데이터는 Orbitron 내에서 컨텍스트를 쉽게 검색하고 참조하는 데 도움이 됩니다:

```
/context
/context:tag ai
/context:category infrastructure
```

`Ctrl + K` 단축키를 사용하여 터미널 내에서 직접 컨텍스트를 선택할 수도 있습니다.

***

### 🔄 조직 컨텍스트 승인 관리

Orbitron에서는 컨텍스트를 **조직 컨텍스트**로 등록 요청할 수 있습니다.

> 💡 **조직 소유자인 경우:** 조직 컨텍스트 추가 요청이 제출되면, 조직 소유자는 목록 화면에서 해당 요청들을 확인할 수 있습니다. 각 요청된 컨텍스트의 세부 정보를 확인하고 **승인** 또는 **거부**를 선택할 수 있습니다. 승인 시 컨텍스트가 전체 조직에 공유되며, 거부 시 해당 컨텍스트는 삭제 처리됩니다.

**승인 로직:**

| 상태                 | 설명                      |
| ------------------ | ----------------------- |
| 개인 컨텍스트            | 생성 시 즉시 승인 (본인이 승인자)    |
| 조직 컨텍스트 (관리자 생성)   | 생성 시 즉시 승인              |
| 조직 컨텍스트 (일반 멤버 생성) | 승인 대기 상태로 생성, 관리자 승인 필요 |

***

### 🔧 MCP 관리

MCP(Model Context Protocol) 설정을 생성하고 관리하는 메뉴입니다. MCP 설정을 통해 다양한 MCP 서버를 구성하고 활용할 수 있습니다.

#### 1. MCP 목록 조회

등록된 모든 MCP 설정을 목록으로 확인합니다.

<figure><img src="/files/aO1ORf7VW1qlDckNHdnl" alt="MCP 목록"><figcaption></figcaption></figure>

* 제목 : MCP 설정의 이름입니다.
* 설명 : MCP 설정에 대한 설명입니다.
* 생성일 : MCP 설정이 처음 생성된 날짜입니다.
* 수정일 : MCP 설정이 마지막으로 수정된 날짜입니다.

#### 2. MCP 생성 및 수정

`새 MCP` 버튼을 눌러 새로운 MCP를 생성합니다.

<figure><img src="/files/s9a46gBwFf6kTzhjwuID" alt="MCP 생성"><figcaption></figcaption></figure>

* 제목 : MCP의 제목을 입력합니다.
* 설명 : MCP에 대한 설명을 입력합니다. (선택사항)
* JSON 설정 : Monaco Editor 기반의 JSON 편집기에서 MCP 서버 설정을 작성합니다.

**JSON 설정 형식:**

MCP는 다음과 같은 JSON 형식으로 작성합니다:

```json
{
  "server-name": {
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-example"]
  }
}
```

**검증 규칙:**

* 서버 이름: 소문자, 숫자, 하이픈(-), 밑줄(\_), 점(.) 허용
* 최소 1개 이상의 서버 설정 필수
* 최대 50개의 서버 설정 가능
* 최대 JSON 크기: 100KB
* 위험 명령어 차단: `rm`, `del`, `format`, `sudo` 등

#### 3. MCP 상세 및 기능

MCP 설정 목록에서 항목을 클릭하여 상세 페이지로 이동하면 다음과 같은 작업을 수행할 수 있습니다:

<figure><img src="/files/JUrwJB66JnMgsom9Yy57" alt="MCP 상세"><figcaption></figcaption></figure>

* 수정 : MCP의 제목, 설명, JSON 내용을 수정합니다.
* 삭제 : 더 이상 사용하지 않는 MCP를 삭제합니다.

#### 💡 Tip: 터미널에서 MCP 설정 동기화

Orbitron Web에서 등록한 조직 공유 MCP 설정은 터미널에서 쉽게 조회하고 다운로드할 수 있습니다:

```
/shared-mcps
```

이 명령어를 실행하면:

* 조직에서 공유한 MCP 서버 설정 목록을 확인할 수 있습니다.
* 원하는 설정을 선택하여 MCP 서버 설정을 적용할 수 있습니다.

***

### 👥 조직 및 사용자 관리

*(관리자 전용 메뉴)*

<figure><img src="/files/r4FpQdBqxnW43dKKYoEs" alt=""><figcaption></figcaption></figure>

조직에 소속된 멤버들을 관리하고 권한을 조정합니다.

* 조직 설정 : 조직의 이름을 수정할 수 있고, 조직에 대한 설명을 작성할 수 있습니다. 소속된 회사는 수정할 수 없습니다.
* 멤버 초대 : 우측 상단 멤버 초대 버튼을 통해 새로운 멤버의 이메일을 입력, 역할과 사용자 권한 선택하고 초대를 발송합니다.
* 멤버 목록 : 소속된 조직의 사용자 목록입니다.
  * 이름 : 소속된 조직의 이름입니다.
  * 이메일 : 소속된 조직 사용자의 계정 이메일
  * 권한 : 현재 권한 (`소유자` 또는 `멤버`)
  * 사용자 권한 : 사용자의 권한 (Execution`실행 가능` 또는 Plan`조회 및 계획 가능`)
  * 가입일 : 사용자가 가입한 날짜
  * 탈퇴 : Orbitron을 사용하지 않는 사용자를 탈퇴시킬 수 있습니다.
* 초대 목록 : 초대 요청을 보낸 목록입니다. 초대 상태를 확인하고, 초대 링크를 복사하여 사용자에게 바로 보낼 수 있으며, 초대를 취소할 수 있습니다.
* SSO 설정 : PoPs Saml 설정 정보와 권장 설정 값을 확인할 수 있습니다.

***

### 📈 사용량 분석

*(관리자 전용 메뉴)*

조직 내 AI 활용 현황을 시각적으로 모니터링합니다.

* **일별 사용량**
  * 조회 조건 : 시작 날짜와 종료 날짜를 선택하여 검색할 수 있습니다.
  * Excel 다운로드 : 조회된 사용량을 Excel로 다운로드 받을 수 있습니다.
  * 조회 결과
    * 총 토큰, 총 비용, 총 요청, 활성 사용자를 조회 날짜에 해당되는 지표를 한 눈에 볼 수 있습니다.
    * Top 5 사용자 : Orbitron의 사용량(토큰 기준)이 제일 많은 상위 5명의 사용자를 볼 수 있습니다.
    * 일별 차트를 토큰 사용량 / 비용 / 요청 수 / 사용자 수 별로 확인할 수 있습니다.
  * 사용자별 일별 사용량
    * 조직 내 사용자별로 사용량을 리스트업하여, 누가 가장 활발하게 Orbitron을 사용하고 있는지 파악할 수 있습니다.
    * 조회 조건 : 시작 날짜와 종료날짜 선택, 이름 또는 이메일로 검색할 수 있습니다.
    * 조회된 조건에 따라 지표를 확인할 수 있습니다.
    * 조회 결과 : 사용자, 날짜, 토큰, 비용, 요청 수를 테이블로 확인할 수 있습니다.
* **모델별 사용량**
  * 조회 조건 : 시작날짜와 종료 날짜를 선택하여 검색할 수 있습니다.
  * 조회 결과
    * 모델별 사용량 분포를 파이차트로 확인할 수 있습니다.
    * 모델별 토큰 사용량을 Input 토큰 / Output 토큰 / Total 토큰으로 비교할 수 있습니다.
  * 모델별 사용량 분석
    * 날짜, 사용자별로 어떤 모델의 토큰을 사용하고 있는지 파악할 수 있습니다.
    * 조회 조건 : 시작날짜와 종료날짜 선택, 이름 또는 이메일로 검색할 수 있습니다.