WordPress WSP MCP

Tích hợp wsp-wordpress — MCP server kết nối trực tiếp với website WordPress của bạn để tự động hóa quy trình đăng tải (deploy) và cập nhật bài viết chuẩn SEO từ Content Pipeline của SEO Kit.

📌 Đây là extension dành cho hoạt động Deploy + Freshness (Bước 6 trong quy trình SEO). Khi kích hoạt, SEO Kit có thể tự động đẩy các bài viết đã được tối ưu hóa trực tiếp lên WordPress dưới dạng bản nháp (Draft) hoặc xuất bản ngay lập tức.

Yêu Cầu

1. Website WordPress đang hoạt động.
2. Đã cài đặt plugin WordPress hỗ trợ MCP (ví dụ: WSP MCP plugin hoặc REST API Route tương thích).
3. Đã có Bearer Token để xác thực kết nối.

Cấu Hình Qua .env

Để bảo mật thông tin truy cập, bạn không cấu hình trực tiếp trong tệp cấu hình JSON của hệ thống. Thay vào đó, hãy thiết lập các biến môi trường sau trong tệp .env tại thư mục gốc của bạn:

# 1. Bật tính năng kết nối WordPress MCP
SEO_WP_MCP_ENABLED=true

# 2. URL Endpoint của WSP MCP Server trên WordPress của bạn
# (Ví dụ: endpoint REST route được cung cấp bởi plugin của bạn)
WSP_MCP_SERVER_URL=https://your-wordpress-site.com/index.php?rest_route=/wsp-mcp/v1/mcp

# 3. Token bảo mật xác thực kết nối (Bearer token)
WSP_MCP_TOKEN=your_secure_wsp_mcp_token_here

# 4. Xác định phương thức Deploy và Server đích
SEO_DEPLOY_METHOD=wordpress
SEO_WP_MCP_SERVER=wsp-wordpress

Lưu ý: Sau khi lưu tệp .env, hệ thống Antigravity sẽ tự động nạp các biến môi trường này vào cấu hình MCP được định nghĩa tại .agents/mcp_config.json thông qua các placeholder dạng ${VAR_NAME}.

Cơ Chế Hoạt Động Của Server

Trong .agents/mcp_config.json, server được đăng ký như sau:

"wsp-wordpress": {
  "serverUrl": "${WSP_MCP_SERVER_URL}",
  "headers": {
    "Authorization": "Bearer ${WSP_MCP_TOKEN}"
  }
}

Mỗi khi bạn chạy lệnh xuất bản, hệ thống sẽ gọi MCP Server wsp-wordpress gửi payload bài viết kèm theo token đã thiết lập trong header.

Hướng Dẫn Sử Dụng

1. Tự động xuất bản sau Content Pipeline

Khi chạy quy trình sản xuất nội dung tự động bằng:

/seo-auto-run

Hệ thống sẽ chạy qua 5 bước chính. Ở Phase 4 (Thực Thi), nếu biến SEO_DEPLOY_METHOD được cấu hình là wordpress và WordPress MCP đã được kích hoạt thành công, tác nhân tech-seo-director phối hợp cùng editor-in-chief sẽ đẩy nội dung bài viết lên WordPress thông qua công cụ Deploy.

2. Thực thi Deploy thủ công

Nếu bạn vừa tạo xong một bài viết hoặc chỉnh sửa bài viết cũ cục bộ và muốn deploy ngay lập tức lên site WordPress:

Sử dụng lệnh chat:

/seo-execute --deploy

Tác nhân tech-seo-director sẽ:

1. Đọc nội dung bài viết đã hoàn thiện trong thư mục dự án cục bộ.
2. Kiểm tra tính hợp lệ của cấu trúc HTML, hình ảnh và metadata (Title, Meta Description).
3. Sử dụng MCP wsp-wordpress để đẩy bài viết lên trang WordPress mục tiêu.
4. Trả về kết quả đường dẫn bài đăng nháp hoặc bài viết chính thức.

Xử Lý Sự Cố