move claude-marketplace to ai-proj-helper

plugins/req-plugin/mcp-auth-config.md

@@ -0,0 +1,64 @@
+# MCP 认证配置
+
+## 环境选择原则
+
+> 需求和任务的主数据源是**生产环境 (ai.pipexerp.com)**。
+> 所有需求创建、任务创建、查询、更新操作必须在生产环境执行。
+
+| 环境 | 用途 | API 地址 |
+|------|------|----------|
+| **生产环境** | 需求创建、任务创建、数据管理 | https://ai.pipexerp.com/api/v1 |
+| 本地环境 | 代码开发调试、功能测试 | http://localhost:8080/api/v1 |
+
+## MCP 配置
+
+确保 `~/.claude/.mcp.json` 配置：
+
+```json
+{
+  "mcpServers": {
+    "ai-proj": {
+      "type": "stdio",
+      "command": "node",
+      "args": ["/path/to/mcp-task-bridge/dist/index.js"],
+      "env": {
+        "TASK_API_BASE": "https://ai.pipexerp.com/api/v1",
+        "TASK_API_TOKEN": "aiproj_pk_xxxxxxxx...",
+        "SYNC_REMOTE_API_BASE": "https://ai.pipexerp.com/api/v1",
+        "SYNC_REMOTE_API_KEY": "aiproj_pk_xxxxxxxx..."
+      }
+    }
+  }
+}
+```
+
+## 认证方式
+
+### PAT 秘钥（推荐）
+
+- 格式: `aiproj_pk_` + 64 字符十六进制（共 74 字符）
+- 优势: 长期有效，无需频繁更新
+
+### dev-quick-login（备选）
+
+仅在 PAT 秘钥不可用时使用：
+
+```bash
+curl -s -X POST "http://localhost:8080/api/v1/auth/dev-quick-login" \
+  -H "Content-Type: application/json" \
+  -d '{"username":"qiudl"}' | jq -r '.data.access_token'
+```
+
+> JWT token 有效期 24 小时，日常使用推荐 PAT 秘钥。
+
+## 验证 PAT 秘钥
+
+```bash
+# 测试本地
+curl -s -H "X-API-Key: aiproj_pk_xxx..." \
+  "http://localhost:8080/api/v1/tasks?limit=1" | jq '.success'
+
+# 测试远程
+curl -s -H "Authorization: Bearer aiproj_pk_xxx..." \
+  "https://ai.pipexerp.com/api/v1/tasks?limit=1" | jq '.success'
+```