Bỏ qua để đến nội dung
SEO Navigator MCP

Bắt đầu nhanh

Hướng dẫn này giả định worker đã được deploy. Nếu bạn LÀ super-admin và cần deploy từ đầu trước, xem Deploy lên Cloudflare.

Cách nhanh nhất là OAuth qua Custom Connector (không cần file config, không cần Node). Nếu Claude Desktop của bạn quá cũ, không có UI Custom Connector, hãy dùng phương án dự phòng bearer-token.

1. Tạo tài khoản người dùng

Phần tiêu đề “1. Tạo tài khoản người dùng”

OAuth cần một danh tính người dùng — master token sẽ không hoạt động với connector.

  1. Mở admin dashboard: https://seo-navigator-mcp.autumn-recipe-cac7.workers.dev/admin/login (hoặc https://<your-worker>.workers.dev/admin/login nếu bạn self-host).
  2. Đăng nhập tại tab Master token bằng master secret.
  3. Vào Users → click + New user → điền username + password.
  4. Gán ít nhất một site cho user. Token do OAuth phát hành sẽ chỉ thấy các site đó.

Bỏ qua bước này nếu đã có tài khoản user cho bạn.

2. Thêm Custom Connector của Claude Desktop

Phần tiêu đề “2. Thêm Custom Connector của Claude Desktop”
  1. Mở Claude Desktop.
  2. Settings → Connectors → Add custom connector.
  3. Điền vào:
    • Name: SEO Navigator
    • Remote MCP server URL: https://seo-navigator-mcp.autumn-recipe-cac7.workers.dev/mcp
    • Để trống OAuth Client ID và OAuth Client Secret — Dynamic Client Registration sẽ xử lý chúng tự động.
  4. Click Add.
  5. Một tab trình duyệt mở ra tại /oauth/authorize. Đăng nhập bằng tài khoản user từ bước 1.
  6. Click Approve trên màn hình consent. Tab tự đóng.

Connector giờ đã active. Access token có hiệu lực 1 giờ và tự refresh; bạn sẽ không phải đụng đến nó trong vòng 30 ngày.

3. Kiểm tra

Phần tiêu đề “3. Kiểm tra”

Mở một chat mới. Biểu tượng 🔌 ở dưới cùng sẽ hiển thị seo-navigator với ít nhất 31 tool khả dụng.

Hỏi:

List my sites.

Claude gọi list_sites và trả về những gì tài khoản user của bạn có quyền truy cập. Nếu bạn thấy các site của mình thì xong. Nếu thấy 0 tool hoặc Disconnected, xem Khắc phục sự cố.

4. Thử một workflow thực

Phần tiêu đề “4. Thử một workflow thực”

Chọn cái phù hợp với công việc của bạn:

Lỗi thường gặp

Phần tiêu đề “Lỗi thường gặp”
  • Màn hình đăng nhập OAuth báo “No user accounts” — hoàn tất bước 1 trước, rồi thử lại setup connector.
  • E_AUTH / “Unauthorized” — session OAuth hết hạn hoặc bị revoke. Xoá và thêm lại connector.
  • E_SCOPE_DENIED — tài khoản user của bạn chưa được cấp site đó. Master-admin có thể cấp trong /admin/users.
  • Tool fail với WP 400 hoặc tương tự — chạy diagnose_site site_id="..." để xem nguyên nhân từ phía upstream.