메인 콘텐츠로 건너뛰기
CloudThinker를 Claude에 연결하면 Claude가 워크스페이스를 읽고 CloudThinker 에이전트 실행을 시작할 수 있습니다. 이 커넥터는 원격 Model Context Protocol(MCP) 서버이며, 현재는 Claude 클라이언트만 연결할 수 있습니다.

사전 요구 사항

  • 하나 이상의 워크스페이스에 접근할 수 있는 CloudThinker 계정
  • Claude(claude.ai 또는 데스크톱 앱) 또는 Claude Code
  • Claude Team 또는 Enterprise 플랜에서는 Claude 조직 소유자가 먼저 커넥터를 추가합니다. 그다음 각 멤버가 개별로 연결합니다.

Claude 연결하기

서버 URL은 모든 경로에서 같습니다.
1

커넥터 추가

Claude에서 Customize → Connectors로 이동해 Add, Add custom connector를 차례로 클릭합니다. Team 및 Enterprise 소유자는 Organization settings → Connectors를 사용합니다.
2

URL 입력

이름을 CloudThinker로 지정하고 서버 URL을 붙여넣은 뒤 Continue를 클릭합니다. 감지된 로그인 설정은 그대로 두고 Add를 클릭합니다.
3

연결 및 승인

Claude가 브라우저에서 CloudThinker로 이동시킵니다. 로그인하고 워크스페이스를 선택한 뒤 Allow를 클릭합니다. Claude가 로그인을 시작하지 않으면 Customize → Connectors에서 커넥터를 열고 연결을 선택합니다.
성공 기준: Claude에 CloudThinker가 연결됨으로 표시되고, 채팅에서 CloudThinker 도구를 사용할 수 있습니다.
이 커넥터는 아직 Claude Connectors Directory에 등록되어 있지 않습니다. 위 URL로 사용자 지정 커넥터로 추가하세요.

승인하는 내용

승인 페이지에는 연결하는 앱의 이름과 Claude가 돌아갈 호스트가 표시됩니다. 이어서 워크스페이스 하나와 세 가지 권한이 표시됩니다.
  • Read incidents, costs, code reviews, automations, and security findings in this workspace
  • Start CloudThinker runs that ask you before any change
  • Act as you, starting in the workspace you pick here; Claude can switch to other workspaces you belong to
로그인은 일반 CloudThinker 로그인을 사용하므로 SSO와 MFA가 적용됩니다. 여러 워크스페이스에 속해 있다면 Claude가 처음 사용할 워크스페이스를 선택합니다. 나중에 Claude에게 전환을 요청할 수 있습니다. 워크스페이스 전환하기를 참고하세요. Claude Code가 내 컴퓨터에서 연결하면 페이지에 경고가 추가로 표시됩니다. 직접 시작한 연결일 때만 Allow를 클릭하세요.

Claude가 할 수 있는 일

Claude는 22개의 도구를 사용합니다. 대부분은 데이터를 읽기만 합니다. Ask CloudThinker는 실행을 시작하고, Switch workspace는 Claude가 작업하는 워크스페이스를 바꿉니다.

워크스페이스

인시던트

에이전트 실행

Automation

Review

Optimize

Cyber

워크스페이스 전환하기

Claude에게 일상적인 말로 요청하세요. 예를 들어 “Which CloudThinker workspace are you using?” 또는 “Switch to the Staging workspace”라고 입력합니다. Claude는 whoami를 호출해 내 워크스페이스를 나열한 뒤 switch_workspace를 호출합니다. 이후의 모든 도구 호출은 새 워크스페이스에서 데이터를 읽고 실행을 시작합니다.
  • 내가 속한 워크스페이스로만 전환할 수 있습니다. CloudThinker는 전환할 때마다, 그리고 호출할 때마다 멤버십과 역할을 확인합니다.
  • 전환은 연결 전체에 적용됩니다. 이 커넥터를 사용하는 모든 Claude 채팅이 새 워크스페이스로 이동합니다. 헷갈리면 Claude에게 “Which workspace are you using?”라고 물어보세요.
  • 레코드는 원래 워크스페이스에 남습니다. 전환한 뒤에는 이전 워크스페이스로 돌아갈 때까지 Claude가 그곳의 실행이나 인시던트를 읽을 수 없습니다.

CloudThinker에 조사 요청하기

ask_cloudthinker는 일반 CloudThinker 에이전트 실행을 시작합니다. 워크스페이스에 이미 있는 연결을 사용합니다.
  • 바로 반환됩니다. Claude는 실행 ID와 링크를 받습니다. 실행이 끝나면 Claude가 get_run을 호출해 답변을 읽습니다.
  • 크레딧을 사용합니다. 실행은 채팅과 마찬가지로 워크스페이스에 청구됩니다. 사용량을 참고하세요.
  • 변경 전에 항상 확인합니다. Claude에서 시작한 실행은 워크스페이스가 Auto Approval mode를 사용해도 Manual 승인을 사용합니다. 변경은 링크를 통해 CloudThinker에서 승인할 때까지 대기합니다. Approvals를 참고하세요.

프롬프트 예시

연결한 뒤 Claude에 다음과 같이 입력하세요.

접근 권한 확인 방식

Claude는 내가 선택한 워크스페이스 하나에서 나로서 동작합니다. CloudThinker는 호출할 때마다 다음을 확인합니다.
  • 아직 워크스페이스 멤버인지.
  • 내 역할에 해당 도구의 권한이 있는지.
  • 도구가 속한 제품 모듈이 켜져 있는지.
Claude는 CloudThinker에서 내가 볼 수 있는 범위를 넘어 볼 수 없습니다.

접근 해제하기

CloudThinker에서 Account settings → Connected apps를 열고 Claude 연결을 해제합니다. 접근은 즉시 종료됩니다. 다음 호출은 실패하고, Claude는 다시 연결하라고 요청합니다. Claude의 커넥터도 제거하세요. Claude에서는 Customize → Connectors에서, Claude Code에서는 claude mcp remove cloudthinker로 제거합니다.

문제 해결

연결한 워크스페이스의 멤버가 아니게 되었거나 워크스페이스가 삭제되었습니다. 연결을 해제하고 다시 연결한 뒤 접근할 수 있는 워크스페이스를 선택하세요.
메시지에 부족한 권한의 이름이 표시됩니다. 워크스페이스 관리자에게 해당 권한을 부여하거나 역할을 변경해 달라고 요청하세요.
Claude가 실행이 승인 대기 중이라고 알렸습니다. Claude가 준 링크를 열고 CloudThinker에서 변경을 승인하거나 거부하세요. 그다음 Claude에게 실행을 다시 확인해 달라고 하세요.
크레딧을 추가하거나 워크스페이스 한도를 높이세요. 사용량을 참고하세요. 그런 다음 다시 요청하세요.
승인 페이지는 10분 후 만료됩니다. Claude로 돌아가 다시 연결하세요.
관리자가 해당 제품 모듈을 꺼 두었습니다. 관리자에게 켜 달라고 요청하세요.

관련 문서

Approvals

Manual 모드가 변경을 멈추고 결정을 묻는 방식

Approval mode

Claude에서 시작한 실행이 먼저 확인하는 이유

사용량

실행이 크레딧을 사용하는 방식

MCP 연결

CloudThinker 에이전트가 직접 운영하는 MCP 서버를 호출하게 하기