메인 콘텐츠로 건너뛰기
연결은 AWS 계정, Kubernetes 클러스터, GitHub 조직처럼 하나의 외부 서비스를 위해 저장한 자격 증명입니다. 서비스를 한 번 연결하면 CloudThinker와 커스텀 에이전트가 별도 설정 없이 사용할 수 있습니다.

연결 추가

1

서비스 선택

아래 카탈로그를 탐색하여 연결할 서비스의 가이드를 여세요.
2

자격 증명 생성

가이드에 따라 최소 권한 자격 증명을 생성하세요 — 가능한 경우 읽기 전용으로.
3

연결

CloudThinker에서 Connections으로 이동하고 서비스를 선택한 후 자격 증명을 입력하세요. 연결이 Connected 상태를 표시합니다.
4

검증

에이전트에게 새 연결을 대상으로 질문해보세요. 각 가이드에 검증 프롬프트가 포함되어 있습니다.

Environment 설정

각 연결에는 Environment가 있습니다: Production, Staging, Development, Not set 중 하나입니다. 이는 연결을 읽는 사람과 에이전트를 위한 레이블입니다. 에이전트의 변경을 실행할지, 사람의 승인을 기다릴지, 거부할지 결정하는 조건인 Rules는 이 값을 읽지 않습니다.
연결 대화상자는 environment를 묻지 않으므로 연결한 직후에 설정하세요. Microsoft Azure처럼 연결을 하나만 가질 수 있는 서비스와 GitHub처럼 OAuth로 로그인하는 모든 서비스는 Not set에서 변경할 수 없습니다. 연결마다 다르게 다루려면 해당 연결을 이름으로 지정하는 Rule을 작성하세요.
여러 연결을 지원하는 서비스에서는 각 계정이 서비스 상세 패널의 행으로 표시됩니다. 계정 행의 연필 아이콘을 클릭하고 Edit Instance 대화상자에서 Environment를 업데이트하세요.

연결한 다음에 일어나는 일

연결이 처음 Connected가 되면 CloudThinker가 Discovery를 실행합니다. 방금 연결한 서비스를 백그라운드에서 한 번 조사하는 작업입니다. 결과는 연결 상세 패널의 Discovery 섹션에 채워집니다. Discovery는 자동으로 한 번, 최대 30분간 실행됩니다. 가장 먼저 얻는 유용한 답이 되는 경우가 많으므로 첫 프롬프트를 작성하기 전에 확인하세요. 자격 증명의 권한을 넓힌 뒤처럼 필요할 때는 Run Discovery로 다시 실행할 수 있습니다. 재실행에는 워크스페이스 Admin 역할이 필요합니다. Discovery는 크레딧을 사용하며, 비용은 서비스가 보유한 데이터 양에 따라 달라집니다. 일일 크레딧은 사용할 수 없으므로 워크스페이스 잔액에 크레딧이 있어야 합니다. 잔액이 부족하면 알림과 함께 일시 중지되므로, 크레딧을 추가한 다음 Run Discovery를 클릭하세요. Discovery는 채팅과 같은 도구와 Approvals를 사용하지만 답해 줄 사람이 없으므로 승인을 기다리지 않습니다. 사람에게 물어야 하는 호출은 건너뛰고, Discovery는 가능한 읽기만으로 계속 진행합니다. 시간 제한에 도달하면 Partial discovery로 끝나고 이미 검증한 결과를 유지합니다. 아무것도 검증하지 못하면 Discovery could not finish가 표시됩니다. 두 경우 모두 연결은 계속 작동합니다.

접근 권한이 작동하는 방식

모든 연결은 하나의 워크스페이스에 속합니다. 해당 워크스페이스에서 작업하는 사람은 누구나, CloudThinker와 커스텀 에이전트까지 포함해, 다시 설정하지 않고 사용할 수 있습니다. 조직 Owner와 Admin은 모든 워크스페이스에서 Admin을 갖습니다. 워크스페이스 역할을 참조하세요.
이 설정이 있는 대부분의 연결에서 Allow writes는 기본적으로 켜져 있습니다. AWS, Google Cloud, Azure, Kubernetes, GitHub, GitLab이 여기에 해당합니다. Docker Hub와 Snowflake처럼 일부는 꺼진 상태로 시작합니다. 연결한 자격 증명에 쓰기 권한이 조금이라도 있으면 에이전트는 연결한 순간부터 변경을 제안할 수 있고, Rules와 Approval mode가 각 제안을 판단합니다. 이를 기본적으로 끄는 워크스페이스나 조직 설정은 없으므로, 통제 수단은 읽기 전용 자격 증명을 쓰는 것과 연결마다 Allow writes를 끄는 것 두 가지입니다.
에이전트가 연결로 무엇을 할 수 있는지는 두 가지 통제가 결정합니다. Manual은 쓰기마다 사람에게 묻습니다. 새 워크스페이스의 기본값은 Auto · Rules + AI · Ask me로, Allow Rule이나 AI 판단이 안전한 변경을 승인하고 나머지는 사용자에게 묻습니다. Allow Rule이 실제로 판단하는 것은 CloudThinker가 해당 워크스페이스에 Rule 적용을 켠 뒤부터이며 이 기능은 기본적으로 꺼져 있으므로, 그때까지는 Manual을 선택하세요. 각 설정 가이드의 Write access 또는 Agent capabilities 섹션에 해당 연결이 어떤 상태로 시작하는지 적혀 있습니다. 토글이 없는 연결도 있습니다. 이 경우 자격 증명이 상한을 정하고 모든 변경은 Approvals를 거칩니다. Rancher처럼 읽기 전용인 연결에는 허용할 쓰기 작업이 아예 없습니다.

비공개 서비스에 연결하기

연결은 CloudThinker Cloud에서 실행되므로 서비스가 인터넷에서 오는 연결을 받을 수 있어야 합니다. 내부 vCenter, PostgreSQL, Prometheus, Argo CD처럼 사설 네트워크에 있는 것에서는 이 점이 문제가 됩니다.

자격 증명 교체

저장된 자격 증명은 연결을 끊지 않고 교체할 수 있습니다. 연결은 별칭, 설정, 이력을 그대로 유지합니다. AWS IAM 역할 연결은 수명이 짧은 STS 자격 증명을 사용하므로 교체할 것이 없고 External ID도 그대로입니다. 액세스 키, 클라이언트 시크릿, JSON 키, API 토큰은 교체가 필요합니다.
1

공급자에서 새 자격 증명 생성

새 키나 토큰을 먼저 만듭니다. 교체가 끝날 때까지 기존 것은 활성 상태로 둡니다.
2

CloudThinker에서 교체

More → Workspace settings → Connections에서 서비스를 열고 계정 행의 연필 아이콘을 클릭한 다음, Edit Instance에서 저장된 자격 증명 옆의 **Replace…**를 클릭합니다. 새 값을 입력하고 Save and test를 클릭합니다.Success state: 테스트가 통과하고 연결이 Connected 상태를 유지합니다. 테스트가 실패하면 CloudThinker는 이전 자격 증명을 유지하고 오류를 표시합니다.
3

기존 자격 증명 폐기

공급자에서 기존 키를 삭제하거나 비활성화합니다.
Microsoft Azure처럼 연결을 하나만 가질 수 있는 서비스에는 연필 아이콘이 없습니다. 이들의 Replace credentials 버튼은 연결이 Error일 때만 나타나므로, 미리 교체하려면 연결을 끊고 새 값으로 다시 연결해야 합니다. 예외는 토큰을 사용하는 Git 공급자(GitLab, Bitbucket, Azure DevOps, AWS CodeCommit)입니다. Review 설정이 끝났다면 연결을 끊지 않고 Review → Settings → Connection actions → Update token에서 토큰을 교체할 수 있습니다. 연결을 끊고 다시 연결하면 새 연결이 되므로 한가한 시간대로 계획하세요.
  • 끊은 시점부터 다시 연결할 때까지 에이전트, 예약된 automation, Optimize 갱신은 그 서비스를 사용할 수 없습니다.
  • Discovery가 다시 실행되고 크레딧을 사용합니다.
  • Allow writes가 기본값으로 돌아갑니다. 대부분의 연결에서 기본값은 켜짐입니다. 껐던 경우에는 다시 끄세요.
  • 해당 연결을 이름으로 지정한 Rules가 여전히 일치하는지 확인하세요.
대부분의 OAuth 연결에는 교체할 자격 증명이 없습니다. 로그인된 계정을 바꾸려면 연결을 끊고 다시 연결하세요.

연결이 끊어졌을 때

백그라운드에서 자격 증명이 작동을 멈추면(토큰 만료, 키 폐기, 역할 삭제) 연결이 Error로 바뀝니다. AWS에서는 백그라운드 실패가 연속 세 번 발생해야 하므로 한 번의 일시적 오류로는 바뀌지 않습니다. 다른 연결은 백그라운드 토큰 갱신이나 실행이 인증 실패에 부딪힌 시점에 바뀝니다. 워크스페이스 admin은 장애 1건당 하나의 알림을 받습니다. 재시도 실패마다 받는 것이 아닙니다. 직접 실행한 테스트는 누구에게도 알리지 않습니다. 연결이 Error인 동안에는 그 연결에 의존하는 예약 작업이 건너뛰어집니다. Optimize 비용 갱신, 예약된 automation, Pulse 알림 수집이 여기에 포함됩니다. 복구 방법:
  1. 공급자에서 원인을 해결합니다. 예를 들어 역할을 복원하거나 새 키를 발급합니다.
  2. 연결을 엽니다. 상세 패널에 오류가 표시됩니다. Retry를 클릭해 저장된 자격 증명을 다시 테스트하거나, Replace credentials를 클릭해 새 값을 입력합니다. OAuth 연결은 Connect를 클릭해 다시 로그인합니다.
  3. 상태가 Connected로 돌아오면 예약 작업은 다음 주기부터 재개됩니다.

연결 해제

More → Workspace settings → Connections에서 서비스를 엽니다. 계정 행이 있는 서비스에서는 계정 행의 휴지통 아이콘을 클릭합니다. 연결을 하나만 가질 수 있는 서비스에서는 상세 패널의 Disconnect를 클릭합니다. Disconnect 대화상자에서 확인합니다. 이 작업은 취소할 수 없습니다. 해제가 끝나는 즉시 에이전트는 해당 서비스에 대한 접근을 잃습니다. 연결을 해제해도 공급자 쪽의 역할, 키, 토큰은 삭제되지 않으므로 그 다음에 공급자에서 삭제하세요. 서비스를 다시 연결하면 새 연결이 됩니다.
  • Discovery가 다시 실행되고 크레딧을 사용합니다.
  • Allow writes는 기본값으로, Environment는 Not set으로 돌아갑니다.
  • Rules는 Alias로 연결을 일치시킵니다. 다시 연결할 때 같은 Alias를 사용하면 그 연결을 지정한 Rule이 계속 일치합니다.

클라우드 플랫폼

인프라 & 접근

데이터베이스

메시징 & 스트리밍

관찰 가능성 & 모니터링

CI/CD & 코드 품질

인시던트 & 티켓

커스텀 MCP

카탈로그에 없는 서비스는 커스텀 MCP 연결로 추가하세요 — 별도의 커넥터 코드가 필요하지 않습니다.

보안

  • 최소 권한 — 에이전트가 사용 사례에 필요한 권한만 부여하세요. 읽기 전용으로 시작한 후 필요에 따라 확장하세요.
  • 기본 읽기 전용 — 에이전트가 이 연결을 통해 변경 작업을 수행하게 할 것이 아니라면 읽기 전용 자격증명을 사용하세요.
  • 자격증명 교체 — 정기 일정에 따라 키와 토큰을 교체하세요. 연결을 업데이트하면 CloudThinker가 새 값을 자동으로 반영합니다.
  • 오프보딩 시 취소 — 연결을 삭제하거나 팀원이 퇴사할 때 프로바이더에서 자격증명을 제거하세요.

관련 문서

AWS 연결

IAM 역할 또는 액세스 키로 가장 일반적인 첫 번째 연결을 설정하세요.

커스텀 MCP 연결

Model Context Protocol을 지원하는 모든 도구로 에이전트를 확장하세요.

에이전트 소개

CloudThinker가 연결로 무엇을 하는지 확인하세요.

자동화 & 자율성

에이전트가 Manual 또는 Auto 모드로 연결된 서비스에서 작동하게 하세요.