Deploy lên Cloudflare

Instance tham khảo chạy tại seo-navigator-mcp.autumn-recipe-cac7.workers.dev. Trang này dành cho những người muốn chạy bản sao của riêng mình.

Điều kiện tiên quyết

• Tài khoản Cloudflare (gói free là đủ để test — đã bao gồm D1)
• Node.js 18+ trên PATH
• git trên PATH
• Wrangler CLI: npm install -g wrangler (hoặc npx wrangler mỗi lệnh)

1. Clone và cài đặt

git clone https://github.com/supportsn/seo-navigator-mcp
cd seo-navigator-mcp
npm install
npx wrangler login

wrangler login mở trình duyệt, yêu cầu bạn authorize, sau đó lưu token vào config local. Sau đó mọi thứ diễn ra qua CLI.

2. Tạo database D1

npx wrangler d1 create blog_mcp

Output bao gồm một database_id. Dán nó vào wrangler.toml:

[[d1_databases]]
binding = "DB"
database_name = "blog_mcp"
database_id = "<paste-here>"

Sau đó apply migrations:

npx wrangler d1 migrations apply blog_mcp --remote

3. Set secrets

Worker tối thiểu cần một master token (mật khẩu super-admin). Tạo một cái:

$token = -join ((48..57) + (97..102) | Get-Random -Count 64 | ForEach-Object {[char]$_})
$token | npx wrangler secret put MASTER_TOKEN

Lưu token vào trình quản lý mật khẩu — bạn sẽ cần nó để đăng nhập vào /admin.

Tuỳ chọn, chỉ khi bạn định dùng Duda hoặc GitHub App hoặc Cloudflare Pages:

# Duda — chỉ gói Team plan trở lên
echo "<duda_api_user>" | npx wrangler secret put DUDA_API_USER
echo "<duda_api_pass>" | npx wrangler secret put DUDA_API_PASS

# GitHub App (Phase J — bắt buộc cho markdown sync và các tool Astro)
# Xem /claude/tokens/ để biết cách tạo GitHub App.
echo "<app_id>" | npx wrangler secret put GITHUB_APP_ID
echo "<app_slug>" | npx wrangler secret put GITHUB_APP_SLUG
echo "<client_id>" | npx wrangler secret put GITHUB_APP_CLIENT_ID
echo "<client_secret>" | npx wrangler secret put GITHUB_APP_CLIENT_SECRET
Get-Content "<path-to-pem>" -Raw | npx wrangler secret put GITHUB_APP_PRIVATE_KEY

# Cloudflare Pages API (tuỳ chọn — bật tool check_astro_deploy)
echo "<cf_api_token>" | npx wrangler secret put CLOUDFLARE_API_TOKEN
echo "<cf_account_id>" | npx wrangler secret put CLOUDFLARE_ACCOUNT_ID

4. Deploy

npx wrangler deploy

CLI in ra URL worker của bạn, định dạng https://seo-navigator-mcp.<account-subdomain>.workers.dev.

5. Đăng nhập admin

Mở https://<your-worker>.workers.dev/admin/login, chuyển sang tab Master token, dán giá trị bạn vừa tạo, và đăng nhập.

Từ đó:

• Tạo tài khoản user đầu tiên tại /admin/users (chỉ super-admin)
• Đăng ký site WordPress / Duda / Astro đầu tiên tại /admin/sites
• Mint một token cho Claude Desktop tại /admin/tokens
• Kết nối Claude theo Hướng dẫn Claude Desktop

Cập nhật

Pull code mới nhất từ GitHub, sau đó:

git pull
npm install
npx wrangler d1 migrations apply blog_mcp --remote
npx wrangler deploy

Migration là idempotent — các migration đã apply sẽ được bỏ qua. Secrets vẫn tồn tại qua các lần deploy.

Chi phí

Giới hạn gói free tính đến năm 2026:

Tài nguyên	Giới hạn free	Mức dùng thực tế hàng tháng
Worker requests	100k/ngày	~1k cho solo, dư sức
D1 reads	5M/ngày	<10k cho workflow điển hình
D1 writes	100k/ngày	<500 cho workflow điển hình
Wall time	10ms CPU mỗi request	Thừa thãi — hầu hết call <5ms

Hoàn toàn miễn phí cho mục đích cá nhân. Gói trả phí ($5/tháng) chỉ cần khi bạn phục vụ nhiều agency trên cùng một worker.