AIアシスタントにStudioをセットアップしてもらう

パソコンにStudioを用意する

• Windowsの場合：Maxisnapで「設定 → アカウント → Maxisnap Studio セットアップウィザード」を開き、「はじめましょう」、続いて「ダッシュボードをダウンロード」をクリックします。MaxisnapがStudioのZIPファイルを「ダウンロード」フォルダーに保存し、そのフォルダーを開きます。
• Macの場合：Maxisnapで「Settings → Welcome & Help → Studio Setup Guide」を開き、「Get Started」、続いて「Download Dashboard」をクリックします。MaxisnapがStudioのZIPファイルを「ダウンロード」フォルダーに保存します。

ZIPファイルを展開します。Windowsでは、右クリックして「すべて展開」を選びます。Macでは、ダブルクリックします。

展開したフォルダーの場所をコピーしておきます。手順3で貼り付けます。Windowsでは、フォルダーを右クリックして「パスのコピー」を選びます。Macでは、フォルダーを選択して Option+Command+C を押します。

AIアシスタント向けの指示書ファイルは、そのフォルダーにあります：

AGENTS.md

必要に応じて、ブランド設定を確定する

「Maxisnap Studio - Start Here.html」をダブルクリックし、ロゴ、カラー、フォントをデザインして、「Lock in my branding」をクリックします。アシスタントがその設定を使います。この手順は省略して、あとからダッシュボードの「Branding」でブランド設定を変更することもできます。

指示文をコピーする

この指示文をコピーし、山かっこで囲まれた行をStudioフォルダーの場所に置き換えて、アシスタントに貼り付けます。

Set up Maxisnap Studio for me.

Maxisnap Studio is a self-hosted dashboard for the screenshots and screen recordings the Maxisnap desktop app uploads: a private library plus branded share links. It comes in two editions with the same features: a PHP app for ordinary web hosting, and a Cloudflare Worker that uses R2 and D1.

Everything is in this folder on my computer:
  <the folder where I extracted the Studio download>

Start by reading AGENTS.md in that folder. It explains both editions, the exact install steps, what must stay private, and how to check the result.
If I locked in my branding, it is in snaps.zip; AGENTS.md says what to do if it is missing.

Goal: Work out with me whether the PHP edition (my web hosting) or the Cloudflare Workers edition fits my setup, then install it.

Rules:
- Ask me before you upload, deploy, or change anything on a server or in an account, and tell me exactly what you will change.
- Never delete, overwrite or rename existing website files, DNS records, Workers, buckets or databases. Studio only adds new things.
- Keep keys and passwords out of files you create and out of chat transcripts where you can.
- When it works, give me the Studio address and the Admin key so I can connect the Maxisnap app (on Windows, Settings, Account, Maxisnap Studio setup wizard, step 4; on a Mac, Settings, Welcome & Help, Studio Setup Guide, “I already have a dashboard”).

アシスタントの質問に答える

1. Webサイトの場所を伝えます。Webホスティング（cPanel、hPanel、Pleskなど）か、Cloudflareか、まだどこにもないか、のいずれかです。Webサイトがない場合は、Cloudflareエディションが安心な選択です。
2. Webホスティングの場合は、何をどこにアップロードするかをアシスタントが案内します。ホスティングへのアクセスを渡せば、アシスタントが代わりにアップロードします。
3. Cloudflareの場合は、アシスタントからCloudflare APIトークンを求められます。Cloudflareの「My Profile → API Tokens」で、アシスタントが示す権限を付けたトークンを作成し、ご自身でターミナルに貼り付けてください。

Cloudflareアカウント、ストレージ、トークンの手順は、無料のCloudflareアカウントのガイドで確認できます。

「はい」と答える前に、実行計画を確認する

Cloudflareにデプロイする前に、アシスタントが実行計画を表示します。「Will create」には1つのWorker、1つのR2バケット、1つのD1データベースが表示され、「Will not touch」にはアカウント内のそれ以外のすべてが表示されます。Webホスティングの場合は、どのフォルダーを追加するかをアシスタントが伝えます。一覧の内容が正しいと確認できたときだけ、「はい」と答えてください。

Maxisnapを接続して試す

うまくいくと、アシスタントからStudioのアドレスと管理者キーが渡されます。キーは、パスワードマネージャーのような安全な場所に保管してください。

• Windows版Maxisnap：「設定 → アカウント → Maxisnap Studio セットアップウィザード」を開き、「はじめましょう」をクリックします。ステップ4の「Maxisnap を接続」まで、「次へ」をクリックして進みます。Studioのアドレスとキーを貼り付け、「接続をテスト」、「次へ」の順にクリックして、最後のページで「完了して保存」をクリックします。セットアップで表示された管理者キーを使えます。ダッシュボードの「People & access」にあるアップロードコードも使えます。
• Mac版Maxisnap：「Settings → Welcome & Help → Studio Setup Guide」を開き、「I already have a dashboard」を選びます。Studioのアドレスとキーを貼り付け、「Test Connection」、「Next」、「Finish & Save」の順にクリックします。

何かをキャプチャして、エディターで「アップロード」をクリックします。Windowsでは、Ctrl+Alt+7を押すと範囲をキャプチャして、すぐにアップロードします。共有リンクはクリップボードにコピーされます。

次のステップ：ダッシュボードの「People & access」でチームメンバーを追加し（全員にそれぞれ専用のコードとロールが付きます）、ロゴやカラーはいつでも「Branding」で変更できます。