KTS MCP Studio

MCP hub trung tâm của studio: một nguồn dữ liệu chung cho mọi agent — kiến thức, ý tưởng, việc, mã game, timeline, đo lường.

● endpoint: https://mcp.kientaoso.com MCP: /mcp REST: /api/v1 Spec v0.5

1. Đăng ký dùng (đăng ký users)

Gửi admin: tên + role mong muốn (member / lead) + tên agent bạn sẽ dùng (VD: may-cua-minh-droid).
Admin tạo user + cấp API key (key hiện một lần — giữ kỹ, không commit vào repo).
Admin gắn mã định danh: viết tắt PE của bạn (dùng cho mã game nội bộ) và Telegram ID (cho giai đoạn sau).

Chưa có self-signup ở giai đoạn này — mọi key do admin phát hành và thu hồi được. OAuth login là mở rộng tương lai.

2. Auth vào CLI (mọi client dùng chung 1 key)

Hub nhận key qua header X-API-Key. Cấu hình một lần cho từng CLI:

Claude Code

claude mcp add --transport http kts-hub https://mcp.kientaoso.com/mcp \
  -H "X-API-Key: <KEY_CUA_BAN>"

Cursor

~/.cursor/mcp.json
{
  "mcpServers": {
    "kts-hub": {
      "url": "https://mcp.kientaoso.com/mcp",
      "headers": { "X-API-Key": "<KEY_CUA_BAN>" }
    }
  }
}

Codex CLI

~/.codex/config.toml
[mcp_servers.kts-hub]
url = "https://mcp.kientaoso.com/mcp"
http_headers = { "X-API-Key" = "<KEY_CUA_BAN>" }

MCP client khác (streamable HTTP)

Bất kỳ client nào hỗ trợ MCP streamable HTTP: trỏ tới https://mcp.kientaoso.com/mcp, gửi header X-API-Key. REST thuần: https://mcp.kientaoso.com/api/v1/....

Kiểm tra đã nối được

curl -s https://mcp.kientaoso.com/api/v1/whoami -H "X-API-Key: <KEY_CUA_BAN>"
# {"userId":"...","role":"member","name":"..."}

3. Phân quyền (cơ bản, có mở rộng)

Role	Được làm gì
admin	Quản lý users, API keys, art providers — toàn quyền
lead	Tạo/sửa portfolio, project, milestone, task; giao việc; duyệt idea; đúc mã game
member (PE)	Cập nhật task được giao, ghi kiến thức, đăng idea, nhận job, log usage
viewer	Chỉ đọc: kiến thức, timeline, metrics

Mọi thay đổi đều ghi audit (ai, khi nào, cái gì). Agent API key thừa kế quyền của owner. Matrix mở rộng (role theo project) là mở rộng kế tiếp nếu cần.

4. Mã game & timeline

Mã nội bộ GM-<VIẾT_TẮT_PE>-NN — đúc tự động khi tạo game, sequence riêng từng PE (VD: GM-HL-01, GM-HL-02).
Mã pub PUB-NNNN — cấp đúng 1 lần lúc phát hành, sequence toàn cục, không bao giờ trộn với mã nội bộ.
Timeline: game → milestone → task (due date, phụ thuộc). Xem việc của mình: tool task_list; xem tổng: hub_status.

# Tạo game cho PE (lead/admin)
game_create { "name": "Rush", "pe_user_id": "<user_id>" }   → GM-HL-01

# Phát hành (admin/lead) — cấp PUB mã vĩnh viễn
game_publish { "game_id": "<id>" }                          → PUB-0001

5. Cheat-sheet tools

Nhóm	Tools
Games & timeline	`game_create` `game_list` `game_publish` `portfolio_create` `project_create` `milestone_create` `task_create` `task_update_status` `task_list`
Tri thức & ý tưởng	`knowledge_add` `knowledge_search` `idea_add` `idea_list` `idea_triage`
Điều phối agent	`job_create` `job_claim` `job_complete` `usage_log`
Hệ thống	`whoami` `hub_status` `user_set_initials`