MCP 개요

Magic Meal Kits 배포는 MCP(Model Context Protocol) 서버를 노출하므로, LLM 클라이언트가 MMK 도구를 직접 호출합니다. PDF와 YouTube 추출, JavaScript 실행, Markdown → Slack 변환, 날짜 파싱을 기본으로 쓰고, 요금제에 따라 Threads, Plaud, Tiro, Paymint, Notion 도구도 씁니다.

서로 다른 두 개의 MCP 서버가 있으니 혼동하지 마세요.

이 페이지: https://<your-deployment>/mcp에 있는 서버의 MCP로, MMK 배포를 대상으로 작업을 실행합니다.
Docs as MCP: https://docs.magicmealkits.com/mcp에 있는 문서 MCP로, LLM이 이 레퍼런스를 읽게 해 줍니다.

앱에서 설정값 복사

연결에 필요한 값은 직접 만들 필요 없이 앱에서 복사합니다. make.magicmealkits.com 왼쪽 메뉴 연결과 MCP 묶음의 MCP 연결을 여세요. 이 화면은 매직밀키트 서버 4.13.8 이상에서 열립니다.

같은 묶음의 연결 관리 화면 맨 위에도 MCP 연결 섹션이 있습니다. 쓰는 곳(Claude Code, Claude.ai, Notion, 그 밖의 도구)을 고르면 붙여 넣을 내용이 나오고, 키는 복사할 때만 들어갑니다. 첫 화면 시작하기 체크리스트 5단계 Claude 에 MCP 로 연결의 MCP 연결하기 버튼도 이 섹션으로 옵니다. 도구 범위까지 고르려면 섹션 아래 도구 범위 고르기 등 자세한 설정을 눌러 MCP 연결 화면으로 가세요.

도구 범위: 전체 도구, 지연 로딩, 직접 선택 중에서 고릅니다. 고른 범위는 아래 URL의 tools 쿼리에 그대로 반영됩니다.
지연 로딩(?tools=deferred)은 도구 설명을 필요할 때만 불러와 AI가 쓰는 컨텍스트를 크게 줄입니다. 도구가 많아 응답이 느리거나 AI가 맞지 않는 도구를 고를 때 켜 보세요.
탭(Claude Code (CLI), Claude.ai (Web), Notion)마다 붙여 넣을 명령이나 값이 내 서버 URL과 API 키로 채워져 있습니다.

연결

클라이언트	방법
Claude.ai (웹)	설정 → 커넥터 → 커스텀 커넥터 추가 → `https://<your-deployment>/mcp`, OAuth로 로그인 후 도구 그룹 선택. Claude(웹) 연결 참고.
Claude Code	`claude mcp add` 또는 `.mcp.json`, 헤더 `X-API-KEY: YOUR_API_KEY`
Cursor / 기타	동일한 `/mcp` URL을 API 키 헤더와 함께 추가
Notion 에이전트	설정 → 연결 → 커스텀 MCP 추가, 인증 유형 API Key, 헤더 `X-API-KEY`. Notion 연결 참고.

Claude Code는 앱의 Claude Code (CLI) 탭에 나오는 명령을 그대로 붙여 넣으면 됩니다. 형식은 아래와 같습니다.

claude mcp add magic-meal-kits \
  --transport http \
  "https://<your-deployment>/mcp" \
  --header "X-API-KEY: YOUR_API_KEY"

{
  "mcpServers": {
    "magic-meal-kits": {
      "type": "http",
      "url": "https://<your-deployment>/mcp",
      "headers": { "X-API-KEY": "YOUR_API_KEY" }
    }
  }
}

웹의 Claude에 연결하시나요? Claude(웹) 연결에서 OAuth 커넥터 흐름과 허용할 도구를 선택하는 방법을 단계별로 자세히 안내합니다.

엔드포인트

엔드포인트	인증	설명
`POST /mcp`	필요	메인 JSON-RPC 엔드포인트
`GET /mcp`	필요	서버 정보 / SSE 스트리밍
`GET /mcp/health`	없음	헬스 체크
`GET /mcp/categories`	없음	도구 카테고리 목록

도구 필터링

tools 쿼리 파라미터로 노출 도구를 제한합니다.

/mcp?tools=pdf,youtube        # 카테고리별
/mcp?tools=pdf_info,youtube_transcript   # 특정 도구별
/mcp                          # 전체 도구 (기본값)

바로 쓰는 자동화를 찾으세요? MMK 스킬은 가장 자주 쓰는 작업에 대한 슬래시 명령(/mmk-notion, /mmk-paymint-send …)을 에이전트에 제공합니다. 한 번 설치하면 따로 코드를 작성하지 않아도 됩니다.

MCP 서버

앱에서 설정값 복사

연결

엔드포인트

도구 필터링

사용 예시

Notion 연결

Tiro 회의록 MCP