unchain-tech · mashharuki · Dec 21, 2025 · Dec 21, 2025
diff --git a/docs/JPYC/AI-Agent-JPYC-ChatApp/section-2/lesson-1.md b/docs/JPYC/AI-Agent-JPYC-ChatApp/section-2/lesson-1.md
@@ -18,11 +18,15 @@ title: プロジェクトのセットアップ
 
 まず、スターターリポジトリをクローンしてきます。
 
+スターターリポジトリは以下のリンクからアクセスできます：
+
+**https://github.com/unchain-tech/jpyc-ai-agent**
+
 **自分のGitHubアカウントにフォークしていない場合は、まずフォークしてきましょう！**
 
 ```bash
 git clone https://github.com/<your_github_account_name>/jpyc-ai-agent
-cd ai-agent-jpyc-chat
+cd jpyc-ai-agent
 ```
 
 ### 📦 依存関係のインストールとコンパイル
@@ -41,7 +45,7 @@ pnpm run compile
 
 ### 📁 プロジェクト構造の作成
 
-`ai-agent-jpyc-chat`以下のディレクトリ構造が以下のようになっているかを確認します。
+`jpyc-ai-agent`以下のディレクトリ構造が以下のようになっているかを確認します。
 
 ```
 ai-agent-jpyc-chat/
@@ -106,8 +110,29 @@ ANTHROPIC_API_KEY=
 JPYC_MCP_SERVER_URL="http://localhost:3001/sse"
 ```
 
+次に、MCPサーバー用の環境変数ファイルも作成します。MCPサーバーは**独立したプロセス**として動作するため、`external/mcp`ディレクトリに`.env`ファイルを作成する必要があります。
+
+```bash
+# external/mcpディレクトリに移動
+cd external/mcp
+
+# .env.exampleをコピーして.envを作成（.env.exampleが存在する場合）
+# 存在しない場合は直接.envファイルを作成してください
+cp .env.example .env
+touch .env
+```
+
+`external/mcp/.env`ファイルに環境変数を設定します：
+
+```.env
+# MCPサーバー用の環境変数
+PRIVATE_KEY=0x... # ウォレットの秘密鍵（.env.localと同じ値を使用）
+```
+
 **重要**：
 - `.env.local`は`.gitignore`に含まれていることを確認してください
+- `external/mcp/.env`も`.gitignore`に含まれていることを確認してください
+- ルートディレクトリの`.env.local`とは別に、`external/mcp/.env`も必要です
 - 本番環境では、秘密鍵を環境変数として安全に管理してください
 
 ### 🙋‍♂️ 質問する

diff --git a/docs/JPYC/AI-Agent-JPYC-ChatApp/section-3/lesson-1.md b/docs/JPYC/AI-Agent-JPYC-ChatApp/section-3/lesson-1.md
@@ -17,6 +17,7 @@ title: JPYC SDK Wrapperの実装
 ```bash
 cd jpyc-ai-agent
 
+mkdir -p external/mcp/src/jpyc
 touch external/mcp/src/jpyc/sdk.ts
 ```
 

diff --git a/docs/JPYC/AI-Agent-JPYC-ChatApp/section-3/lesson-2.md b/docs/JPYC/AI-Agent-JPYC-ChatApp/section-3/lesson-2.md
@@ -17,6 +17,7 @@ MCPツールは、AI Agentが実行できる「関数」として機能します
 ```bash
 cd jpyc-ai-agent
 
+mkdir -p external/mcp/src
 touch external/mcp/src/tools.ts
 ```
 以下のコードを記述します：

diff --git a/docs/JPYC/AI-Agent-JPYC-ChatApp/section-3/lesson-3.md b/docs/JPYC/AI-Agent-JPYC-ChatApp/section-3/lesson-3.md
@@ -17,6 +17,7 @@ MCPサーバーは、HTTP/SSE（Server-Sent Events）プロトコルを使用し
 ```bash
 cd jpyc-ai-agent
 
+mkdir -p external/mcp/src
 touch external/mcp/src/index.ts
 ```
 

diff --git a/docs/JPYC/AI-Agent-JPYC-ChatApp/section-4/lesson-1.md b/docs/JPYC/AI-Agent-JPYC-ChatApp/section-4/lesson-1.md
@@ -19,6 +19,7 @@ title: LLMモデルの設定
 ```bash
 cd jpyc-ai-agent
 
+mkdir -p src/lib/mastra/model
 touch src/lib/mastra/model/index.ts
 ```
 

diff --git a/docs/JPYC/AI-Agent-JPYC-ChatApp/section-4/lesson-2.md b/docs/JPYC/AI-Agent-JPYC-ChatApp/section-4/lesson-2.md
@@ -17,6 +17,7 @@ MCPクライアントは、AI AgentからMCPサーバーに接続し、ツール
 ```bash
 cd jpyc-ai-agent
 
+mkdir -p src/lib/mastra/mcp
 touch src/lib/mastra/mcp/client.ts
 ```
 

diff --git a/docs/JPYC/AI-Agent-JPYC-ChatApp/section-4/lesson-3.md b/docs/JPYC/AI-Agent-JPYC-ChatApp/section-4/lesson-3.md
@@ -17,6 +17,7 @@ AI Agentは、ユーザーの自然言語の指示を理解し、適切なMCPツ
 ```bash
 cd jpyc-ai-agent
 
+mkdir -p src/lib/mastra
 touch src/lib/mastra/agent.ts
 ```
 

diff --git a/docs/JPYC/AI-Agent-JPYC-ChatApp/section-5/lesson-1.md b/docs/JPYC/AI-Agent-JPYC-ChatApp/section-5/lesson-1.md
@@ -17,6 +17,7 @@ title: チャットAPIの実装
 ```bash
 cd jpyc-ai-agent
 
+mkdir -p src/app/api/chat
 touch src/app/api/chat/route.ts
 ```
 

diff --git a/docs/JPYC/AI-Agent-JPYC-ChatApp/section-5/lesson-3.md b/docs/JPYC/AI-Agent-JPYC-ChatApp/section-5/lesson-3.md
@@ -18,6 +18,7 @@ title: チャットインターフェース（前半）
 ```bash
 cd jpyc-ai-agent
 
+mkdir -p src/components
 touch src/components/ChatInterface.tsx
 ```
-Original file line number
+Diff line change
@@ Expand Up / @@ -17,6 +17,7 @@ title: JPYC SDK Wrapperの実装 @@
     ```bash
     cd jpyc-ai-agent
+    mkdir -p external/mcp/src/jpyc
     touch external/mcp/src/jpyc/sdk.ts
     ```
@@ Expand Down @@