@impv_npm/task-manager-mcp 1.0.0 → 1.1.0

package/README.md

@@ -1,7 +1,16 @@
 # Task Manager MCP Server
 
+[![npm version](https://badge.fury.io/js/@impv_npm%2Ftask-manager-mcp.svg)](https://www.npmjs.com/package/@impv_npm/task-manager-mcp)
+
 Task ManagerアプリをClaude CodeなどのMCPクライアントから操作するためのMCPサーバーです。
 
+## クイックスタート
+
+```bash
+# ビルド不要。npxで直接実行可能
+npx -y @impv_npm/task-manager-mcp
+```
+
 ## 概要
 
 このMCPサーバーを使用すると、以下の操作をAIアシスタントから直接実行できます：
@@ -20,7 +29,7 @@ Task ManagerアプリをClaude CodeなどのMCPクライアントから操作す
 ### 1. APIキーの作成
 
 1. Task Managerアプリにログイン
-2. **設定** ページに移動
+2. [設定ページ](https://task-manager-impressive.vercel.app/settings)に移動
 3. **API設定** セクションの **MCP APIキー** カードを見つける
 4. 「新しいAPIキーを作成」欄に名前を入力（例: "Claude Code"）
 5. **+** ボタンをクリックしてキーを作成
@@ -37,10 +46,10 @@ Task ManagerアプリをClaude CodeなどのMCPクライアントから操作す
   "mcpServers": {
     "task-manager": {
       "command": "npx",
-      "args": ["-y", "@impv/task-manager-mcp"],
+      "args": ["-y", "@impv_npm/task-manager-mcp"],
       "env": {
         "TASK_MANAGER_API_KEY": "tm_xxxxxxxxxxxxxxxxxxxx",
-        "TASK_MANAGER_URL": "https://your-app.vercel.app"
+        "TASK_MANAGER_URL": "https://task-manager-impressive.vercel.app"
       }
     }
   }
@@ -80,6 +89,12 @@ Task ManagerアプリをClaude CodeなどのMCPクライアントから操作す
 | `work_start` | 業務を開始 | `note` |
 | `work_end` | 業務を終了 | `note` |
 
+### その他
+
+| ツール | 説明 | 主なパラメータ |
+|--------|------|----------------|
+| `open_board` | タスクボードをブラウザで開く | なし |
+
 ## ツール詳細
 
 ### task_list
@@ -170,6 +185,73 @@ Task ManagerアプリをClaude CodeなどのMCPクライアントから操作す
 **パラメータ:**
 - `note` (string, optional): 業務終了時のメモ
 
+### open_board
+
+タスクボード（カンバン形式）をブラウザで開くためのURLを返します。
+
+**パラメータ:** なし
+
+**レスポンス:**
+```json
+{
+  "success": true,
+  "data": {
+    "url": "https://task-manager-impressive.vercel.app/board",
+    "message": "タスクボードを開いてください",
+    "action": "open_url"
+  }
+}
+```
+
+## Claude Code プラグイン（/task スキル）
+
+MCPサーバーに加えて、Claude Code用のプラグイン（スキル）をインストールすると、`/task` コマンドでより便利にタスク管理ができます。
+
+### プラグインのインストール
+
+```bash
+# リポジトリをクローン後
+cd task-manager
+./claude-plugin/install.sh
+
+# 自然言語対応（task-routing.md）も含める場合
+./claude-plugin/install.sh --with-rules
+```
+
+### アンインストール
+
+```bash
+./claude-plugin/uninstall.sh
+```
+
+### 利用可能なコマンド
+
+| コマンド | 説明 |
+|---------|------|
+| `/task` | タスクを作成（対話形式） |
+| `/task list` | タスク一覧を表示 |
+| `/task do [N]` | タスク #N を開始 |
+| `/task review [N]` | タスク #N をレビュー待ちに |
+| `/task done [N]` | タスク #N を完了 |
+| `/task close [N]` | タスク #N をクローズ |
+| `/task delete [N]` | タスク #N を削除 |
+| `/task advise` | 次にやるべきタスクを提案 |
+| `/task hello` | 業務開始 |
+| `/task bye` | 業務終了 |
+| `/task board` | タスクボードを開く |
+| `/task today` | 今日の進捗を表示 |
+
+### 自然言語対応（--with-rules オプション）
+
+`task-routing.md` をインストールすると、自然言語でもタスク操作が可能になります：
+
+- 「次何やる？」 → `/task advise`
+- 「タスク一覧」 → `/task list`
+- 「業務開始」 → `/task hello`
+- 「タスク完了」 → `/task done`
+
+詳細は `claude-plugin/README.md` を参照してください。
+
 ## 活用例
 
 ### 1. 朝の業務開始
@@ -244,6 +326,8 @@ Error: Unauthorized
 
 → APIキーが有効か確認してください。設定画面で新しいキーを発行し直すことをお勧めします。
 
+**開発者向け**: `/api/mcp`エンドポイントはAPIキー認証を使用するため、`src/proxy.ts`の`publicPaths`に含まれている必要があります。Supabaseセッション認証をバイパスするためです。
+
 ### サーバーに接続できない
 
 → `TASK_MANAGER_URL` が正しいか、Task Managerアプリが起動しているか確認してください。
@@ -254,6 +338,16 @@ Error: Unauthorized
 - APIキーが漏洩した場合は、設定画面から即座に削除し、新しいキーを発行してください。
 - 各APIキーは作成したユーザーの権限で操作を実行します。
 
+### ユーザーに紐づいた操作
+
+全ての操作（MCP経由およびアプリ内チャットインターフェース）は、認証されたユーザーのコンテキストで実行されます：
+
+- **task_list / task_advise / get_today_progress**: `assignee`を指定しない場合、自動的に自分のタスクのみが表示されます
+- **task_add**: 自分自身のみをassigneeとして設定できます。他人をassigneeに指定しようとするとエラーが返されます。`assignees`を指定しない場合は自動的に自分が設定されます。
+- **task_start / task_review / task_end / task_close / task_delete / update_task / change_status**: 自分がassigneeまたは作成者のタスクのみ操作可能です。他人のタスクを操作しようとするとエラーが返されます。
+- **業務管理（work_start / work_end / start_break / end_break）**: 常に認証ユーザー自身の業務として記録されます。
+- **Slack通知**: 常に認証ユーザーの設定とチャンネルが使用されます。
+
 ## 開発
 
 ```bash

package/dist/tools.js

@@ -108,4 +108,39 @@ export function registerTools(server, client) {
             content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
         };
     });
+    // open_board - タスクボードを開く
+    server.tool("open_board", "タスクボード（カンバン形式）をブラウザで開きます。", {}, async () => {
+        const boardUrl = "https://task-manager-impressive.vercel.app/board";
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        success: true,
+                        data: {
+                            url: boardUrl,
+                            message: "タスクボードを開いてください",
+                            action: "open_url",
+                        },
+                    }, null, 2),
+                },
+            ],
+        };
+    });
+    // list_clients - クライアント一覧取得
+    server.tool("list_clients", "既存のクライアント名一覧を取得します。タスク作成時に表記ブレを防ぐために使用してください。", {}, async () => {
+        const result = await client.call("list_clients", {});
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+    });
+    // list_projects - プロジェクト一覧取得
+    server.tool("list_projects", "既存のプロジェクト名一覧を取得します。タスク作成時に表記ブレを防ぐために使用してください。", {
+        client: z.string().optional().describe("クライアント名でフィルタ（指定しない場合は全て）"),
+    }, async (params) => {
+        const result = await client.call("list_projects", params);
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+    });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@impv_npm/task-manager-mcp",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "type": "module",
   "main": "dist/index.js",
   "bin": {
@@ -9,12 +9,6 @@
   "files": [
     "dist"
   ],
-  "scripts": {
-    "build": "tsc",
-    "start": "node dist/index.js",
-    "dev": "tsx src/index.ts",
-    "prepublishOnly": "pnpm build"
-  },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.0",
     "zod": "^4.3.6"
@@ -26,5 +20,10 @@
   },
   "publishConfig": {
     "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsx src/index.ts"
   }
-}
+}