73개 MCP 도구 + 완전한 REST API

TutuPrints API 문서

REST API 또는 MCP 프로토콜을 통해 AI 어시스턴트가 사진 인쇄, 문서 인쇄, 주문 관리 등 모든 작업을 직접 수행하게 하세요.
Claude, Gemini, Codex, Copilot 등 21개 주요 AI 클라이언트를 지원합니다.

빠른 시작

세 단계로 연동하고 바로 AI로 인쇄를 시작하세요.

계정 등록

TutuPrints 웹사이트에 방문해 문자 인증코드로 빠르게 가입하세요.

API Key 생성

계정 센터의 「API 키」 페이지에서 원클릭으로 키를 만들어 바로 사용하세요.

요청 보내기

API Key로 REST API를 호출하거나, AI 클라이언트에 설정해 MCP를 사용하세요.

인증 방식

모든 API 요청은 HTTP 헤더에 API Key를 담아 인증합니다.

Authorization: Bearer tk_YOUR_API_KEY

Base URL

https://tutupp.com

응답 형식

Content-Type: application/json

MCP 엔드포인트

POST https://tutupp.com/api/mcp

오픈 플랫폼: 가입 후 승인 없이 API Key를 만들어 모든 API와 MCP 기능을 즉시 사용하세요.

MCP 통합

MCP (Model Context Protocol)는 Anthropic이 제안한 개방형 프로토콜로, AI 어시스턴트가 외부 도구를 직접 호출하게 합니다.

설정 후에는 자연어로 AI에게 「문서 업로드 → 주문 생성 → 잔액 결제」 전체 흐름을 실행하게 할 수 있습니다.

프로토콜 정보

엔드포인트: https://tutupp.com/api/mcp

프로토콜: JSON-RPC 2.0 over Streamable HTTP

메서드: initialize · tools/list · tools/call

파일 업로드: multipart/form-data 확장(message part + file parts, base64 불필요, 100MB+)과 표준 application/json를 지원

AI 클라이언트 선택 21개

Claude Code — mcs_desc_cli

추가 (Add)

claude mcp add --transport http tutuprints https://tutupp.com/api/mcp --header "Authorization: Bearer tk_YOUR_API_KEY"

--scope user는 전역, --scope project는 현재 프로젝트에만 적용

키 교체 (Replace)

claude mcp remove tutuprints && claude mcp add --transport http tutuprints ...(새 키)

제거 (Remove)

claude mcp remove tutuprints

AI 대화 예시

나: 바탕화면의 report.pdf를 A4 흑백으로 한 부 인쇄하고 잔액으로 결제해 줘

AI가 자동으로 호출:

1. upload_document → 파일 업로드

2. get_print_prices → A4 흑백 가격 조회

3. create_order → 주문 생성

4. pay_with_balance → 잔액 결제

AI: 완료! 주문번호 PP2026040612345, A4 흑백 1부, 잔액에서 ¥0.50 차감했습니다.

REST API 레퍼런스

API Key로 아래 모든 엔드포인트에 접근할 수 있으며, UI의 모든 기능을 포함합니다.

adt0

POST /api/documents/upload add0

GET /api/documents add1

GET /api/documents/{id} add2

DELETE /api/documents/{id} add3

adt1

POST /api/photos/upload add4

GET /api/photos/{id} add5

DELETE /api/photos/{id} add6

GET /api/photos/{id}/quality-check?size={size} add7

adt2

POST /api/orders add8

GET /api/orders add9

GET /api/orders/{id} add10

PUT /api/orders/{id}/cancel add11

GET /api/orders/track/{order_no} add12

GET /api/orders/{id}/tracking add13

adt3

POST /api/payment/create add14

POST /api/payment/balance add15

GET /api/payment/status/{order_id} add16

adt4

GET /api/user/balance add17

POST /api/user/balance/topup add18

GET /api/user/balance/transactions add19

adt5

GET /api/user/coupons add20

GET /api/user/coupons/available add21

POST /api/user/coupons/redeem add22

adt6

GET /api/addresses add23

POST /api/addresses add24

PUT /api/addresses/{id} add25

DELETE /api/addresses/{id} add26

POST /api/addresses/parse add27

adt7

GET /api/user/pre-orders add28

POST /api/user/pre-orders add29

GET /api/user/pre-orders/{id} add30

PUT /api/user/pre-orders/{id} add31

PUT /api/user/pre-orders/{id}/status add32

POST /api/user/pre-orders/{id}/submissions/{sid}/review add33

PUT /api/user/pre-orders/{id}/submissions/{sid}/cancel add34

adt8

GET /api/share/{code} add35

POST /api/share/{code}/submit add36

GET /api/share/{code}/submissions/{sid} add37

GET /api/share/{code}/my-submissions add38

adt9

GET /api/user/after-sales add39

POST /api/after-sales add40

adt10

GET /api/regions add41

GET /api/regions/{id} add42

GET /api/regions/tree add43

GET /api/regions/coverage add44

GET /api/regions/{city_id}/city-coverage add45

GET /api/regions/{id}/express-delivery add46

GET /api/regions/{id}/pickup-points add47

GET /api/agents/referral/{code} add48

GET /api/shipping/config add49

GET /api/shipping/carriers add50

adt11

GET /api/prices add51

GET /api/print-options/sizes add52

GET /api/print-options/paper-types add53

adt12

POST /api/photos/{id}/restore add54

GET /api/restorations/{id} add55

adt13

GET /api/auth/me add56

PUT /api/auth/me add57

adt14

GET /api/printer/status add58

GET /api/print-queue/status add59

GET /api/orders/auto-print-schedule add60

adt15

GET /api/user/api-keys add61

POST /api/user/api-keys add62

DELETE /api/user/api-keys/{id} add63

adt16

GET /api/health add64

MCP 도구 목록73개

아래 모든 도구는 MCP 프로토콜로 호출할 수 있으며, AI 클라이언트는 설정 후 자동으로 발견합니다.

adt17

upload_document add65 file_url | content | file_path, filename?

list_documents add66

get_document_info add67 document_id

delete_document add68 document_id

adt18

upload_photo add69 file_url | content | file_path, filename?

get_photo add70 photo_id

delete_photo add71 photo_id

check_photo_quality add72 photo_id, size

adt19

create_order add73 items[], delivery_method?, shipping_carrier_id?, coupon_id?

list_orders add74

get_order_status add75 order_id

cancel_order add76 order_id

track_order add77 order_no

get_order_tracking add78 order_id

adt20

create_payment add79 order_id, payment_method?

pay_with_balance add80 order_id

get_payment_status add81 order_id

create_topup add82 amount, payment_method?

get_balance add83

get_balance_transactions add84 page?, page_size?

adt21

list_coupons add85 scope?

get_available_coupons add86 amount?, scope?

redeem_coupon add87 code

adt22

list_addresses add88

create_address add89 name, phone, country, province, city, district, detail, ...

update_address add90 address_id, ...

delete_address add91 address_id

parse_address add92 text, country

adt23

list_pre_orders add93

create_pre_order add94 title, order_type, spec_mode, ...

get_pre_order add95 pre_order_id

update_pre_order add96 pre_order_id, ...

update_pre_order_status add97 pre_order_id, status

review_submission add98 pre_order_id, submission_id, approved, reject_reason?

cancel_submission add99 pre_order_id, submission_id

adt24

get_share_info add100 share_code

submit_share_photos add101 share_code, photo_ids[], password?, ...

get_submission_status add102 share_code, submission_id

list_my_submissions add103 share_code

adt25

list_after_sales add104

create_after_sales add105 order_id, type, reason, ...

adt26

list_regions add106 level?, parent_id?, search?

get_region add107 region_id

get_region_tree add108

get_region_coverage add109

get_city_coverage add110 city_id

get_agent_by_referral add111 referral_code

check_express_delivery add112 region_id

get_shipping_config add113

get_shipping_carriers add114

list_pickup_points add115 region_id

adt27

get_print_prices add116

get_print_options add117

get_printer_status add118

get_queue_status add119

adt28

get_profile add120

update_profile add121 nickname

adt29

restoration_preview add122 photo_id

get_restoration add123 restoration_id

create_restore_share add_sh1 restoration_ids[], message?, expire_days?, max_claims?, with_passcode?

list_my_restore_shares add_sh2 page?, limit?

revoke_restore_share add_sh3 share_id

claim_restore_share add_sh4 code, passcode?

adt30

list_api_keys add124

create_api_key add125 name, expires_in_days?

revoke_api_key add126 api_key_id

adt31

health_check add127

get_auto_print_schedule add128

adt32

submit_order_review add129 order_id, rating_print, rating_shipping?, rating_service?, comment?

batch_submit_order_reviews add130 items[{order_id, rating_print, ...}]

list_my_order_reviews add131 page?, limit?

get_order_review add132 review_id

mark_order_review_read add133 review_id

코드 예시

「가격 조회 → 파일 업로드 → 주문 생성 → 잔액 결제」 전체 흐름의 완전한 예시.

# 가격 조회
curl https://tutupp.com/api/prices \
  -H "Authorization: Bearer tk_YOUR_API_KEY"

# 문서 업로드
curl -X POST https://tutupp.com/api/documents/upload \
  -H "Authorization: Bearer tk_YOUR_API_KEY" \
  -F "file=@report.pdf"

# 주문 생성
curl -X POST https://tutupp.com/api/orders \
  -H "Authorization: Bearer tk_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [{
      "document_id": "uuid-here",
      "size": "A4",
      "paper_type": "matte",
      "quantity": 1
    }],
    "delivery_method": "pickup"
  }'

# 잔액으로 결제
curl -X POST https://tutupp.com/api/payment/balance \
  -H "Authorization: Bearer tk_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"order_id": "uuid-here"}'

일반적인 워크플로

파일 업로드 가격 조회 주문 생성 잔액 결제 완료

오류 처리

API는 표준 HTTP 상태 코드를 사용하며, 오류 응답에는 JSON 형식의 오류 정보가 포함됩니다.

// 오류 응답 형식
{
  "error": "오류 설명"
}

400

add134 ade0

401

add135 ade1

403

add136 ade2

404

add137 ade3

409

add138 ade4

413

add139 ade5

422

add140 ade6

429

add141 ade7

500

add142 ade8

속도 제한: 로그인 / 가입 / 인증코드 같은 민감한 쓰기 작업만 공격 방어 대상이며 일반 사용으로는 절대 발동하지 않고, 임계값은 관리자 콘솔에서 설정할 수 있습니다. 응답에는 retry_after_seconds 필드 + Retry-After 헤더가 포함됩니다.

시작할 준비가 되셨나요?

계정을 만들고 API Key를 생성해 AI에게 인쇄를 맡기세요.

API 키 관리