> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nudget.app/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP Setup

> AI 도구에서 Nudget 사용하기

# MCP 서버 설정

Nudget는 [Model Context Protocol (MCP)](https://modelcontextprotocol.io) 서버를 제공합니다. Claude Desktop, Claude Code, Cursor 등 MCP를 지원하는 AI 도구에서 구독, 콘텐츠, 다이제스트를 직접 조회하고 관리할 수 있습니다.

## 사전 준비

1. Nudget 계정이 필요합니다.
2. Settings 페이지에서 **API Key**를 발급합니다. ([API Key 가이드](/ko/guides/api-keys))

## 설정

MCP 클라이언트의 설정 파일에 다음을 추가합니다:

<CodeGroup>
  ```json Claude Desktop (claude_desktop_config.json) theme={null}
  {
    "mcpServers": {
      "nudget": {
        "type": "http",
        "url": "https://nudget.app/api/mcp",
        "headers": {
          "X-API-Key": "YOUR_API_KEY"
        }
      }
    }
  }
  ```

  ```json Claude Code (.mcp.json) theme={null}
  {
    "mcpServers": {
      "nudget": {
        "type": "http",
        "url": "https://nudget.app/api/mcp",
        "headers": {
          "X-API-Key": "${CONTENTS_HUB_API_KEY}"
        }
      }
    }
  }
  ```
</CodeGroup>

<Tip>
  Claude Code에서는 `${CONTENTS_HUB_API_KEY}` 환경변수를 사용하면 API Key를 파일에 직접 노출하지 않을 수 있습니다.
</Tip>

## 사용 가능한 도구

### 구독 관리

| 도구                          | 설명                                   |
| --------------------------- | ------------------------------------ |
| `list_subscriptions`        | 모든 구독 목록 조회 (URL, 타입, 상태, 마지막 체크 시간) |
| `get_subscription_contents` | 특정 구독의 수집된 콘텐츠 목록 (페이지네이션 지원)        |

### 콘텐츠 조회

| 도구                   | 설명                        |
| -------------------- | ------------------------- |
| `list_content_items` | 전체 콘텐츠 목록 (구독별, 상태별 필터링)  |
| `get_content_item`   | 특정 콘텐츠의 상세 정보 (원문 텍스트 포함) |

### 브리핑

| 도구                         | 설명                       |
| -------------------------- | ------------------------ |
| `list_briefings`           | 브리핑 목록 조회 (페이지네이션)       |
| `get_today_briefing`       | 오늘의 브리핑 조회               |
| `get_briefing`             | 특정 브리핑 상세 조회             |
| `submit_briefing_feedback` | 브리핑 피드백 제출 (👍/👎 + 코멘트) |

### 렌즈 관리

| 도구            | 설명                      |
| ------------- | ----------------------- |
| `list_lenses` | 렌즈 목록                   |
| `create_lens` | 렌즈 추가 (이름 + 선택적 detail) |
| `delete_lens` | 렌즈 삭제                   |

## 활용 예시

MCP를 연결하면 AI 도구에서 자연어로 Nudget를 사용할 수 있습니다:

* "오늘 다이제스트 보여줘"
* "AI 관련 렌즈 추가해줘"
* "최근 YouTube 구독에서 수집된 콘텐츠 목록 보여줘"
* "이번 주 다이제스트에 좋아요 남겨줘"