KDIGI CMS 1.2.0: CMS AI-native với máy chủ MCP và CLI kcms

KDIGI CMS 1.2.0 là bản AI-native đầu tiên: CMS có sẵn máy chủ MCP để Claude Code, Codex, Cursor, VS Code hay OMP tìm, viết, hẹn giờ, đăng bài và kiểm tra SEO trực tiếp, với đúng vai trò và site của người dùng sở hữu API key. Bản này không có migration mới.

Điểm mới trong 1.2.0

1. Máy chủ MCP tại /api/mcp

Model Context Protocol là chuẩn mở để công cụ AI gọi công cụ bên ngoài. KDIGI CMS giờ là một máy chủ MCP với 23 công cụ: tìm và đọc bài, tạo bản nháp từ Markdown, sửa một phần, đăng, gỡ, hẹn giờ, thùng rác, lịch sử phiên bản, chuyên mục và thẻ, media, shortcode, kiểm tra SEO và lấy link duyệt. Kèm hướng dẫn nội dung kcms://guide/content và hai prompt write-post, refresh-seo.

Máy chủ bật sẵn; đặt MCP_ENABLED=false để tắt.

2. An toàn như một biên tập viên

• API key của một người dùng: agent có đúng vai trò và site của người đó. Author vẫn không đăng được bài; site khác coi như không tồn tại.
• Không ghi đè: mỗi lần sửa phải kèm expectedUpdatedAt. Có người vừa lưu thì lệnh báo conflict và không thay đổi gì.
• Tôn trọng khoá biên tập: bài đang mở trong trang quản trị thì agent nhận locked, không chiếm khoá.
• Bản nháp trước: bài mới luôn là bản nháp, agent gửi lại link trang quản trị để bạn duyệt.
• Có nhật ký: mỗi lần gọi công cụ ghi một dòng log agent-op, không ghi nội dung hay key.

3. CLI kcms

Gói @kdigi/kcms-cli cấu hình công cụ AI bằng một lệnh, và cho bạn sửa bài như tệp Markdown:

npm install -g @kdigi/kcms-cli
export KCMS_API_KEY=change-me
kcms setup claude-code --url https://cms.example.com --write --with-skill

kcms setup hỗ trợ claude-code, codex, cursor, vscode, omp và json. Tệp cấu hình chỉ tham chiếu biến KCMS_API_KEY, không chứa key. --with-skill cài thêm agent skill dạy quy trình biên tập an toàn.

Thay đổi hành vi cần biết

Phiên đăng nhập bằng API key bị giới hạn trên mọi route REST, GraphQL và MCP: không tạo người dùng, không đổi email, mật khẩu, API key, vai trò hay site của tài khoản, và không xoá vĩnh viễn (chỉ chuyển vào thùng rác). Script cũ dùng API key cho các việc này sẽ nhận 403. Phiên đăng nhập trình duyệt không bị ảnh hưởng.

Sửa lỗi: cập nhật một phần qua REST/GraphQL không còn ghi đè excerpt hay xoá seo.breadcrumbs; author cố đăng bài giờ nhận 403 thay vì 500.

Nâng cấp

Không có migration mới. Với Docker hoặc Coolify, chỉ cần build lại:

git fetch --tags && git checkout v1.2.0
docker compose up -d --build

Tài khoản demo công khai không tạo được API key, nên muốn thử MCP hãy tự host một bản. Hướng dẫn kết nối từng công cụ: AI agent và MCP. Tổng quan tính năng: AI agent và MCP trong KDIGI CMS. Danh sách thay đổi đầy đủ: CHANGELOG.