> ## Documentation Index
> Fetch the complete documentation index at: https://docs-hub.magicmealkits.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 문제 해결

> 보고 계신 증상을 찾고 원인을 확인하세요. 설치의 어느 단계에 속하는지로 묶어두었습니다.

<Warning>
  **모든 도구 호출이 권한이 없다고 돌아온다면** 여기서 멈추세요. 설치가
  잘못된 게 아닙니다. 프로젝트가 아직
  [Developer Preview](/ko/developer-preview) 승인을 받지 못한 것이고, 그
  전까지는 아무것도 동작하지 않습니다.
</Warning>

## 설치와 업그레이드

| 증상                             | 원인                                                                                        |
| ------------------------------ | ----------------------------------------------------------------------------------------- |
| 설치 페이지에 MCP 허브 항목이 없음          | 허브는 베타이고 계정 단위로 액세스를 드립니다. [hub.magicmealkits.com](https://hub.magicmealkits.com)에서 신청하세요 |
| 배포가 결제에서 멈춤                    | 프로젝트에 결제 계정이 연결돼 있지 않습니다. 안내 메시지의 버튼으로 해당 페이지를 열어 연결한 뒤 다시 배포하세요                          |
| 새 버전이 나왔는데 **지금 업그레이드** 버튼이 없음 | 이미 최신 버전입니다. 버전 추적이 생기기 전에 설치하신 허브라면 말씀해 주시면 저희가 올려드립니다                                   |
| 갑자기 모든 클라이언트가 다시 연결하라고 함       | 관리자 토큰이 새로 발급됐습니다. 허브를 중지하고 다시 배포하면 그렇게 됩니다. 업그레이드는 그러지 않습니다                              |
| 리전을 바꾸고 싶음                     | 배포 후에는 고정입니다. 바꾸려면 중지하고 다시 배포해야 하고, 그러면 관리자 토큰과 MCP 주소가 새로 발급됩니다                          |

## Developer Preview

| 증상                   | 원인                                                                                         |
| -------------------- | ------------------------------------------------------------------------------------------ |
| 모든 도구 호출에 권한 없음      | 프로젝트가 아직 승인되지 않았습니다. [Developer Preview](/ko/developer-preview)를 보세요                       |
| 점검에서 켜지지 않은 API가 나옴  | 승인 전에는 정상입니다. 승인으로 열리는 것들입니다                                                               |
| 신청하고 일주일이 지나도 연락이 없음 | 스팸함을 확인하고, 그다음 [workspace-dpp-mod@google.com](mailto:workspace-dpp-mod@google.com)으로 문의하세요 |
| 신청이 반려됨              | 등록 이메일 칸에 Gmail 주소, 서비스 계정, 그룹 주소를 넣은 경우가 대부분입니다. Workspace 주소로 다시 신청하세요                   |
| 승인됐는데 여전히 권한 없음      | 승인받은 프로젝트와 그 계정의 자격증명이 있는 프로젝트가 다릅니다. 승인 단위는 프로젝트입니다                                       |
| 한 계정은 되는데 다른 계정만 안 됨 | 같은 원인입니다. 그 계정의 자격증명이 등록되지 않은 프로젝트에 있습니다                                                   |

## 구글 계정 붙이기

| 증상                     | 원인                                                                      |
| ---------------------- | ----------------------------------------------------------------------- |
| 계정은 붙었는데 아무것도 못 함      | 구글 권한 화면에서 **Select all**을 체크하지 않으셨습니다. 계정을 다시 연결하면서 체크하세요              |
| 구글이 리디렉션 주소가 맞지 않는다고 함 | 설치 페이지 OAuth 카드의 주소가 클라이언트의 승인된 리디렉션 URI에 들어가 있지 않거나, 한 글자 빠진 채로 들어갔습니다 |
| 구글이 확인되지 않은 앱이라고 경고함   | 본인이 만든 앱이니 정상입니다. 고급을 누르고 이동 링크로 진행하세요                                  |
| 일주일에 한 번쯤 계속 재연결하라고 함  | 동의 화면이 아직 **Testing** 상태입니다. 게시하면 멈춥니다. 검증을 받는 것과는 관계가 없습니다             |
| 계정에 주의 표시가 붙음          | 로그인이 만료됐거나 해제됐습니다. 계정에서 재연결을 누르세요                                       |
| 서비스를 추가했더니 재연결하라고 함    | 정상입니다. 새 서비스에 필요한 권한을 아직 받지 않았기 때문입니다. 서비스를 뺄 때는 묻지 않습니다                |

## Claude 등 클라이언트 연결

| 증상                      | 원인                                                                              |
| ----------------------- | ------------------------------------------------------------------------------- |
| Claude는 연결됐는데 도구가 안 보임  | Developer Preview가 막혀 있는 동안에는 등록된 것이 없습니다. 관리 UI에서 스키마 상태 옆의 **새로고침**을 한 번 누르세요 |
| Claude가 서버에 연결할 수 없다고 함 | 주소가 허브가 알리는 주소와 다릅니다. 직접 입력하지 마시고 설치 페이지에서 다시 복사하세요                             |
| ChatGPT나 다른 도구에서 쓰고 싶음  | 커스텀 MCP 서버를 받는 곳이면 같은 주소가 그대로 동작합니다. 그 화면의 이름만 다릅니다                             |

## 메일 발송

| 증상                     | 원인                                                                   |
| ---------------------- | -------------------------------------------------------------------- |
| Claude가 초안은 쓰는데 보내지 않음 | 그 계정의 발송이 꺼져 있습니다. 관리 UI에서 계정을 열고 메일 발송에서 켜세요                        |
| 두 주소로 보냈는데 같은 이름으로 도착함 | Gmail은 표시 이름을 주소마다 따로 두는데 처음에는 대개 다 같습니다. [바꾸는 방법](/ko/sending-name) |
| 의도하지 않은 주소로 나감         | 부탁하실 때 주소를 같이 말씀하세요. 말하지 않으면 그 계정이 평소 보내는 주소로 나갑니다                   |

## 그래도 안 되면

* [설치하기](/ko/quickstart), 처음부터
* [Developer Preview](/ko/developer-preview), 전체 내용
