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

# MCP 개요

> Magic Meal Kits 서버의 MCP 도구를 MCP 클라이언트에 연결하세요.

Magic Meal Kits 배포는 **MCP(Model Context Protocol)** 서버를 노출하므로, LLM
클라이언트가 MMK 도구를 직접 호출할 수 있습니다 — PDF·YouTube 추출, JavaScript 실행,
Markdown → Slack 변환, 날짜 파싱, 그리고 등급에 따라 Threads, Plaud, Tiro, Paymint,
Notion 도구까지.

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

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

## 연결

| 클라이언트           | 방법                                                                                               |
| --------------- | ------------------------------------------------------------------------------------------------ |
| **Claude.ai**   | 설정 → 커넥터 → 커스텀 커넥터 추가 → `https://<your-deployment>/mcp`, 인증 `Authorization: Bearer YOUR_API_KEY` |
| **Claude Code** | `claude mcp add` 또는 `.mcp.json`, 헤더 `X-API-KEY: YOUR_API_KEY`                                    |
| **Cursor / 기타** | 동일한 `/mcp` URL을 API 키 헤더와 함께 추가                                                                  |

## 엔드포인트

| 엔드포인트                 | 인증 | 설명                |
| --------------------- | -- | ----------------- |
| `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                          # 전체 도구 (기본값)
```

<Info>
  **바로 쓰는 자동화를 찾으세요?** [MMK 스킬](/ko/cli/skills)은 가장 자주 쓰는 작업에
  대한 슬래시 명령(`/mmk-notion`, `/mmk-paymint-send` …)을 에이전트에 제공합니다 — 한 번
  설치하면 붙이는 코드를 작성할 필요가 없습니다.
</Info>