CORPORATE

技術情報

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の主要な操作をカバーしています。

カテゴリ主なツールできること
Productssearch_products, get_productキーワードで商品を検索、商品詳
細の取得
Materialscreate_material, create_text_material画像URLやテキストから素
材を作成・管理
Itemslist_itemsTシャツ、マグカップなどアイテム種別の一覧取得
Usersget_current_user, update_userユーザー情報の取得・プロフィール
更新
Favoritesadd_favorite, remove_favoriteズッキュンの追加・解除
Activitieslist_activitiesアクティビティの確認
Placementpreview_product_placement, compare_placements配置のプレ
ビュー・比較
Choicescreate_choice, update_choiceチョイスの作成・管理

動作イメージ

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

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

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

配置プレビュー

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

配置の一括比較

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

4パターンの配置をブラウザで一覧比較できる

配置プリセット

よく使う配置パターンを「プリセット」として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システム）も兼任。趣味は音楽鑑賞、ドラム演奏。

採用情報

関連記事

No.1&STEAM人財採用 新卒年収710万プログラム

KEYWORD

CATEGORY

TAG

もっとタグを見る

PICKUP

採用情報

SNS FOLLOW

GMOインターネットグループのSNSをフォローして最新情報をチェック

CATEGORY