# FetchPan MCP 서버: AI 비서가 클라우드 드라이브와 파일 호스트에서 내려받게 하기

> FetchPan MCP 서버로 AI 비서가 링크를 확인하고, 클라우드 드라이브 공유를 열고, 다운로드 직링크를 받아요. 연결 방법은 아래에 있고, 여기서 바로 호출해 볼 수도 있어요.

- 서버 주소: https://fetchpan.com/mcp
- 전송 방식: Streamable HTTP (상태 없음, JSON 응답)
- 인증: 선택: Authorization: Bearer fp_… (토큰은 개발자 페이지에서 만들어요)
- 토큰 없이: 연결, 도구 보기, 링크 확인, 처음 몇 개 무료 파일 다운로드
- 웹 페이지: https://fetchpan.com/ko/mcp-server
- JSON 서비스 설명: https://fetchpan.com/mcp-server.json

## 할 수 있는 일

MCP(Model Context Protocol)는 AI 비서가 외부 도구를 쓰는 공통 방식이에요. FetchPan을 연결하면 AI에게 "이 Baidu 링크 내려받아 줘"라고 말하면 돼요.

AI가 먼저 지원하는 사이트인지 확인하고, 공유에 폴더가 있으면 파일 목록을 보여 줘서 고르게 한 뒤, 서버에서 파일을 준비해 다운로드 직링크를 줘요.

토큰 없이 시작할 수 있어요: 같은 네트워크의 처음 몇 개 파일은 무료예요. 로그인해서 토큰을 만들면 하루 무료 파일이 늘고, 트래픽으로 고속 다운로드도 돼요.

## AI 클라이언트에 연결하기

토큰 없이 바로 써 볼 수 있어요: 서버 주소만 추가하면 돼요(Claude Code: claude mcp add --transport http fetchpan https://fetchpan.com/mcp). 하루 3개 무료 파일을 받으려면 토큰을 만들고(1단계) YOUR_TOKEN 자리에 넣으세요. 가이드마다 2분 정도 걸려요.

### Codex (OpenAI Codex CLI, IDE 확장 프로그램, 앱)

1. 위에서 토큰을 만들고 복사하세요.
2. 셸 프로필(~/.zshrc 또는 ~/.bashrc)에 토큰을 FETCHPAN_TOKEN 변수로 추가한 다음 터미널을 다시 시작하세요.
3. ~/.codex/config.toml을 열고(없으면 새로 만드세요) 아래 [mcp_servers.fetchpan] 블록을 추가하세요. 한 프로젝트에서만 쓰려면 신뢰하는 프로젝트 안의 .codex/config.toml에 블록을 넣으세요.
4. Codex를 실행하고 /mcp를 입력하세요. 목록에 fetchpan이 보여야 해요. 일반 터미널에서는 codex mcp list로도 확인할 수 있어요.
5. 이렇게 요청하세요: “FetchPan으로 이 링크를 확인해 줘: …”.

다음 파일에 추가: `~/.codex/config.toml`

```toml
# 1) in ~/.zshrc or ~/.bashrc, then restart the terminal:
export FETCHPAN_TOKEN="YOUR_TOKEN"

# 2) in ~/.codex/config.toml:
[mcp_servers.fetchpan]
url = "https://fetchpan.com/mcp"
bearer_token_env_var = "FETCHPAN_TOKEN"
```

터미널이 아닌 앱 아이콘으로 Codex를 열면 셸 변수를 읽지 못할 수 있어요. 그럴 때는 bearer_token_env_var 줄을 다음으로 바꾸세요: http_headers = { Authorization = "Bearer YOUR_TOKEN" } (이 경우 토큰이 파일에 저장되므로 파일을 다른 사람이 보지 못하게 관리하세요).

### WorkBuddy

1. 위에서 토큰을 만들고 복사하세요.
2. WorkBuddy에서 Connectors를 열고 Custom connector를 선택한 다음, 오른쪽 위의 Configure MCP를 클릭하세요. ~/.workbuddy/mcp.json 파일이 열려요. 메뉴 이름은 버전에 따라 조금 다를 수 있어요.
3. 아래 fetchpan 항목을 mcpServers 안에 추가하세요. 이미 있는 항목은 그대로 두세요. Save를 클릭하세요.
4. My MCP를 열고 fetchpan을 켜세요. WorkBuddy가 서버를 신뢰할지 물으면 확인을 누르세요.
5. 작업을 시작하고 “FetchPan 도구 목록을 보여 줘.”라고 요청하세요. download, check_link, get_account가 보여야 해요.

다음 파일에 추가: `~/.workbuddy/mcp.json`

```json
{
  "mcpServers": {
    "fetchpan": {
      "type": "http",
      "url": "https://fetchpan.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}
```

### Claude Code

1. 위에서 토큰을 만들고 복사하세요.
2. 터미널에서 아래 명령어를 실행하세요.
3. claude mcp list를 실행하거나 Claude Code 안에서 /mcp를 입력하세요. fetchpan이 연결됨으로 표시되어야 해요.
4. 이렇게 요청하세요: “FetchPan으로 이 링크를 다운로드해 줘: …”.

```bash
claude mcp add --transport http fetchpan https://fetchpan.com/mcp \
  --header "Authorization: Bearer YOUR_TOKEN"
```

## 도구 목록

도구는 10가지예요. 에이전트에게는 보통 download 하나면 충분해요. 연결, 둘러보기, 처음 몇 개 무료 파일 다운로드(같은 네트워크에서 하루 1개, 모두 5개)는 토큰 없이 돼요. 고속 다운로드, 계정 조회, 결제 링크에는 토큰이 필요해요.

| 도구 | 하는 일 | 소모 | 토큰 |
| --- | --- | --- | --- |
| `download` | 링크를 주면 파일이 준비될 때까지 기다렸다가 다운로드 URL을 돌려줘요. 제시간에 준비되지 않으면 이어서 확인할 수 있는 작업 ID를 돌려줘요. 파일이 여러 개인 공유는 하나를 고를 수 있게 목록을 먼저 돌려줘요. | 무료 파일 1개 또는 트래픽(고속) | 처음 몇 개 무료 |
| `check_link` | 이 사이트를 지원하고 지금 정상 작동하나요? | 없음 | 필요 없음 |
| `list_supported_sites` | 지원하는 모든 사이트와 실시간 상태. | 없음 | 필요 없음 |
| `list_files` | Quark·PikPak 공유의 폴더를 열어 원하는 파일을 찾아요 (그다음 download에 share_id와 file_id를 넘겨요). | 없음 | 필요 없음 |
| `start_download` | 기다리지 않고 작업을 시작해요. 작업 ID를 돌려줘요. | 없음 | 처음 몇 개 무료 |
| `get_job` | 작업 상태, 그리고 무료 또는 고속 다운로드에 드는 비용. | 없음 | 처음 몇 개 무료 |
| `get_download_link` | 완료된 작업의 URL(무료 또는 고속). | 무료 파일 1개 또는 트래픽(고속) | 처음 몇 개 무료 |
| `get_account` | 이메일, 트래픽 잔액, 하루 무료 파일 수, 최근 다운로드. | 없음 | 필요 |
| `list_packages` | 구매할 수 있는 트래픽 패키지. | 없음 | 필요 없음 |
| `create_payment_link` | 사용자에게 건넬 패키지 결제 페이지를 만들어요. 결제는 사람만 할 수 있어요. | 없음 | 필요 |

## 호출해 보기

서버는 상태가 없어요: 초기화 없이 POST 한 번이 호출 한 번이에요. 아래 두 호출은 토큰이 필요 없고 다운로드를 만들지 않아요.

### 링크 확인 · check_link

```bash
curl -X POST https://fetchpan.com/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"check_link","arguments":{"url":"https://pan.baidu.com/s/1AbCdEfGh"}}}'
```

### 모든 도구 · tools/list

```bash
curl -X POST https://fetchpan.com/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
```

## 무료 파일이 더 필요하면 토큰을 만드세요

로그인한 뒤 개발자 페이지에서 API 토큰을 만들어 MCP 설정에 넣으세요: 하루 무료 파일이 늘고, 트래픽으로 고속 다운로드도 돼요. https://fetchpan.com/ko/developers