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

TutuPP API ドキュメント

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

クイックスタート

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

1

アカウント登録

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

2

API キーを作成

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

3

リクエストを送信

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 — ターミナル CLI

追加 (Add)

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

--scope user でグローバル、--scope project で現在のプロジェクトのみ有効

キーを置換 (Replace)

claude mcp remove tutupp && claude mcp add --transport http tutupp ...(新しいキー)

削除 (Remove)

claude mcp remove tutupp

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 の全機能を網羅します。

ドキュメント管理

POST /api/documents/upload
GET /api/documents
GET /api/documents/{id}
DELETE /api/documents/{id}

写真管理

POST /api/photos/upload
GET /api/photos/{id}
DELETE /api/photos/{id}
GET /api/photos/{id}/quality-check?size={size}

注文

POST /api/orders
GET /api/orders
GET /api/orders/{id}
PUT /api/orders/{id}/cancel
GET /api/orders/track/{order_no}
GET /api/orders/{id}/tracking

支払い

POST /api/payment/create
POST /api/payment/balance
GET /api/payment/status/{order_id}

残高

GET /api/user/balance
POST /api/user/balance/topup
GET /api/user/balance/transactions

クーポン

GET /api/user/coupons
GET /api/user/coupons/available
POST /api/user/coupons/redeem

配送先住所

GET /api/addresses
POST /api/addresses
PUT /api/addresses/{id}
DELETE /api/addresses/{id}
POST /api/addresses/parse

代理注文(事前注文)

GET /api/user/pre-orders
POST /api/user/pre-orders
GET /api/user/pre-orders/{id}
PUT /api/user/pre-orders/{id}
PUT /api/user/pre-orders/{id}/status
POST /api/user/pre-orders/{id}/submissions/{sid}/review
PUT /api/user/pre-orders/{id}/submissions/{sid}/cancel

事前注文の共有

GET /api/share/{code}
POST /api/share/{code}/submit
GET /api/share/{code}/submissions/{sid}
GET /api/share/{code}/my-submissions

アフターサービス

GET /api/user/after-sales
POST /api/after-sales

地域と配送

GET /api/regions
GET /api/regions/{id}
GET /api/regions/tree
GET /api/regions/coverage
GET /api/regions/{city_id}/city-coverage
GET /api/regions/{id}/express-delivery
GET /api/regions/{id}/pickup-points
GET /api/agents/referral/{code}
GET /api/shipping/config
GET /api/shipping/carriers

設定の照会

GET /api/prices
GET /api/print-options/sizes
GET /api/print-options/paper-types

AI 写真修復

POST /api/photos/{id}/restore
GET /api/restorations/{id}

ユーザー情報

GET /api/auth/me
PUT /api/auth/me

印刷ステータス

GET /api/printer/status
GET /api/print-queue/status
GET /api/orders/auto-print-schedule

API キーの自己管理

GET /api/user/api-keys
POST /api/user/api-keys
DELETE /api/user/api-keys/{id}

システム稼働状況

GET /api/health

MCP ツール一覧69 個

以下のすべてのツールは MCP プロトコルで呼び出せます。AI クライアントは設定後に自動で検出します。

ドキュメント管理

upload_document ドキュメントをアップロード (PDF/DOC/DOCX/XLS/XLSX/PPT/PPTX) — one of: file_url / content (base64) / file_path (curl)
list_documents 現在のユーザーがアップロードした全ドキュメントを一覧
get_document_info ドキュメント詳細を取得 (ページ数、ファイルサイズなど)
delete_document ドキュメントを削除 (有効な注文に未関連の場合のみ)

写真管理

upload_photo 写真をアップロード (JPG/PNG/WebP/HEIC) — one of: file_url / content (base64) / file_path (curl)
get_photo 写真の詳細情報を取得
delete_photo 写真を削除 (有効な注文に未関連の場合のみ)
check_photo_quality 指定サイズでの写真印刷品質を確認 (DPI)

注文

create_order 印刷注文を作成
list_orders 現在のユーザーの全注文を一覧
get_order_status 注文の状態と詳細を照会
cancel_order 注文をキャンセル (支払い待ち状態のみ)
track_order 注文番号で注文情報を照会 (公開)
get_order_tracking 注文の配送追跡情報を取得

支払いと残高

create_payment 第三者決済を作成 (payment_url を返却、ブラウザで開いて支払い可)
pay_with_balance 口座残高で注文を支払う
get_payment_status 注文の支払い状況を照会
create_topup 残高チャージ注文を作成 (payment_url を返却)
get_balance 口座残高を照会 (総額/凍結/利用可能)
get_balance_transactions 残高取引履歴を照会

クーポン

list_coupons 現在のユーザーのクーポンを一覧
get_available_coupons 利用可能クーポンを取得 (金額で絞り込み可)
redeem_coupon 引き換えコードでクーポンを受け取る

配送先住所

list_addresses 配送先住所を一覧
create_address 配送先住所を追加
update_address 配送先住所を更新
delete_address 配送先住所を削除
parse_address 住所テキストを自動解析

代理注文(事前注文)

list_pre_orders すべての事前注文を一覧
create_pre_order 事前注文を作成 (共有リンクで他者が提出)
get_pre_order 事前注文の詳細を取得 (全提出を含む)
update_pre_order 事前注文の設定を更新
update_pre_order_status 事前注文の状態を変更
review_submission 事前注文の提出を審査
cancel_submission ある提出を取り消す

事前注文の共有

get_share_info 共有リンク情報を取得
submit_share_photos 共有リンクに写真を提出
get_submission_status 提出の状態と写真詳細を照会
list_my_submissions ある共有リンク下の全提出を一覧

アフターサービス

list_after_sales 現在のユーザーのアフターサービス履歴を一覧
create_after_sales アフターサービス申請を作成 (返金/再印刷/再送)

地域と配送

list_regions 地域一覧を照会
get_region 地域の詳細と下位地域を取得
get_region_tree 地域ツリー全体を取得 (省→市→区県)
get_region_coverage 代理店カバレッジ統計を取得
get_city_coverage 市内の各区県のカバレッジを取得
get_agent_by_referral 紹介コードで代理店を検索
check_express_delivery 当日配達に対応しているか確認
get_shipping_config 配送料設定を取得 (グローバル)
get_shipping_carriers 運送会社一覧を取得 (遠隔地追加料金含む)
list_pickup_points 受取場所一覧を照会

設定とステータス

get_print_prices 印刷価格 + 数量割引の段階を取得
get_print_options 利用可能なサイズと用紙タイプを取得
get_printer_status プリンターの状態を照会
get_queue_status 印刷キューの状態を照会

ユーザー情報

get_profile 現在のユーザーの個人情報を取得
update_profile ユーザーのニックネームを更新

AI 写真修復

restoration_preview 写真に AI 修復プレビューを実行
get_restoration AI 修復タスクの結果を取得

API キーの自己管理

list_api_keys 現在のユーザーの全 API キーを一覧
create_api_key 新しい API キーを作成 (完全なキーは一度だけ表示)
revoke_api_key 指定した API キーを取り消す

システム

health_check サービスの稼働状況を確認 (データベース/決済ゲートウェイ/バージョン)
get_auto_print_schedule 自動印刷の時間枠設定を取得

注文レビュー

submit_order_review 注文レビューを 1 件送信 (3 軸評価 + コメント)。ON CONFLICT で冪等、レート制限 5/h
batch_submit_order_reviews 一括レビュー (最大 20 · 単一トランザクション · アトミック)。ワンタップ 5 つ星
list_my_order_reviews 自分のレビューを一覧 (ページング封筒)
get_order_review レビュー 1 件の詳細を取得 (公式返信を含む)
mark_order_review_read 公式返信を既読にする (CTE でリプレイ防止、nav バッジ数を削減)

コード例

「価格照会 → ファイルアップロード → 注文作成 → 残高支払い」の一連の流れの完全な例。

# 查询打印价格
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
リクエストパラメータ不正 必須項目の欠落、形式が不正
401
未認証 API キーの欠落または無効
403
権限なし 操作が禁止、権限不足
404
リソースが存在しない 注文/ドキュメント/写真 ID が存在しない
409
競合 写真は注文に関連付けられており削除不可
413
ファイルが大きすぎる ドキュメントが 50MB 超 / 写真が 120MB 超
422
ビジネスルール未充足 残高不足、注文をキャンセル不可
429
リクエスト過多 API レート制限を超過
500
サーバー内部エラー 後でやり直すか、サポートにご連絡ください
レート制限：ログイン / 登録 / 認証コードなど機微な書き込み操作のみ攻撃対策を行い、通常利用では発動しません。しきい値は管理画面で設定可能。応答には retry_after_seconds フィールドと Retry-After ヘッダーが付きます。

始める準備はできましたか？

アカウントを登録し、API キーを作成して、AI に印刷を任せましょう。

今すぐ登録 API キーを管理