🔴 Redmine MCP Server

MCP Server kết nối Claude Code với Redmine — check issues và log time hàng ngày lúc 17h.

📦 Cài đặt

git clone <your-repo>
cd redmine-mcp
npm install
npm run build

⚙️ Cấu hình

1. Lấy API Key từ Redmine

Vào My account → API access key (góc phải trên) → Copy key.

2. Tạo file .env

cp .env.example .env

Sửa .env:

REDMINE_URL=https://your-redmine.example.com
REDMINE_API_KEY=your_api_key_here

3. Thêm vào Claude Code

Mở file ~/.claude.json (tạo nếu chưa có) và thêm:

{
  "mcpServers": {
    "redmine": {
      "command": "node",
      "args": ["/absolute/path/to/redmine-mcp/dist/index.js"],
      "env": {
        "REDMINE_URL": "https://your-redmine.example.com",
        "REDMINE_API_KEY": "your_api_key_here"
      }
    }
  }
}

Lưu ý: Thay /absolute/path/to/redmine-mcp bằng đường dẫn thực tế trên máy bạn.

Hoặc dùng lệnh CLI:

claude mcp add redmine -- node /absolute/path/to/redmine-mcp/dist/index.js

🛠️ Các tools có sẵn

Tool	Mô tả
whoami	Kiểm tra kết nối & user hiện tại
check_my_issues	Xem issues được assign cho bạn
get_issue_detail	Xem chi tiết issue + comments
create_issue	Tạo issue mới
update_issue	Cập nhật status, % done, comment
log_time	⏱️ Log time vào issue
get_today_time_log	Xem time đã log hôm nay
get_time_activities	Danh sách loại activity
get_projects	Danh sách projects

📅 Workflow log time 17h hàng ngày

Mỗi 17h, nói với Claude:

"Log time cho hôm nay đi"

Claude sẽ tự động:

1. Gọi check_my_issues — xem bạn đang làm issues gì
2. Gọi get_today_time_log — kiểm tra đã log chưa
3. Hỏi bạn làm gì, bao lâu
4. Gọi log_time — ghi vào Redmine

🧪 Test kết nối

echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"whoami","arguments":{}}}' \
  | REDMINE_URL=https://your.redmine.com REDMINE_API_KEY=xxx node dist/index.js