backlog-readonly-mcp-blog 1.0.0

package/.github/copilot-instructions.md

@@ -0,0 +1,57 @@
+# Copilot Review Instructions
+
+## 言語設定
+- レビューコメントは**日本語**で記述してください
+- 技術用語は適切な日本語訳を使用し、必要に応じて英語を併記してください
+
+## プロジェクトコンテキスト
+このプロジェクトは**個人用・学習・検証用**のコードです。以下の点を考慮してレビューしてください：
+
+### 開発・学習目的
+- 本番運用ではなく、技術検証とブログ記事執筆が目的
+- 学習効果を重視し、過度なセキュリティ要件は不要
+- シンプルで理解しやすい実装を優先
+- **個人利用のため、細かいエラーハンドリングや例外処理は最小限で十分**
+
+### 許容される実装
+- 環境変数での機密情報管理（開発環境用）
+- 基本的なリソース設定（過度なセキュリティ設定は不要）
+- 開発環境での利便性を重視した設定
+- 最小限のテストカバレッジ
+- **個人用スクリプトレベルのエラーハンドリング**
+
+## レビュー重点項目
+以下の観点を重視してレビューしてください：
+
+### 優先度：高
+- **機能的正確性**: コードが意図した通りに動作するか
+- **型安全性**: 型定義と型チェックの適切性
+- **統合性**: 各コンポーネント間の連携が正しく実装されているか
+- **コメント・ドキュメント**: 学習用として理解しやすい説明があるか
+
+### 優先度：中
+- コードの可読性と保守性
+- エラーハンドリングの適切性
+- パフォーマンスの基本的な考慮
+
+### 優先度：低（指摘不要）
+- 本番環境向けセキュリティ設定
+- 詳細なテストカバレッジ
+- 高度な監視・ログ設定
+- 本格的な暗号化・アクセス制御
+- **個人用スクリプトの細かいエラーハンドリング**
+- **ファイル存在チェック後の詳細なエラー処理**
+- **エンタープライズレベルの例外処理**
+
+## 特記事項
+- このプロジェクトは技術ブログの題材として使用されます
+- 読者の理解を助ける観点からのコメントを歓迎します
+- 過度に複雑な実装よりも、シンプルで説明しやすい実装を推奨してください
+
+## レビュー抑制ガイドライン
+**個人用プロジェクトのため、以下の指摘は控えてください：**
+- 細かいエラーハンドリングの不足
+- ファイル操作の詳細な例外処理
+- エンタープライズレベルのロバスト性
+- 本番環境を想定した堅牢性の指摘
+- 個人利用で十分な実装に対する過度な改善提案

package/.github/settings.yml

@@ -0,0 +1,49 @@
+# GitHub Repository Settings
+# https://github.com/probot/settings
+
+repository:
+  # Repository settings
+  name: backlog-readonly-mcp
+  description: "Backlog読み取り専用MCPサーバー - プロジェクト、課題、ユーザー情報を安全に取得"
+  homepage: ""
+  topics: ["mcp", "backlog", "readonly", "api", "typescript"]
+  private: false
+  has_issues: true
+  has_projects: false
+  has_wiki: false
+  has_downloads: true
+  default_branch: main
+  allow_squash_merge: true
+  allow_merge_commit: false
+  allow_rebase_merge: false
+  delete_branch_on_merge: true
+  enable_automated_security_fixes: true
+  enable_vulnerability_alerts: true
+
+# Branch protection rules
+branches:
+  - name: main
+    protection:
+      required_status_checks:
+        strict: false
+        contexts: []
+      enforce_admins: false
+      required_pull_request_reviews:
+        required_approving_review_count: 0
+        dismiss_stale_reviews: false
+        require_code_owner_reviews: false
+        dismissal_restrictions:
+          users: []
+          teams: []
+        bypass_pull_request_allowances:
+          users: []
+          teams: []
+      restrictions: null
+      required_conversation_resolution: true
+      allow_force_pushes: false
+      allow_deletions: false
+
+# Pull request settings
+pull_requests:
+  # Automatically delete head branches when pull requests are merged
+  delete_branch_on_merge: true

package/.husky/pre-commit

@@ -0,0 +1 @@
+npx lint-staged

package/.kiro/hooks/agent-completion-sound.kiro.hook

@@ -0,0 +1,15 @@
+{
+  "enabled": true,
+  "name": "Agent Completion Sound",
+  "description": "エージェントの実行が完了した時にPing音を鳴らして通知します（macOS専用）",
+  "version": "1",
+  "when": {
+    "type": "agentStop"
+  },
+  "then": {
+    "type": "runCommand",
+    "command": "afplay /System/Library/Sounds/Ping.aiff"
+  },
+  "shortName": "agent-completion-sound",
+  "workspaceFolderName": "backlog-readonly-mcp-blog"
+}

package/.kiro/hooks/markdown-lint-save.kiro.hook

@@ -0,0 +1,19 @@
+{
+  "enabled": true,
+  "name": "Markdown Lint on Save",
+  "description": "Automatically runs markdown linting when markdown files are edited to ensure consistent formatting and catch syntax errors",
+  "version": "1",
+  "when": {
+    "type": "fileEdited",
+    "patterns": [
+      "*.md",
+      "*.markdown"
+    ]
+  },
+  "then": {
+    "type": "askAgent",
+    "prompt": "保存されたMarkdownファイルに対してtextlintを実行して文章を校正してください。以下のコマンドを実行してください：\n\npnpm lint:fix\n\n実行後、修正された内容があれば簡潔に報告してください。"
+  },
+  "workspaceFolderName": "techblog_workspace",
+  "shortName": "markdown-lint-save"
+}

package/.kiro/settings/locale.json

@@ -0,0 +1,3 @@
+{
+    "chatLanguage": "japanese"
+}

package/.kiro/settings/mcp.json

@@ -0,0 +1,32 @@
+{
+  "mcpServers": {
+    "aws-knowledge-mcp-server": {
+      "url": "https://knowledge-mcp.global.api.aws",
+      "disabled": false,
+      "autoApprove": [
+        "aws___search_documentation",
+        "aws___read_documentation"
+      ]
+    },
+    "backlog-readonly": {
+      "command": "node",
+      "args": [
+        "packages/backlog-readonly-mcp/dist/index.js"
+      ],
+      "env": {
+        "BACKLOG_DOMAIN": "${BACKLOG_DOMAIN}",
+        "BACKLOG_API_KEY": "${BACKLOG_API_KEY}",
+        "BACKLOG_CONFIG_PATH": "${workspaceFolder}/.backlog-mcp.env"
+      },
+      "disabled": false,
+      "autoApprove": [
+        "test_connection",
+        "get_default_project",
+        "get_projects",
+        "get_wikis",
+        "get_project",
+        "get_issues"
+      ]
+    }
+  }
+}

package/.kiro/specs/backlog-readonly-mcp/design.md

@@ -0,0 +1,285 @@
+# 設計文書
+
+## 概要
+
+Backlog 読み取り専用 MCP サーバーは、TypeScript と Node.js を使用して実装される Model Context Protocol サーバーです。このサーバーは、Backlog の REST API を利用してプロジェクト、課題、ユーザー、Wiki などの情報を読み取り専用で提供します。セキュリティを重視し、データの変更や作成は一切行いません。
+
+## アーキテクチャ
+
+### 全体構成
+
+```mermaid
+graph TB
+    subgraph "MCP Client"
+        A["AI Agent<br/>Claude/Cline/Cursor"]
+    end
+    
+    subgraph "MCP Server"
+        B["MCP Protocol Handler"]
+        C["Tool Registry"]
+        D["Backlog API Client"]
+        E["Error Handler"]
+        F["Logger"]
+    end
+    
+    subgraph "External Service"
+        G["Backlog REST API"]
+    end
+    
+    A <-->|MCP Protocol| B
+    B --> C
+    C --> D
+    D -->|HTTP GET Only| G
+    B --> E
+    B --> F
+```
+
+### レイヤー構成
+
+1. **MCPプロトコル層**: MCP クライアントとの通信を処理
+2. **ツール層**: 各種 Backlog ツールの実装
+3. **APIクライアント層**: Backlog REST API との通信
+4. **ユーティリティ層**: エラーハンドリング、ログ、設定管理
+
+## コンポーネントとインタフェース
+
+### MCPサーバーコンポーネント
+
+#### 1. MCPサーバー（McpServer）
+- **責任**: MCP プロトコルの処理、ツールの登録・管理
+- **依存関係**: @modelcontextprotocol/sdk
+- **インタフェース**: 
+  - `listTools()`: 利用可能なツール一覧を返す
+  - `callTool(name, args)`: 指定されたツールを実行
+
+#### 2. BacklogAPIクライアント（BacklogApiClient）
+- **責任**: Backlog REST API との通信、API キーの安全な管理
+- **設定**: 環境変数（ワークスペース `.backlog-mcp.env` 優先）から API キー・ドメイン・オプション設定を読み込み
+- **セキュリティ機能**:
+  - API キーのマスキング（ログ出力時）
+  - API キーの有効性検証
+- **インタフェース**:
+  - `get(endpoint, params?)`: GET リクエストの実行
+  - `handleRateLimit()`: レート制限の処理
+  - `validateApiKey()`: API キーの有効性チェック
+  - `loadConfig()`: 環境変数と.backlog-mcp.env ファイルからの設定読み込み
+
+#### 3. ツールレジストリ（ToolRegistry）
+- **責任**: 各種 Backlog ツールの登録と管理
+- **ツールカテゴリ**:
+  - プロジェクト関連ツール
+  - 課題関連ツール
+  - ユーザー関連ツール
+  - Wiki 関連ツール
+  - マスタデータ関連ツール
+
+### ツール実装
+
+#### プロジェクト関連ツール
+
+```typescript
+interface ProjectTool {
+  name: string;
+  description: string;
+  inputSchema: JSONSchema;
+  handler: (args: any) => Promise<any>;
+}
+```
+
+**実装ツール**:
+- `get_projects`: プロジェクト一覧取得
+- `get_project`: プロジェクト詳細取得
+- `get_project_users`: プロジェクトメンバー取得
+
+#### 課題関連ツール
+
+**実装ツール**:
+- `get_issues`: 課題一覧取得（検索条件付き）
+- `get_issue`: 課題詳細取得
+- `get_issue_comments`: 課題コメント取得
+- `get_issue_attachments`: 課題添付ファイル取得
+
+#### その他のツール
+
+**ユーザー関連**: `get_users`, `get_user`, `get_myself`
+**Wiki関連**: `get_wikis`, `get_wiki`
+**マスタデータ関連**: `get_priorities`, `get_statuses`, `get_resolutions`, `get_categories`
+
+## データモデル
+
+### 設定モデル
+
+```typescript
+interface BacklogConfig {
+  domain: string;           // example.backlog.com
+  apiKey: string;           // APIキー
+  defaultProject?: string;  // デフォルトプロジェクトキー
+  maxRetries: number;       // リトライ回数
+  timeout: number;          // タイムアウト（ms）
+}
+```
+
+### APIキー管理
+
+#### 環境変数による設定
+API キーとドメインは環境変数で管理し、ワークスペース単位での設定も可能です。
+
+**設定の優先順位**：
+1. **ワークスペース設定ファイル** (最優先)
+   - プロジェクトルートの `.backlog-mcp.env` ファイル
+   - ワークスペース固有の設定
+2. **システム環境変数**
+   - グローバルな設定
+
+**必須環境変数**:
+- `BACKLOG_API_KEY`: Backlog の API キー
+- `BACKLOG_DOMAIN`: Backlog ドメイン（例: your-company.backlog.com）
+
+**オプション環境変数**:
+- `BACKLOG_DEFAULT_PROJECT`: デフォルトプロジェクトキー（例: MYPROJ）
+- `BACKLOG_MAX_RETRIES`: リトライ回数（デフォルト: 3）
+- `BACKLOG_TIMEOUT`: タイムアウト（ms、デフォルト: 30000）
+
+#### ワークスペース単位の設定
+プロジェクトルートに `.backlog-mcp.env` ファイルを配置することで、ワークスペース固有の設定が可能：
+
+```bash
+# プロジェクトA/.backlog-mcp.env
+BACKLOG_DOMAIN="company-a.backlog.com"
+BACKLOG_API_KEY="project-a-api-key"
+BACKLOG_DEFAULT_PROJECT="PROJA"
+
+# プロジェクトB/.backlog-mcp.env  
+BACKLOG_DOMAIN="company-b.backlog.com"
+BACKLOG_API_KEY="project-b-api-key"
+BACKLOG_DEFAULT_PROJECT="PROJB"
+```
+
+#### デフォルトプロジェクト機能
+多くの場合、特定のプロジェクトに集中して作業するため、デフォルトプロジェクトを設定できます：
+
+- `BACKLOG_DEFAULT_PROJECT` が設定されている場合、プロジェクト ID を省略可能
+- 課題取得時に自動的にデフォルトプロジェクトを使用
+- 明示的にプロジェクト ID を指定すれば他のプロジェクトにもアクセス可能
+
+#### セキュリティ対策
+```typescript
+interface SecurityConfig {
+  // APIキーの有効性チェック
+  validateApiKey: boolean;
+  // ログにAPIキーを出力しない
+  maskSensitiveData: boolean;
+}
+```
+
+#### 環境変数設定例
+
+**システム全体の設定**:
+```bash
+export BACKLOG_DOMAIN="your-company.backlog.com"
+export BACKLOG_API_KEY="your-api-key-here"
+```
+
+**ワークスペース固有の設定** (`.backlog-mcp.env` ファイル):
+```bash
+# プロジェクトA/.backlog-mcp.env
+BACKLOG_DOMAIN="company-a.backlog.com"
+BACKLOG_API_KEY="project-a-api-key"
+BACKLOG_DEFAULT_PROJECT="PROJA"
+BACKLOG_MAX_RETRIES="3"
+BACKLOG_TIMEOUT="30000"
+```
+
+#### MCPクライアント設定例
+```json
+{
+  "mcpServers": {
+    "backlog-readonly": {
+      "command": "node",
+      "args": ["dist/index.js"],
+      "cwd": "${workspaceFolder}",
+      "env": {
+        "NODE_ENV": "production"
+      }
+    }
+  }
+}
+```
+
+**注意**: MCP クライアント設定では `cwd` を `${workspaceFolder}` に設定することで、ワークスペースの `.backlog-mcp.env` ファイルが自動的に読み込まれます。
+
+#### 使用例
+```typescript
+// デフォルトプロジェクトの課題を取得
+await callTool("get_issues", {});
+
+// 特定プロジェクトの課題を取得
+await callTool("get_issues", { projectId: "OTHERPROJ" });
+
+// デフォルトプロジェクトの課題詳細を取得
+await callTool("get_issue", { issueKey: "MYPROJ-123" });
+```
+
+### APIレスポンスモデル
+
+```typescript
+interface BacklogProject {
+  id: number;
+  projectKey: string;
+  name: string;
+  chartEnabled: boolean;
+  subtaskingEnabled: boolean;
+  projectLeaderCanEditProjectLeader: boolean;
+  useWikiTreeView: boolean;
+  textFormattingRule: string;
+  archived: boolean;
+  displayOrder: number;
+  useDevAttributes: boolean;
+}
+
+interface BacklogIssue {
+  id: number;
+  projectId: number;
+  issueKey: string;
+  keyId: number;
+  issueType: IssueType;
+  summary: string;
+  description: string;
+  resolution: Resolution | null;
+  priority: Priority;
+  status: Status;
+  assignee: User | null;
+  category: Category[];
+  versions: Version[];
+  milestone: Milestone[];
+  startDate: string | null;
+  dueDate: string | null;
+  estimatedHours: number | null;
+  actualHours: number | null;
+  parentIssueId: number | null;
+  createdUser: User;
+  created: string;
+  updatedUser: User;
+  updated: string;
+  customFields: CustomField[];
+  attachments: Attachment[];
+  sharedFiles: SharedFile[];
+  stars: Star[];
+}
+```
+
+### エラーモデル
+
+```typescript
+interface BacklogError {
+  code: string;
+  message: string;
+  details?: any;
+}
+
+interface MCPError {
+  code: number;
+  message: string;
+  data?: any;
+}
+```

package/.kiro/specs/backlog-readonly-mcp/requirements.md

@@ -0,0 +1,158 @@
+# 要件文書
+
+## 概要
+
+BacklogのAPIを利用して、プロジェクト、課題、ユーザー情報などを参照できるMCP（Model Context Protocol）サーバーを開発する。このMCPサーバーは読み取り専用に特化し、データの変更や作成は一切行わない。既存のnulab公式MCPサーバーとは異なり、セキュリティを重視し、誤ってデータを変更するリスクを完全に排除する。
+
+## 用語集
+
+- **Backlog**: ヌーラボが提供するプロジェクト管理ツール
+- **MCP_Server**: Model Context Protocolに準拠したサーバー
+- **API_Client**: BacklogのREST APIにアクセスするクライアント
+- **Project**: Backlogにおけるプロジェクト
+- **Issue**: Backlogにおける課題
+- **User**: Backlogのユーザー
+
+## 要件
+
+### 要件 1: API認証とアクセス
+
+**ユーザーストーリー:** 開発者として、BacklogのAPIキーを使用してAPIにアクセスしたい。これにより、安全にBacklogのデータを取得できる。
+
+#### 受け入れ基準
+
+1. WHEN APIキーが提供されたとき、THE MCP_Server SHALL Backlog APIに対して認証を行う
+2. WHEN 無効なAPIキーが提供されたとき、THE MCP_Server SHALL 適切なエラーメッセージを返す
+3. WHEN API接続が失敗したとき、THE MCP_Server SHALL 接続エラーを適切に処理する
+4. THE MCP_Server SHALL 環境変数またはコンフィグファイルからAPIキーを読み込む
+
+### 要件 2: プロジェクト情報の取得
+
+**ユーザーストーリー:** ユーザーとして、Backlogのプロジェクト一覧と詳細情報を取得したい。これにより、プロジェクトの概要を把握できる。
+
+#### 受け入れ基準
+
+1. WHEN プロジェクト一覧が要求されたとき、THE MCP_Server SHALL 利用可能なプロジェクトのリストを返す
+2. WHEN 特定のプロジェクトIDが指定されたとき、THE MCP_Server SHALL そのプロジェクトの詳細情報を返す
+3. WHEN 存在しないプロジェクトIDが指定されたとき、THE MCP_Server SHALL 適切なエラーメッセージを返す
+4. THE MCP_Server SHALL プロジェクト名、キー、説明、作成日時を含む情報を提供する
+
+### 要件 3: 課題情報の取得
+
+**ユーザーストーリー:** ユーザーとして、Backlogの課題情報を検索・取得したい。これにより、プロジェクトの進捗状況を把握できる。
+
+#### 受け入れ基準
+
+1. WHEN 課題一覧が要求されたとき、THE MCP_Server SHALL プロジェクト内の課題リストを返す
+2. WHEN 特定の課題IDが指定されたとき、THE MCP_Server SHALL その課題の詳細情報を返す
+3. WHEN 課題検索条件が指定されたとき、THE MCP_Server SHALL 条件に合致する課題を返す
+4. THE MCP_Server SHALL 課題のタイトル、説明、ステータス、担当者、期限を含む情報を提供する
+5. WHEN 存在しない課題IDが指定されたとき、THE MCP_Server SHALL 適切なエラーメッセージを返す
+
+### 要件 4: ユーザー情報の取得
+
+**ユーザーストーリー:** ユーザーとして、Backlogのユーザー情報を取得したい。これにより、プロジェクトメンバーの情報を確認できる。
+
+#### 受け入れ基準
+
+1. WHEN ユーザー一覧が要求されたとき、THE MCP_Server SHALL プロジェクトのユーザーリストを返す
+2. WHEN 特定のユーザーIDが指定されたとき、THE MCP_Server SHALL そのユーザーの詳細情報を返す
+3. THE MCP_Server SHALL ユーザー名、表示名、メールアドレス、ロールを含む情報を提供する
+4. WHEN 存在しないユーザーIDが指定されたとき、THE MCP_Server SHALL 適切なエラーメッセージを返す
+
+### 要件 5: MCPプロトコル準拠
+
+**ユーザーストーリー:** 開発者として、標準的なMCPクライアントからこのサーバーを利用したい。これにより、既存のMCPエコシステムと統合できる。
+
+#### 受け入れ基準
+
+1. THE MCP_Server SHALL MCPプロトコルの仕様に準拠する
+2. WHEN MCPクライアントから接続要求があったとき、THE MCP_Server SHALL 適切なハンドシェイクを行う
+3. THE MCP_Server SHALL 利用可能なツールのリストを提供する
+4. WHEN ツールが呼び出されたとき、THE MCP_Server SHALL 適切なレスポンスを返す
+5. THE MCP_Server SHALL エラー処理をMCPプロトコルに従って行う
+
+### 要件 6: 読み取り専用制限
+
+**ユーザーストーリー:** システム管理者として、このMCPサーバーがBacklogのデータを変更しないことを保証したい。これにより、安全にデータを参照できる。
+
+#### 受け入れ基準
+
+1. THE MCP_Server SHALL GET リクエストのみを使用してBacklog APIにアクセスする
+2. THE MCP_Server SHALL POST、PUT、DELETE リクエストを一切送信しない
+3. WHEN データ変更を要求するツール呼び出しがあったとき、THE MCP_Server SHALL エラーメッセージを返す
+4. THE MCP_Server SHALL 読み取り専用であることをツールの説明に明記する
+
+### 要件 7: エラーハンドリングとログ
+
+**ユーザーストーリー:** 開発者として、APIエラーや接続問題を適切に処理・ログ出力したい。これにより、問題の診断と解決ができる。
+
+#### 受け入れ基準
+
+1. WHEN Backlog APIからエラーレスポンスが返されたとき、THE MCP_Server SHALL 適切なエラーメッセージを生成する
+2. WHEN ネットワークエラーが発生したとき、THE MCP_Server SHALL 接続エラーを適切に処理する
+3. THE MCP_Server SHALL 重要な操作とエラーをログに記録する
+4. WHEN レート制限に達したとき、THE MCP_Server SHALL 適切な待機時間を設ける
+5. THE MCP_Server SHALL ユーザーフレンドリーなエラーメッセージを提供する
+
+### 要件 8: 既存MCPサーバーとの差別化
+
+**ユーザーストーリー:** セキュリティ重視の環境で作業する開発者として、データ変更のリスクを完全に排除したBacklog MCPサーバーを使用したい。これにより、安心してAIエージェントにBacklogデータへのアクセスを許可できる。
+
+#### 受け入れ基準
+
+1. THE MCP_Server SHALL 公式MCPサーバーと比較して読み取り専用機能のみを提供する
+2. THE MCP_Server SHALL データ変更機能（課題作成、コメント追加、Wiki編集など）を一切実装しない
+3. WHEN データ変更を試みるツール呼び出しがあったとき、THE MCP_Server SHALL 明確な拒否メッセージを返す
+4. THE MCP_Server SHALL セキュリティ重視の用途に適していることをドキュメントに明記する
+5. THE MCP_Server SHALL 最小限の権限でBacklog APIにアクセスする
+
+### 要件 9: 提供ツールの定義
+
+**ユーザーストーリー:** 開発者として、MCPサーバーが提供する具体的なツールを把握したい。これにより、どのような操作が可能かを理解できる。
+
+#### 受け入れ基準
+
+1. THE MCP_Server SHALL 以下のプロジェクト関連ツールを提供する：
+   - `get_projects`: プロジェクト一覧の取得
+   - `get_project`: 特定プロジェクトの詳細取得
+   - `get_project_users`: プロジェクトメンバー一覧の取得
+
+2. THE MCP_Server SHALL 以下の課題関連ツールを提供する：
+   - `get_issues`: 課題一覧の取得（検索条件付き）
+   - `get_issue`: 特定課題の詳細取得
+   - `get_issue_comments`: 課題のコメント一覧取得
+   - `get_issue_attachments`: 課題の添付ファイル一覧取得
+
+3. THE MCP_Server SHALL 以下のユーザー関連ツールを提供する：
+   - `get_users`: ユーザー一覧の取得
+   - `get_user`: 特定ユーザーの詳細取得
+   - `get_myself`: 自分のユーザー情報取得
+
+4. THE MCP_Server SHALL 以下のWiki関連ツールを提供する：
+   - `get_wikis`: Wiki一覧の取得
+   - `get_wiki`: 特定Wikiページの取得
+
+5. THE MCP_Server SHALL 以下のマスタデータ関連ツールを提供する：
+   - `get_priorities`: 優先度一覧の取得
+   - `get_statuses`: ステータス一覧の取得
+   - `get_resolutions`: 完了理由一覧の取得
+   - `get_categories`: カテゴリ一覧の取得
+
+6. WHEN 各ツールが呼び出されたとき、THE MCP_Server SHALL 適切なBacklog APIエンドポイントにGETリクエストを送信する
+
+7. THE MCP_Server SHALL 各ツールの説明に「読み取り専用」であることを明記する
+
+### 要件 10: ワークスペース固有設定
+
+**ユーザーストーリー:** 複数のプロジェクトで作業する開発者として、ワークスペースごとに異なるBacklogプロジェクトをデフォルトとして設定したい。これにより、プロジェクト切り替え時の設定変更が不要になる。
+
+#### 受け入れ基準
+
+1. THE MCP_Server SHALL BACKLOG_CONFIG_PATH環境変数で指定されたファイルから設定を読み込む
+2. WHEN ワークスペース固有の設定ファイルが存在するとき、THE MCP_Server SHALL そのファイルからBACKLOG_DEFAULT_PROJECTを読み込む
+3. WHEN デフォルトプロジェクトが設定されているとき、THE MCP_Server SHALL プロジェクトIDを省略した課題取得でそのプロジェクトを使用する
+4. THE MCP_Server SHALL 認証情報（BACKLOG_DOMAIN、BACKLOG_API_KEY）は環境変数から取得する
+5. WHEN 設定ファイルが存在しないとき、THE MCP_Server SHALL 環境変数のみを使用して動作する
+6. THE MCP_Server SHALL 設定ファイルの形式として.envファイル形式をサポートする
+7. WHEN 無効な設定ファイルが指定されたとき、THE MCP_Server SHALL 適切なエラーメッセージを返す