Supercoordination MCP Server

# 良渚青年公社 · 超协体使用指南

**更新时间：** 2026-01-31
**版本：** 1.0（用户认证版）
**适用对象：** 良渚青年公社成员（10人）

---

## 🎯 快速开始（3分钟）

### 第一步：注册账号

**方式一：使用命令行测试（开发者）**
```bash
curl -X POST https://supercoordination-mcp-production.up.railway.app/api/auth/register \
  -H "Content-Type: application/json" \
  -d '{
    "email": "你的邮箱@liangzhu.com",
    "password": "设置密码至少6位",
    "username": "你的昵称"
  }'
```

**方式二：使用Postman/Insomnia（推荐）**
1. 打开Postman
2. 新建POST请求
3. URL: `https://supercoordination-mcp-production.up.railway.app/api/auth/register`
4. Body → raw → JSON
5. 填入：
```json
{
  "email": "你的邮箱@liangzhu.com",
  "password": "设置密码",
  "username": "你的昵称"
}
```
6. 点击Send

**成功返回：**
```json
{
  "success": true,
  "message": "注册成功",
  "token": "eyJhbGc...",  // 保存这个token！
  "user": {
    "id": "f48c2f4e-...",
    "email": "你的邮箱",
    "username": "你的昵称",
    "pointsBalance": 50,    // 初始积分
    "createdAt": "2026-01-31T..."
  }
}
```

**⚠️ 重要：** 保存返回的`token`，后续所有请求都需要它！

---

### 第二步：登录获取Token

如果忘记了token，可以重新登录：

```bash
curl -X POST https://supercoordination-mcp-production.up.railway.app/api/auth/login \
  -H "Content-Type: application/json" \
  -d '{
    "email": "你的邮箱@liangzhu.com",
    "password": "你的密码"
  }'
```

---

### 第三步：访问超协体系统

**查看自己的信息：**
```bash
curl -X GET https://supercoordination-mcp-production.up.railway.app/api/auth/me \
  -H "Authorization: Bearer 你的token"
```

**访问Web仪表盘：**
1. 浏览器打开：https://supercoordination-mcp-production.up.railway.app
2. （目前前端还未添加登录页面，下个版本会完善）

---

## 📱 API接口文档

### 基础信息
- **API地址：** `https://supercoordination-mcp-production.up.railway.app`
- **认证方式：** JWT Bearer Token
- **Token过期时间：** 7天

### 1. 用户注册
**端点：** `POST /api/auth/register`

**请求示例：**
```json
{
  "email": "zhangsan@liangzhu.com",
  "password": "password123",
  "username": "张三"
}
```

**成功响应：**
```json
{
  "success": true,
  "message": "注册成功",
  "token": "eyJhbGc...",
  "user": { ... }
}
```

**错误响应：**
```json
{
  "success": false,
  "message": "该邮箱已被注册"
}
```

---

### 2. 用户登录
**端点：** `POST /api/auth/login`

**请求示例：**
```json
{
  "email": "zhangsan@liangzhu.com",
  "password": "password123"
}
```

**成功响应：**
```json
{
  "success": true,
  "message": "登录成功",
  "token": "eyJhbGc...",
  "user": {
    "id": "...",
    "email": "...",
    "username": "...",
    "pointsBalance": 50,
    "pwpCompleted": false
  }
}
```

---

### 3. 获取当前用户信息
**端点：** `GET /api/auth/me`

**请求头：**
```
Authorization: Bearer eyJhbGc...
```

**成功响应：**
```json
{
  "success": true,
  "user": {
    "id": "...",
    "email": "...",
    "username": "...",
    "avatarUrl": null,
    "pwpProfile": { ... },
    "pwpCompleted": false,
    "pointsBalance": 50,
    "createdAt": "...",
    "updatedAt": "..."
  }
}
```

---

## 🎨 使用场景示例

### 场景1：团队成员注册加入
```bash
# 小王注册
curl -X POST https://supercoordination-mcp-production.up.railway.app/api/auth/register \
  -H "Content-Type: application/json" \
  -d '{
    "email": "xiaowang@liangzhu.com",
    "password": "wang2026",
    "username": "小王"
  }'

# 保存返回的token: eyJhbGc...ABC123
```

### 场景2：查看个人信息
```bash
# 使用token查看信息
curl -X GET https://supercoordination-mcp-production.up.railway.app/api/auth/me \
  -H "Authorization: Bearer eyJhbGc...ABC123"
```

### 场景3：重新登录
```bash
# token过期或忘记时重新登录
curl -X POST https://supercoordination-mcp-production.up.railway.app/api/auth/login \
  -H "Content-Type: application/json" \
  -d '{
    "email": "xiaowang@liangzhu.com",
    "password": "wang2026"
  }'
```

---

## 🔐 安全说明

### 密码要求
- ✅ 最少6位字符
- ✅ 自动加密存储（bcrypt）
- ✅ 明文密码不会被保存

### Token说明
- ✅ 有效期7天
- ✅ 过期后需重新登录
- ✅ 妥善保管，不要泄露给他人

### 数据隐私
- ✅ 所有数据存储在Railway云端PostgreSQL
- ✅ 密码经过加密，无法被反向解密
- ✅ 仅限良渚青年公社成员使用

---

## 💡 常见问题

### Q1: 注册后忘记了token怎么办？
**A:** 使用登录API重新获取token即可。

### Q2: 密码忘记了怎么办？
**A:** 目前版本暂不支持密码重置，请联系管理员重置。（下个版本会添加）

### Q3: 可以修改用户名吗？
**A:** 目前版本不支持，下个版本会添加用户信息更新功能。

### Q4: 积分有什么用？
**A:** 积分是超协体的核心经济系统，可用于发布任务、获取服务等（功能开发中）。

### Q5: 如何查看其他成员？
**A:** 使用MCP工具的`list_all_members`功能（需要后续版本支持认证）。

---

## 🚀 下一步计划

### 即将上线的功能
- [ ] 前端登录注册页面
- [ ] 用户信息编辑
- [ ] 密码重置
- [ ] 头像上传
- [ ] PWP五行画像填写界面
- [ ] 积分交易系统
- [ ] 任务市场

### 当前可用功能
- ✅ 用户注册
- ✅ 用户登录
- ✅ Token认证
- ✅ 查看个人信息
- ✅ MCP工具（需要认证，后续版本完善）

---

## 📞 联系方式

**遇到问题？**
- 📧 邮箱：[管理员邮箱]
- 💬 微信群：良渚青年公社·超协体
- 🏢 线下：良渚文化村·青年公社

**技术支持：**
- GitHub: https://github.com/VIONWILLIAMS/supercoordination-mcp
- 文档：本指南

---

## 🎉 欢迎加入超协体！

**你已成为良渚青年公社的超协体成员！**

### 成员权益
- ✅ 50积分初始奖励
- ✅ 参与社区任务分配
- ✅ 使用五行智能匹配
- ✅ 访问团队协作仪表盘
- ✅ 参加线下活动优先权

### 下一步行动
1. ✅ 完成注册
2. [ ] 填写PWP五行画像（开发中）
3. [ ] 发布第一个任务（开发中）
4. [ ] 参加线下接入会（待通知）

---

**让我们一起，用AI重新定义协作！** 🚀

*明道而不迷，立法而不散，修术而不虚，观势而不躁，造器而不执。*