> 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/CdpsTGujRrN1B0XSDCbz" 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` 파일과 연결한 코드베이스에서 찾아낸 스킬을 AI 어시스턴트와 워크플로의 AI 에이전트 블록에서 어떻게 사용할지 설정할 수 있습니다.

| 모드 | 설명                                                                         |
| -- | -------------------------------------------------------------------------- |
| 자동 | 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/PpQa21C5OynR5HBfN4nF" 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 %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.genesis.autify.com/features-ko/settings/workspace-settings/workspace-configuration.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.