InkRoom · Visual & Batch Design Studio
InkRoom MCP Server:Claude / Cursor で商品画像を制作
InkRoom MCP は商品画像の生成と参照編集を AI アシスタントに接続します。ポイント見積もりを確認して実行し、元の受領情報で結果を取得できます。
画像タスク別のツール・入力・納品確認
| 制作タスク | ツールと必要な入力 | パラメータと実行条件 | 納品前の確認 |
|---|---|---|---|
| 文章から商品シーン | generate_image:prompt、任意で model・size・quality・count | count は 1–16。寸法と品質は実際のモデル一覧・見積もりに従う | 構図、実寸、元画像の形式 |
| 部分変更・背景変更 | derive_image:編集指示と referenceImages または parentTaskId | 複数画像の親タスクは parentImageIndex が必要。専用マスク切り抜き API ではない | 商品比率、ラベル、変更対象外の領域。透明指定時は alpha |
| 複数 SKU・掲載位置 | batch_generate:items 全体を見積もり。同じ設定は count | 合計ポイントと承認を確認。空き並列枠はサーバーが補充 | タスク ID で SKU と画像を対応。成功分は再生成しない |
| 商品拡大・アニメ補正 | upscale_image:1 枚の image と operation | x2・x4・anime・face。利用可否は processingOperations | 素材、輪郭、顔補正後の人物特徴 |
| 中断後の取得 | wait_images:元の nextAction.arguments をそのまま使用 | 同じ requestId / batchId を保持。保存失敗で新規見積もりしない | 完成分を表示し、保存した元画像を開いて確認 |
From a client connection to your first image quote
- Sign in to MCP Server, review MCP access, and create or select your personal Token with the required generation, model and batch Scopes.
- Connect to https://mcp.inkroom.ai using the appropriate Claude Code or Cursor format and verify discovery. This setup step does not run paid generation.
- Preview the references, prompt, placements and quantity. Check the actual model and credit estimate, execute within saved authorization, and approve the specific order when requested.
Copyable MCP Server JSON configuration
The service uses Streamable HTTP with a Bearer MCP Token. These examples follow the two clients' documented structures. There is no prerequisite public API call or private replacement for an API Key.
Claude Code · .mcp.json
{
"mcpServers": {
"inkroom": {
"type": "http",
"url": "https://mcp.inkroom.ai",
"headers": {
"Authorization": "Bearer YOUR_INKROOM_MCP_TOKEN",
"X-InkRoom-Continuation": "receipt-v1"
}
}
}
}Cursor · mcp.json
{
"mcpServers": {
"inkroom": {
"url": "https://mcp.inkroom.ai",
"headers": {
"Authorization": "Bearer YOUR_INKROOM_MCP_TOKEN",
"X-InkRoom-Continuation": "receipt-v1"
}
}
}
}Claude Code uses type:http in a project's .mcp.json; Cursor uses url and headers in its mcp.json. Merge the inkroom entry into existing mcpServers and retain other connections. Replace the placeholder with your personal MCP Token and keep the personal configuration private. X-InkRoom-Continuation enables the existing receipt flow; it belongs to MCP configuration, not public API requests.
This configuration requires a host supporting custom HTTP headers. Check compatibility for OAuth-only web connectors; it does not establish direct access from Claude on the web, Perplexity or every AI assistant.
Tools for generation, reference editing and enhancement
list_models— Discover models, processing operations and accessgenerate_image— Text-to-image and cost previewderive_image— Reference editing and derivation from existing imagesupscale_image— Upscaling, anime enhancement and face restorationbatch_generate— Submit multiple generation taskswait_images— Retrieve completed images and original links
Use derive_image with a source and instructions for detail or background cleanup. There is no dedicated remove_background Tool or mask field. Inspect real alpha for transparent PNG. upscale_image exposes x2/x4/anime/face as separate operations without a prompt or general model parameters; check availability with list_models first.
Where to obtain a MCP Token or API Key
For MCP: sign in, open MCP Server, choose Configuration, create or select a MCP Token, and copy the complete Token. For the API: sign in, open API management, create or select an API Key, and follow its documented authentication. The credentials are distinct; registration, copying an example or completing setup does not grant model access or raise spending limits.
Related workflows and official configuration documentation
Client configuration documentation reviewed:
この3つのシーン別レシピから始める
リンクはプロンプトを入力するだけです。必要な参照画像を追加し、予想クレジットを確認してから生成してください。
スポイト瓶:背景だけを変更
参照画像の要件:ラベルと輪郭が読める正面の元画像 1 枚。チャットの縮小画像は避ける。
参照画像の琥珀色ガラス製スポイト瓶を唯一の商品にする。高さ、肩の丸み、キャップ、ラベル文字とロゴの位置・比率を維持し、背景のみを明るいグレーの無地スタジオとマットな石材の台に変更する。正面斜めの視点、柔らかな側光、自然なガラスの透過と接地影。正方形で瓶全体を収め、文字、道具、2 本目の瓶を追加しない。指定外の商品部分をできる限り保ち、歪んだラベルは公開前に除外する。ランニングシューズ:側面の広告サンプル
参照画像の要件:同じ靴の鮮明な側面原図。色とひもを統一。別の掲載位置は指示を個別変更し、MCP 一括処理に渡す。
参照のランニングシューズから側面の広告サンプルを 1 枚作る。淡いベージュのマットな床と同色無地背景に、1 個の靴の全体の側面を配置する。色、商標、素材、形、縫い目を維持し、柔らかな側光と薄い接地影を使う。横 4:3、つま先は右向きで全体を収め、左上に後工程の文字用余白を残す。文字、価格、コラージュ、2 個目の靴を追加しない。保温カップ:白背景の商品写真
参照画像の要件:ふたとブランドが明瞭で、金属の白飛びがないカップ全体の写真。
参照の保温カップを白背景の商品画像に整える。元の背景と小物を除き、背景は RGB 255,255,255 を目標にする。ふた、取っ手、金属の筋、商品マーク、実物の比率を保つ。カップを直立させて全体を中央に置き、切り抜き用の余白を残す。新しい文字、枠、透かしは加えない。薄い接地影を残す。白背景を透明と扱わず、公開前に背景の画素、輪郭、マークを確認する。公開前のチェックリスト
- 必要なツールと Scope を確認し、選んだモデル・処理が利用可能か確認する。
- モデル、設定、枚数、合計ポイントを確認。保存済み承認を使い、要求された場合は今回の全体費用を承認する。
- 全 SKU、ロゴ、ガラス・金属の輪郭と保持領域を確認。白画素と alpha は別々に調べる。
- 元の受領情報で結果を照合し、元画像の開封・寸法を確認。保存失敗時は取得だけを再開する。
FAQ
Claude Code と Cursor と Claude Web は同じ設定を使えますか?
下記には Claude Code の type:http と Cursor の url/headers を別々に掲載しています。InkRoom は Streamable HTTP と個人 Bearer MCP Token を使用します。Claude Web、Perplexity などはカスタム URL と安全な Bearer Header に対応する場合のみ接続できます。OAuth 専用の接続先にそのまま使えるとは限りません。
背景除去や部分変更の Tool は?透明 PNG を保証しますか?
derive_image に元画像と編集指示を渡し、モデルの能力に応じて処理します。専用 remove_background Tool やマスク入力はありません。PNG は透明を意味しません。元画像の alpha と、ラベル・髪・ガラスの縁を確認してください。
MCP Token はどこで取得しますか?API Key で代用できますか?
ログイン後、MCP Server の設定で本人の Token を作成・選択して Bearer の仮文字列を置換します。API Key は API 管理で別途取得し、/v1・/v1beta の標準 API に使用します。両者は互換ではなく、MCP の見積もりや受領手順も API の前提条件ではありません。
参考資料
Last reviewed: