MCP — AI エージェントを接続

Claude などのエージェントがこのエディターを直接操作します。

ログインすれば photovim.com でも使えます。下で接続コードを取得し、ご自身のコンピューターで 1 行実行してください。コードの有効期間は数分で、ご自身のタブにのみ接続します。

何が違うのか

エージェントが作ったものは、1 枚に統合された画像ではなく、編集可能なドキュメントとして残ります。

  • テキストはテキストレイヤーとして、背景は独立したレイヤーとして届くため、文言やカラーの変更をその場で行えます。
  • エージェントの操作は取り消し 1 段階です。気に入らなければ Ctrl+Z で元に戻せます。
  • 今見ているタブで実行されます — 同じドキュメント、同じ取り消し履歴です。

接続コードを取得

エディタータブを開いたままコードを取得し、下の行をご自身のコンピューターのターミナルに貼り付けてください。コードは数分で期限切れになります。

ログインしてコードを取得

インストールせずに接続 (リモート)

Canva や Figma と同じく、URL 1 つで接続できます。Node は不要です。Claude Code なら下の 1 行だけで済み、コードを取得すると該当箇所が入力されます。

claude mcp add --transport http photovim https://photovim.com/mcp --header "Authorization: Bearer 接続コード"

その他のクライアントは、URL https://photovim.com/mcp に Authorization: Bearer コード ヘッダーを付けて使います。ヘッダーを送れない場合は https://photovim.com/mcp/コード を使います。リモートでは open_file は使えず (お使いのコンピューター上のパスを受け取るため)、export は png/jpg/webp を画像として返すだけです。

パッケージで接続 (npx)

以下をクライアントの MCP 設定に追加してください。必要なのは Node 22 以降だけで、インストールするものはありません。上でコードを取得すると、コードの欄が入力されます。

{
  "mcpServers": {
    "photovim": {
      "command": "npx",
      "args": ["-y", "@photovim/mcp", "--url", "wss://photovim.com/cable", "--code", "接続コード"]
    }
  }
}

クライアント別

Claude Code
作業フォルダーの .mcp.json に記述するか、claude mcp add photovim -- npx -y @photovim/mcp --url … --code … で追加します。
Claude Desktop · Cursor
claude_desktop_config.json の mcpServers の下にそのまま追加し、Claude Desktop を再起動します。
Codex
~/.codex/config.toml の [mcp_servers.photovim] に同じ command と args を記述します。

接続を確認する方法

エディターのメニューバーでヘルプの右にある MCP を見てください。ボタン内のドットが現在の状態です。

  • 緑 — 接続済み。エージェントが何かを実行すると、その名前も表示されます。
  • 黄 — 接続中、または接続が切れた後の再接続中です。
  • 赤 — 接続できませんでした。トークンまたはサーバーを確認してください。

現在できること

ドキュメントを開く・保存、選択範囲、レイヤーの作成・配置・変形・色調補正、テキストの追加・編集、ブラシストロークのペイント、背景の削除、被写体を選択、AI 生成、取り消し — 全部で 34 個のツールです。

ツール機能種類
接続
list_tabs現在開いているエディタータブ読み取り
attachエディタータブに接続します — 以降のツールはそのタブで実行されます (同じドキュメント、同じ取り消し履歴)選択
get_capabilitiesこのエディターで現在できること — 形式、色調補正名、モデル読み取り
ドキュメント
open_file画像、PSD、.photovim、TIFF を新しいタブで開きます変更 (取り消し履歴に残ります)
new_document空のドキュメントを作成します変更 (取り消し履歴に残ります)
list_documents開いているドキュメント (タブ)読み取り
select_documentドキュメント (タブ) を選びます選択
exportドキュメントをファイルに保存します (.png .jpg .webp .psd .photovim)読み取り
表示
get_stateドキュメントの状態 — サイズ、リビジョン、レイヤーツリー、選択範囲、取り消しの段階数読み取り
list_layersレイヤーの一覧と状態 (get_state と同じ)読み取り
screenshot現在の合成結果を PNG で取得します読み取り
選択範囲
rect_select長方形の選択範囲 (ドキュメント座標)選択
select_subjectブラウザー内のモデルで被写体を検出して選択します (写真は外部に送信されません)選択
deselect選択を解除選択
selection_to_mask選択範囲をアクティブなレイヤーのマスクにします変更 (取り消し履歴に残ります)
レイヤー
select_layerレイヤーを 1 つアクティブにします (id または index)選択
add_layer最上部に空のレイヤーを追加します変更 (取り消し履歴に残ります)
set_layer_propsレイヤー名、表示、不透明度、描画モード変更 (取り消し履歴に残ります)
move_layerレイヤーを移動します (相対 dx/dy または絶対 x/y)変更 (取り消し履歴に残ります)
reorder_layerレイヤーの重ね順を変更します変更 (取り消し履歴に残ります)
transform_layerレイヤーを拡大・縮小または回転します (テキスト・スマートオブジェクトは値のまま残ります)変更 (取り消し履歴に残ります)
ピクセルと色調補正
fill_selection選択範囲 (またはレイヤー全体) をカラーで塗りつぶします — テキスト・シェイプ・スマートオブジェクトは rasterize: true がないと拒否します変更 (取り消し履歴に残ります)
paint_strokesブラシストロークを 1 本ずつペイントします (ポイント、カラー、サイズ、不透明度、硬さ) — 描かれる様子をエディターで確認できます変更 (取り消し履歴に残ります)
apply_adjustmentアクティブなレイヤーに色調補正を適用します (明るさ、レベル補正、トーンカーブ、色相…) — テキスト・シェイプレイヤーは rasterize: true がないと拒否します。スマートオブジェクトにはスマートフィルターとして適用されます変更 (取り消し履歴に残ります)
remove_backgroundブラウザー内のモデルで背景を削除します変更 (取り消し履歴に残ります)
resize_image画像のサイズを変更します (すべてのレイヤーをまとめて)変更 (取り消し履歴に残ります)
cropドキュメントを長方形に切り抜きます変更 (取り消し履歴に残ります)
テキスト
add_textテキストレイヤーを作成します変更 (取り消し履歴に残ります)
edit_textテキストレイヤーの内容、位置、書式を変更します変更 (取り消し履歴に残ります)
AI 生成
list_ai_modelsAI 生成に使えるモデル、1 回あたりのクレジット、残りのクレジット読み取り
generate_imageAI で編集 (選択範囲または画像全体)、テキストから新しい画像を作成、または削除します — 結果は新しいレイヤーに配置されます。クレジットモデルではクレジットを消費します変更 (取り消し履歴に残ります)
ai_job_status時間のかかる生成を引き続き待ち、結果 (新しいレイヤー、消費したクレジット) を受け取ります読み取り
バッチと取り消し
batch複数のコマンドを 1 つのまとまりとして実行します — 取り消しは 1 段階です。onError=rollback の場合、失敗するとまとまり全体を元に戻します変更 (取り消し履歴に残ります)
undo最後の操作を取り消します変更 (取り消し履歴に残ります)

制限

制限はユーザーごとです。コマンド 1 つが 1 回で、batch は含まれる各ステップを数えます。読み取りと書き込みは同じに数えます。制限を超えると、そのコマンドにはすぐに「レート制限」の応答が返ります。

現在 (全員)
1 分あたり300 回
1 日あたり20,000 回
同時に接続できるエージェント10

未対応: 「バナーを作って」のような一度で完成させる作業は今後予定しています。現在は 34 個のツールを 1 つずつ操作します。

エディターに戻る