허브는 라이선스가 있는 계정에서 설치하실 수 있습니다. 설치 페이지에
MCP 허브 항목이 보이지 않는다면,
hub.magicmealkits.com/buy에서 설치
페이지에 로그인하실 때와 같은 이메일 주소로 구매해 주세요.
준비물
- 결제 계정이 연결된 Google Cloud 프로젝트. 허브는 아무도 사용하지 않을 때 자동으로 꺼져서 요금이 거의 들지 않지만, 결제 계정이 연결돼 있지 않은 프로젝트에는 Cloud Run이 배포되지 않습니다. Google Cloud를 처음 사용하신다면 아래를 보세요.
- 20분 정도의 시간. 두 번에 나눠 진행합니다. 중간에 구글 승인을 기다려야 하고, 승인에는 보통 영업일 하루가 걸립니다. 그래서 신청을 맨 뒤가 아니라 두 번째 순서에 두었습니다.
- Google Workspace 계정(있으신 경우). 없어도 설치는 되지만, 구글의 Developer Preview 신청은 Workspace 주소만 받습니다. 없으신 경우에 하실 일은 아래와 Developer Preview에 정리했습니다.
Google Cloud를 처음 사용하신다면
Google Cloud 계정이 아예 없으시다면 먼저 Google Cloud 가입하기를 보시고 다시 이 페이지로 돌아오세요. 이미 가입은 하셨는데 프로젝트가 없으신 경우, 설치 페이지가 프로젝트를 찾을 수 없습니다라고 알려주면서 무엇을 하면 되는지 안내합니다. Google Cloud Console을 열어 이용약관에 동의하고, 결제를 설정하고, 돌아오시면 됩니다. 그다음 설치 페이지의 새 프로젝트 만들기로 페이지를 떠나지 않고 첫 프로젝트를 만드실 수 있습니다. 새로 만든 프로젝트는 목록에 뜨기까지 몇 분 걸릴 수 있습니다. 그럴 때는 드롭다운 옆의 새로고침을 눌러 보세요.허브 배포하기
설치 페이지를 열어 로그인한 뒤 MCP 허브 항목까지 내려갑니다. Google Cloud에서 사용하시는 계정으로 미리 연결돼 있어야 합니다. 설치 페이지가 이 계정으로 프로젝트 목록을 읽고, 그중 하나에 배포하기 때문입니다.1
프로젝트를 고르고, 점검하고, 배포하기
허브 배포 카드의 Google Cloud 프로젝트 드롭다운에서 프로젝트를
선택합니다. 허브 전용 프로젝트를 따로 두시는 편이 좋습니다. 허브는
설치된 프로젝트 안의 민감한 정보에 접근할 수 있어서, 같은 프로젝트에 다른
서비스를 두면 그것까지 접근 범위에 들어갑니다. 함께 사용해도 동작에는
문제가 없지만, 접근 범위가 필요 이상으로 넓어집니다. 지역도 지금
정해 두세요. 나중에
바꾸려면 허브를 정지하고 다시 배포해야 합니다.먼저 점검 실행을 누릅니다. 허브에 필요한 구글 API를 켜 보고 결과를
알려 줍니다. 아무것도 만들지 않고 요금도 청구되지 않습니다.그다음 확인 체크박스를 누르고 허브 배포하기를 누릅니다.
전부 켜졌다고 해서 승인이 된 것은 아닙니다. API는
Developer Preview 승인 전에도 켜집니다. 이
화면에서는 승인 여부를 알 수 없고, 승인을 받지 않으면 나중에 Claude가
실제로 요청을 보낼 때 권한 오류로 거부됩니다.
2
허브가 실행 중입니다
3
로그인
Developer Preview 신청하기
이 신청부터 먼저 하세요. 승인은 보통 영업일 하루 안에 오고, 기다리는 동안 아래 나머지를 전부 진행하실 수 있습니다. 구글은 프로젝트가 승인을 받기 전까지 허브가 사용하는 Gmail, 캘린더, 드라이브 서비스를 열어 주지 않습니다. 그동안 허브는 정상으로 보이지만 요청은 모두 거부됩니다. 설치 페이지로 돌아가 Developer Preview Program 신청하기까지 내려가세요. 누르면 프로젝트 번호가 채워진 구글 신청서가 열립니다.
OAuth 클라이언트 만들기
OAuth 클라이언트는 설치 페이지가 대신 만들어 드릴 수 없습니다. 구글이 자동으로 만드는 방법을 제공하지 않아서, 콘솔에서 본인 계정으로 직접 만드셔야 합니다. 만드신 클라이언트는 본인 프로젝트 안에 그대로 있습니다.
구글 계정 추가하기
이 화면에서 허브가 다룰 구글 계정을 정합니다. 계정마다 항목을 하나씩 만들고, 항목마다 사용할 서비스도 함께 고릅니다. 여기에 추가하신 계정만 연결되고, 여기서 삭제하시면 연결이 끊깁니다. 계정과 클라이언트는 서로 다른 것이고, 이 화면에서 둘 다 입력합니다. 둘의 구분이 헷갈리신다면 계정과 클라이언트를 먼저 읽어 보세요. 2분이면 됩니다.
personal, work 정도면 충분합니다. 영문
소문자, 숫자, -, _만 사용하실 수 있습니다.
첫 계정에는 아직 클라이언트가 없으니 새 클라이언트를 직접 입력을 고르고
방금 복사한 클라이언트 ID와 시크릿을 붙여넣으세요. 그다음부터는 그 클라이언트가
목록에 남아서, 계정을 더 추가하실 때 자동으로 선택됩니다.
계정 연결하기
Connect를 누르면 구글의 로그인 화면으로 넘어갑니다.1
지금 연결
2
계정 선택
3
구글이 미검증 앱이라고 경고합니다
4
그래도 이동하기
Advanced를 눌러야 링크가 나타납니다.
5
Continue
6
Select all을 체크하세요
7
신뢰하고 계속하기
8
연결 완료
두 번째 계정 추가하기
계정은 원하는 만큼 추가하실 수 있고, 개인 계정과 업무용 계정을 섞어서 사용하셔도 됩니다. 과정은 위와 같지만, 새 OAuth 클라이언트는 만들지 않으셔도 됩니다.1
다시 계정 추가
2
이름을 짓고, 있는 클라이언트를 그대로 사용합니다
work처럼 이름을 짓고, 이번에는 새 클라이언트를 직접 입력 대신 이미
만들어 둔 클라이언트를 고르세요. 대부분은 클라이언트 하나로 개인 Gmail
계정과 업무용 Workspace 계정을 모두 연결하시면 됩니다. 예외가 한 가지
있는데, 그 경우와 하실 일은
프로젝트는 몇 개 필요한가에
있습니다.3
서비스를 고르고 제출
4
연결하기
5
두 계정 모두 연결됨
6
설치 페이지에서도 확인하기
선택: 관리 화면에 구글 계정으로 로그인하기
지금까지의 설치와 상관없는 단계라서 언제든 나중에 하셔도 됩니다. 이 단계는 고객님이 관리 화면에 들어가는 방법에 관한 것입니다. 기본 방식은 관리자 비밀번호라서, 비밀번호를 아는 사람은 누구나 관리 화면을 열 수 있습니다. 이 설정을 켜면 구글 계정으로도 로그인하실 수 있고, 허브에 등록하실 때 사용하신 주소만 들어올 수 있습니다. 설정을 켠 뒤에도 비밀번호 로그인은 그대로 됩니다. 로그인 방법이 바뀌는 것이 아니라 하나 더 생깁니다.
- 카드에 나온 리디렉션 주소를 복사합니다. 계정 연결에 사용한 주소와 다른, 로그인용 두 번째 주소입니다.
- 클라이언트 설정 열기를 누르면 아까 만든 클라이언트로 갑니다. 이미 들어 있는 주소는 그대로 두고 이 주소를 추가하세요. 지우면 안 됩니다.
- 동의 화면 열기를 눌러 데이터 액세스에서
openid와email을 체크합니다. 허브가 고객님이 누구인지와 이메일 주소만 확인한다는 뜻이고, 그 밖의 정보는 보지 않습니다. - 클라이언트 ID와 시크릿을 카드에 붙여넣고 적용을 누릅니다.
- 관리 화면을 다시 여시면 Google로 로그인 버튼이 보입니다.
Claude 연결하기
1
MCP 주소 복사
2
Claude에 커스텀 커넥터 추가
3
주소 붙여넣기
4
Connect
5
허용하기
Claude가 묻지 않고 실행할 도구 정하기
연결이 끝나면 Claude의 이 커넥터 설정에 Tool permissions 패널이 생깁니다. 허브가 제공하는 도구는 세 그룹으로 나뉘고, 그룹마다 Needs approval, Always allow, Never allow 중 하나를 고르실 수 있습니다.
설치는 여기까지입니다
Developer Preview 승인을 받기 전까지는 요청이 계속 거부됩니다. 승인 메일을 받으시면 관리 화면에서 스키마 상태 옆의 새로고침을 한 번 눌러주세요. 그러면 도구가 나타납니다.다음
- 업그레이드하기. 새 버전이 나왔을 때
- 허브 정지하기. 정지하면 무엇이 같이 사라지는지
- Developer Preview. 모든 요청이 여기에 달려 있습니다
- 문제 해결. 뭔가 이상할 때
- 운영 비용