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

# 조직 관리하기

> Krea 조직 대시보드에서 회사 전체를 관리하는 방법을 안내합니다. 워크스페이스 생성과 접근 제어, 멤버 초대, Owner와 Admin 등 역할 할당, 도메인 인증까지 조직 관리자가 수행하는 주요 작업을 섹션별로 차례대로 자세히 설명하는 가이드입니다.

**조직 대시보드**는 Owner와 Admin이 회사 전체에 걸친 워크스페이스, 멤버, 인증된 도메인을 관리하는 곳입니다. 이 가이드에서는 각 섹션을 차례로 살펴봅니다.

조직 모델이 처음이라면 먼저 [조직](/docs/user-guide/help-and-support/organizations) 문서를 읽어 보세요.

## 사전 요구 사항

<CardGroup cols={2}>
  <Card title="조직 역할" icon="user-shield">
    조직의 **Owner** 또는 **Admin**이어야 합니다.
  </Card>
</CardGroup>

## 조직 대시보드 열기

Owner와 Admin은 언제든지 계정 메뉴에서 조직 대시보드에 접근할 수 있습니다.

<Steps>
  <Step title="계정 메뉴 열기">
    사이드바 좌측 하단의 계정 아바타를 클릭하세요.
  </Step>

  <Step title="Organization 선택">
    메뉴에서 **Organization**을 선택합니다. 이 옵션은 조직의 Owner와 Admin에게만 표시됩니다.
  </Step>
</Steps>

![Organization 옵션이 표시된 계정 메뉴](https://s.krea.ai/docs/organizations/org-navigation.webp)

## 대시보드 개요

대시보드 상단의 **Overview**에는 크레딧 풀, 이번 달 사용량 상위 워크스페이스, 그리고 한도에 가까운 멤버와 예산이 요약되어 있고, 그 아래로 **Workspaces**, **Members**, **Domains** 세 가지 섹션이 이어집니다.

![Workspaces 테이블이 표시된 조직 대시보드](https://s.krea.ai/docs/organizations/org-admin-header.webp)

## Workspaces

**Workspaces** 섹션에는 조직 내 모든 워크스페이스가 나열됩니다.

| 열 | 표시 내용 |
| - | - |
| **Name** | 워크스페이스 이름. 조직의 기본 워크스페이스에는 **default** 태그가 표시됩니다. |
| **Owner** | 워크스페이스 소유자의 이름과 이메일. |
| **Usage** | 워크스페이스가 소비한 컴퓨트 양. |
| **Access** | 조직 멤버가 워크스페이스에 가입할 수 있는지 여부 — **Public** 또는 **Private**. |
| **Created** | 워크스페이스가 생성된 시점. |
| **Actions** | **⋯** 메뉴에서 워크스페이스의 멤버를 관리하고 사용량을 확인할 수 있습니다. |

검색창으로 이름을 필터링하고, 열 헤더로 정렬할 수 있습니다.

### 워크스페이스 만들기

<Steps>
  <Step title="이름 입력">
    Workspaces 섹션 하단의 **New workspace name** 필드에 이름을 입력하세요.
  </Step>

  <Step title="생성">
    **Create Workspace**를 클릭합니다. 새 워크스페이스가 조직에 추가되고 테이블에 표시됩니다.
  </Step>

  <Step title="접근 권한 설정">
    새 워크스페이스는 기본적으로 **Private**입니다. 조직 멤버가 직접 가입할 수 있게 하려면 **Access** 드롭다운을 **Public**으로 변경하세요.
  </Step>
</Steps>

### 기존 워크스페이스 가져오기

이미 팀원들이 각자의 워크스페이스에서 Krea를 사용하고 있다면, 새로 만드는 대신 해당 워크스페이스를 조직으로 가져오세요. 워크스페이스 소유자의 확인된 이메일 주소가 조직의 [인증된 도메인](/docs/user-guide/help-and-support/domain-verification) 중 하나와 일치하지만 아직 조직에 포함되지 않은 경우, Workspaces 페이지 상단에 가져오지 않은 워크스페이스 수를 알리는 배너가 표시됩니다.

<Steps>
  <Step title="가져오지 않은 워크스페이스 확인">
    배너의 **Review**를 클릭해 **Capture Workspaces** 시트를 엽니다.
  </Step>

  <Step title="워크스페이스 선택">
    목록을 검색하고 가져올 워크스페이스를 선택하세요. 가져오기를 실행하면 워크스페이스와 멤버가 조직으로 이동합니다.
  </Step>

  <Step title="가져오기">
    **Capture workspaces**를 클릭하세요. 워크스페이스에서 선택된 청구 계정은 조직 소유가 되며 선택 상태를 유지하고, 플랜, 구독, 크레딧 잔액은 그대로 유지됩니다. 나중에 워크스페이스가 조직에서 분리되더라도 해당 청구 계정은 조직에 남습니다.
  </Step>
</Steps>

### 워크스페이스 접근 제어

**Access** 드롭다운은 조직 멤버가 워크스페이스에 들어오는 방식을 제어합니다.

| Access | 동작 |
| - | - |
| **Private** | 초대 전용입니다. 멤버는 추가되지 않는 한 워크스페이스를 보거나 가입할 수 없습니다. 새 워크스페이스의 기본값입니다. |
| **Public** | 로그인 후 가입 화면에서 조직 멤버 누구나 워크스페이스를 찾아 가입할 수 있습니다. |

<Tip>
  대부분의 프로젝트 워크스페이스는 **Private**으로 유지하고, 새 팀원이 합류할 때 진입하는 공유 **Public** 워크스페이스(보통 기본 워크스페이스)를 하나 두는 것이 좋습니다.
</Tip>

<h3 id="manage-workspace-members">
  워크스페이스 멤버 관리
</h3>

워크스페이스의 **⋯** 메뉴를 열고 **Members**를 선택해 소속 멤버를 관리하세요.

![역할과 초대 필드가 있는 워크스페이스 멤버 패널](https://s.krea.ai/docs/organizations/org-workspace-members-sheet.webp)

이 패널에서 다음을 할 수 있습니다:

* **멤버와 워크스페이스 역할 확인**.
* 각 멤버 옆의 역할 드롭다운으로 **역할 변경**(Owner, Admin, Member).
* 삭제 아이콘으로 **멤버 제거**.
* **사용자 초대** — 이메일 주소를 하나 이상 입력(쉼표 또는 공백으로 구분)한 뒤 **Invite**를 클릭하세요. 초대된 사용자는 **Member**로 합류합니다.

<Note>
  이 역할은 **워크스페이스**에 적용되며 조직에는 적용되지 않습니다. 사용자의 조직 수준 역할은 [Members](#members) 섹션에 표시됩니다. 차이점은 [역할](/docs/user-guide/help-and-support/organizations#roles)을 참고하세요.
</Note>

### 태그로 정리하기

태그를 만들어 워크스페이스에 할당하면 큰 조직도 쉽게 탐색할 수 있습니다. 하나 이상의 워크스페이스를 선택해 **Add tags** 피커에서 태그를 대량으로 추가하거나 제거하고, 새 이름을 입력해 태그를 만들 수 있습니다. 태그별로 워크스페이스 목록을 필터링하고 그룹화할 수 있으며, 같은 태그로 **Usage** 페이지의 조직 전체 보고서를 필터링할 수 있습니다.

## Members

**Members** 섹션은 조직 내 모든 사용자의 디렉터리입니다. 각 사용자의 이메일, 조직 역할(**Owner**, **Admin** 또는 **Member**), 가입 일자가 표시됩니다.

![역할이 표시된 조직 멤버 목록](https://s.krea.ai/docs/organizations/org-admin-members.webp)

이메일이나 역할로 검색하고, 역할 또는 가입 일자로 정렬할 수 있습니다. 도메인이 인증되면 대부분의 사용자는 [Domain Capture](#domains)를 통해 자동으로 합류합니다.

<Tip>
  팀원이 직접 로그인하기 전에 미리 데려오려면, 해당 워크스페이스의 [Members 패널](#manage-workspace-members)에서 직접 추가하세요.
</Tip>

### 멤버 사용량 제한 설정

플랜에 멤버 사용량 제한 기능이 포함되어 있다면, 각 사용자가 달력 월별로 사용할 수 있는 컴퓨트 양에 상한을 설정할 수 있습니다. 제한은 두 레이어로 작동합니다:

* **Workspace default limit** — 워크스페이스의 모든 멤버에게 적용됩니다. 개별 제한이 설정된 멤버는 해당 제한을 유지합니다.
* **Member limit** — 한 사람에 대한 재정의로, 워크스페이스 기본 제한보다 우선합니다.

제한을 **0**으로 설정하면 모든 사용이 차단됩니다. 제한은 매월 1일에 초기화됩니다. **Overview** 페이지에서는 한도에 가까워지는 멤버를 표시하므로, 작업이 차단되기 전에 조정할 수 있습니다.

## 사용량

활동을 확인하려면 **Usage**를 엽니다. 표시되는 내용은 조직 역할에 따라 다릅니다.

**Owner와 Admin**은 조직 전체 보고서를 확인할 수 있습니다. 날짜 범위를 선택하고, **Workspace**, **User**, **Model**, **Product**로 결과를 그룹화하며, 클라이언트 유형이나 워크스페이스 태그로 좁힐 수 있습니다. 기간 동안의 추이는 영역 차트로 표시되고, 세부 분류 테이블에는 그룹별 합계가 나열됩니다.

**Member**는 **My Usage**를 봅니다: 이번 달부터 현재까지와 전체 기간 컴퓨트 사용량, 일별 차트, 그리고 자신에게 적용되는 워크스페이스별 제한이 표시됩니다.

## Domains

**Domains** 섹션에서는 조직이 소유한 도메인을 인증하고, 해당 도메인 사용자가 합류하고 로그인하는 방식을 구성합니다.

![인증, 캡처 모드, SSO가 표시된 조직 도메인 테이블](https://s.krea.ai/docs/organizations/org-admin-domains.webp)

각 도메인에는 다음이 표시됩니다:

* **Verified** — 도메인이 **Verified**인지, 아직 DNS 검사 중인 **Pending** 상태인지.
* **Capture mode** — 해당 이메일 도메인 사용자가 로그인할 때의 동작: **Off**, **Optional**(가입을 안내받음), **Enforced**(자동으로 등록됨).
* **SSO** — 해당 도메인에 대한 Single Sign-On이 **Required**, **Available**, **Not set up** 중 어느 상태인지.

### 도메인 추가 및 인증

<Steps>
  <Step title="도메인 추가">
    **Add domain** 필드에 회사의 이메일 도메인(예: `acme.com`)을 입력하고 **Add Domain**을 클릭하세요.
  </Step>

  <Step title="소유권 인증">
    새 도메인의 **⋯** 메뉴를 열어 **Verify domain**을 선택한 뒤 Krea가 제공하는 DNS TXT 레코드를 추가합니다. 전체 안내는 [도메인 인증 및 캡처](/docs/user-guide/help-and-support/domain-verification)에서 확인하세요.
  </Step>

  <Step title="캡처 모드 설정">
    인증이 완료되면 일치하는 사용자가 조직에 합류하는 방식을 제어할 **Capture mode**를 선택하세요.
  </Step>
</Steps>

각 캡처 모드와 Single Sign-On 설정에 대한 자세한 내용은 다음을 참고하세요:

<CardGroup cols={2}>
  <Card title="도메인 인증 및 캡처" icon="globe" href="/docs/user-guide/help-and-support/domain-verification">
    도메인 소유권을 인증하고 일치하는 사용자의 등록 방식을 선택하세요.
  </Card>

  <Card title="SAML SSO 설정" icon="key" href="/docs/user-guide/help-and-support/saml-sso-setup">
    ID 공급자를 연결해 팀이 SSO로 로그인하도록 하세요.
  </Card>
</CardGroup>

## 문제 해결

<AccordionGroup>
  <Accordion title="멤버가 워크스페이스에 접근할 수 없어요">
    조직 멤버십이 모든 워크스페이스에 대한 접근을 보장하지는 않습니다. 워크스페이스의 **Access**를 **Public**으로 설정해 가입할 수 있게 하거나, 워크스페이스의 [Members 패널](#manage-workspace-members)에서 직접 추가하세요.
  </Accordion>

  <Accordion title="새 팀원에게 워크스페이스가 자동으로 배정되지 않았어요">
    자동 등록은 **Capture mode**가 Off가 아닌 **인증된 도메인**이 있어야 작동합니다. 도메인이 **Verified** 상태인지 확인하고 [Domains](#domains) 섹션에서 캡처 모드를 검토하세요.
  </Accordion>

  <Accordion title="도메인이 Pending 상태에서 멈춰 있어요">
    DNS 변경 사항이 전파되는 데 시간이 걸릴 수 있습니다. TXT 레코드가 정확히 일치하는지 다시 확인하고 다시 시도하세요. [도메인 인증 문제 해결](/docs/user-guide/help-and-support/domain-verification#troubleshooting) 단계를 참고하세요.
  </Accordion>

  <Accordion title="조직 대시보드를 찾을 수 없어요">
    대시보드는 조직의 **Owner** 및 **Admin**에게만 제공됩니다. 역할이 맞는데도 열리지 않는다면 [support@krea.ai](mailto:support@krea.ai)로 문의하세요.
  </Accordion>
</AccordionGroup>

## 도움이 필요하신가요?

<CardGroup cols={2}>
  <Card title="엔터프라이즈 지원" icon="headset" href="mailto:support@krea.ai">
    엔터프라이즈 지원팀에 **[support@krea.ai](mailto:support@krea.ai)**로 문의하세요.
  </Card>

  <Card title="영업팀" icon="envelope" href="mailto:sales@krea.ai">
    엔터프라이즈 플랜에 대한 문의는 **[sales@krea.ai](mailto:sales@krea.ai)**로 이메일을 보내세요.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.