- 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이 필요합니다.1
앱 상태 열기
make.magicmealkits.com/app-status에서
Connection & Access 섹션을 찾습니다.
2
서비스 URL 복사
SERVICE URL(예:
https://magic-meal-kits-xxxx-uw.a.run.app)을 복사합니다. MCP
엔드포인트는 이 URL 뒤에 /mcp를 붙인 것입니다. API 키 방법을 쓰려면 API KEY도 함께
복사하세요. 자세한 내용은 인증을 참고하세요.2. OAuth로 연결 (권장)
1
Claude에서 커스텀 커넥터 추가
Claude에서 설정 → 커넥터 → 커스텀 커넥터 추가로 이동합니다. MCP 엔드포인트(서비스 URL +
이름(예: Magic Meal Kits)을 지정하고 추가합니다.
/mcp)를 API 키 없이 붙여넣습니다.2
Magic Meal Kits 로그인
Claude가 Magic Meal Kits 로그인 페이지를 엽니다.
make.magicmealkits.com에서 사용하는 같은 계정으로
로그인하세요. (서버 자체에는 로그인이 없어, 로그인과 동의를
make.magicmealkits.com/mcp/authorize의 Magic Meal Kits 앱에 위임합니다.)3
허용할 도구 선택
동의 화면에 도구 그룹 체크리스트가 표시됩니다. 이 커넥터에 필요한 그룹만 체크하세요 —
커넥터는 선택한 그룹의 도구로만 제한됩니다(최소 권한). 아래
도구 그룹을 참고하세요.
4
승인 및 테스트
**승인(Authorize)**을 클릭합니다. Claude가 설정 화면으로 돌아오고 커넥터가 활성화됩니다.
새 채팅을 열어 Magic Meal Kits 도구가 도구 목록에 표시되는지 확인하세요.
도구 그룹 (스코프)
동의 화면에서 아래 그룹 중 하나 이상을 허용합니다. 각 그룹은 관련 도구를 열어 주며, 체크하지 않은 그룹의 도구는 커넥터에서 보이지 않습니다.일부 그룹(Threads, Plaud, Tiro, Paymint, Notion)은 배포에 해당 라이선스 등급도 필요합니다.
라이선스가 없는 그룹은 허용하더라도 도구가 반환되지 않습니다.
3. API 키로 연결 (폴백)
OAuth를 사용할 수 없다면, URL에 API 키를 넣어 커넥터를 추가합니다.1
커넥터 URL 추가
Claude에서 설정 → 커넥터 → 커스텀 커넥터 추가로 이동해 인증을 None으로 설정하고
다음을 붙여넣습니다.
2
도구 필터링(선택)
tools 쿼리 파라미터로 노출 도구를 제한합니다.3
활성화 및 테스트
커넥터를 저장한 뒤 새 채팅을 열어 도구가 로드되는지 확인합니다.
다음 단계
MCP 개요
엔드포인트, 도구 필터링, 서버 MCP와 문서 MCP의 차이.