@impv_npm/task-manager-mcp 1.0.0 → 1.0.1

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,24 @@ 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"
+  }
+}
+```
+
 ## 活用例
 
 ### 1. 朝の業務開始
@@ -244,6 +277,8 @@ Error: Unauthorized
 
 → APIキーが有効か確認してください。設定画面で新しいキーを発行し直すことをお勧めします。
 
+**開発者向け**: `/api/mcp`エンドポイントはAPIキー認証を使用するため、`src/proxy.ts`の`publicPaths`に含まれている必要があります。Supabaseセッション認証をバイパスするためです。
+
 ### サーバーに接続できない
 
 → `TASK_MANAGER_URL` が正しいか、Task Managerアプリが起動しているか確認してください。
@@ -254,6 +289,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,23 @@ 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),
+                },
+            ],
+        };
+    });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@impv_npm/task-manager-mcp",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "type": "module",
   "main": "dist/index.js",
   "bin": {