허브는 베타이고, 계정 단위로 액세스를 드리고 있습니다. 설치 페이지에 MCP
허브 항목이 보이지 않는다면 아직 액세스가 없는 것입니다.
hub.magicmealkits.com에서 신청해 주시면
확인 후 메일로 연락드립니다.
준비물
- 결제 계정이 연결된 Google Cloud 프로젝트. 허브는 아무도 쓰지 않을 때 자동으로 꺼져서 요금이 붙지 않지만, 결제 계정이 연결돼 있지 않은 프로젝트에는 Cloud Run이 배포되지 않습니다.
- 20분 정도, 두 번에 나눠서. 대부분은 구글을 기다리는 시간입니다.
- Google Workspace 계정(있으신 경우). 없어도 설치는 되지만, 구글의 Developer Preview 신청에는 Workspace 주소가 필요합니다. 없으신 경우의 방법은 Developer Preview에 있습니다.
허브 만들기
설치 페이지를 열어 로그인한 뒤 MCP 허브 항목까지 내려갑니다.1
Google Cloud 계정 연결
페이지 위쪽에서 Google로 연결을 누르고, Google Cloud에서 쓰시는
계정을 고릅니다. 설치 페이지가 이 계정으로 프로젝트 목록을 읽고, 그중
하나에 배포합니다.
2
프로젝트 고르기
허브 배포 카드에서 프로젝트를 선택합니다.허브 전용 프로젝트를 따로 두시는 편이 좋습니다. 허브는 자신이 배포된
프로젝트 전체의 시크릿에 접근할 수 있어서, 그 프로젝트에 다른 것을 같이
두면 그것까지 닿습니다. 같이 써도 동작에는 문제가 없고, 문이 필요
이상으로 넓어질 뿐입니다.리전은 도쿄로 되어 있고 응답 속도에만 영향을 줍니다. 다만 지금
한 번 정해두시는 편이 좋습니다. 나중에 바꾸려면 허브를 정지하고 다시
배포해야 하기 때문입니다.
3
점검 실행
점검 실행은 허브에 필요한 구글 API를 켜보고 어디까지 됐는지
알려줍니다. 아무것도 만들지 않고 과금도 없습니다.몇 개는 대개 실패하는데 정상입니다. 그것이 바로
Developer Preview 승인으로 열리는 부분입니다.
지금 확인해 두면 미리 아실 수 있습니다. 그러지 않으면 배포한 뒤 도구
호출이 막히고 나서야 알게 됩니다.
4
배포
확인 체크박스를 누르고 허브 배포하기를 누릅니다. 2분 정도 걸리고,
진행 상황이 버튼에 표시됩니다.결제 때문에 멈추면, 메시지에 있는 버튼으로 결제 페이지를 열어 계정을
연결한 뒤 다시 배포하시면 됩니다.끝나면 허브가 실행 중입니다와 함께 관리 UI 주소와 관리자 토큰이
나옵니다. 토큰은 다시 찾을 수 있는 곳에 저장해 두세요. 로그인하는
수단이고, 두 번 보여주지 않습니다.
허브에 구글 로그인 자격증명 만들어주기
이 부분만은 설치 페이지가 대신 해드릴 수 없습니다. 구글이 이 자격증명을 자동으로 만드는 방법을 제공하지 않아서, 잠깐 Google Cloud 콘솔에 다녀오셔야 합니다. 설치 페이지의 OAuth 클라이언트 만들기 카드가 단계마다 버튼으로 안내합니다. 하실 일은 세 가지입니다. 동의 화면의 사용자 유형을 External로 저장하고, 웹 애플리케이션 클라이언트를 만들고, 카드에 나온 리디렉션 주소를 복사해서 그 클라이언트의 승인된 리디렉션 URI 항목에 넣습니다. 그다음 클라이언트 ID와 시크릿을 복사합니다. 시크릿은 이때 한 번만 보입니다. 동의 화면에 들어간 김에 게시까지 해두세요. Testing 상태로 두면 대략 일주일에 한 번씩 계정 로그인이 풀려서 매번 다시 연결해야 합니다. 게시하면 그 일이 없어집니다. 동의할 때 미검증 앱이라는 경고는 계속 나오는데, 본인만 보는 화면이라 괜찮습니다. 이 자격증명은 본인 프로젝트에 있습니다. 저희가 보관하지 않습니다.구글 계정 붙이기
계정 추가 카드의 버튼으로 관리 UI를 열고 + Add account를 누릅니다. 방금 복사한 클라이언트 ID와 시크릿을 붙여넣고, 계정에 짧은 이름을 주고, 쓰실 서비스를 고릅니다. 전체 선택을 누르면 한 번에 켜집니다. 이 이름은 나중에 Claude에게 “이 계정으로 해줘”라고 말할 때 쓰는 이름이니 알아보기 쉽게 지어주세요.personal, work 정도면 충분합니다.
그다음 Connect를 누르고 구글에 로그인합니다.
계정은 원하는 만큼 붙일 수 있고, 개인 계정과 업무용 계정을 섞어도 됩니다.
Claude 연결하기
Claude 연결 카드에서 MCP 주소를 복사합니다. Claude에서 설정, 커넥터, 커스텀 커넥터 추가 순으로 들어가 붙여넣습니다. 클라이언트 시크릿 칸은 비워두세요. 저장하면 브라우저가 열리고, 로그인한 뒤 Allow를 누르면 연결됩니다. 같은 주소가 ChatGPT에서도, MCP를 지원하는 다른 도구에서도 그대로 동작합니다. 그 화면의 이름만 도구마다 다를 뿐 주소는 같습니다. 이 주소는 비밀번호가 아닙니다. 이 주소를 아는 사람도 로그인 화면까지만 가고 그 이상은 못 가기 때문에, 스크린샷이나 문의 글에 그대로 쓰셔도 됩니다. 잘 됐는지 보시려면 계정 이름을 넣어서 시켜보세요. “personal 계정으로 최근 메일 3개 찾아줘” 정도면 됩니다.새 버전으로 올리기
새 버전이 나오면 설치 페이지에 새 버전 있음과 지금 업그레이드 버튼이 뜹니다. 그 버튼을 누르시면 됩니다. 관리자 토큰과 MCP 주소는 그대로여서 다시 연결하실 것은 없습니다. 저절로 올라가지도, 강제로 올라가지도 않습니다. 버전마다 무엇이 달라졌는지는 릴리스 노트에 있습니다.허브 정지하기
설치 페이지 맨 아래의 허브 정지는 프로젝트에서 허브를 삭제합니다. 확인을 위해 서비스 이름을 입력하게 되어 있습니다.다음
- Developer Preview. 모든 도구 호출이 여기에 달려 있습니다
- 문제 해결. 뭔가 이상할 때
- 운영 비용