계정은 구글 계정입니다
계정은 허브에 붙여 둔 구글 계정 하나입니다. 개인 Gmail, 회사 Workspace 주소, 도메인을 사면서 딸려온 것 같은 계정들입니다. 계정마다 짧은 이름을 붙이시는데, 그 이름이 나중에 Claude에게 “이 계정으로 해줘”라고 말할 때 쓰는 이름입니다. 계정은 관리 UI의 계정 화면에 있습니다. 여기에 넣기 전에는 아무 계정도 연결되지 않고, 여기서 빼면 연결이 끊깁니다.클라이언트는 구글에서 받는 열쇠입니다
OAuth 클라이언트는 허브가 계정을 구글에 로그인시킬 때 쓰는 것입니다. 열쇠라고 생각하시면 됩니다. Google Cloud 콘솔에서 한 번 만드시면 구글이 두 값을 줍니다. 클라이언트 ID와 클라이언트 시크릿, 이 둘이 열쇠입니다. 이것은 Claude가 아닙니다. 여기서 많이 헷갈리시는데, “클라이언트”라는 말이 원래 어딘가에 접속하는 프로그램을 뜻하기도 하기 때문입니다. 허브에서는 그 뜻이 아니라, 허브가 로그인할 때 쓰는 열쇠만 가리킵니다. 클라이언트라고 부르는 이유는 구글 콘솔이 그렇게 부르기 때문이고, 고객님도 거기서 그 말로 찾으셔야 합니다. 클라이언트는 관리 UI의 클라이언트 화면에 있고, 만드는 일은 10분짜리이며 한 번만 하시면 됩니다.커넥터는 Claude나 ChatGPT입니다
커넥터는 반대쪽에 있는 프로그램입니다. Claude, ChatGPT, 그 밖에 MCP를 쓰는 무엇이든요. Claude도 자기 설정 화면에서 이것을 커넥터라고 부릅니다. 허브 주소를 거기에 한 번 넣어 두시면, 그 커넥터가 붙여 두신 계정 전부에 닿습니다. 허용하신 커넥터는 관리 UI의 승인된 커넥터에 모여 있고, 거기서 해지하실 수 있습니다.셋이 어떻게 이어지는가
계정은 여럿, 클라이언트는 하나
열쇠는 계정에 딸린 것이 아닙니다. Google Cloud 프로젝트에 딸린 것이고, 그 열쇠로 로그인한 계정은 전부 열립니다. 그래서 하나 만들어 계속 씁니다. 클라이언트 ID와 시크릿을 붙여넣으시는 것은 첫 계정을 추가하실 때 한 번뿐입니다. 그다음부터는 허브가 이미 갖고 있어서, 계정을 붙이는 일은 이름을 정하고, 목록에서 고르고, 쓸 서비스를 고르는 것으로 끝납니다. 두 번째가 필요하신 분은 거의 없습니다. 예외는 Workspace 조직이 미검증 앱을 차단하는 경우, 또는 조직 구성원에게 미검증 경고를 보이고 싶지 않은 경우입니다. 그때는 그 조직이 소유한 프로젝트에 클라이언트를 하나 더 두게 되고, 프로젝트는 몇 개 필요한가에 적어두었습니다. 계정을 옮기려고 클라이언트를 하나 더 만드는 것이 아닙니다. 계정이 잘못된 클라이언트에 붙었다면 그건 따로 바로잡는 일입니다.다음
- 설치하기, 처음부터 끝까지
- OAuth 클라이언트 만들기