Vinpack MCP Gateway

Điều khiển nhiều WordPress site bằng Codex. Admin nạp site & cấp quyền; Member dùng Codex audit/sửa các web được giao. Token site mã hoá ở gateway, không xuống máy người dùng.

🚀 Cài đặt Codex (1 lần — không cần code)

Làm một cách theo hệ điều hành, rồi mở lại Codex là dùng được.

🪟 Windows

Cách 1: → bấm đúp → dán key vc_... → đợi “DONE”. (Win chặn? → More info → Run anyway)

Cách 2: mở PowerShell, dán dòng này rồi Enter:

🍎 macOS / Linux

Cách 1 (file bấm): → giải nén → chuột phải file vinpack-codex-install.command → Open → Open (lần đầu macOS hỏi vì chưa ký) → hộp thoại hỏi key.

Cách 2 (Terminal): mở Terminal, dán dòng này rồi Enter:

Installer cài gì

Bridge MCP (1 file), 6 skill vào ~/.codex/skills, ghi ~/.codex/config.toml với key, kiểm tra Node. Không đụng WordPress/plugin, không lưu token site.

👤 Dùng trong Codex

Khởi động lại Codex sau khi cài.
Gõ “liệt kê web tôi quản” → ra bảng web + quyền của bạn.
Audit sâu SEO: “audit SEO sâu https://vinpack.vn” → kiểm technical / on-page / schema / internal-link bằng dữ liệu thật trong site, ra báo cáo ưu tiên 🔴🟠🟢 + đề xuất fix cụ thể → duyệt là áp ngay.
Sửa nội dung: “sửa meta title bài 42 trên vinpack.vn”, “tạo page nháp …”, “thêm CSS …”.

Audit cần quyền readonly; áp fix / sửa cần seo_write. Cần thêm web hoặc nâng quyền? → nhờ admin.

🛡️ Thiết lập (Admin) ADMIN

Đăng nhập admin → Đổi mật khẩu.

Nạp website: cài plugin v0.22.5 (tải) lên site → WP Admin → Hermes Bridge → Tokens cấp token, IP whitelist = 103.77.240.14 → dán vào “Nạp website mới” → bấm Test kết nối (xanh = OK).

Tạo user cho member → Gán site (tick site + chọn quyền readonly/seo_write/full).

Đưa member tài khoản + bảo họ mở trang này (chế độ Member) bấm Cài đặt. Họ tự tạo connection (Codex Connections → Tạo → copy key vc_).

Plugin v0.22.5 đã có sẵn tạo/xoá page, upload ảnh, category/menu, sửa CSS & code snippet an toàn — không cần cài thêm gì.

🔒 Bản quyền theo domain: plugin chỉ chạy trên domain được duyệt (site đã đăng ký tự được duyệt; thêm domain khác ở mục “Domain bản quyền” trong Dashboard). Domain lạ → plugin tự khoá API. File plugin cũng chỉ tải được khi đã đăng nhập admin.

Mô hình quyền

Admin gán site + quyền cho user; Codex connection thừa hưởng quyền của user tạo nó (admin = full mọi site; member = site được gán).

`readonly`	Đọc/audit
`seo_write`	readonly + sửa title/meta/nội dung/options
`full`	Tất cả + file/plugin/DB

📥 File tải về & cách cài chi tiết

1. Installer Codex — vinpack-codex-install.bat MEMBER

⬇ Tải .bat — trình cài tự động cho máy member (không cần code).

Cài: tải → bấm đúp → dán key vc_... → đợi “DONE”. (Win báo chặn → More info → Run anyway.)
Nó tự làm: kiểm tra Node → tải bridge về %USERPROFILE%\.vinpack\bridge.cjs → tải 6 skill vào %USERPROFILE%\.codex\skills → ghi %USERPROFILE%\.codex\config.toml (khai báo MCP vinpack + key).
Windows (thay thế, PowerShell): irm https://mcp.vinpack.top/downloads/vinpack-codex-install.ps1 | iex
macOS / Linux: mở Terminal chạy curl -fsSL https://mcp.vinpack.top/downloads/vinpack-codex-install.sh | bash (đặt bridge ở ~/.vinpack/bridge.cjs).
Xong → khởi động lại Codex → gõ “liệt kê web tôi quản”.

2. Plugin WordPress — hermes-bridge-v0.22.5.zip ADMIN

⬇ Tải .zip — plugin chính, cài trên mỗi site cần điều khiển. Gồm REST API + đọc/sửa nội dung + tạo/xoá page, upload ảnh, category/menu + sửa CSS & code snippet an toàn.

Cài mới: WP Admin → Plugins → Add New → Upload Plugin → chọn zip → Install Now → Activate.
Cập nhật (đã có bản cũ): Upload đè → chọn “Replace current with uploaded”. Đừng Delete (Delete chạy uninstall, mất bảng token).
Sau cài: WP Admin → Hermes Bridge → Tokens → cấp token, IP whitelist = 103.77.240.14 → dán vào dashboard mục “Nạp website mới” → bấm Test kết nối.

3. Bộ Skill Codex — vinpack-codex-skills.zip (6 skill) nâng cao

⬇ Tải .zip — hướng dẫn cho Codex: vinpack-mcp (hub), vinpack-list-sites, vinpack-setup, vinpack-seo-edit, vinpack-seo-audit, vinpack-safe-code. Installer (#1) đã tự tải — chỉ cần khi muốn cài tay.

Cài tay: giải nén vào ~/.codex/skills/ (mỗi skill 1 thư mục con) → khởi động lại Codex.

Cấu hình config.toml thủ công (nếu không dùng installer)

[mcp_servers.vinpack]
command = "node"
args = ["C:/Users/<ban>/.vinpack/bridge.cjs"]

[mcp_servers.vinpack.env]
GATEWAY_URL = "https://mcp.vinpack.top"
CONNECTION_KEY = "vc_..."

File nội bộ (installer tự lo, không cần tải tay): vinpack-bridge.cjs (cầu MCP 1 file), vinpack-codex-install.ps1 (script cài mà .bat gọi).

Xử lý lỗi thường gặp

Lỗi	Xử lý
`no_site_grant` / `insufficient_profile`	MEMBER nhờ admin gán site / nâng quyền
`http_401/403` (từ site) hoặc Test kết nối đỏ	ADMIN cấp lại token, IP whitelist = `103.77.240.14`
`http_404` (từ site)	Cập nhật site lên plugin hermes-bridge v0.22.x
Codex không thấy tool `vinpack`	Chạy lại installer + khởi động lại Codex

Token mã hoá AES-256-GCM · audit mọi thao tác · ← Dashboard