MCP 도구 레퍼런스

Model Context Protocol — AI 에이전트가 자연어로 외부 시스템을 조작하기 위한 표준입니다. 이 문서는 문피디(이북) MCP의 6개 카테고리 25개 도구입니다. 설문(섭피디) MCP 도구는 섭피디 문서를 참고하세요.

연결 설정

Claude Desktop

{
  "mcpServers": {
    "moonpd": {
      "url": "https://mcp.moonpd.ai/sse",
      "headers": { "Authorization": "Bearer mpd_xxxxxxxxxxxxxxxxxxxx" }
    }
  }
}

ChatGPT / Cursor

HTTP SSE 엔드포인트 https://mcp.moonpd.ai/sse + Authorization: Bearer ... 헤더.

Claude.ai 웹

Claude.ai 웹은 OAuth 2.0(Authorization Code + PKCE)로 연결합니다. 마이페이지 → MCP·API 탭 → OAuth 앱 발급으로 받은 Key ID·Key Secret을 클라이언트 설정에 입력하세요.

설정 항목값
Client IDKey ID (mpdc_...)
Client SecretKey Secret (mpds_...)
Authorization URLhttps://moonpd.ai/api/v1/oauth/authorize
Token URLhttps://moonpd.ai/api/v1/oauth/token
Scopeebook:read ebook:write ebook:publish stats:read
OAuth 흐름·PKCE·redirect_uri 정책 상세는 인증 문서의 OAuth 2.0 섹션을 참고하세요.

권장 워크플로

도구는 아래 순서로 쓰면 가장 매끄럽습니다(MCP 도구 목록도 이 순서로 노출됩니다).

  1. who_am_i · get_my_channel — 계정·채널 확인
  2. 업로드 — 로컬 파일이면 create_ebook_upload_session으로 upload_url을 받아 에이전트가 직접 업로드(curl -F "file=@문서.pdf" <upload_url>). 이미 공개 URL에 있으면 convert_url_to_ebook
  3. get_ebook_upload_session_status · get_conversion_status — 업로드·변환 완료 확인
  4. finalize_ebook — session_id(또는 ebook_id)만 넘기면 마무리. 기본은 비공개 저장, visibility:"public"이면 공개 후 공유 URL 반환
대용량 파일은 base64로 보내지 말고 create_ebook_upload_session의 upload_url에 직접 업로드하세요. 바이트가 MCP를 거치지 않아 크기 제한이 없습니다.

이북 발행 (6)

create_ebook_upload_session
파일 업로드 세션 발급(session_id·upload_url). 에이전트가 upload_url에 직접 multipart POST 가능(curl -F file=@… — 인증 불필요, URL 토큰이 인증). 사람/보안망은 브라우저로 업로드. 기본 비공개 등록
convert_url_to_ebook
공개 URL(구글드라이브 등)의 파일을 변환
get_ebook_upload_session_status
업로드 세션 상태 조회(pending/completed=job_id/expired)
get_conversion_status
변환 진행 상태 조회(processing/completed/failed)
finalize_ebook ★
변환 확인→(카테고리·태그)→공개여부 적용→URL 반환을 한 번에. ebook_id 또는 session_id 입력. wait_timeout_sec로 변환 완료 대기 가능. 기본 비공개, visibility:public 시 공개+공유 URL 반환
publish_ebook
변환된 이북을 채널에 공개 게시(STATUS=Y, 즉시 공개)

이북 관리 (5)

list_my_ebooks
내 이북 목록(상태·채널 필터, 페이지네이션)
get_ebook_detail
단일 이북 상세(제목·태그·표지·공개URL)
update_ebook_meta
제목·설명·태그·카테고리 수정
set_ebook_visibility
public / unlisted / private 전환
delete_ebook
이북 삭제(soft delete)

홍보 자산 (4)

get_ebook_share_assets
단축 URL·OG 메타·대표 이미지·QR URL
generate_promo_brief
요약·키워드·타깃 추정(캡션은 LLM이 작성)
get_qr_code_image
인쇄용 QR PNG(크기·여백 옵션)
preview_social_card
인스타·페이스북·트위터 OG 카드 미리보기

단축 URL (4)

create_short_url
임의 URL을 mpd.zip/M{6}로 단축. UTM 파라미터 자동 부착 옵션. 차단 도메인은 거부.
get_short_url
단축 URL 상세 + 클릭수 조회 (본인 발급만)
list_my_short_urls
내가 발급한 단축 URL 목록 (페이징, 클릭수 포함)
delete_short_url
단축 URL 비활성화 (soft delete, 향후 클릭 차단)

통계 (3)

get_ebook_stats
조회·좋아요·다운로드 + 월별 일자별 추이
get_my_dashboard_kpi
내 채널 KPI
get_traffic_sources
GA 기반 지역·기기 유입 분석

채널·계정 (3)

who_am_i
인증된 계정·채널 목록·등급
get_my_channel
채널 상세(소개·구독자·이북수)
update_channel_intro
채널 소개·프로필 이미지 수정

에러 코드

코드의미
UNAUTHORIZEDAPI 키 누락 또는 무효
FORBIDDEN_SCOPE스코프 부족
INVALID_INPUT입력 파라미터 오류
NOT_FOUND대상 리소스 없음
RATE_LIMITED분당 한도 초과(Retry-After 참고)
CONVERSION_FAILED이북 변환 실패
INTERNAL_ERROR서버 오류

제한사항