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

# API 키 재발급(교체)하기

> 매직밀키트 API 키(MMK_API_KEY)가 노출되었을 때 사용하세요 — 코드·스크린샷·공개 저장소에 유출된 경우, 재발급하면 기존 키가 무효화되고 새 키로 재배포됩니다.

API 키([`MMK_API_KEY`](/ko/authentication))가 노출되었다면 — 클라이언트 코드에
붙여넣었거나, 스크린샷에 담겼거나, 공개 저장소에 커밋된 경우 — 재발급하세요. 재발급하면
새 키가 생성되고 서비스가 재배포되어 새 키가 적용되며, 유출된 기존 키는 더 이상 쓸 수
없게 됩니다.

## 이럴 때 사용하세요

다음 상황이라면 API 키를 재발급하세요.

* 공개 GitHub 저장소에 키가 커밋됨(“바이브코딩” 중 실수 포함).
* 스크린샷·문의 메시지·클라이언트 코드에 키가 노출됨.
* 누군가 키를 봤을 가능성이 의심됨.

API 키는 배포된 서버로 보내는 모든 요청을 인증합니다. 키가 유출되면 제3자가 여러분의
서비스를 호출할 수 있습니다. 키의 정체와 사용처는 [인증](/ko/authentication)를 참고하세요.

<Warning>
  **재발급하면 기존 키가 즉시 무효화되고, 그 키를 쓰던 모든 연결이 한꺼번에 끊깁니다.**
  Make.com 연결, CLI, MCP 클라이언트 모두 새 키로 갱신하기 전까지는 `401 Unauthorized`로
  실패합니다. 또한 서비스가 재배포되며(약 1\~2분), 그동안 요청이 잠깐 실패할 수 있습니다.
  **재발급 직후 모든 연결을 새 키로 갱신할 준비가 되었을 때만 진행하세요.** 서비스 URL·
  라이선스·데이터는 모두 유지됩니다.
</Warning>

## API 키 재발급하기

<Steps>
  <Step title="Google Cloud 로그인">
    [make.magicmealkits.com/google-connection](https://make.magicmealkits.com/google-connection)
    에서 Google Cloud에 로그인합니다.
  </Step>

  <Step title="App Status 페이지로 이동">
    [make.magicmealkits.com/app-status](https://make.magicmealkits.com/app-status) 로
    접속합니다.
  </Step>

  <Step title="키 재발급">
    **Connection & Access** 카드의 **API Key** 항목에서 **Reissue API key**(API 키
    재발급)를 클릭하고 확인합니다. 새로 생성된 키로 서비스가 재배포됩니다.
  </Step>

  <Step title="새 키 복사">
    새 키가 표시되면 복사하세요. 이후에도 이 페이지의 API Key 옆 눈(👁) 버튼으로 언제든
    다시 확인할 수 있습니다.
  </Step>
</Steps>

## 재발급 후 — 클라이언트 갱신하기

기존 키는 즉시 사용할 수 없게 되므로, 이 키를 쓰는 모든 곳을 갱신하세요.

* **Make.com 연결** — 이 연결은 make.magicmealkits.com이 아니라 **본인 Make 계정**에
  있습니다. 본인 Make 지역(zone)의 **Connections(연결)** 페이지 —
  `https://<zone>.make.com/<team-id>/connections` — 로 이동하세요. `<zone>`은 Make
  주소창에 보이는 지역입니다(예: `us1`, `us2`, `eu1`, `eu2`). 매직밀키트 연결을 열어
  API Key를 새 값으로 교체합니다.
* **CLI** — CLI 설정의 `api-key` 값을 새 키로 변경합니다.
* **MCP 클라이언트** — 키로 설정된 MCP 클라이언트를 새 키로 갱신합니다.

각 연결에 새 키를 반영하기 전까지는 해당 요청이 `401`로 실패합니다.

## 노출된 키도 함께 제거하세요

재발급하면 유출된 키는 무효화되지만, 키가 남아 있는 위치도 정리하세요.

* 코드·스크린샷·공개된 위치에서 해당 키를 삭제합니다.
* git에 커밋된 경우, 현재 파일에서 지워도 **커밋 히스토리에는 남습니다.** 저장소를
  비공개로 전환하거나, 히스토리에서 키를 정리하세요.

## 그래도 해결되지 않나요?

재발급이 완료되지 않거나, 키를 갱신했는데도 클라이언트가 계속 연결되지 않는다면, 계정
이메일과 증상 설명을 함께 [지원팀에 문의](https://open.kakao.com/me/pureugong)해 주세요.