메인 콘텐츠로 건너뛰기
허브는 Gmail, 캘린더, 드라이브를 직접 다루지 않고 구글이 운영하는 서버를 거칩니다. 구글은 Developer Preview Program 승인을 받은 프로젝트에만 그 서버를 열어 줍니다. 승인 전에도 허브는 설치되고 실행되며 정상으로 보이지만, 도구 호출은 전부 거부됩니다. 설정을 잘못하신 것이 아니라 아직 승인을 받지 못했기 때문입니다. 승인은 보통 영업일 하루 안에 옵니다. 오전에 신청하시면 당일이나 다음 날 승인 메일이 오는 경우가 많습니다.

설치 페이지에서 신청하기

설치 페이지에 Developer Preview Program 신청하기 카드가 있습니다. 신청서를 직접 여시는 것보다 이 카드로 신청하시는 것이 좋습니다. 틀리기 쉬운 프로젝트 번호와 주소가 미리 채워져 있기 때문입니다. 이 카드는 프로젝트 번호가 정해지는 허브 배포 뒤에 나타납니다. 그래서 설치, 신청, 승인 순서로 진행됩니다. 승인이 나면 다른 절차 없이 그때부터 바로 사용하실 수 있습니다.
설치 페이지의 Developer Preview Program 카드. 프로젝트 번호가 미리 채워진 신청하기 버튼이 있고, 그 아래에 Workspace 계정이 없을 때 대신 신청해 주는 카드가 있다
카드의 신청하기 버튼을 누르면 신청서가 대부분 채워진 채로 열립니다. 약관 동의는 직접 체크하셔야 합니다.
Workspace 주소로 신청하세요. 구글 신청서는 Gmail 주소, 서비스 계정, 그룹 주소를 받지 않으며, 신청이 반려되는 가장 흔한 이유가 이것입니다.Workspace 계정이 없으시면 아래 안내를 따라 주세요. Gmail 주소로 신청하시면 승인되지 않습니다.

신청서 작성하기

1

이름과 지원 이메일

이름과 성을 입력하는 신청서 필드, 이 단계에서 로그인하는 구글 계정은 Gmail 주소여도 된다는 안내
신청서를 작성할 때 로그인하는 구글 계정은 개인 Gmail이어도 됩니다. Workspace 주소가 필요한 곳은 다음 단계의 이메일 칸입니다.
2

회사 정보와 Workspace 이메일

회사명과 회사 웹사이트 칸, 미리 채워진 Google Cloud 프로젝트 번호, Workspace 주소만 받는 필수 이메일 칸
설치 페이지에서 여셨다면 Google Cloud 프로젝트 번호는 이미 채워져 있습니다. 점검 화면에서 보신 번호와 같은지 확인하세요. Workspace 주소를 넣어야 하는 칸은 What Email should we grant access to Developer Preview features? 이고, 지금 로그인한 계정과는 별개입니다.
3

선택 항목, 약관, 제출

선택 항목인 Google Workspace 제품 체크박스, 필수인 약관 체크박스, 제출 버튼
Workspace 제품 체크박스는 선택이고 약관 체크박스는 필수입니다. 제출하시면 승인 메일이 오고, 대개 그다음 날부터 허브를 사용하실 수 있습니다.

Workspace 계정이 없으시면

Workspace를 새로 구독하실 필요는 없습니다.
설치 페이지의 Workspace 계정이 없으신가요 카드. 추가로 전달할 내용을 적는 칸과 요청 보내기 버튼이 있다
신청 카드 안에 Workspace 계정이 없으신가요? 항목이 있습니다. 거기서 요청을 보내주시면 확인 후 저희가 대신 신청해 드립니다. 프로젝트 번호는 자동으로 함께 전달되고, 전하실 말씀이 있으면 적어주시면 됩니다. 결과는 메일로 알려드립니다.

약관은 한 번 읽어보세요

프로그램 약관은 짧습니다. 꼭 보실 곳은 (iv)항입니다. 프리뷰 기능을 사용하는 통합은 그 기능이 정식 출시되기 전에는 고객에게 제공할 수 없다는 내용입니다. 이 조항은 통합을 다른 사람에게 제공하는 일 자체에 적용됩니다. 어디에서 실행되는지, 데이터가 누구 것인지와는 상관이 없으므로, 각자 자기 허브를 운영한다고 해서 이 조항에서 벗어나지는 않습니다. 본인이 사용하시는 것이 아니라 고객에게 제공하실 계획이라면, 신청서의 용도 칸에 그렇게 적고 구글의 답변을 받아 두세요.

승인된 다음

메일이 두 통 옵니다. 하나는 프로그램 그룹에 추가되었다는 메일이고, 다른 하나는 프로젝트 등록이 끝났다는 메일입니다. 둘 다 구글에서 보내니 스팸함도 확인해 보세요. 그다음 허브 관리 화면에서 스키마 상태 옆의 새로고침을 한 번 눌러 주세요. 승인 전에는 허브에 등록된 도구가 없어서, 이 새로고침을 한 번 하시기 전까지는 Claude가 사용할 도구가 없습니다. 다시 배포하는 것이 아니라서 금방 끝납니다. 승인 메일은 왔는데 여전히 안 된다면, 대개 승인받은 프로젝트와 지금 사용하시는 프로젝트가 다른 경우입니다.

프로젝트가 두 개 필요해지는 경우

대부분은 하나면 됩니다. 붙이시는 계정이 Workspace 계정일 때만 확인해 보세요. 구글의 동의 화면 설정은 프로젝트마다 하나뿐이라, 한 프로젝트에 Internal 클라이언트와 External 클라이언트를 함께 둘 수 없습니다. 그래서 Workspace 쪽이 Internal이어야 할 때만 프로젝트를 나눕니다.
  • Workspace 관리자가 미검증 앱을 차단해 두었을 때. 흔한 설정입니다. 이 설정이 켜져 있으면 그 계정으로는 직접 만드신 앱에도 동의할 수 없고, 설정을 풀 수 있는 사람은 관리자뿐입니다.
  • 조직 구성원에게 미검증 경고를 보이고 싶지 않을 때. Internal로 두면 그 경고가 나오지 않습니다.
둘 중 하나에 해당하면 Workspace 쪽 프로젝트와 클라이언트를 따로 두시고, 그 프로젝트도 승인을 받으셔야 합니다. 설치 페이지에 연결할 Workspace 계정의 조직이 미검증 앱을 차단하나요? 카드가 있습니다. 이 카드에서 두 번째 프로젝트를 정하시면, 두 프로젝트 번호를 신청서에 그대로 붙여넣으실 수 있게 한 줄로 정리해 줍니다. 처음 신청하실 때 두 번호를 함께 넣으시면 다시 신청하고 기다리실 필요가 없습니다.

검증보다 게시가 중요한 이유

검증과 게시를 헷갈려서 일주일마다 계정을 다시 연결하시는 경우가 많습니다. 동의 화면이 External이면서 게시 상태가 Testing이면 로그인이 7일 만에 만료됩니다. 두 조건이 다 맞아야 하고, 검증 여부는 아무 상관이 없습니다. 검증받지 않은 앱이라도 게시 상태를 In production으로 바꾸면 더 이상 만료되지 않습니다. 그러니 동의 화면을 게시하세요. 게시한 뒤에도 동의할 때 미검증 경고가 나오고 사용 인원 제한이 있지만, 본인이 사용하시는 허브에서는 둘 다 문제가 되지 않습니다.

잘 안 될 때

직접 확인하는 방법

지금은 관리 화면에서 바로 확인하실 수 있습니다. 클라이언트 화면을 열면, 허브가 실행 중인 프로젝트와 다른 프로젝트에서 만든 OAuth 클라이언트마다 경고 상자가 나오고 두 프로젝트 번호를 함께 보여 줍니다.
클라이언트 화면. OAuth 클라이언트의 프로젝트 번호와 허브 자신의 프로젝트 번호가 서로 다르다는 경고 상자가 강조되어 있다
이 경고는 오류가 아니므로 계정이나 클라이언트를 추가하는 것을 막지 않습니다. 위에서 설명한 것처럼 두 번째 프로젝트가 필요한 경우라면 클라이언트가 다른 프로젝트에 있는 것이 정상이고, 그 프로젝트를 Developer Preview에 등록하지 않았을 때만 문제가 됩니다. 경고 상자에 나온 두 번호를 신청서에 적은 번호와 비교해 보세요. 프로젝트를 두 개 사용하시려던 것이 아니라 클라이언트를 잘못 고르신 것이라면, 신청할 것이 아니라 클라이언트를 바꾸셔야 합니다. 잘못된 OAuth 클라이언트로 계정을 붙였을 때를 참고하세요.

경고 끄기

두 번째 프로젝트를 일부러 두신 것이고 두 번호가 모두 신청서에 들어가 있다면, 경고의 의도한 설정입니다를 누르세요. 그러면 그 클라이언트의 경고가 계정 화면과 허브 자가진단에 다시 나오지 않고, 나중에 같은 클라이언트로 계정을 더 붙이셔도 다시 묻지 않습니다. 경고를 꺼도 정보가 사라지지는 않습니다. 클라이언트 화면에는 두 프로젝트 번호가 일반 안내 문구로 계속 나오고, 옆에 경고 다시 표시 버튼이 있습니다.