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

# 커넥터: GitHub, Gmail 및 기타 앱

> 커넥터를 사용하면 클라우드 세션이 사용자 명의로 GitHub, Gmail 등의 서비스에 접근할 수 있습니다. 이 페이지에서는 연결, Gmail 접근 수준, 인증 만료와 재연결, 전송 확인, 접근 권한 관리와 연결 해제를 설명합니다.

**커넥터** 는 AIHubMix Cloud가 사용하도록 사용자가 인증한 서드파티 계정입니다. 연결하면 클라우드 세션이 사용자 명의로 이 서비스들을 읽고 쓸 수 있습니다. 예를 들어 GitHub 저장소를 가져오거나 Gmail을 검색할 수 있습니다. 인증은 브라우저에서 진행하며 토큰을 입력할 필요가 없습니다.

커넥터는 계정만 다룹니다. 에이전트 기능 확장(플러그인, MCP, Skills)은 [플러그인 / MCP / Skills](https://docs.aihubmix.com/ko/cloud/integrations/plugins-mcp-skills.md)에서 관리합니다.

## 사용 가능 여부

데스크톱 앱, 웹 앱, 모바일 웹에서 지원됩니다. 커넥터는 클라우드 세션에서만 사용되며 사용자 기기의 구성을 변경하지 않습니다. 커넥터 하나당 계정 하나를 연결합니다.

## 찾는 위치

* **Settings › Integrations › Connectors**.
* GitHub를 연결하기 전에 **Import from GitHub** 로 프로젝트를 만들 때 **Connect GitHub** 를 클릭합니다.

## Connectors 페이지

페이지는 **Code**(GitHub), **Email**(Gmail), **Connected apps**, **More apps** 그룹으로 나뉩니다. 각 행에는 이름과 상태가 표시됩니다.

| 상태 | 할 수 있는 작업 |
| - | - |
| 연결 안 됨 | **Connect** 를 클릭합니다 |
| **● Connected · account** | **Manage** 를 클릭해 접근 권한을 보거나 연결을 해제합니다 |
| **● Authorization expired · account** | **Reconnect** 를 클릭합니다. 보통 해당 서비스에서 인증을 철회한 경우입니다 |

연결할 수 있는 앱은 페이지에 표시된 앱입니다.

## 앱 연결

1. 앱의 행에서 **Connect** 를 클릭합니다(Gmail은 먼저 접근 수준을 선택합니다. 아래 참고).
2. 브라우저에 해당 서비스의 인증 페이지가 열립니다. 그곳에서 인증을 완료합니다. 페이지가 나타나지 않으면 **Reopen browser** 를 클릭합니다.
3. 완료되면 AIHubMix Cloud로 돌아옵니다. 앱이 연결됨 상태로 표시됩니다.

인증이 완료되지 않으면 **Authorization not completed** 와 이유가 표시됩니다. **Try again** 또는 **Reconnect** 를 클릭해 다시 시도합니다. 다른 계정이 이미 연결되어 있다고 표시되면, 계정을 바꾸기 위해 먼저 기존 연결을 해제합니다.

## GitHub

GitHub를 인증하면 저장소를 프로젝트로 가져오고, 클라우드 서버에서 코드를 가져오고, 브랜치를 푸시하고 PR을 열 수 있으며, 세션에서 이슈와 PR을 읽고 코드를 검색할 수 있습니다. 접근 가능한 저장소와 조직은 GitHub에서 선택합니다. 조직이나 저장소를 추가하려면 관리 페이지에서 **Manage on GitHub** 를 클릭합니다.

GitHub 연결을 해제하면 기존 클라우드 환경에서 더 이상 코드를 가져오거나, 브랜치를 푸시하거나, PR을 열 수 없습니다. 환경의 파일은 유지됩니다.

## Gmail

Gmail에는 두 가지 접근 수준이 있으며, 에이전트는 이메일을 보내기 전에 **항상** 세션에서 사용자의 승인을 요청합니다. AIHubMix 계정 하나당 Google 계정 하나만 연결할 수 있습니다.

| 수준 | 에이전트가 할 수 있는 작업 |
| - | - |
| Read and send(기본값) | 이메일 검색 및 읽기, 사용자 대신 이메일 보내기 |
| Send only | 사용자 대신 이메일 보내기만 가능하며, 이메일을 검색하거나 읽을 수 없습니다 |

* **접근 수준 변경**: Gmail 관리 페이지에서 **Change granted access** 를 클릭하고, 새 수준을 선택한 다음 **Authorize with Google** 을 클릭합니다.
* **재연결**: 인증이 만료되면 **Reconnect** 를 클릭합니다. 현재 수준이 유지됩니다.
* **Read and send** 를 선택했지만 Google 인증 페이지에서 읽기 권한을 선택하지 않았다면, Gmail 행에 **Send only** 가 표시되고 에이전트는 아직 이메일을 읽을 수 없습니다. **Change granted access** 를 클릭해 다시 인증하고 읽기 권한을 선택하세요.

### 보내기 전 확인

에이전트가 이메일을 보내려고 하면 먼저 세션에 **Confirm before sending** 을 표시하고 보내는 사람, 받는 사람, 제목, 본문을 보여 줍니다. **Send** 또는 **Don't send** 를 클릭합니다. 관리 페이지의 권한 스위치로는 이 확인을 건너뛸 수 없습니다. 연결된 Outlook 계정으로 이메일을 보낼 때도 확인이 필요합니다.

## 커넥터 관리와 접근 권한

연결된 앱에서 **Manage** 를 클릭하면 **Manage connector** 가 열리며, 연결된 계정과 접근 권한을 확인하고 **Disconnect** 할 수 있습니다.

### 접근 권한

접근 권한 목록은 해당 서비스에서 계정이 실제로 부여받은 권한을 기반으로 하므로, 항목은 앱과 계정에 따라 다릅니다.

* 부여된 권한은 스위치로 끄거나 켤 수 있습니다. 변경 사항은 저장에 성공한 후에만 적용됩니다. 권한을 끄면 세션이 해당 기능을 호출할 때 차단됩니다.
* 회색으로 표시되어 전환할 수 없는 항목은 이 계정에 부여되지 않았거나, 편집할 수 없거나, 재연결이 필요한 권한입니다. 접근 범위를 넓히려면 다시 인증합니다.
* 부여된 권한을 저장하거나 불러오지 못하면 **Reload access** 를 클릭하고 다시 시도합니다.

### 연결 해제

1. 관리 페이지에서 **Disconnect** 를 클릭합니다.
2. 확인 대화 상자에서 **Disconnect** 를 클릭합니다. 연결을 해제하면 클라우드 작업이 이 앱에 접근할 수 없게 됩니다. 언제든지 다시 연결할 수 있습니다.

연결 해제에 실패하면 연결이 유지됩니다. **Reload access** 를 클릭하고 다시 시도합니다.

## 참고 및 제한 사항

* 커넥터 하나당 계정 하나만 연결할 수 있습니다. 계정을 바꾸려면 먼저 연결을 해제합니다.
* 커넥터는 클라우드 세션에만 적용되며 사용자 기기의 구성을 변경하지 않습니다.
* 표시되는 권한과 변경 가능 여부는 해당 서비스에서 실제로 부여된 권한에 따라 다릅니다.

## 자주 묻는 질문

### GitHub 토큰을 입력해야 하나요?

아니요. 모든 커넥터는 브라우저 인증을 사용합니다.

### GitHub 또는 Gmail에 "Authorization expired"가 표시되면 어떻게 하나요?

보통 해당 서비스에서 인증이 철회된 경우입니다. 행에서 **Reconnect** 를 클릭하세요. Gmail은 이전 수준을 유지합니다.

### GitHub 연결을 해제하면 프로젝트가 삭제되나요?

아니요. 클라우드 환경의 파일은 유지됩니다. 해당 환경에서 더 이상 코드를 가져오거나, 브랜치를 푸시하거나, PR을 열 수 없습니다.

### 에이전트가 내 승인 없이 이메일을 보내나요?

아니요. 수준이나 권한 스위치와 관계없이 에이전트는 보내기 전에 세션에서 확인을 요청합니다.

## 관련 문서

* [플러그인 / MCP / Skills](https://docs.aihubmix.com/ko/cloud/integrations/plugins-mcp-skills.md)
* [사용자 개입](https://docs.aihubmix.com/ko/cloud/sessions/user-intervention.md)
* [프로젝트](https://docs.aihubmix.com/ko/cloud/projects/projects.md)


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