> 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/resources-context/integrations.md).

# 연동

**리소스 및 컨텍스트** 탭 안의 **연동** 서브탭에서는 이 워크스페이스의 MCP 서버 연결과 플러그인을 관리합니다. **MCP 서버**와 **플러그인**의 2가지 섹션으로 구성됩니다.

## 사전 조건

| 작업                                    | 필요한 권한                  |
| ------------------------------------- | ----------------------- |
| MCP 연결·플러그인 목록 보기                     | 전체 구성원                  |
| MCP 연결 추가·편집·삭제                       | 관리자 / 소유자 또는 워크스페이스 매니저 |
| Nexus·Aximo·Slack 채널 플러그인 설정 추가·편집·삭제 | 관리자 / 소유자 또는 워크스페이스 매니저 |

## 연동 탭 접근하기

1. 워크스페이스 페이지에서 **리소스 및 컨텍스트** 탭을 선택합니다.
2. **연동** 서브탭을 선택합니다.

<figure><img src="https://1016798916-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoYYKu2VRfV5iT1y7lkvp%2Fuploads%2Fgit-blob-a93938da0741bb011b65c577e4c83575179c4c12%2Fresources-context-integrations-tab.png?alt=media" alt="리소스 및 컨텍스트의 연동 서브탭 스크린샷"><figcaption><p>리소스 및 컨텍스트의 연동 서브탭</p></figcaption></figure>

## 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="https://1016798916-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoYYKu2VRfV5iT1y7lkvp%2Fuploads%2Fgit-blob-20855d75b93db713da7d5708a7ff1ba1bab944ae%2Ficon-lucide-square-pen.svg?alt=media" alt="" data-size="line">을 클릭하십시오.
2. **이름**이나 **URL**·인증 방식·인증 정보를 변경하십시오.
3. **연결 및 저장**을 클릭하십시오.

### 연결 삭제하기

1. 삭제하려는 연결 카드의 **연결 삭제** <img src="https://1016798916-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoYYKu2VRfV5iT1y7lkvp%2Fuploads%2Fgit-blob-690270a5f4858b1f05ac9c07e6a54d8fa97e21ea%2Ficon-lucide-trash.svg?alt=media" alt="" data-size="line">를 클릭하십시오.
2. 확인 대화 상자에서 **연결 삭제**를 클릭하십시오.

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

### 연결 상태 확인하기

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

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

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

연결 카드의 **도구 목록** <img src="https://1016798916-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoYYKu2VRfV5iT1y7lkvp%2Fuploads%2Fgit-blob-0d88fb189cde6db143ee290aa12c255d7344f13c%2Ficon-lucide-list.svg?alt=media" alt="" data-size="line">을 클릭하면 그 MCP 서버가 제공하는 도구 목록을 확인할 수 있습니다. 도구 이름·설명·매개변수가 목록으로 표시됩니다. 검색으로 목록을 좁히고 현재 조건에 맞는 도구 수를 확인할 수 있습니다. 각 도구의 **입력 스키마**는 필요할 때만 펼쳐서 매개변수를 살펴보십시오.

## 플러그인

이 워크스페이스에서 이용할 플러그인을 관리합니다. Autify 제품과의 연동(Nexus·Aximo), 조직 측에서 연결한 외부 서비스(Slack), 그리고 개인 Google 드라이브 연결을 다룹니다.

### Nexus

Autify Nexus를 연결하면 이 프로젝트에서 테스트 플랜을 실행하고 결과를 가져올 수 있습니다.

1. **Nexus** 카드에서 **연결**을 클릭하십시오.
2. **Nexus URL**에 Nexus API 클라이언트 자격 증명에 표시된 URL을 붙여넣으십시오. MCP 엔드포인트는 Genesis가 자동으로 추가합니다.
3. **API 토큰**에 Nexus의 **설정 → 클라이언트 관리**에서 생성한 토큰을 입력하십시오.
4. **저장**을 클릭하십시오.

연결하면 카드에 연결 상태(**정상** / **오류** / **확인 중…** / **알 수 없음**)와 연결된 엔드포인트가 표시됩니다. URL이나 토큰을 변경하려면 **편집**을 클릭하십시오. 연결을 해제하려면 **연결 해제**를 클릭하십시오.

### Aximo

Aximo API 키를 등록하면 워크플로에서 Autify Aximo의 기능을 호출할 수 있게 됩니다.

1. **Aximo** 카드에서 **연결**을 클릭하십시오.
2. Aximo **API 키**를 입력하고 **연결**을 클릭하십시오.

{% hint style="info" %}
API 키는 Aximo 앱의 설정 화면에서 발급할 수 있습니다.
{% endhint %}

연결하면 카드에 연결 상태(**정상** / **오류** / **확인 중…** / **알 수 없음**)가 표시됩니다. 연결을 해제하려면 카드의 **연결 해제**를 클릭하십시오.

### 이 워크스페이스의 Slack 채널

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

### Google 드라이브

{% hint style="info" %}
**Google 드라이브** 카드는 이 환경에서 Google 드라이브 연동이 활성화된 경우에만 표시됩니다.
{% endhint %}

개인 Google 계정을 연결하면 이 워크스페이스에 공유한 Google 스프레드시트 파일을 AI가 읽고 편집할 수 있게 됩니다. 이 연결은 개인 단위이며, 역할과 관계없이 모든 구성원이 자신의 Google 계정을 연결할 수 있습니다.

1. **Google 드라이브** 카드에서 **Google 계정 연결**을 클릭하고 Google 로그인을 완료하십시오.
2. **파일 추가**를 클릭하고 Google 파일 선택기에서 공유할 스프레드시트를 선택하십시오.

추가한 파일은 **이 프로젝트에 공유된 파일**에 표시됩니다. 각 파일의 **편집 허용**을 켜면 AI가 파일을 편집할 수 있습니다(기본값은 읽기 전용). 공유를 중단하려면 **삭제**를 클릭하십시오. 파일은 공유한 구성원 본인, 또는 **관리자** / **소유자** / **워크스페이스 매니저** 역할을 가진 구성원이 관리할 수 있습니다.

Google 계정 연결을 해제하려면 카드의 **연결 해제**를 클릭하십시오. 해제하면 이 워크스페이스에 공유했던 파일에 AI가 더 이상 접근할 수 없습니다.

{% hint style="info" %}
파일 선택기는 삽입된 Google 화면에서 동작하므로 `google.com`의 서드파티 쿠키가 필요합니다. 이미 Google에 로그인했는데도 로그인을 요구한다면 이 사이트에서 서드파티 쿠키를 허용한 후 다시 시도하십시오.
{% endhint %}

## 참고 자료

* [리소스 및 컨텍스트 개요](/features-ko/resources-context/resources-and-context-overview.md)