Marunage Studio

原稿のそばで、クライアントレビューを。

Studioに届いたコメントと修正提案を、VS Code / Cursorの原稿に表示します。 文脈を確かめながら返信し、提案は原稿の上で差分として読む。採否はチャットのAIに一言で頼み、承認した変更はそのまま原稿へ。

はじめる

1. VS Code / Cursorの 拡張機能 を開き、@id:ele-inc.marunage-feedback を検索します。
2. Marunage Studio をインストールします。Auto Update（自動更新） をオンにしておくと、新版を自動で受け取れます。
3. 原稿のリポジトリを開き、Markdownファイルを本文表示で開きます。

VS Code Marketplace · Cursor / Open VSX

必要なのは Studioの管理者・スタッフアカウント と 手元の原稿リポジトリ です。 接続はログアウトするまで切れません。

接続は2つあります

コメントを原稿に出す接続と、チャットのAIがコメントを読む接続は別です。どちらもブラウザでStudioにログインしたうえで、許可します。

① コメントを原稿に出す

コマンドパレットで 「Marunage Studio: Studioにログイン」 を実行します。接続コードは エディタ左下の通知 に出ます。

ブラウザのコードと一致することを確認して 「このCursorを接続する」 を押します。 つながると、同じ左下に「〜としてStudioにログインしました」と出ます。 💬と提案の差分の表示、返信、対応済みはこちらです。VS CodeでもCursorでも行います。

② チャットのAIにコメントを読ませる

Cursorのチャットで 「この台本のコメントを読んでください」 と送ります。次のカードが出たら Authenticate を押します。Skip は押しません。

ブラウザが開いたら Studio にログインし、「このエディタを接続する」 を押します。 チャットからコメントを読む・返信する・対応済みにする接続です。クライアント提案の一覧・採否もここから頼めます。承認した変更はその場で本文へ反映されます。

「Configure extension-marunage-feedback」は設定元の切替で、認証ではありません。 VS Codeでは②は不要です。Claude Codeは .mcp.json のURLから、同じOAuthへ進みます。 「Copy URLs & Proceed」は使いません。.cursor/mcp.json への手書きも不要です。

カードが出ないとき・あとから認証するとき

チャットにカードが出なかったときや、AIが「Studioに接続してください」と返すときは、設定画面から認証します。

1. Cmd + Shift + J（Cursor → Settings → Cursor Settings）を開きます。普通の Settings ではなく Cursor Settings です。
2. 左の MCP（または Tools & MCP）を選び、上の検索欄に marunage と打ちます。
3. extension-marunage-feedback の行を見ます。「Needs authentication」と黄色の点が出ていたら、右端の Authenticate を押します。

ブラウザが開いたら Studio にログインし、「このエディタを接続する」 を押します。 戻ってくると点が緑になり「N tools enabled」と出ます。これで完了で、次からは聞かれません。 すでに緑なら何もしなくてよいです。赤や黄で止まっているときは、行にマウスを乗せると出る回転矢印（Refresh）で再接続します。

画像で認証待ちになっている marunage-studio-preview は確認用の別サーバーです。普段は extension-marunage-feedback の行だけ見ます。

コメントに、その場で返信

原稿の 💬 をクリックすると、該当行の下にコメントと返信が開きます。 その場から返信・対応済みへの変更・AIへの修正依頼ができます。自分が投稿した返信は「自分の返信を編集・削除」から修正できます。削除時には確認が出ます。 返信や承認の履歴には、ログインしたStudioアカウントが記録されます。

提案は原稿の上で読み、採否はチャットで

クライアントが提案モードで加えた変更は、原稿の該当箇所に 赤（消える文）と緑（入る文） で出ます。 行の上の ✏️ ○○ の修正提案 をクリックするか、赤緑にマウスを乗せると、差分の全文が読めます。 スクロールバーの右にも赤緑の印が出るので、画面の外にある提案にも気づけます。

拡張には承認・見送りのボタンはありません。1件ずつ押す作業をなくすため、採否はチャットのAIに頼みます。

チャットのAIに進め方を相談する

②の接続があれば、Cursorのチャットで 「この台本のレビューを始めて」 と頼めます。 AIがコメントと提案を一度に読んで、進め方を相談してきます。

• 提案は本文を読んで「そのまま反映してよさそうなもの（表記・言い回しの微修正）」と「見てもらいたいもの（文の削除、事実や主張が変わるもの）」に分けて示します。全部そのままでよさそうなら 「18件とも表記の修正なので、まとめて反映しますか？」 の一言です。
• コメントは「言い回し / 事実・数字 / 構成・順序 / 追加要望 / 質問」などにざっくり分け、どう直すかの方針を出します。

あとは普段のチャットと同じです。「全部OK」「3件目は見送り」「数字は自分で確認する」と返すと、その通りに承認・見送りを保存し、コメントは手元の原稿を直します。 1件ずつ押す必要はありません。承認した変更はその場で本文（GitHubのcanonical branch。本番では main）に反映されます。AIが「本文へ反映しました」と返したら、続きの編集の前に手元を pull してください。「処理中」「止まっています」の場合は pull せず、Studioの文書画面で反映状態を確認します。

手元の原稿を保ちながら使う

未保存の編集や未同期の変更がある場合は、コメントの対応済み操作を止めます。 承認後の「最新の本文を取得」は、手元に変更がなく、対象のブランチを安全に進められる場合だけ実行します。 同期できない場合は、Studioの確定版との差分を確認できます。

更新・困ったとき

• 拡張の更新はエディタのストアから受け取ります。自動更新を有効にしてください。更新後にエディタの再読み込みが必要な場合があります。
• コメントが変わったら「Marunage Studio: コメント・提案を読み直す」を実行します。
• Markdownをプレビューしている場合は、ソース・本文表示へ切り替えてください。
• 接続先の設定は通常変更不要です。導入方法はStudioのエディタ拡張設定でも確認できます。

掲載画像はテスト用クライアント「仮メンタリストえる」の原稿を使った表示デモです。