> ## 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.

# Claude(웹) 연결

> Magic Meal Kits MCP 서버를 웹의 Claude(claude.ai)에 커스텀 커넥터로 연결할 때 사용하세요 — OAuth로 로그인하고, 허용할 도구를 선택한 뒤, 채팅에서 MMK 도구를 사용합니다.

Magic Meal Kits 배포는 자체 **MCP 서버**를 실행하므로, 웹의 Claude([claude.ai](https://claude.ai))가
채팅에서 MMK 도구를 직접 호출할 수 있습니다. 이 가이드는 **커스텀 커넥터**로 연결하는 두 가지
방법을 안내합니다.

* **OAuth (권장)** — `/mcp` URL만 추가하고, Magic Meal Kits 계정으로 로그인한 뒤, Claude가
  사용할 도구 그룹을 체크합니다. URL에 API 키를 넣지 않습니다.
* **API 키 (폴백)** — `/mcp` URL에 API 키를 쿼리 파라미터로 붙여 붙여넣습니다. OAuth를 사용할
  수 없는 배포에서만 사용하세요.

<Note>
  OAuth 커넥터 로그인은 **Magic Meal Kits 버전 4.21.7 이상**이 필요합니다. 배포가 이보다 낮으면
  먼저 최신 버전으로 재배포하거나([설치 → 업그레이드](/ko/installation#upgrading-redeploy)),
  아래 API 키 방법을 사용하세요. 커스텀 커넥터는 Claude **Pro·Team·Enterprise** 플랜을 권장합니다.
</Note>

## 1. 서버 URL 확인

배포의 **서비스 URL**이 필요합니다.

<Steps>
  <Step title="앱 상태 열기">
    [make.magicmealkits.com/app-status](https://make.magicmealkits.com/app-status)에서
    **Connection & Access** 섹션을 찾습니다.
  </Step>

  <Step title="서비스 URL 복사">
    **SERVICE URL**(예: `https://magic-meal-kits-xxxx-uw.a.run.app`)을 복사합니다. MCP
    엔드포인트는 이 URL 뒤에 `/mcp`를 붙인 것입니다. API 키 방법을 쓰려면 **API KEY**도 함께
    복사하세요. 자세한 내용은 [인증](/ko/authentication)을 참고하세요.
  </Step>
</Steps>

## 2. OAuth로 연결 (권장)

<Steps>
  <Step title="Claude에서 커스텀 커넥터 추가">
    Claude에서 **설정 → 커넥터 → 커스텀 커넥터 추가**로 이동합니다. MCP 엔드포인트(서비스 URL +
    `/mcp`)를 API 키 **없이** 붙여넣습니다.

    ```
    https://<your-deployment>/mcp
    ```

    이름(예: *Magic Meal Kits*)을 지정하고 추가합니다.
  </Step>

  <Step title="Magic Meal Kits 로그인">
    Claude가 Magic Meal Kits 로그인 페이지를 엽니다.
    [make.magicmealkits.com](https://make.magicmealkits.com)에서 사용하는 **같은 계정**으로
    로그인하세요. (서버 자체에는 로그인이 없어, 로그인과 동의를
    `make.magicmealkits.com/mcp/authorize`의 Magic Meal Kits 앱에 위임합니다.)
  </Step>

  <Step title="허용할 도구 선택">
    동의 화면에 **도구 그룹** 체크리스트가 표시됩니다. 이 커넥터에 필요한 그룹만 체크하세요 —
    커넥터는 선택한 그룹의 도구로만 제한됩니다(최소 권한). 아래
    [도구 그룹](#도구-그룹-스코프)을 참고하세요.
  </Step>

  <Step title="승인 및 테스트">
    \*\*승인(Authorize)\*\*을 클릭합니다. Claude가 설정 화면으로 돌아오고 커넥터가 활성화됩니다.
    **새 채팅**을 열어 Magic Meal Kits 도구가 도구 목록에 표시되는지 확인하세요.
  </Step>
</Steps>

<Tip>
  나중에 커넥터가 사용할 도구를 바꾸려면, Claude에서 커넥터를 제거한 뒤 다시 추가하면서 다른
  도구 그룹을 허용하세요.
</Tip>

## 도구 그룹 (스코프)

동의 화면에서 아래 그룹 중 하나 이상을 허용합니다. 각 그룹은 관련 도구를 열어 주며, 체크하지
않은 그룹의 도구는 커넥터에서 보이지 않습니다.

| 그룹                 | 허용 범위                   |
| ------------------ | ----------------------- |
| **Plaud**          | 음성 노트, 폴더, 전사           |
| **Tiro**           | 미팅 노트 & 요약              |
| **Notion**         | 페이지 내용 & 전사             |
| **Threads**        | 게시물, 답글 & 인사이트          |
| **Threads 데이터**    | 수집한 게시물 검색 & 분석         |
| **Paymint**        | 결제 청구서                  |
| **YouTube**        | 전사 & 메타데이터              |
| **PDF**            | PDF 정보 & 변환             |
| **Slack**          | Markdown → Block Kit 변환 |
| **JavaScript**     | 샌드박스 JS 실행              |
| **JSON**           | 텍스트에서 JSON 추출           |
| **날짜/시간**          | ISO 8601 포맷팅            |
| **Naver Commerce** | 스마트스토어 주문               |

<Note>
  일부 그룹(Threads, Plaud, Tiro, Paymint, Notion)은 배포에 해당 라이선스 등급도 필요합니다.
  라이선스가 없는 그룹은 허용하더라도 도구가 반환되지 않습니다.
</Note>

## 3. API 키로 연결 (폴백)

OAuth를 사용할 수 없다면, URL에 API 키를 넣어 커넥터를 추가합니다.

<Steps>
  <Step title="커넥터 URL 추가">
    Claude에서 **설정 → 커넥터 → 커스텀 커넥터 추가**로 이동해 **인증**을 **None**으로 설정하고
    다음을 붙여넣습니다.

    ```
    https://<your-deployment>/mcp?api_key=YOUR_API_KEY
    ```
  </Step>

  <Step title="도구 필터링(선택)">
    `tools` 쿼리 파라미터로 노출 도구를 제한합니다.

    ```
    https://<your-deployment>/mcp?api_key=YOUR_API_KEY&tools=pdf,youtube
    ```
  </Step>

  <Step title="활성화 및 테스트">
    커넥터를 저장한 뒤 새 채팅을 열어 도구가 로드되는지 확인합니다.
  </Step>
</Steps>

<Warning>
  API 키 방법은 키가 URL에 포함되어 서버 요청 로그에 남을 수 있습니다. OAuth를 우선 사용하고,
  가능하면 필터링된 도구 집합으로 키 범위를 좁혀 두세요.
</Warning>

## 다음 단계

<Card title="MCP 개요" icon="plug" href="/ko/mcp/overview">
  엔드포인트, 도구 필터링, 서버 MCP와 문서 MCP의 차이.
</Card>