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

# 회사 호스팅

> 회사만의 Archetype. 저희가 운영하거나 내 서버에서. 멤버, 역할, 회사 플러그인, 요금.

회사의 Archetype은 그 회사만의 호스트 하나입니다. 멤버, 역할, 대화, 일, 에이전트가 여기 있습니다. 각자는 자기 컴퓨터의 앱과 에이전트를 그대로 쓰고, 거기서 회사 호스트에 참여합니다. 짧은 소개는 [팀용 Archetype](https://docs.archetype.ing/ko/teams/overview.md)에 있고, 이 페이지는 더 자세히 다룹니다.

## 저희가 운영하기

회사마다 `<회사이름>.archetype.ing`에 자기 호스트가 생기고, 운영과 업데이트는 저희가 합니다.

* **만들기.** [콘솔](https://id.archetype.ing/)에서 Google로 로그인하고 회사 이름을 정합니다. 이름이 주소가 되고, 만든 사람이 첫 관리자가 됩니다.
* **다른 회사와 분리.** 회사마다 호스트, 데이터베이스, 에이전트의 명령이 도는 runner가 따로 있습니다. 함께 쓰는 것은 그 아래 장비뿐입니다.
* **모델은 회사 것.** 관리자가 회사의 **관리**에서 ChatGPT에 로그인하거나, Claude를 연결하거나, API 키를 넣습니다. 저희는 토큰이 아니라 호스트와 컴퓨팅을 팝니다.
* **Slack**은 archetype.ing를 거쳐 연결하므로 토큰을 따로 둘 필요가 없습니다.

### 요금

| 플랜 | 월 | 좌석 | 동시 작업 |
| - | - | - | - |
| Starter | ₩69,000 | 3 | 1 |
| Team | ₩279,000 | 10 | 3 |
| Business | ₩829,000 | 30 | 6 |

* 좌석 추가는 플랜과 관계없이 1석당 월 ₩16,000입니다.
* 좌석은 회사 호스트에 로그인하는 멤버 한 명입니다. Slack 같은 채널에서 에이전트와 이야기만 하는 사람은 좌석이 아닙니다.
* 동시 작업은 같은 순간에 돌 수 있는 대화 수입니다. 대화마다 자기 runner에서 돕니다. 사용량으로 매기지 않습니다.
* 카드 없이 14일 동안 Team을 무료로 씁니다. 끝나기 3일 전에 메일을 드리고, 계속 쓰려면 콘솔에서 플랜을 고릅니다.
* 지금은 청구서로 결제합니다. [help@archetype.ing](mailto:help@archetype.ing)로 메일 주세요.
* 결제가 밀리면 7일 동안은 그대로 돌고 그다음 멈춥니다. 회사를 지우면 30일 동안 내보낸 데이터를 보관합니다.

자세한 것은 [요금](https://archetype.ing/ko/pricing/) 페이지에 있습니다.

## 내 서버에서

회사 호스트를 직접 운영하면 무료이고, 호스팅 플랜에 있는 것은 모두 있습니다. 준비된 구성은 Docker Compose로 컨테이너 세 개를 올립니다. 호스트, Postgres, HTTPS를 맡는 Caddy입니다.

80·443 포트가 열린 서버, 그 서버를 가리키는 도메인, Google OAuth 클라이언트(**Web application**, redirect 주소 `https://<내 도메인>/api/auth/callback`)가 필요합니다.

**1. 설정 채우기**

Archetype 저장소의 `deploy/company`에서 `env.example`을 `.env`로 복사하고 `DOMAIN`, `GOOGLE_CLIENT_ID`, `GOOGLE_CLIENT_SECRET`, `ADMINS`(처음 관리자의 이메일), `POSTGRES_PASSWORD`, `ARCHETYPE_HOST_KEY`를 채웁니다.

**2. 시작하기**

```bash theme={null}
docker compose up -d --build
```

처음 시작할 때 회사 설정을 쓰고 로그인 redirect 주소를 출력합니다. OAuth 클라이언트에 넣은 주소와 같은지 확인합니다.

**3. 로그인**

도메인을 열고 Google로 로그인합니다. **관리**에서 모델 키를 넣고, 회사 이름을 정하고, 사람을 초대하고, 일을 둘 곳을 연결합니다.

다른 곳(Kubernetes, 직접 둔 로드밸런서 뒤)도 같은 두 단계입니다. `archetype-server corp init`으로 설정을 쓰고, `archetype-server daemon --cwd DIR --listen --port 8787`을 HTTPS 뒤에서 돌립니다. `GET /healthz`와 `GET /readyz`는 로그인 없이 답합니다.

> [!WARNING]
>
> 이 구성에서는 에이전트의 명령이 호스트의 비밀이 있는 같은 컨테이너에서 돌게 되므로, 명령이 돌 곳(Docker 컨테이너, 세션별 pod, runner)을 사용자 설정의 `environment`로 따로 정하기 전에는 관리자에게도 명령이 실행되지 않습니다.

호스트 키는 데이터베이스 백업과 따로 보관합니다. 키가 없으면 데이터베이스에 봉인된 로그인과 키를 읽을 수 없습니다.

## 멤버

로그인이 곧 참여이고, 회사가 들인 사람만 멤버가 됩니다.

* **초대**: 어느 도메인의 이메일이든 역할과 함께 초대합니다. 그 사람이 처음 로그인할 때 들어옵니다. **참여 방법 복사**로 회사의 참여 링크를 전합니다.
* 도메인 전체(`@example.com`)를 초대하면, 그 도메인을 관리하는 Google Workspace 계정은 누구나 그 역할로 들어옵니다.
* 초대 없이 로그인한 사람은 요청을 남깁니다. 관리자는 사람마다 하루 한 번 알림을 받고, **받아들이기**나 **거절**을 고릅니다.
* 내보낸 멤버는 다시 초대하기 전에는 들어오지 못합니다.

멤버는 앱에서 참여합니다. 사이드바 → \*\*팀 참여…\*\*에서 회사 이름이나 주소를 넣습니다.

## 역할

회사에는 모든 것을 하고 멤버와 역할을 관리하는 **admin**과 **member**가 있습니다. 관리자는 **관리 → 역할**에서 권한을 골라 다른 역할을 만듭니다.

| 묶음 | 권한 |
| - | - |
| 세션 | 자기 대화, 모든 대화 |
| 에이전트 | 명령 실행, 파일 변경, 웹 사용, MCP 서버 사용 |
| 자동화 | 자기 자동화, 모든 자동화 |
| 회사 작업 | 프로젝트, 토론, 지식, 관리 |
| 재무 | 재무 보기, 장부 기록, 경비 청구 |
| 회사 설정 | 멤버, 지침과 스킬, 채널, 작업 출처, 설정 |

**명령 실행**과 **파일 변경**은 호스트 전체와 모든 사람의 작업 공간에 닿으니 관리자 권한처럼 신중히 줍니다. 기본 member 역할에는 자기 대화, 자기 자동화, 프로젝트, 토론, 지식, 경비 청구가 있습니다.

## 회사 플러그인

**프로젝트**, **지식**, **토론**, **재무**는 회사 호스트에 들어 있고 처음부터 켜져 있습니다. 관리자는 회사의 **관리 → 플러그인**에서 플러그인을 켜고 끄며, 어느 역할이 화면을 보고, 다루고, 도구를 쓸지 정합니다. 따로 고르지 않으면 모든 역할이 셋 다 가집니다. [식사](https://docs.archetype.ing/ko/plugins/meals.md)도 같은 방법으로 켭니다. 회사가 직접 만든 비공개 플러그인은 호스트와 같은 권한으로 돈다는 것을 관리자가 받아들여야 설치됩니다. 멤버가 플러그인으로 바꾼 것, 대화에서 부른 도구, 플러그인 설정의 변경은 회사의 감사 기록에 남습니다. [팀 플러그인](https://docs.archetype.ing/ko/plugins/team.md) 참고.

회사 계정(Linear, Notion, Google…)은 관리자가 **관리 → 연결 → 회사 계정**에서 한 번 연결하면 모든 멤버의 에이전트가 회사 규칙에 따라 씁니다.


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