FetchPan

FetchPan을 AI 에이전트에게.

에이전트가 파일 호스팅 사이트와 중국 클라우드 드라이브에서 파일을 다운로드할 수 있게 하세요. 토큰 하나로 FetchPan 계정과 똑같은 무료 파일과 트래픽을 사용해요.

FetchPan MCP 서버란?

FetchPan은 파일 호스팅 사이트(Rapidgator, Katfile, Nitroflare, Turbobit 등)와 중국 클라우드 드라이브(Baidu Netdisk, Quark, PikPak 등)를 위한 다운로드 서비스예요. MCP 서버를 통해 AI 에이전트도 FetchPan을 사용할 수 있어요. 에이전트가 링크를 보내면 직접 다운로드 URL을 받아요.

원격 서버(Streamable HTTP)와 Bearer 토큰을 지원하는 MCP 클라이언트라면 어디서든 작동해요. 아래에 Codex, WorkBuddy, Claude Code 단계별 가이드가 있어요. 같은 토큰은 REST API에서도 쓸 수 있어요.

https://fetchpan.com/mcp

1. API 토큰 만들기

토큰을 사용하면 프로그램이 내 계정으로 작업할 수 있어요. 비밀번호처럼 다뤄 주세요. 토큰을 가진 사람은 누구나 내 무료 파일과 트래픽 잔액을 사용할 수 있어요.

불러오는 중…

2. 에이전트 연결하기

사용하는 도구를 고르세요. YOUR_TOKEN을 1단계에서 만든 토큰으로 바꾸세요(토큰을 만든 직후에는 자동으로 채워져요).

다음 파일에 추가: ~/.codex/config.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"

그런 다음 에이전트에게 “FetchPan 도구 목록을 보여 줘.”라고 요청하세요. download, check_link, get_account가 나오면 연결된 거예요.

설치 가이드

먼저 토큰을 만드세요(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

# 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

{
  "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으로 이 링크를 다운로드해 줘: …”.
claude mcp add --transport http fetchpan https://fetchpan.com/mcp \
  --header "Authorization: Bearer YOUR_TOKEN"

에이전트가 할 수 있는 일

도구는 9가지예요. 에이전트에게는 보통 download 하나면 충분해요. 3개는 토큰 없이도 작동하고 연결과 도구 목록 조회도 토큰 없이 할 수 있어서, 가입하기 전에 에이전트가 먼저 둘러볼 수 있어요.

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

다운로드가 진행되는 방식

  1. 에이전트가 전달받은 링크로 download를 호출해요.
  2. FetchPan이 링크를 열고 fetchpan.com의 URL을 돌려줘요. 이 URL은 12시간 동안 유효하고 이어받기(HTTP Range)를 지원해요.
  3. 에이전트가 그 URL에서 파일을 받아요(curl, aria2, 브라우저 등 무엇이든 괜찮아요).
  4. 무료 다운로드: 하루 몇 개 파일, 최대 2 GB, 속도 제한이 있어요. 고속 다운로드는 잔액의 트래픽을 사용해요. 자세한 수치는 “무료 vs 고속” 페이지를 참고하세요.

무료 vs 고속 →

일반 HTTP가 더 편한가요?

같은 토큰으로 웹사이트의 REST API도 사용할 수 있어요. 기본 URL: https://fetchpan.com/v1/web, 헤더: Authorization: Bearer YOUR_TOKEN.

POST /jobs작업을 시작해요. 요청 본문: {"url": "…", "password": "…"}
GET /jobs/{id}작업 상태와 다운로드 옵션.
POST /jobs/{id}/downloadURL을 받아요. 요청 본문: {"tier": "free"} 또는 {"tier": "fast"}
GET /session계정, 잔액, 무료 한도.
GET /account잔액, 최근 주문과 다운로드.
GET /sites, GET /hosts지원하는 사이트와 실시간 상태.
GET /packages, POST /orders트래픽 패키지, 결제 페이지 만들기.

알아 두면 좋은 점

  • 토큰은 나를 대신해 작동해요. 유출되면 위에서 삭제하세요. 즉시 작동을 멈춰요.
  • 한도는 웹사이트와 같아요. 계정당 시간당 새 링크 최대 10개, 하루 무료 파일 수는 “무료 vs 고속” 페이지에 안내된 대로, 무료 파일은 개당 최대 2 GB예요.
  • 오류는 코드와 한 문장짜리 설명으로 돌아와요. 예: sign_in_required, daily_limit, too_many_links, not_ready, insufficient_balance. 무료 한도 오류에는 언제 다시 시도하면 되는지 나와 있어요.
  • 다운로드할 권리가 있는 파일만 받으세요. “저작권 / 악용 신고” 페이지를 참고하세요. 저희는 파일을 호스팅하지 않으며, 사용자가 준 링크를 열 뿐이에요.

자주 묻는 질문

FetchPan MCP 서버란 무엇인가요?

https://fetchpan.com/mcp 주소의 Model Context Protocol 서버예요. AI 에이전트에게 9가지 도구를 제공해서 링크를 확인하고, 지원하는 파일 호스팅 사이트나 중국 클라우드 드라이브에서 파일을 가져오고, 다운로드 URL을 받을 수 있게 해요.

Codex에 FetchPan을 추가하려면 어떻게 하나요?

이 페이지에서 토큰을 만들어 FETCHPAN_TOKEN으로 export하고, ~/.codex/config.toml에 url = "https://fetchpan.com/mcp"와 bearer_token_env_var = "FETCHPAN_TOKEN"이 들어간 [mcp_servers.fetchpan] 블록을 추가하세요. 그런 다음 Codex에서 /mcp를 실행해 확인하세요.

WorkBuddy에 FetchPan을 추가하려면 어떻게 하나요?

WorkBuddy에서 Connectors, Custom connector, Configure MCP를 차례로 열고, mcp.json에 type이 http, URL이 https://fetchpan.com/mcp, Authorization 헤더가 "Bearer YOUR_TOKEN"인 fetchpan 항목을 추가하세요. 저장한 다음 My MCP에서 켜세요.

무료인가요?

토큰 생성은 무료예요. 다운로드에는 계정의 하루 무료 파일(몇 개, 최대 2 GB, 속도 제한)이나 구매한 트래픽이 사용돼요. 에이전트는 무언가를 소모하기 전에 이 다운로드에 어느 쪽이 쓰일지 알려 줄 수 있어요.

FetchPan이 파일을 호스팅하나요?

아니요. 사용자가 준 링크를 열고 12시간 동안 유효한 fetchpan.com의 임시 URL을 돌려줘요. 다운로드할 권리가 있는 파일만 받으세요.

토큰은 안전한가요?

저희는 토큰의 지문만 저장하므로 토큰은 한 번만 표시돼요. 토큰을 가진 사람은 누구나 내 무료 파일과 트래픽을 사용할 수 있으니 다른 사람에게 알리지 마세요. 이 페이지에서 삭제할 수 있으며, 삭제하면 즉시 작동을 멈춰요.

ChatGPT나 claude.ai에 커넥터로 추가할 수 있나요?

아직은 안 돼요. 이 커넥터들은 OAuth 로그인이 필요한데, FetchPan은 Bearer 토큰을 사용해요. Codex, WorkBuddy, Claude Code, 또는 Authorization 헤더를 설정할 수 있는 클라이언트를 사용하세요.

질문이 있거나 필요한 기능이 없나요?

에이전트에게 무엇이 필요한지 피드백 페이지에서 알려 주세요. 모든 메시지를 꼼꼼히 읽고 있어요. 의견 보내기 →