> For the complete documentation index, see [llms.txt](https://help.genesis.autify.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.genesis.autify.com/features-ko/settings/workspace-settings/workspace-configuration.md).

# 워크스페이스 설정

이 문서에서는 워크스페이스 설정 화면에서 할 수 있는 작업과 절차를 설명합니다. 설정 화면에서는 워크스페이스의 기본 정보 변경, 스킬 사용 방식 설정, 외부 MCP 서버 연결 관리, 플러그인 관리, 그리고 워크스페이스 멤버 관리를 할 수 있습니다.

## 사전 조건

워크스페이스 설정 변경은 조직의 **관리자** 또는 **소유자**에 더해, 대상 워크스페이스의 **워크스페이스 매니저**도 실행할 수 있습니다.

{% hint style="info" %}
**멤버** 탭은 **관리자**·**소유자**·**워크스페이스 매니저**에게 표시됩니다. 워크스페이스 내의 역할이 **구성원**인 사용자에게는 표시되지 않습니다.
{% endhint %}

## 설정 화면 접근

1. 왼쪽 사이드바의 워크스페이스 이름 오른쪽에 있는 **메뉴** <img src="/files/5x7iTzm1dplp6iFwxXET" alt="" data-size="line">를 클릭하십시오.
2. **워크스페이스 설정**을 클릭하십시오.

<figure><img src="/files/6SvxDHqZ67q40W0dlDJ8" alt="워크스페이스 이름 옆 메뉴 스크린샷"><figcaption><p>워크스페이스 이름 옆 메뉴</p></figcaption></figure>

설정 화면에는 **일반**·**연동**·**멤버**의 3가지 탭이 있습니다.

<figure><img src="/files/wBAf8Z2ZjZGrhqlUPbJz" alt="워크스페이스 설정 화면의 탭 스크린샷"><figcaption><p>워크스페이스 설정 화면의 탭</p></figcaption></figure>

## 일반 탭 — 기본 정보 변경

**일반** 탭의 **워크스페이스 세부 정보** 섹션에서는 워크스페이스의 이름과 설명을 변경할 수 있습니다.

**일반** 탭에는 **스킬** 섹션도 있으며, 업로드한 `SKILL.md` 파일, 연결한 코드베이스에서 찾아낸 스킬, 그리고 Genesis가 기본 제공하는 내장 스킬을 AI 어시스턴트와 워크플로의 AI 에이전트 블록에서 어떻게 사용할지 설정할 수 있습니다.

모든 워크스페이스에는 `/xlsx-processing`, `/pdf-processing`, `/docx-reports`, `/pptx-processing` 같은 내장 스킬이 처음부터 포함됩니다. 워크스페이스에서 같은 이름의 `SKILL.md`를 업로드하거나 연결한 경우에는, 그 워크스페이스 전용 스킬이 내장 스킬보다 우선합니다.

| 모드 | 설명                                                                         |
| -- | -------------------------------------------------------------------------- |
| 자동 | AI가 모든 스킬을 인식하고 관련할 때 자동으로 사용합니다. `/skill-name`을 입력한 경우에는 항상 해당 스킬이 적용됩니다. |
| 수동 | `/skill-name`으로 명시적으로 참조한 스킬만 사용합니다.                                       |

## 연동 탭 — MCP 연결과 플러그인 관리

**연동** 탭은 **MCP 서버**와 **플러그인**의 2가지 섹션으로 구성됩니다.

### MCP 서버

워크스페이스에서 사용할 외부 MCP(Model Context Protocol) 서버 연결을 등록·관리합니다. 여기서 등록한 연결은 워크플로의 AI 에이전트 블록에서 도구로 이용할 수 있습니다.

각 연결 카드에는 연결 이름, 인증 방식(**OAuth** 또는 **API 키 / 헤더**), 서버 URL, 연결 상태가 표시됩니다.

#### 연결 추가하기

1. **새 연결**을 클릭하십시오.
2. 표시된 프리셋 목록에서 연결할 앱(GitHub Production 등)을 선택하거나, **사용자 지정**을 선택하여 임의의 MCP 서버 URL을 지정하십시오.
3. **서버 세부 정보 입력**에서 다음 항목을 입력하십시오.
   * **이름** — 연결을 식별하기 위한 명칭(예: JIRA Production)
   * **URL** — MCP 서버의 엔드포인트 URL
   * **인증 방식** — **OAuth** 또는 **API 키 / 헤더**를 라디오 버튼으로 선택
4. **다음**을 클릭하십시오.
5. **인증 정보**에서 선택한 인증 방식에 따라 다음을 입력하십시오.
   * **OAuth**를 선택한 경우 보통은 추가 입력 없이 진행합니다. 동적 등록을 지원하지 않는 MCP 서버로 연결할 때만 \*\*고급 (선택 사항)\*\*을 열어 클라이언트 ID·클라이언트 시크릿·토큰 URL·인증 URL·스코프 등을 설정합니다.
   * **API 키 / 헤더**를 선택한 경우 **헤더 키**와 **값**(예: `Authorization: Bearer ...`)을 입력합니다. 헤더 행은 필요에 따라 추가할 수 있습니다.
6. **연결 및 저장**을 클릭하십시오. **OAuth**를 선택한 경우, 이어서 MCP 서버의 인증 페이지로 리디렉션되어 액세스를 승인합니다.

{% hint style="warning" %}
보안상의 이유로 MCP 연결에는 HTTPS의 외부 URL만 등록할 수 있습니다. `http://` URL이나 로컬호스트, 프라이빗 IP, 링크 로컬 주소 등의 내부용 주소는 등록할 수 없습니다. 연결할 수 없는 경우, 네트워크를 통해 도달 가능한 HTTPS의 MCP 서버 URL을 지정하십시오.
{% endhint %}

{% hint style="info" %}
등록된 헤더 값은 화면에서 숨겨집니다(●●●●●●●●). 기존 값을 변경하려면 한 번 삭제한 후 다시 추가하십시오.
{% endhint %}

{% hint style="info" %}
오류가 발생한 경우 TLS/인증서나 인증 헤더, 네트워크 등을 확인하십시오.
{% endhint %}

#### 연결 편집하기

1. 편집하려는 연결 카드의 **MCP 연결 편집** <img src="/files/S3uysTObbRjrvIzntJz6" alt="" data-size="line">을 클릭하십시오.
2. **이름**이나 **URL**·인증 방식·인증 정보를 변경하십시오.
3. **연결 및 저장**을 클릭하십시오.

#### 연결 삭제하기

1. 삭제하려는 연결 카드의 **연결 삭제** <img src="/files/OrbsDljbe3Vhtekk5t5k" alt="" data-size="line">를 클릭하십시오.
2. 확인 대화 상자에서 **연결 삭제**를 클릭하십시오.

{% hint style="warning" %}
연결을 삭제하면 그 연결을 사용하는 워크플로의 블록에서도 도구를 이용할 수 없게 됩니다. 삭제 전에 워크플로에 미치는 영향을 확인하십시오. 구체적으로 연결을 삭제하면, 그 연결을 참조하는 워크플로는 실행 전 검증에서 오류가 됩니다("이 워크스페이스에 존재하지 않는 MCP 연결을 사용하고 있습니다"라는 오류가 표시됩니다). 삭제 전에 대상 워크플로에서 MCP 연결 설정을 변경하거나 불필요한 블록을 삭제하십시오.
{% endhint %}

#### 연결 상태 확인하기

연결 카드의 상태 배지(**정상** / **오류** / **확인 중…** / **인증 필요** / **알 수 없음**)를 클릭하면 MCP 서버로의 연결을 즉시 확인할 수 있습니다.

| 상태     | 설명                                                                                                                                                                                   |
| ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| 정상     | 연결되어 있는 상태                                                                                                                                                                           |
| 오류     | MCP 서버로의 연결 시도 중에 문제가 발생한 상태. 다음 2가지를 확인한 후, 오류라고 표시된 상태 배지를 클릭하여 재연결을 시도하십시오. ·MCP 연결용 URL을 확인한다 ·`Authorization: Bearer xxx` 등의 인증 헤더(Authorization header)가 올바르게 설정되어 있는지 다시 확인한다 |
| 확인 중…  | 연결 가능한지 확인 중인 상태                                                                                                                                                                     |
| 인증 필요  | OAuth 연결의 액세스 토큰이 실효되는 등으로 재인증이 필요한 상태. 상태 배지를 클릭하면 인증 플로를 다시 실행할 수 있습니다.                                                                                                            |
| 알 수 없음 | 연결 가능한지 판정할 수 없었던 상태. 알 수 없음이라고 표시된 상태 배지를 클릭하여 재연결을 시도하십시오.                                                                                                                         |

#### 사용 가능한 도구 확인하기

연결 카드의 **도구 목록** <img src="/files/HhrKIao8f4DwrFSOsH3I" alt="" data-size="line">을 클릭하면 그 MCP 서버가 제공하는 도구 목록을 확인할 수 있습니다. 도구 이름·설명·매개변수가 목록으로 표시됩니다. 검색으로 목록을 좁히고 현재 조건에 맞는 도구 수를 확인할 수 있습니다. 각 도구의 **입력 스키마**는 필요할 때만 펼쳐서 매개변수를 살펴보십시오.

### 플러그인

이 워크스페이스에서 이용할 플러그인을 관리합니다. Autify 제품과의 연동(Aximo)이나, 조직 측에서 연결한 외부 서비스(Slack)의 워크스페이스 단위 설정을 합니다.

* **Aximo** — Aximo API 키를 등록하면 워크플로에서 Autify Aximo의 기능을 호출할 수 있게 됩니다.
* **이 워크스페이스의 Slack 채널** — 이 워크스페이스의 워크플로와 채팅이 게시·읽기할 수 있는 Slack 채널을 선택합니다. 조직에서 Slack이 연결되어 있지 않은 경우 **조직 설정 열기**에서 조직 설정으로 이동하여 Slack을 연결하십시오. 조직 수준에서의 Slack 연결 절차는 [앱](/features-ko/settings/connection-settings/integrations-hub.md) 참조.

## 멤버 탭 — 워크스페이스 멤버 관리

**멤버** 탭에서는 이 워크스페이스에 액세스할 수 있는 조직 구성원을 관리합니다.

{% hint style="info" %}
**멤버** 탭은 **관리자**·**소유자**·**워크스페이스 매니저**에게 표시됩니다. 조직의 **소유자** / **관리자** 역할의 사용자는 모든 워크스페이스에 자동으로 액세스 권한을 가집니다. 멤버 목록에는 "조직 소유자", "조직 관리자"로 표시되지만, 워크스페이스별로 삭제할 수는 없습니다.
{% endhint %}

### 멤버 할당하기

1. **멤버 관리**를 클릭하십시오.
2. 검색 폼에서 이름 또는 이메일 주소를 입력하여 대상 사용자를 좁히십시오.
3. 할당하려는 멤버를 클릭하십시오.

{% hint style="info" %}
조직에 속한 멤버 중, 아직 이 워크스페이스에 할당되지 않은 구성원 역할의 사용자만 목록으로 표시됩니다.
{% endhint %}

### 멤버 제거하기

1. 제거하려는 멤버 행에 있는 **메뉴** <img src="/files/Eif3PfKr886L3Ym6Y3j2" alt="" data-size="line">를 클릭하십시오.
2. **멤버 제거**를 클릭하십시오.

{% hint style="warning" %}
워크스페이스에서 제거된 멤버는 이 워크스페이스의 파일·채팅·워크플로에 액세스할 수 없게 됩니다.
{% endhint %}