- OAuth (권장) —
/mcpURL만 추가하고, Magic Meal Kits 계정으로 로그인한 뒤, Claude가 사용할 도구 그룹을 체크합니다. URL에 API 키를 넣지 않습니다. - API 키 (폴백) —
/mcpURL에 API 키를 쿼리 파라미터로 붙여 붙여넣습니다. OAuth를 사용할 수 없는 배포에서만 사용하세요.
OAuth 커넥터 로그인은 Magic Meal Kits 버전 4.21.7 이상이 필요합니다. 배포가 이보다 낮으면
먼저 최신 버전으로 재배포하거나(설치 → 업그레이드),
아래 API 키 방법을 사용하세요. 커스텀 커넥터는 Claude Pro·Team·Enterprise 플랜을 권장합니다.
1. 서버 URL 확인
배포의 서비스 URL이 필요합니다.앱 상태 열기
make.magicmealkits.com/app-status에서
Connection & Access 섹션을 찾습니다.
서비스 URL 복사
SERVICE URL(예:
https://magic-meal-kits-xxxx-uw.a.run.app)을 복사합니다. MCP
엔드포인트는 이 URL 뒤에 /mcp를 붙인 것입니다. API 키 방법을 쓰려면 API KEY도 함께
복사하세요. 자세한 내용은 인증을 참고하세요.2. OAuth로 연결 (권장)
Claude에서 커스텀 커넥터 추가
Claude에서 설정 → 커넥터 → 커스텀 커넥터 추가로 이동합니다. MCP 엔드포인트(서비스 URL +
이름(예: Magic Meal Kits)을 지정하고 추가합니다.
/mcp)를 API 키 없이 붙여넣습니다.Magic Meal Kits 로그인
Claude가 Magic Meal Kits 로그인 페이지를 엽니다.
make.magicmealkits.com에서 사용하는 같은 계정으로
로그인하세요. (서버 자체에는 로그인이 없어, 로그인과 동의를
make.magicmealkits.com/mcp/authorize의 Magic Meal Kits 앱에 위임합니다.)허용할 도구 선택
동의 화면에 도구 그룹 체크리스트가 표시됩니다. 이 커넥터에 필요한 그룹만 체크하세요 —
커넥터는 선택한 그룹의 도구로만 제한됩니다(최소 권한). 아래
도구 그룹을 참고하세요.
도구 그룹 (스코프)
동의 화면에서 아래 그룹 중 하나 이상을 허용합니다. 각 그룹은 관련 도구를 열어 주며, 체크하지 않은 그룹의 도구는 커넥터에서 보이지 않습니다.| 그룹 | 허용 범위 |
|---|---|
| Plaud | 음성 노트, 폴더, 전사 |
| Tiro | 미팅 노트 & 요약 |
| Notion | 페이지 내용 & 전사 |
| Threads | 게시물, 답글 & 인사이트 |
| Threads 데이터 | 수집한 게시물 검색 & 분석 |
| Paymint | 결제 청구서 |
| YouTube | 전사 & 메타데이터 |
| PDF 정보 & 변환 | |
| Slack | Markdown → Block Kit 변환 |
| JavaScript | 샌드박스 JS 실행 |
| JSON | 텍스트에서 JSON 추출 |
| 날짜/시간 | ISO 8601 포맷팅 |
| Naver Commerce | 스마트스토어 주문 |
일부 그룹(Threads, Plaud, Tiro, Paymint, Notion)은 배포에 해당 라이선스 등급도 필요합니다.
라이선스가 없는 그룹은 허용하더라도 도구가 반환되지 않습니다.
3. API 키로 연결 (폴백)
OAuth를 사용할 수 없다면, URL에 API 키를 넣어 커넥터를 추가합니다.다음 단계
MCP 개요
엔드포인트, 도구 필터링, 서버 MCP와 문서 MCP의 차이.