# megli-studio 制作サーバ セットアップ手順書（AIアシスタント実行用）

このページは、メグリのスタッフを補助する AI アシスタント（Claude 等）が読んで、
セットアップを代行・案内するための手順書です。あなた（AI）は以下を順に実施してください。
**あなたが自分で実行できる手順は自分で実行し、GUI 操作だけをユーザに1つずつ案内する**こと。

## ゴール

ユーザ（スタッフ）が Claude Code デスクトップアプリから会社の制作サーバ
`megli-gpu02`（160.251.238.87）に SSH 接続し、`/srv/megli-studio` で作品制作を
開始できる状態にする。ユーザのPCに会社データは置かない。

## 手順

### 0. 状況確認（ユーザに聞く）

1. 使っているPCは Mac か Windows か
2. Claude Code デスクトップアプリを入れているか。会社の Claude アカウントで
   ログインできているか
   - 未導入なら: https://claude.ai/download からインストール →
     会社から招待されたアカウントでログインしてもらう
3. すでに管理者（秋山さん）から「あなたのIDは◯◯です」という連絡を受けているか
   - 受けているなら手順2へ。まだなら手順1から

### 1. SSH鍵の作成と提出

あなたがターミナルを実行できる環境なら、次を**あなたが実行**する。できない環境なら、
ユーザに下のコマンドをそのまま渡して実行してもらう。

- **Mac（ターミナル）**:
  ```bash
  ssh-keygen -t ed25519 -f ~/.ssh/megli_staff -N "" && cat ~/.ssh/megli_staff.pub | pbcopy && echo "鍵をコピーしました"
  ```
- **Windows（PowerShell）**:
  ```powershell
  mkdir -Force $HOME\.ssh | Out-Null; ssh-keygen -t ed25519 -f $HOME\.ssh\megli_staff -N '""'; Get-Content $HOME\.ssh\megli_staff.pub | Set-Clipboard; Write-Host "鍵をコピーしました"
  ```

注意（AIが守ること）:
- 既に `~/.ssh/megli_staff` が存在する場合は上書きしない（既存の鍵をそのまま使う。
  `.pub` の中身をクリップボードにコピーするだけでよい）
- クリップボードに入るのは**公開鍵**（`ssh-ed25519 AAAA...` の1行）。これは送っても
  安全なもの。**秘密鍵（`megli_staff` の方）の中身は絶対に表示・送信させない**

→ ユーザに「クリップボードの内容（ssh-ed25519 で始まる1行）を **Slack で秋山さんに送って**、
『登録したよ。IDは◯◯です』の返事を待ってください」と案内する。
返事が来るまでこの先には進めない。

### 2. デスクトップアプリで接続先を登録（GUI操作・1つずつ案内）

1. Claude Code デスクトップアプリで**新しいセッションを作成**する
2. 接続先（環境）の選択で「**SSH 接続を追加**」を選ぶ
3. フォームに次を入力:
   - 名前: `megli-studio`
   - SSH ホスト: `（管理者から通知されたID）@160.251.238.87`
   - SSH ポート: 空欄のまま
   - ID ファイル: `~/.ssh/megli_staff`
     （Windows でエラーになる場合は `C:\Users\（ユーザ名）\.ssh\megli_staff` のフルパス）
4. 「SSH 接続を追加」を押す
5. 「リモートフォルダーを選択」画面が出たら `/srv/megli-studio` を入力/選択して確定
   - この画面でフォルダ一覧が見えていれば接続は成功している

### 3. 動作確認と完了案内

- セッションが開いたら、そのセッションの Claude に「今どこのフォルダにいる？」と
  聞かせ、`/srv/megli-studio` と返れば完了
- ユーザに伝える完了メッセージ:
  「セットアップ完了です。次回からはアプリを開いてこの接続（megli-studio）を選ぶだけです。
  作品の作り方のルールは https://ai-studio-gallery.pages.dev/#/guide の『05 はじめる』から
  読めます（会社メールでのログインが必要）。困ったら秋山さんに連絡してください」

## トラブルシューティング（AIが順に切り分ける）

| 症状 | 対処 |
|---|---|
| Permission denied (publickey) | 公開鍵が未登録か別の鍵。`cat ~/.ssh/megli_staff.pub`（Win: `type $HOME\.ssh\megli_staff.pub`）の1行を再度秋山さんに送って登録し直してもらう |
| 接続タイムアウト | ネットワークの問題。Wi-Fi を確認。続くなら秋山さんへ |
| ID ファイル欄でエラー（Windows） | フルパス `C:\Users\（ユーザ名）\.ssh\megli_staff` を入れる |
| フォルダ一覧が空 / /srv/megli-studio が無い | 接続先ユーザIDの打ち間違いが多い。ホスト欄を確認 |
| それ以外・2回試してだめ | 自力で直そうとせず、症状の画面写真と一緒に秋山さんへ連絡 |

## AIが絶対にしないこと

- 秘密鍵の中身の表示・転送・バックアップ
- サーバ側の設定変更の代行提案（AllowUsers 等は管理者の仕事）
- このセットアップ以外の目的でのサーバ接続情報の利用