render-images-in-cursor

Cursor で画像を表示する

Cursor のチャットで画像が確実に表示されるのは、ファイルが開いているワークスペース内にある場合のみです。画像ツールはワークスペース外のフォルダー（たとえば、Cursor のプロジェクトディレクトリ内にある assets フォルダー）に保存することが多く、「すでに表示されています」と報告しますが、ユーザーには何も表示されず、エラーも出ません。チャット内のインライン表示は、Cursor の新しい機能で、段階的に提供されているため、必ずエディタータブで開く方法も追加してください。

ワークフロー

1. 画像を開いているワークスペースにコピーします。 ワークスペース内のどのフォルダーでも構いませんが、リポジトリの一時フォルダーをおすすめします。

mkdir -p tmp/mockups
cp "$IMAGE_PATH" tmp/mockups/my-image.png

2. チャットの返信に画像を埋め込みます。 ワークスペース内のファイルを指すプレーンな Markdown を使い、絶対パスを指定してください。

![Short description](ABSOLUTE-WORKSPACE-PATH/tmp/mockups/my-image.png)

画像ごとに 1 つ埋め込み、各画像をそれぞれ別の行に配置し、その上に太字の 1 行のラベルを付けてください。画像ツールの「すでに表示されています」という出力を決して信用せず、毎回明示的に埋め込んでください。

3. 各画像をエディタータブでも開きます。インライン表示が失敗しても確実に表示されます。cursor-app-control MCP サーバーを使う場合は、open_resource を呼び出します。

uri = file://ABSOLUTE-WORKSPACE-PATH/tmp/mockups/my-image.png

ファイル URI は、ワークスペース内（またはユーザーの .cursor フォルダー内）を指す必要があります。この MCP サーバーがない場合は、ワークスペースのルートから cursor tmp/mockups/my-image.png を実行してください。

4. ユーザーに確認します。 画像が表示されているか尋ねてください。インライン表示に失敗した場合は、手順 3 のエディタータブが代替手段になります。同じ Markdown を再送するだけでは不十分です。

失敗するケース

• 画像がワークスペース外に保存されている：チャットには何も表示されず、通知もありません。まず手順 1 でワークスペース内にコピーし、そのパスを埋め込んでください。
• Markdown が画像ではなくプレーンなファイルリンクとして表示される：ユーザーの Cursor のビルドにはチャット内のインライン画像表示機能がありません。手順 3 のエディタータブを使ってください。
• open_resource が URI を拒否する：ファイルがワークスペース外にあります。手順 1 に従ってパスを修正してください。
• macOS の open によって Cursor の外部にある Preview で画像が表示される：最終手段としてのみ使用してください。