ドキュメント

StudioCat をはじめる

StudioCat は Web 版 ChatGPT を Mac 上のプロジェクトにつなぎます。何をするかは ChatGPT が決め、StudioCat がローカルで実行します。すべての呼び出しを設定した権限と照らし合わせ、すべての変更をワークベンチに表示します。

動作環境

macOS 14 以降の Mac。
Web で開発者モードを使える ChatGPT アカウント。iPhone、iPad、Android の ChatGPT はまだカスタム MCP サーバを呼び出せません。
トンネルと API キーを作成できる OpenAI Platform の組織。モデル API の課金は発生しません。
プロジェクトですでに使っているツールチェーン（Go、Swift、Node など）。StudioCat はそれらを実行しますが、同梱はしません。

インストール

署名・公証済みの DMG をダウンロードして開き、StudioCat を「アプリケーション」にドラッグします。StudioCat は自動でアップデートし、インストール前に確認を求めます。プライベートベータの期間中は、ホームページから参加を申し込んでください。

初回起動時には設定アシスタントが次の 3 ステップを案内します。あとから上部バーのトンネル状態、または StudioCat → 設定アシスタント… でいつでも開き直せます。

1 · トンネルを作成

Platform → Tunnels を開いてトンネルを作成し、Tunnel ID（tunnel_…）をコピーします。
Platform → API keys を開いてキーを作成します。Restricted を選び、Tunnels: Read と Use だけを有効にします。
アカウントが複数の組織（たとえば個人用と仕事用）に属している場合は、トンネルを所有する組織の ID（org-…、Settings → Organization にあります）を控えておきます。

2 · StudioCat を接続

Tunnel ID、API キー、必要なら組織 ID を設定アシスタント（または 設定 → 一般 → トンネルの認証情報）に貼り付け、保存して接続を選びます。認証情報は macOS のキーチェーンに保存されます。接続すると上部バーのトンネル状態が緑色になります。Mac が行うのは外向きの HTTPS 接続だけで、StudioCat がポートを開くことはありません。

3 · ChatGPT に MCP サーバを追加

パソコンのブラウザで chatgpt.com/plugins を開きます。追加ボタンが見当たらない場合は、先に ChatGPT の詳細設定で開発者モードをオンにしてください。
StudioCat という名前で MCP サーバを追加します。Connection で Tunnel を選び、トンネルを選択します（または Tunnel ID を貼り付けます）。
保存して更新し、StudioCat を有効にした新しいチャットを始めます。試しに 「StudioCat を使って、プロジェクトのルートにあるファイルを一覧表示して」 と送ってみましょう。

あとで別のトンネルに切り替えた場合は、ChatGPT の MCP サーバも新しいトンネルに向けてください。そうしないと、トンネルクライアントが接続されていないというエラーになります。

プロジェクトと権限

StudioCat が作業するのは、ファイル → プロジェクトを開く…（⌘O）で開いたプロジェクトの中だけです。プロジェクトを開くときに、何を許可するかを決めます。

読み取り、検索、編集、パッチ、チェックポイント、コードインテリジェンスは、プロジェクト内では既定で許可されています。
ターミナル（コマンドの実行）とコミットは既定でオフです。プロジェクトごとにオンにするか、ChatGPT から最初に求められたときに許可します。
危険なパターンに一致するコマンドは、Mac 上で確認を求めます。拒否すればそれで終わりで、何も実行されません。

確認が 2 段階あるのは意図的です。ChatGPT が呼び出しを送るかどうかを尋ね、StudioCat が危険な呼び出しを実行する前に尋ねます。どちらも、もう一方の代わりにはなりません。

レビューと取り消し

ワークベンチには呼び出しがその場で表示され、出力にはコマンドの出力が表示されます。
編集はすべて差分レビューのカードになります。元に戻すを押すと、名前の変更やファイルモードも含めてファイルを復元します。その後にファイルがまた変更されていた場合、古いカードは新しい編集を上書きせず、取り消しを拒否します。
チェックポイントは、プロジェクトのスナップショットを隠し git ref に保存します。ブランチ、HEAD、インデックス、stash には一切触れません。

チェックポイントはバックアップではありません。ターミナルで rm -rf により削除された、git が無視するファイル（build/ など）は復元できません。

複数のプロジェクトを同時に

ChatGPT の会話は、最初に作業したプロジェクトに紐付きます。ワークベンチに表示するプロジェクトを切り替えても、会話はバックグラウンドで自分のプロジェクトでの作業を続けます。会話の中から（明示的なパスで）別のプロジェクトを開くと、その会話はそちらに移ります。

トラブルシューティング

「API Key が無効です」: キー全体をもう一度コピーするか、新しく作成してください。取り消されたキーはすぐに使えなくなります。
「このキーではトンネルを使えません」（tunnel_use_forbidden）: キーに Tunnels の Read と Use を付与してください。新しい権限の反映には数分かかることがあります。
「組織 ID が必要です」（tunnel_active_organization_required）: キーが複数の組織に属しています。設定でトンネルの組織 ID を入力し、再接続してください。
ChatGPT がトンネルクライアントに接続されていないと言う: 上部バーでトンネルが接続済みになっていること、ChatGPT の MCP サーバが StudioCat と同じトンネルを使っていることを確認してください。
Web では動くのにスマートフォンでは動かない: 想定どおりの動作です。ChatGPT のモバイルアプリはまだカスタム MCP サーバを呼び出せません。
OpenAI に接続できない: ネットワークを確認してください。プロキシを使っている場合は、システムのプロキシがオンになっていることを確認してください。StudioCat はそれに従い、自動で再試行します。

データとアンインストール

設定、権限、ログ、ローカルの監査ログは ~/.cache/StudioCat/ に保存されます。
トンネルの認証情報はキーチェーン項目 StudioCat.mcp-tunnel に保存されます。設定 → 削除で削除できます。
アンインストールするには、StudioCat を終了してゴミ箱に入れ、~/.cache/StudioCat/ を削除します。ChatGPT の MCP サーバを削除し、Platform で API キーを取り消してください。