Files
ai-proj-helper/skills-req/req-plugin/docs/mcp-auth-config.md
John Qiu 712063071c refactor: 通用技能按类别拆分为独立目录
skills/ → skills-dev(9), skills-req(10), skills-ops(4),
skills-integration(8), skills-biz(4), skills-workflow(7)

generate-marketplace.py 改为自动扫描所有 skills-* 目录。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-14 11:31:58 +10:30

1.7 KiB
Raw Blame History

MCP 认证配置

环境选择原则

需求和任务的主数据源是生产环境 (ai.pipexerp.com)。 所有需求创建、任务创建、查询、更新操作必须在生产环境执行。

环境 用途 API 地址
生产环境 需求创建、任务创建、数据管理 https://ai.pipexerp.com/api/v1
本地环境 代码开发调试、功能测试 http://localhost:8080/api/v1

MCP 配置

确保 ~/.claude/.mcp.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 秘钥不可用时使用:

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 秘钥

# 测试本地
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'