Sirv AI Studio

Sirv AI MCP Server

Sirv AI Studio 向けの MCP（Model Context Protocol）サーバーです。AI を活用した画像・動画処理を行います。

機能

この MCP サーバーは、AI 処理、アセット管理、商品管理、Shopify 連携、サプライヤーポータルの操作、Sirv CDN のファイル管理にわたる 54 個のツールを提供します。

画像処理

• sirv_remove_background - BiRefNet または Bria を使って画像の背景を削除します
• sirv_upscale - ESRGAN、Clarity、または Topaz を使って画像を 2～4 倍に拡大します
• sirv_background_replace - AI 生成のシーンで画像の背景を置き換えます
• sirv_object_removal - 画像内のオブジェクトを削除するか、プロンプトに基づいてマスク領域を塗りつぶします
• sirv_depth_map - 画像から深度マップを生成します

画像生成

• sirv_generate - テキストプロンプトから画像を生成します
• sirv_image_to_image - テキストプロンプトに基づいて画像を変換します
• sirv_image_translation - 画像内のテキストを翻訳します

商品 AI

• sirv_product_lifestyle - ライフスタイルシーンの商品画像を作成します
• sirv_virtual_try_on - バーチャル試着を行います

3D と動画

• sirv_image_to_3d - 画像を 3D モデルに変換します
• sirv_optimize_glb - メッシュとテクスチャを圧縮して GLB モデルを最適化します
• sirv_video_generation - テキストまたは画像から動画を生成します
• sirv_video_upscale - SeedVR または Topaz を使って動画を 2 倍または 4 倍に拡大し、出品に適した品質にします

バッチ操作

• sirv_batch_remove_background - 利用権のある画像バッチの背景を削除します
• sirv_batch_upscale - 利用権のある画像バッチを拡大します

ワークフロー

• sirv_list_workflows - 保存済みワークフローを一覧表示します
• sirv_get_workflow - ワークフローの詳細を取得します

アセット管理（DAM）

• sirv_list_assets - フィルタリングとページネーションを使ってアセットを一覧表示します
• sirv_get_asset - ID を指定して単一のアセットを取得します
• sirv_search_assets - ワークスペース内のアセットをテキストで検索し、すべての単語または語幹に一致するものを探します
• sirv_find_similar_assets - ワークスペースの視覚的類似性インデックスを使って、見た目が似ているアセットを探します
• sirv_update_asset - アセットのフィールド（ファイル名、代替テキスト、お気に入り）を更新します
• sirv_delete_asset - アセットを論理削除します
• sirv_get_asset_metadata - アセットのカスタムメタデータを取得します
• sirv_update_asset_metadata - カスタムメタデータのフィールドを更新します
• sirv_generate_asset_alt_text - アセットの代替テキストを AI で生成します
• sirv_bulk_asset_operation - お気に入りへの追加・解除、削除、タグ付け、移動を一括で実行します
• sirv_import_asset_url - 外部 URL からアセットをインポートします

商品管理（PIM）

• sirv_list_products - フィルタリングとページネーションを使って商品を一覧表示します
• sirv_get_product - ID を指定して単一の商品を取得します
• sirv_create_product - 新しい商品を作成します
• sirv_update_product - 商品のフィールドを更新します
• sirv_delete_product - 商品を削除します
• sirv_search_products - 名前または SKU で簡易検索します
• sirv_list_products_with_assets - 紐付けられたアセットの詳細とともに商品を一覧表示します
• sirv_link_assets_to_product - アセットを商品に紐付けます
• sirv_bulk_product_action - 削除、ステータスの更新、アセットの紐付けを一括で実行します

Shopify 連携

• sirv_shopify_status - Shopify の接続状態を確認します
• sirv_push_image_to_shopify - 承認済みの公開プランを通じて、Studio アセットを Shopify の商品に公開します
• sirv_sync_shopify_products - Shopify の商品と画像を PIM にバックグラウンドでインポートします

サプライヤーポータル

• sirv_get_supplier_sftp_status - 利用権のあるサプライヤーポータルの SFTP 接続情報を確認します
• sirv_get_supplier_review_assist_requirements - サプライヤーポータルへの提出要件を確認します
• sirv_run_supplier_autofix - クレジットを消費して、サプライヤー画像の自動修正を実行します

Sirv CDN ファイル管理

これらのツールは、Studio のアセットライブラリではなく、ワークスペースに接続された Sirv アカウントで動作します。

• sirv_cdn_search_files - ページネーションと並べ替えを指定して Sirv ファイルを検索
• sirv_cdn_get_file_metadata - ファイルのメタデータを読み取る
• sirv_cdn_manage_folder - フォルダーを作成するか、内容を一覧表示
• sirv_cdn_upload_from_url - 公開 URL からファイルをアップロード
• sirv_cdn_update_file_metadata - タイトル、説明、タグ、または商品メタデータを設定
• sirv_cdn_update_file_tags - ファイルのタグを追加または削除
• sirv_cdn_manage_file - ファイルの名前変更、コピー、または削除

ユーティリティ

• sirv_alt_text - 代替テキストの説明を生成
• sirv_get_usage - クレジット使用統計を確認

組織コンテキスト

• sirv_list_organizations - 認証済みユーザーが利用できる組織を一覧表示

すべての DAM、商品、Shopify、Supplier Portal、Sirv CDN ツールでは、リクエストを特定の組織に限定するための省略可能な orgId パラメーターを利用できます。省略した場合は、ユーザーのデフォルト組織が使用されます。サーバーは orgId を X-Org-Id ヘッダーとして送信し、API はユーザーが所属する組織と照合して検証します。

エンタイトルメントの確認

すべての Studio プランには API および MCP へのアクセスが含まれていますが、管理者はワークスペースでこれを無効にできます。その場合、リスト、取得、検索、メタデータ読み取り、使用状況、組織、ワークフロー読み取りなどのプレビュー可能なツールは、追加のツール固有の確認なしで実行されます。変更を行うツール、クレジットを消費する直接 AI ツール、バッチ操作、視覚的類似性、Shopify の配信／同期、Supplier Portal Pro ツールは、実行前に Studio の /api/mcp/authorize-tool エンドポイントを呼び出し、ワークスペースに該当するエンタイトルメントがない場合は実行を拒否します。

プロンプト

• prepare-listing-image (assetId) - ライブラリ内の画像 1 枚の背景を削除し、小さい場合はアップスケールして、代替テキストを作成
• alt-text-sweep (folderId) - ユーザーが費用を確認した後、フォルダー内で代替テキストが設定されていない画像を見つけて代替テキストを作成

インストール

ホスト型サーバー https://mcp.sirv.studio を使用するか、npm パッケージを実行します。

npx -y sirv-ai-mcp-server

バージョン 1.0.5 以降を使用してください。それ以前のバージョンは、2026-10-30 の www.sirv.studio 切り替え前のレガシーサーバーです。

ソースからビルドするには、次のコマンドを実行します。

bun install
bun run build
node dist/index.js

設定

環境変数

# Optional: Sirv AI Studio URL (default: https://www.sirv.studio)
SIRV_AI_BASE_URL="https://www.sirv.studio"

# Optional: API key for authentication (if not using OAuth)
SIRV_AI_API_KEY="your-api-key"

# Transport mode: "stdio" (default) or "http"
MCP_TRANSPORT="stdio"

# HTTP server settings (when using http transport)
MCP_HTTP_PORT=3001
MCP_HTTP_HOST=0.0.0.0
MCP_BASE_URL="https://your-mcp-server.com"

# HTTPS (optional - can also use reverse proxy)
MCP_SSL_KEY_PATH="/path/to/key.pem"
MCP_SSL_CERT_PATH="/path/to/cert.pem"

# Security: IP allowlisting
MCP_ENABLE_IP_ALLOWLIST="true"
MCP_ALLOWED_IPS="1.2.3.4,5.6.7.8/24"

# CORS: Allowed origins (comma-separated)
MCP_CORS_ORIGINS="https://claude.ai,https://your-app.com"

トランスポートモード

Stdio トランスポート（デフォルト）

Claude Desktop および Claude Code とのローカル連携に使用します。

bun run start
# or
bun run dev

HTTP トランスポート

HTTPS 経由でアクセスできるリモート／ホスト型デプロイに使用します。

bun run start:http
# or
bun run dev:http

HTTP モードで実行すると、サーバーは以下を公開します。

• / - MCP プロトコルエンドポイント（互換性のため /mcp も受け付けます）
• /health - ヘルスチェックエンドポイント
• /.well-known/oauth-authorization-server - OAuth 2.0 メタデータ
• /.well-known/oauth-protected-resource - 保護されたリソースのメタデータ

セキュリティ機能

リクエスト制限

HTTP リクエストでは、圧縮されていない最大 1 MiB の JSON を受け付けます。ツール引数は、ネストされた値も含め、配列要素とオブジェクトメンバーの合計が 10,000 個までに制限されます。大きなリクエストは複数の小さな呼び出しに分割してください。ファイルのアップロードには、インラインのバイトデータではなく URL を使用します。

サインイン済みの各呼び出し元は、1 分間に 100 件のリクエストを送信できます。1 つの IP アドレスから送信できる無効な API キーは、1 分間に 30 件までです。期限切れの OAuth トークンはこの制限にカウントされません。

OAuth 2.0 のサポート

このサーバーは、安全な認証のために PKCE を使用した OAuth 2.0 を実装しています。

• S256 コードチャレンジを使用した認可コードフロー
• トークンの更新をサポート
• ~/.sirv-ai/tokens.json への安全なトークン保存

ツールの安全性アノテーション

すべてのツールには、適切な MCP 安全性アノテーションが含まれています。

• readOnlyHint - ツールがデータの読み取りのみを行うかどうかを示します
• destructiveHint - ツールがデータを削除または上書きする可能性があるかどうかを示します
• idempotentHint - 呼び出しを繰り返したときに同じ結果が得られるかどうかを示します
• openWorldHint - ツールが外部サービスにアクセスするかどうかを示します

CORS の設定

HTTP モードで実行する場合、ブラウザベースの認証用に CORS が設定されます。

• デフォルトの許可オリジン：https://claude.ai、https://console.anthropic.com
• MCP_CORS_ORIGINS 環境変数でカスタマイズ可能です
• 認証情報をサポートした適切なプリフライト処理

IP 許可リスト

IP ベースのアクセス制御を任意で設定できます。

• Claude.ai／Claude Code の IP 範囲が事前設定されています
• MCP_ENABLE_IP_ALLOWLIST=true で有効にします
• MCP_ALLOWED_IPS でカスタム IP／CIDR 範囲を追加できます

HTTPS サポート

本番環境にデプロイする場合：

1. HTTPS を直接設定：MCP_SSL_KEY_PATH と MCP_SSL_CERT_PATH を設定します
2. リバースプロキシ：TLS 終端を行う nginx／Caddy の背後で HTTP を実行します

Claude Desktop での使用

Claude Desktop の設定（claude_desktop_config.json）に追加します。

{
  "mcpServers": {
    "sirv-ai": {
      "command": "npx",
      "args": ["-y", "sirv-ai-mcp-server"],
      "env": {
        "SIRV_AI_BASE_URL": "https://www.sirv.studio"
      }
    }
  }
}

Claude Code での使用

Claude Code の MCP 設定に追加します。

{
  "mcpServers": {
    "sirv-ai": {
      "command": "npx",
      "args": ["-y", "sirv-ai-mcp-server"],
      "env": {
        "SIRV_AI_BASE_URL": "https://www.sirv.studio"
      }
    }
  }
}

ChatGPT での使用

ホストされたサーバーの場合、MCP コネクターの URL として https://mcp.sirv.studio を使用します。https://mcp-dev.sirv.studio で追加したコネクターも引き続き 動作します。Studio が https://www.sirv.studio でサインインと同意を処理します。 すべての Studio プランで接続できます。ワークスペースのクレジットがなくなると、ツールは Studio のクレジット購入ページへのリンクを返します。 この接続方法は、OpenAPI 仕様を使用する ChatGPT Actions とは別のものです。

ChatGPT コネクターから提供されたコールバック URL を使用します。Studio は、 1 つの ID セグメントに英字、数字、アンダースコア、ハイフンを含む https://chatgpt.com/connector/oauth/<id> と、従来の https://chatgpt.com/connector_platform_oauth_redirect コールバックを受け付けます。URL は クライアントに登録されたリダイレクト URI とも一致する必要があります。OAuth では引き続き PKCE S256 が必要です。MCP 開発者向けドキュメントを参照してください。

現在のソースでは、画像結果を返す 10 個のツールがインタラクティブな画像ウィジェットを 追加します。アカウント、アセット、商品、バッチ、ワークフロー、動画、3D の各ツールは、 ウィジェットなしでツールの結果を返します。複数画像の生成では、ウィジェットは ギャラリーではなく最初の結果をプレビューします。

ウィジェットは、MCP Apps リソース ui://widget/sirv-studio-v3.html を MIME タイプ text/html;profile=mcp-app で使用します。 これはサーバーの実装について説明するものであり、アプリが ChatGPT ディレクトリに掲載されていることを示すものではありません。

リモートサーバーのデプロイ

MCP サーバーをリモートでホストする場合（claude.ai からアクセス可能）：

2 つのオリジンを区別してください。

• SIRV_AI_BASE_URL は、OAuth と API リクエストを処理する Studio アプリです。
• MCP_BASE_URL は、クライアントが MCP サーバーに接続するために使用する公開オリジンです。 公開される OAuth リソースとウィジェットのドメインを指定します。

Docker Compose 設定のデフォルトは、それぞれ https://www.sirv.studio と https://mcp.sirv.studio です。 別の環境にデプロイする場合は、両方を明示的に設定してください。

クライアントを接続する前に、ディスカバリーを確認してください。

curl --fail https://mcp.sirv.studio/.well-known/oauth-protected-resource
curl --fail https://mcp.sirv.studio/.well-known/oauth-authorization-server

これらのデフォルトでは、resource は https://mcp.sirv.studio、 issuer と唯一の authorization_servers エントリーは https://www.sirv.studio である必要があります。認可、トークン、登録の各 エンドポイントには Studio のオリジンを使用してください。

1. HTTPS でデプロイする

# Using SSL certificates directly
MCP_TRANSPORT=http \
MCP_HTTP_PORT=443 \
MCP_BASE_URL=https://mcp.your-domain.com \
MCP_SSL_KEY_PATH=/etc/ssl/private/key.pem \
MCP_SSL_CERT_PATH=/etc/ssl/certs/cert.pem \
MCP_ENABLE_IP_ALLOWLIST=true \
SIRV_AI_BASE_URL=https://www.sirv.studio \
bun run start:http

2. またはリバースプロキシを使用する（推奨）

nginx の設定例：

server {
    listen 443 ssl http2;
    server_name mcp.your-domain.com;

    ssl_certificate /etc/ssl/certs/cert.pem;
    ssl_certificate_key /etc/ssl/private/key.pem;

    location / {
        proxy_pass http://127.0.0.1:3001;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

3. claude.ai で設定する

デプロイ後、ユーザーはサーバー URL を使って claude.ai の MCP 設定から接続できます。

開発

# Run in development mode with auto-reload (stdio)
bun run dev

# Run in development mode (http)
bun run dev:http

# Build for production
bun run build

# Run the server (stdio)
bun run start

# Run the server (http)
bun run start:http

ツールの使用例

背景の削除

Remove the background from https://example.com/product.jpg

画像の生成

Generate an image of a modern minimalist living room with natural lighting

アセットの閲覧

Show me my latest 10 assets
Search my assets for "product photos"

商品の管理

List all active products from Shopify
Create a product with SKU "CHAIR-001" named "Modern Chair"
Link these 3 assets to the chair product as gallery images

Shopify ワークフロー

Check my Shopify connection status
Sync products from Shopify including images
Push this processed image to Shopify product 12345

クレジットのコスト

ツール	クレジット
背景の削除	1-2
アップスケール	2-3
生成	2
画像から画像	2-4
背景の置換	4
オブジェクトの削除	3
代替テキスト	1
深度マップ	無料
バーチャル試着	4
画像から3D	80
動画生成	変動

トラブルシューティング

接続の問題

「サーバーが見つかりません」または接続が拒否される

• サーバーが起動していることを確認します。stdio の場合は bun run start、HTTP モードの場合は bun run start:http を実行します
• SIRV_AI_BASE_URL が正しく設定されていることを確認します
• HTTP モードの場合、ポートがファイアウォールでブロックされていないことを確認します

「認証に失敗しました」

• 保存されたトークンを削除します：rm -rf ~/.sirv-ai/tokens.json
• OAuth フローで再認証します
• https://www.sirv.studio でアカウントが有効であることを確認します

「API キーが無効です」

• SIRV_AI_API_KEY が正しく設定されていることを確認します（API キー認証を使用する場合）
• Sirv AI Studio アカウント設定で API キーを再生成します

ツールのエラー

「クレジットが不足しています」

• sirv_get_usage ツールを使ってクレジット残高を確認します
• https://www.sirv.studio/billing でクレジットを追加購入します

「画像 URL にアクセスできません」

• 画像 URL に誰でもアクセスできることを確認します（認証で保護されていないこと）
• まず画像を公開ホスティングサービスにアップロードしてみてください

「処理がタイムアウトしました」

• 大きな画像や複雑な操作には、より時間がかかる場合があります
• 画像を小さくするか、解像度設定を下げて試してください
• 動画生成や 3D 変換には数分かかる場合があります

HTTP トランスポートの問題

ブラウザーでの CORS エラー

• MCP_CORS_ORIGINS 環境変数にオリジンを追加します
• 例：MCP_CORS_ORIGINS="https://your-app.com,https://claude.ai"

SSL/TLS 証明書エラー

• MCP_SSL_KEY_PATH と MCP_SSL_CERT_PATH の証明書パスが正しいことを確認します
• 証明書の有効期限が切れていないことを確認します
• 開発時には、Let's Encrypt を利用したリバースプロキシの使用を検討してください

IP がブロックされています

• IP 許可リストを使用している場合は、MCP_ALLOWED_IPS に IP を追加します
• IP アドレスが変更されていないか確認します（動的 IP アドレスの場合）

ヘルプの利用

• 問題を報告する：https://www.sirv.studio/contact?type=support
• ドキュメント：https://www.sirv.studio/docs
• サポートへのお問い合わせ：[email protected]

プライバシーポリシーと利用規約

Sirv AI MCP Server を使用すると、当社の規約とポリシーに同意したことになります。

• プライバシーポリシー：https://www.sirv.studio/privacy
• 利用規約：https://www.sirv.studio/terms

データの取り扱い

• 画像は fal.ai API を通じて処理され、そのデータポリシーが適用されます
• 生成された出力は、取得できるよう一時的に保存されます
• ユーザー認証トークンはローカルの ~/.sirv-ai/tokens.json に保存されます
• MCP サーバー自体がユーザーデータを収集することはありません。ただし、認証に必要なデータは除きます

ライセンス

このプロジェクトは MIT License の下でライセンスされています。詳細は LICENSE ファイルを参照してください。