MCP で画像を作る skill（配布準備）

tagru-mcp-images は、TAGRU MCP に接続済みの AI エージェント向けの skill ソースです。画像作成・編集 → プレビュー確認 → 下書き保存を扱い、SNS への投稿・予約は行いません。Figma 連携や新しい API は不要です。

このページはソースと手動導入手順の準備です。外部リポジトリは現在 private であり、この skill の一般公開・npm 配布・接続先への機能反映が済んだことを意味しません。利用可能な配布物・ソースへのアクセスを確認してから導入してください。リポジトリの公開、外部同期、npm 公開は別途行う作業です。

CLI 用 skill との違い

	CLI 用 `tagru`	MCP 用 `tagru-mcp-images`
ソース（CLI パッケージルート基準）	`skills/tagru/SKILL.md`	`skills/tagru-mcp-images/SKILL.md`
操作	ターミナルの `tagru ...`	接続済み TAGRU MCP のツール
認証	CLI のブラウザログイン	MCP クライアント側の認証・同意
導入・更新・削除	`tagru skill`	下記の手動コピー・ファイル削除

tagru skill install / show / uninstall が扱うのは tagru だけです。MCP 用を選ぶ引数はありません。既存の CLI 用 skill に上書きしないでください。CLI の --workspace・--yes・--out や JSON 出力形式を MCP に流用しないでください。

既存のパッケージ設定は skills ディレクトリ全体を同梱対象にしています。このソースを含む配布物であれば同じ場所から取得できますが、古い配布物に含まれるとは限りません。CLI 本体のインストール・ログインは、この MCP 用 skill の手動導入には不要です。

1. 利用者が MCP 接続を準備する

利用するエージェントの MCP 設定から TAGRU に接続・認証します。skill のコピーだけでは接続・権限は設定されません。キー・トークンを skill や会話に貼らないでください。

生成と下書き保存には MCP の draft.write scope と、対象領域の MCP 利用資格が必要です。
ワークスペースは workspaces_me の接続可能一覧から選びます。画像操作は member 以上、下書き保存・一覧は admin/owner が必要です。個人領域は別の利用資格で判定されます。
接続先の tools/list に image_generate / image_history_list / image_preview_get / draft_create / draft_list（WS ならそれぞれ workspaces_ 版）があることを確認します。実際の引数は接続先の schema を正とします。無い場合は手順を止め、CLI や推測したツールで代替しません。
画像を表示できるクライアントを推奨します。非対応なら利用者が TAGRU 画面で確認し、エージェントは未確認と伝えます。

2. SKILL.md を手動でコピーする

アクセス権のあるソース、またはこの skill を含む配布物から skills/tagru-mcp-images/SKILL.md を取得します。開発用モノレポのチェックアウトでは CLI/skills/tagru-mcp-images/SKILL.md です。コピー前に内容を読み、信頼する版であることを確認してください。

導入先は利用するエージェントの skill 検出先に合わせます。例:

Claude Code（ユーザー用）: ~/.claude/skills/tagru-mcp-images/SKILL.md
Codex（ユーザー用）: ~/.codex/skills/tagru-mcp-images/SKILL.md
プロジェクト限定: 利用先プロジェクトの .claude/skills/tagru-mcp-images/SKILL.md または .codex/skills/tagru-mcp-images/SKILL.md
その他: エージェントが指定する skills ディレクトリの tagru-mcp-images/SKILL.md

macOS / Linux の例（SKILL_SOURCE は取得したファイルの絶対パスに置き換える）:

bash

SKILL_SOURCE="/path/to/tagru-cli/skills/tagru-mcp-images/SKILL.md"
SKILL_DEST="$HOME/.claude/skills/tagru-mcp-images/SKILL.md"
mkdir -p "$(dirname "$SKILL_DEST")"
cp -i "$SKILL_SOURCE" "$SKILL_DEST"
cmp "$SKILL_SOURCE" "$SKILL_DEST"

cp -i は既存ファイルがあれば確認します。Windows では同じ導入先のフォルダを作り、ファイル操作でコピー・内容比較を行ってください。プロジェクト限定の場合は利用先プロジェクトを指定し、このソースリポジトリの開発用 .claude/skills 等には配置しません。

更新は差分を読んで同じファイルをコピーし直します。削除は導入した tagru-mcp-images/SKILL.md だけを削除します。 tagru skill uninstall では削除されません。導入後はエージェントの手順に従って skills を再読込するか、新しいセッションを開始してください。

3. 生成せずに導入を確認する

導入先のファイルがコピー元と一致し、エージェントの利用可能な skills に tagru-mcp-images が見えることを確認します。さらに「この skill の対象、必要なツールと権限を説明して。ツール呼出しや画像生成・保存はしないで」と依頼すれば、課金操作なしで読込を確認できます。これだけで生成・プレビュー・保存の動作確認が済んだとは扱いません。

利用時の確認ポイント

依頼例: 「TAGRU MCP で指定した WS の投稿画像を1枚作りたい。指示と料金・残り枠を確認してから生成し、プレビューと本文を見せ、了承後に下書きへ保存して。投稿・予約はしないで。」

生成・編集は1回で画面と共通の月次枠を1枚使い、失敗でも消費することがあります。対象領域の残り枠・プランの料金条件を画面で確認し、了承後だけ実行します。
生成結果の paths は同じ領域の下書きの parameters.media に渡します。画像は作成から1時間以内に保存し、履歴から回収するときは draft_usable_until を確認します。
WS 画像ツールの workspace_id はトップレベルですが、workspaces_draft_create では parameters.workspace_id です。
応答が切れても再生成しません。履歴の mine・created_at・prompt を照合し、完了済みの paths とプレビューを回収します。保存の応答不明時も下書き一覧を先に確認します。
保存成功時の id と open_url を利用者に返し、公開は利用者が TAGRU 画面で行います。

MCP で画像を作る skill（配布準備） ​

CLI 用 skill との違い ​

1. 利用者が MCP 接続を準備する ​

2. SKILL.md を手動でコピーする ​

3. 生成せずに導入を確認する ​