메인 콘텐츠로 건너뛰기
커넥터 는 AIHubMix Cloud가 사용하도록 사용자가 인증한 서드파티 계정입니다. 연결하면 클라우드 세션이 사용자 명의로 이 서비스들을 읽고 쓸 수 있습니다. 예를 들어 GitHub 저장소를 가져오거나 Gmail을 검색할 수 있습니다. 인증은 브라우저에서 진행하며 토큰을 입력할 필요가 없습니다. 커넥터는 계정만 다룹니다. 에이전트 기능 확장(플러그인, MCP, Skills)은 플러그인 / MCP / Skills에서 관리합니다.

사용 가능 여부

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

찾는 위치

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

Connectors 페이지

페이지는 Code(GitHub), Email(Gmail), Connected apps, More apps 그룹으로 나뉩니다. 각 행에는 이름과 상태가 표시됩니다. 연결할 수 있는 앱은 페이지에 표시된 앱입니다.

앱 연결

  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 계정 하나만 연결할 수 있습니다.
  • 접근 수준 변경: 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을 열 수 없습니다.

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

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

관련 문서