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

# Notion 연결

> 노션 커스텀 에이전트가 매직밀키트 MCP 도구를 쓰도록 연결할 때 보는 페이지입니다. 앱의 MCP 연결 화면에서 값을 복사해 노션의 커스텀 MCP로 등록합니다.

노션의 **커스텀 에이전트**는 MCP 서버를 연결해 외부 도구를 부릅니다. 매직밀키트 MCP를
연결하면 Make 시나리오 없이도 에이전트가 노션 안에서 결제선생 청구서 발송, PDF 추출 같은 매직밀키트 도구를
바로 부릅니다.

<Note>
  * 노션 에이전트는 노션 **유료 플랜**에서만 제공됩니다.
  * 앱의 **MCP 연결** 화면은 매직밀키트 서버 **4.13.8 이상**에서 열립니다. 버전이 낮으면 먼저
    [업그레이드](/ko/installation#upgrading-redeploy)하세요.
</Note>

## 1. 앱에서 연결값 복사

<Steps>
  <Step title="MCP 연결 화면 열기">
    [make.magicmealkits.com](https://make.magicmealkits.com) 왼쪽 메뉴에서 **MCP 연결**을 열고
    **Notion** 탭을 고릅니다.
  </Step>

  <Step title="도구 범위 고르기">
    **도구 범위**에서 노션 에이전트에 줄 도구를 정합니다. 결제선생만 쓰신다면 **직접 선택**에서
    **Paymint 결제**만 체크하세요. 도구를 적게 줄수록 에이전트가 맞지 않는 도구를 고르는 일이
    줄어듭니다.
  </Step>

  <Step title="네 가지 값 확인">
    Notion 탭에 표시되는 값을 그대로 씁니다.

    | 항목 | 값 |
    | - | - |
    | MCP 서버 URL | 서비스 URL 뒤에 `/mcp`가 붙은 주소 |
    | 커넥터 이름 | `Magic Meal Kits` |
    | 인증 헤더 키 | `X-API-KEY` |
    | 인증 헤더 값 | 내 API 키 |
    | <Info>캡처 준비 중: MCP 연결 화면의 Notion 탭</Info> | |
  </Step>
</Steps>

## 2. 노션에 커스텀 MCP 추가

<Steps>
  <Step title="커스텀 MCP 추가 열기">
    노션에서 **설정 → 연결**로 가서 **+ 커스텀 MCP 추가**를 누릅니다.
  </Step>

  <Step title="값 넣고 연결">
    URL과 이름을 넣고, 인증 유형은 **API Key**를 고른 뒤 헤더 키와 값을 넣습니다.
    **연결**을 누르면 매직밀키트 도구 목록이 보입니다.
  </Step>

  <Step title="에이전트에서 도구 켜기">
    커스텀 에이전트 설정에서 방금 추가한 매직밀키트 연결을 고르고, 쓸 도구만 켠 뒤 저장합니다.
    에이전트가 읽고 쓸 노션 페이지나 데이터베이스가 있다면 권한 설정에서 함께 지정하세요.
  </Step>

  <Step title="채팅으로 확인">
    에이전트 채팅창에 매직밀키트 도구를 쓰는 요청을 넣어 봅니다. 예를 들어 결제선생을 켰다면
    "최근 청구서 5건 보여줘"처럼 물어보세요. 결과가 나오면 연결이 끝났습니다.
  </Step>
</Steps>

<Warning>
  API 키가 헤더에 들어갑니다. 노션 워크스페이스에서 이 연결을 쓰는 사람은 누구나 매직밀키트 서버를
  부르게 되니, 공유 워크스페이스라면 권한을 확인하세요. 키가 새어 나갔다면
  [API 키 재발급](/ko/operations/reissue-api-key)을 참고해 새 키로 바꾸세요.
</Warning>

## 함께 보기

<CardGroup cols={2}>
  <Card title="MCP 개요" icon="plug" href="/ko/mcp/overview">
    도구 범위, 지연 로딩, 다른 클라이언트 연결 방법.
  </Card>

  <Card title="Claude(웹) 연결" icon="message" href="/ko/mcp/connect-claude">
    claude.ai 커스텀 커넥터로 연결하는 방법.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.