SUZURI MCP Server

SUZURI MCP Server

日本語版 README はこちら / 日本語版 README

SUZURI の公式リモート Model Context Protocol（MCP） サーバーです。GMO Pepabo, Inc. が運営する、オンデマンド印刷のグッズプラットフォームです。

画像をアップロードしたり、テキストデザインを生成したりして、450 点以上のアイテムに配置すれば、オリジナルグッズを作成できます。商品を検索・閲覧することもできます。すべて AI アシスタントとの自然言語による会話で操作できます。

エンドポイント

https://mcp.suzuri.jp/mcp

トランスポート：Streamable HTTP。認証：OAuth 2.1（対応クライアントでは自動的に処理されます）。

機能

• 素材管理 — 画像素材のアップロード、テキスト素材の生成、参照画像の分析、既存の素材の管理
• 商品作成 — 素材をアイテムに配置して商品を作成し、配置をプレビュー・比較。配置プリセットも利用できます
• 商品検索 — 商品の検索・閲覧、おすすめ商品の確認、類似アイテムや厳選セレクションの表示
• お気に入りとコレクション — お気に入りを管理し、商品を「Choice」コレクションに整理
• アカウントとアクティビティ — プロフィール、フォローしているユーザー、アクティビティフィードを確認

料金：MCP サーバーへのアクセスは無料です。 グッズの制作や購入には、SUZURI の通常の手数料が適用されます。

クイックスタート

以下からクライアントを選択してください。

Claude Code

claude mcp add --transport http suzuri https://mcp.suzuri.jp/mcp

次に、Claude Code 内で /mcp を実行し、Authenticate を選択して OAuth フローを完了します。

Claude Code MCP ドキュメント

Claude Desktop / claude.ai

Settings → Connectors → Add custom connector を選択し、次を入力します。

https://mcp.suzuri.jp/mcp

OAuth は Claude によって自動的に処理されます。

Cursor

.cursor/mcp.json に追加します。

{
  "mcpServers": {
    "suzuri": {
      "url": "https://mcp.suzuri.jp/mcp"
    }
  }
}

OpenAI Codex CLI

codex mcp add suzuri --url https://mcp.suzuri.jp/mcp

Gemini CLI

リモート MCP サーバーの追加方法については、Gemini CLI MCP サーバーのドキュメントを参照してください。

ローカル stdio ブリッジ（上級者向け）

stdio トランスポートのみをサポートするクライアントでは、mcp-remote を使用します。

{
  "mcpServers": {
    "suzuri": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.suzuri.jp/mcp"]
    }
  }
}

必要条件

• SUZURI アカウント
• MCP 対応クライアント（Claude Desktop、Claude Code、Cursor、OpenAI Codex CLI、Gemini CLI など）

プライバシーポリシー

• プライバシーポリシー：GMO Pepabo, Inc. のプライバシーポリシー
• 利用規約：SUZURI の利用規約
• お問い合わせ：SUZURI のお問い合わせフォーム

このサーバーがアクセスする情報

このサーバーは、接続時にお客様が許可した OAuth 2.1 アクセストークンを使用して、お客様に代わって SUZURI API を呼び出します。各ツールは、固定された SUZURI エンドポイントを 1 つ呼び出します。

• 読み取り — お客様の SUZURI プロフィール、素材、商品、販売記録、お気に入り、コレクション、アクティビティフィード、および公開カタログ（商品、ユーザー、アイテム）。
• 書き込み — お客様が承認した書き込みツールを通じてのみ実行されます。素材や商品の作成・編集、お気に入りやコレクションの管理が含まれます。このサーバーは購入や支払いを処理しません。チェックアウトは suzuri.jp で行われます。
• お客様が指定する画像 URL — 画像から素材を作成する場合や、参照画像の分析を依頼する場合、サーバーは SUZURI に画像を渡したり、画像を検査したりするために、その URL から画像を取得します。

保存と保持期間

• お客様の SUZURI コンテンツ（商品、素材、販売データ）は、このサーバーによってキャッシュまたは保存されません。すべてのツール呼び出しは SUZURI API に直接送信されます。
• OAuth トークンは保存時に暗号化（AES-256-GCM）され、自動的に有効期限が切れます。認証セッションとコードは 10 分後に、アクセストークンはそれぞれの有効期限が切れた時点で失効します。
• 認証が完了すると、MCP クライアント ID、SUZURI のユーザー ID とユーザー名、許可されたスコープを含む監査ログが記録されます。アクセストークンがログに記録されることはありません。
• ツールの引数や会話内容がログに記録または保存されることはありません。

サードパーティ

外部へのリクエストは suzuri.jp と、お客様が明示的に指定した画像 URL にのみ送信されます。このサーバーが他のサードパーティとデータを共有することはありません。

お客様による管理

• MCP クライアントでコネクターをいつでも切断して、すべてのアクセスを停止できます。
• アクセストークンは SUZURI の OAuth 失効エンドポイントから失効させることができ、有効期限が切れると自動的に失効します。
• 個人データの開示、訂正、削除については、プライバシーポリシーの第 13 項をご覧ください。

サポート

• サービスに関するお問い合わせ：SUZURI お問い合わせフォーム
• このリポジトリに関する問題：GitHub Issueを作成してください。

ライセンス

MIT