73 個の MCP ツール + 完全な REST API

TutuPrints API ドキュメント

REST API または MCP プロトコルを使って、AI アシスタントに写真印刷・文書印刷・注文管理などすべての操作を直接実行させます。
Claude・Gemini・Codex・Copilot など 21 の主要 AI クライアントに対応。

クイックスタート

3 ステップで導入し、すぐに AI で印刷を始められます。

アカウント登録

TutuPrints のサイトにアクセスし、SMS 認証コードで素早く登録。

API キーを作成

アカウントセンターの「API キー」ページでワンクリックでキーを作成し、すぐに利用できます。

リクエストを送信

API キーで REST API を呼び出すか、AI クライアントに設定して MCP を利用します。

認証方式

すべての API リクエストは HTTP ヘッダーに API キーを載せて認証します。

Authorization: Bearer tk_YOUR_API_KEY

Base URL

https://tutupp.com

レスポンス形式

Content-Type: application/json

MCP エンドポイント

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

オープンプラットフォーム：登録後すぐ審査なしで API キーを作成でき、すべての 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 モノクロで 1 部印刷して、残高で支払って

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 キーは以下のすべてのエンドポイントにアクセスでき、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 キーを作成して、AI に印刷を任せましょう。

API キーを管理