SUZURI APIを使ってSUZURI MCP Serverを作った話 / 開発者向けブログ・イベント

GMOインターネットグループエキスパート黒瀧です。今回は、SUZURIの公開APIを活用してMCP（Model Context Protocol）サーバーを作った話を紹介します。

はじめに

MCPは、AIアシスタントが外部のツールやデータソースと連携するための標準プロトコルです。Claude DesktopやClaude CodeなどのMCPクライアントに対応したアプリケーションから、さまざまな外部サービスを自然言語で操作できるようになります。
SUZURIにはAPIが公開されているので、これをMCPサーバーとしてラップすれば、AIアシスタントとの対話を通じてSUZURIの操作ができるのでは？と思い、開発してみました。
npm パッケージとして公開しています。

@kurotaky/suzuri-mcp-server – npm

注意: このMCPサーバーはSUZURIの公式プロダクトではありません。個人
が開発・公開しているものです。

SUZURI APIについて

SUZURIでは開発者向けにAPIが公開されており、[SUZURI Developer]（https://suzuri.jp/developer) ペジからアプリケーションの登録やAPIトークンの発行ができます。
このAPIを使うと、商品の検索・取得、素材のアップロード・管理、ユーザー情報の取得、ズッキュン（お気に入り）の操作など、SUZURIの主要な機能をプログラムから利用できます。
今回作ったMCPサーバーは、このSUZURI APIをMCPのツールとしてラップしたものです。

セットアップ方法

事前にSUZURI Developerページでトークンを発行し
ておきます。Claude Codeをお使いの場合、以下のワンライナーでセットアップ
できます


claude mcp add suzuri -e SUZURI_TOKEN=your-token-here -- npx -y @kurotaky/suzuri-mcp-server

Claude Desktopの場合は、設定ファイル（claude_desktop_config.json）に以下
を追加します。


{
  "mcpServers": {
    "suzuri": {
      "command": "npx",
      "args": ["-y", "@kurotaky/suzuri-mcp-server"],
      "env": {
        "SUZURI_TOKEN": "your-token-here"
      }
    }
  }
}

設定後にアプリを再起動すれば利用可能です。

できること

27個のツールを用意しており、SUZURIの主要な操作をカバーしています。

カテゴリ	主なツール	できること
Products	`search_products`, `get_product`	キーワードで商品を検索、商品詳
細の取得
Materials	`create_material`, `create_text_material`	画像URLやテキストから素
材を作成・管理
Items	`list_items`	Tシャツ、マグカップなどアイテム種別の一覧取得
Users	`get_current_user`, `update_user`	ユーザー情報の取得・プロフィール
更新
Favorites	`add_favorite`, `remove_favorite`	ズッキュンの追加・解除
Activities	`list_activities`	アクティビティの確認
Placement	`preview_product_placement`, `compare_placements`	配置のプレ
ビュー・比較
Choices	`create_choice`, `update_choice`	チョイスの作成・管理

動作イメージ

*Claude Codeからプロフィール画像をアップロードし、Tシャツを作成した例*

おもしろ機能: Claude Codeでお手入れ（プレビュー）

個人的におもしろ機能として、Claude Code上で画像の配置をプレビュ
ーしながら調整できる「お手入れ」機能を作ってみました。

配置プレビュー

preview_product_placement ツールを使うと、素材の配置（拡大率・位置）を指
定してプレビュー画像を確認できます。Claude Codeの対話の中で「もう少し左
に寄せて」「サイズを小さくして」といった自然言語での指示が可能です。

配置の一括比較

compare_placements ツールでは、複数の配置パターンをブラウザで一覧比較できます。実行するとローカルにHTTPサーバーが立ち上がり、カード形式のUIで各
パターンを並べて表示します。気に入った配置を選択すると、その結果がClaude
Codeに返されます。

配置プリセット

よく使う配置パターンを「プリセット」として9種類用意しています。

プリセット	説明
center	標準サイズで中央に配置
left_chest	左胸にワンポイント
right_chest	右胸にワンポイント
full_front	大きく全面プリント
bottom_center	下部中央に配置
top_center	上部中央に配置
pocket_area	胸ポケット位置に小さく配置
mug_wrap	マグカップ表面を覆う配置
small_center	中央にコンパクトに配置

インタラクティブな配置フロー

これらのツールを組み合わせると、以下のような対話的なフローが実現できま
す。

プリセットから候補を選ぶ
compare_placements でブラウザ上で比較
気に入ったパターンをベースに「もう少し大きく」などと微調整
create_product_with_placement で確定した配置で商品を作成

AIとの対話で自然にグッズのお手入れ（配置調整）ができるのは、なかなか楽しい体験です。

まとめ

SUZURIの公開APIをMCPサーバーとしてラップすることで、AIアシスタントから
自然言語でSUZURIを操作できるようになりました。特にお手入れ（配置プレビ
ュー）機能は、対話しながら視覚的に確認・調整できるので、MCPならではの体
験だと感じています。
SUZURIのAPIが充実していたおかげで、比較的スムーズにMCPサーバーを構築で
きました。MCPに興味がある方は、お気に入りのサービスのAPIをMCPサーバー
化してみると、AIとの新しい連携の可能性が広がるかもしれません。
リポジトリはこちらです。
https://github.com/kurotaky/suzuri-mcp-server

ブログの著者欄

黒瀧悠太

GMOペパボ株式会社

オリジナルグッズを手軽に作成・販売できる「SUZURI byGMOペパボ」、国内最大級のハンドメイドマーケット「minne byGMOペパボ」の技術戦略とプロダクト開発を統括。テクノロジーとクリエイター支援の両軸から、事業部全体の価値最大化に取り組んでいる。GMOインターネットグループエキスパート(次世代IoTシステム）も兼任。趣味は音楽鑑賞、ドラム演奏。