# UTAGE接続スキル — 導入プロンプト（このファイルを丸ごとAIに渡してください） --- ## 【受け取った方へ】使い方（ここだけ読めばOK） 1. **Claude Code**（または Codex）を起動する。 2. このファイルを **AIにドラッグ＆ドロップで添付**（またはファイルを開いて全文コピー → AIに貼り付け）して送信する。 3. AIが自動でスキルを組み立てます。終わったら **AIを完全に終了して再起動**。 4. `/utage-connect` で起動します。 **ZIPの手動保存・解凍なしで復元できます。** 配布ZIPと同じ 3 ファイルをテキストで収録しています。復元後の依存ツール導入は説明書に従います。OSや環境による確認・警告が出る場合もあります。 うまくいかない時は「スキルが作れているか確認して」とAIに伝えてください。 --- あなた（AI）はこれから、「UTAGE接続スキル」を利用者のPCに構築します。以下の指示に厳密に従ってください。 ## 手順 0. 実行環境（Mac / Windows）を確認する。**手順1〜3ではファイル復元だけを行う。** 配布ファイルは本文にそろっている。外部ツールの依存導入は手順4で行う。 1. 作業フォルダ `~/Downloads/AI顧問スキル/utage-connect/` を作成する（Windows は `%USERPROFILE%\Downloads\AI顧問スキル\utage-connect\`）。 - 同名フォルダが既にある場合は新しい作業フォルダへ復元する。導入先の旧版を別の場所にバックアップし、mydata・本人ナレッジ・認証設定を保全してから切り替える。復元やセットアップに失敗したら旧版へ戻す。 2. 下の「ファイル定義」にある **3 ファイル** を、指定された相対パス（`~/Downloads/AI顧問スキル/utage-connect/` からの相対）に作成する。 - 各ファイルの内容は `========== FILE: パス ==========` 行の次の行から `========== END FILE ==========` 行の直前の行までを、 **一字一句変更せずそのまま** 書き込む。ファイルの末尾は改行1つで終わらせる。 - 要約・整形・体裁変更・翻訳・改行の増減・全角半角の変換・Markdown記法の「修正」は一切禁止。 マーカー行（`========== ... ==========`）自体はファイルに含めない。 - ファイル数が多い場合は数ファイルずつに分けて作成してよい。**途中で省略せず、必ず全ファイルを作りきる。** 3. 全ファイル作成後、次を検証して結果を報告する: - `~/Downloads/AI顧問スキル/utage-connect/` 配下に 3 ファイルが存在すること - 各ファイルの行数（`wc -l`）が下の「行数チェック表」と一致すること。 一致しないファイルがあれば、そのファイルだけ作り直す。 4. **セットアップまで実行する。** 作成したフォルダの中にある説明書 （`README.md` / `README_使い方.md` / `INSTALL.md` / `INSTALL_FOR_AI.md` / `はじめにお読みください.md` のうち存在するもの）を読み、 そこに書かれた手順どおりに、このPCで `/utage-connect` が使える状態まで導入を完了させる。 - 説明書に Claude Code 用・Codex 用の両方が書かれている場合は、現在のアプリを確認して該当手順を使う。判別できない場合だけ利用者に聞く。 - 追加で必要なもの（Python等）が足りなければ、OSを確認して1ステップずつ案内する。 5. 最後に利用者へ、次の3点を伝える: - 作成したフォルダの場所（フルパス） - **AIを完全に終了して再起動する**必要があること - 再起動後 `/utage-connect` で呼び出せること ## 行数チェック表（wc -l の値） | ファイル | 行数 | |---|---| | README.md | 80 | | claude-code/SKILL.md | 49 | | codex/SKILL.md | 49 | --- ## ファイル定義 ========== FILE: README.md ========== # UTAGE接続スキル **Claude Desktop または Codex とUTAGEをMCPで初期接続する**ための対話型ガイドスキルです。 顧問生のあなたが、1問1答で順番に進めるだけで接続が完了します。 ## 必要なもの - **UTAGE管理画面にログインできるアカウント**1つ - **Claude Desktop**（https://claude.ai/download）または **Codex（デスクトップアプリ）** - ブラウザ（Chrome / Safari / Edge いずれか） > ⚠️ APIキー・コマンド操作・ターミナル（黒い画面）は**一切使いません**。GUIまたは設定ファイル編集だけで完結します。 ## フォルダ構成 ``` utage-connect/ ├── README.md ← このファイル ├── claude-code/ │ └── SKILL.md ← Claude Code 用（Claude Desktop の操作も同じスキルが案内） └── codex/ └── SKILL.md ← Codex 用 ``` 中身はどちらも同じです。お使いのクライアントに合わせてどちらかを配置してください。 ## セットアップ手順（スキルを置く） ### Claude Code / Claude Desktop を使う場合 1. `claude-code/SKILL.md` を以下に配置： - macOS: `~/.claude/skills/utage-connect/SKILL.md` - Windows: `%USERPROFILE%\.claude\skills\utage-connect\SKILL.md` 2. Claude Code または Claude Desktop を再起動 3. チャットに `/utage-connect` と入力 ### Codex を使う場合 1. `codex/SKILL.md` を以下に配置： - macOS: `~/.codex/skills/utage-connect/SKILL.md` - Windows: `%USERPROFILE%\.codex\skills\utage-connect\SKILL.md` 2. Codex を再起動 3. チャットに `/utage-connect` と入力 > 💡 配置に迷ったら、スキル `/api` の手順を踏めば自動でフォルダを作って開いてくれます。 ## 使い方の流れ スキルを起動するとAIが以下の順番で案内してくれます。 1. **クライアント＋OSを答える**（4択：Claude Desktop × macOS / Claude Desktop × Windows / Codex × macOS / Codex × Windows） 2. **設定追加＋OAuth認証**を一気に進める（手順がまとめて表示される） 3. **接続テスト**：「UTAGEのファネル一覧を見せて」と打って結果を報告 合計**3〜4回のやり取り**で接続完了します。 ## つまずいたとき - どこを押せばいいか分からなくなったら、**画面のスクショを撮ってチャットに送ってください**。AIが画面を見て次の一手を指示します。 - エラーが出たら、エラーメッセージをそのままチャットに貼り付けてください。症状別の対処法に進みます。 ## 接続後にできること（例） - 「UTAGEのファネル一覧を見せて」 - 「マネースクールのファネルの中身を教えて」 - 「リストインから何分後に何通送ってる？」 - 「離脱率が高い箇所を教えて」 - 「2日後のメッセージを◯◯に変えて」 メディア（画像・音声・動画）のアップロードは別スキル `/utage-upload` が担当します。 ## 注意事項 - AIが作った下書きは**必ずUTAGE管理画面で確認してから公開**してください - APIキー・パスワードを**チャットに直接貼らないで**ください（今回のUTAGE接続では聞かれません） - 認証URLは**毎回個人ごとに違う**ので、過去のURLは流用しないでください --- 何か困ったら、AI顧問のDiscord / Zoom 個別相談で聞いてくださいね。 ========== END FILE ========== ========== FILE: claude-code/SKILL.md ========== --- name: utage-connect description: UTAGE公式MCPをClaude Desktop、Claude Code、Codexへ接続し、読み取り操作で疎通を確認する。初期接続と再認証の案内に使用する。 --- # UTAGE公式MCPの接続 接続先は `https://api.utage-system.com/mcp`。OAuthで認証する。パスワードやトークンをチャットに貼らせない。 公式手順: https://docs.utage-system.com/mcp/setup ## 既に接続されているか 利用可能なツールからUTAGEの読み取り専用一覧取得を探す。使えるなら1回呼び、成功すれば再設定しない。 一覧が0件でも、正常な応答と認証が確認できれば接続は成功。エラーと空配列を混同しない。 ツールがなければ、実際のクライアント（Claude Desktop/Claude Code/Codex）とOSを確認する。 ## 設定する - Claude Desktop: 現行の設定画面にあるコネクタ追加から、上記URLを登録して認証する。画面の位置やボタン名は変わり得るため、見ていない画面を「左上の青いボタン」と断定しない。 - Claude Code: 現行のMCP追加機能を使う。CLIを使える場合は `claude mcp --help` と公式手順でHTTP接続の書式を確認する。Desktopの設定をClaude Codeへ流用しない。 - Codex: 現行のMCP設定画面または `codex mcp --help` に従って追加する。設定ファイルを使う場合は既存の `config.toml` を保全して、次の表を1つだけ登録する。 ```toml [mcp_servers.utage] url = "https://api.utage-system.com/mcp" ``` 同名表があれば重複追記しない。同じURLなら認証へ進み、異なるアカウントやURLなら変更対象を本人に確認する。ほかのMCP、モデル、権限設定は保つ。設定したクライアントを必要に応じて再起動する。 ## 本人による認証 現在のクライアントが発行した認証URLを本人が開き、対象UTAGEアカウントを確認して許可する。 過去の認証URLは再利用しない。ログインや認証コード入力は本人が行う。 白い画面だけを成功判定にしない。クライアントに戻り一覧取得の応答で判定する。 ## つまずいた場合 - ツールなし: 設定先クライアント、登録の有無、再起動を確認。 - 401: 今の接続に対して再認証。無関係なコネクタを削除しない。 - 403: ログイン中アカウントと権限を確認。再認証だけで直ると断定しない。 - URL期限切れ: クライアントから新しい認証URLを取得する。 - 設定解析エラー: 重複したTOML表やJSONの構文を確認し、秘密情報を表示せず対象箇所だけ修正する。 - 同じ手順で2回失敗したら連続再試行をやめ、実行環境・手順・伏せ字化したエラーを整理する。 ## 完了の判定と次の操作 報告するのは接続したクライアント、取得した一覧の種類、件数、確認できたアカウントの範囲。 接続設定だけの依頼で配信やレッスン更新は行わない。次に運用を依頼されたら、公開中の対象をGETで取得し、対象IDを確定してから必要なフィールドだけ更新する。受講生の閲覧条件や配信状態をついでに変更しない。 未同梱の `/utage-upload` 等があると仮定せず、実際に利用可能なMCP機能を調べる。 ========== END FILE ========== ========== FILE: codex/SKILL.md ========== --- name: utage-connect description: UTAGE公式MCPをClaude Desktop、Claude Code、Codexへ接続し、読み取り操作で疎通を確認する。初期接続と再認証の案内に使用する。 --- # UTAGE公式MCPの接続 接続先は `https://api.utage-system.com/mcp`。OAuthで認証する。パスワードやトークンをチャットに貼らせない。 公式手順: https://docs.utage-system.com/mcp/setup ## 既に接続されているか 利用可能なツールからUTAGEの読み取り専用一覧取得を探す。使えるなら1回呼び、成功すれば再設定しない。 一覧が0件でも、正常な応答と認証が確認できれば接続は成功。エラーと空配列を混同しない。 ツールがなければ、実際のクライアント（Claude Desktop/Claude Code/Codex）とOSを確認する。 ## 設定する - Claude Desktop: 現行の設定画面にあるコネクタ追加から、上記URLを登録して認証する。画面の位置やボタン名は変わり得るため、見ていない画面を「左上の青いボタン」と断定しない。 - Claude Code: 現行のMCP追加機能を使う。CLIを使える場合は `claude mcp --help` と公式手順でHTTP接続の書式を確認する。Desktopの設定をClaude Codeへ流用しない。 - Codex: 現行のMCP設定画面または `codex mcp --help` に従って追加する。設定ファイルを使う場合は既存の `config.toml` を保全して、次の表を1つだけ登録する。 ```toml [mcp_servers.utage] url = "https://api.utage-system.com/mcp" ``` 同名表があれば重複追記しない。同じURLなら認証へ進み、異なるアカウントやURLなら変更対象を本人に確認する。ほかのMCP、モデル、権限設定は保つ。設定したクライアントを必要に応じて再起動する。 ## 本人による認証 現在のクライアントが発行した認証URLを本人が開き、対象UTAGEアカウントを確認して許可する。 過去の認証URLは再利用しない。ログインや認証コード入力は本人が行う。 白い画面だけを成功判定にしない。クライアントに戻り一覧取得の応答で判定する。 ## つまずいた場合 - ツールなし: 設定先クライアント、登録の有無、再起動を確認。 - 401: 今の接続に対して再認証。無関係なコネクタを削除しない。 - 403: ログイン中アカウントと権限を確認。再認証だけで直ると断定しない。 - URL期限切れ: クライアントから新しい認証URLを取得する。 - 設定解析エラー: 重複したTOML表やJSONの構文を確認し、秘密情報を表示せず対象箇所だけ修正する。 - 同じ手順で2回失敗したら連続再試行をやめ、実行環境・手順・伏せ字化したエラーを整理する。 ## 完了の判定と次の操作 報告するのは接続したクライアント、取得した一覧の種類、件数、確認できたアカウントの範囲。 接続設定だけの依頼で配信やレッスン更新は行わない。次に運用を依頼されたら、公開中の対象をGETで取得し、対象IDを確定してから必要なフィールドだけ更新する。受講生の閲覧条件や配信状態をついでに変更しない。 未同梱の `/utage-upload` 等があると仮定せず、実際に利用可能なMCP機能を調べる。 ========== END FILE ==========