Dương Cao Trí› Khóa học› IFY› Webcake› Tổng quan
✦ Chuẩn bị trước khóa IFY

Nối Webcake vào Claude

Nối một lần, sau đó bạn chỉ cần nói "dựng cho tôi một trang landing page…" — Claude tự dựng trang ngay trong tài khoản Webcake của bạn. Khoảng 15 phút, làm một lần cho mỗi máy.

Thuộc khóaInternet For You
Thời giankhoảng 15 phút
Làm mấy lần1 lần mỗi máy
Cần trướctài khoản Webcake
💡
Hướng dẫn này dành cho Claude Desktop (app bấm chuột) — cách dễ nhất: đứng ở thư mục nào chạy lệnh cũng được, dùng chung cho cả máy.
(Nếu bạn dùng Claude Code gõ lệnh trong terminal: lệnh cài gắn Webcake theo đúng thư mục bạn đang đứng lúc chạy — nên mở cửa sổ lệnh ngay trong thư mục làm việc rồi mới chạy. Không cần bận tâm nếu dùng Desktop.)
⚠️
Cần Claude đã cài trên máy (Claude Desktop hoặc Claude Code) và tài khoản Webcake tại webcake.io. Chưa có thì để dành làm tại lớp.
Bạn đang dùng máy nào?
1

Cài Node.js và Claude Code

Mục tiêu: Lệnh nối Webcake chạy nhờ Node.js. Máy chưa có thì không chạy được lệnh nào ở các bước sau.

Các bước

  1. Vào trang nodejs.org.
  2. Bấm nút ghi LTS (bản ổn định) — không chọn Current.
  3. File tải về có đuôi .msi. Bấm đôi để mở.
  4. Trong cửa sổ cài đặt, cứ bấm Next và để mặc định mọi thứ:
    • Trang điều khoản: tick I accept… rồi Next
    • Thư mục cài, Custom Setup: để mặc định, Next
    • Tools for Native Modules: không cần tick, Next
  5. Bấm Install, chờ vài phút, rồi Finish.
  6. Đóng hết cửa sổ PowerShell / CMD đang mở rồi mở lại. Nếu vẫn báo lỗi ở bước sau thì khởi động lại máy.
  7. Kiểm tra: mở PowerShell, dán lệnh này rồi Enter: 
    node -v
    Hiện ra số phiên bản (ví dụ v22.14.0) là xong.
⚠️
Báo 'node' is not recognized nghĩa là Windows chưa nhận Node vừa cài. Đóng hết cửa sổ lệnh, mở lại. Vẫn lỗi thì khởi động lại máy.

Cài Claude Code

  1. Mở PowerShell, dán lệnh này rồi Enter: 
    irm https://claude.ai/install.ps1 | iex
  2. Chờ hiện Installation complete cùng dòng Location: C:\Users\…\.local\bin\claude.exe là cài xong.

Thêm đường dẫn (PATH) — để máy nhận lệnh claude

  1. Ngay sau khi cài, màn hình in một đường dẫn kết thúc bằng \.local\bin (ví dụ C:\Users\Admin\.local\bin) — copy đường dẫn đó.
  2. Bấm Start → gõ environment → mở Edit the system environment variables → nút Environment Variables….
  3. Ở ô trên (User variables) chọn dòng Path → Edit… → New → dán đường dẫn vừa copy → OK hết các cửa sổ.
  4. Đóng hết PowerShell rồi mở lại, kiểm tra: 
    claude --version
    Hiện số phiên bản (ví dụ 2.1.241) là xong.
⚠️
Gõ claude báo không nhận diện được? Là \.local\bin chưa vào PATH, hoặc chưa mở lại cửa sổ lệnh. Làm lại phần thêm PATH ở trên rồi đóng/mở lại PowerShell.
Đã làm xong bước nàyNode + Claude Code đã cài, gõ claude --version ra số
2

Cấp quyền chạy lệnh cho PowerShell

Mục tiêu: Windows mặc định chặn chạy loại lệnh này. Mở khoá một lần cho tài khoản của bạn. Làm 1 lần duy nhất mỗi máy.

Các bước

  1. Mở PowerShell thường (bấm Start → gõ PowerShell → Enter). Chưa cần quyền quản trị.
  2. Dán lệnh này rồi Enter: 
    Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned
  3. Máy hỏi xác nhận, hiện dòng có [Y] Yes [A] Yes to All … → gõ Y rồi Enter.
💡
Nếu lệnh trên báo đỏ (thường là máy công ty bị khoá): đóng cửa sổ, bấm Start → gõ PowerShell → chuột phải → Run as administrator → Yes, rồi dán lại lệnh. Xong thì đóng luôn cửa sổ quyền quản trị đó — các bước sau phải dùng PowerShell thường, nếu không sẽ vướng đúng cái bẫy thư mục nói ở đầu trang.
Đã làm xong bước nàyLệnh chạy không báo đỏ
3

Chạy lệnh nối Webcake

Mục tiêu: Chạy một lệnh duy nhất. Nó hỏi 4 câu — bước này trả lời 2 câu đầu, câu thứ hai sẽ làm trình duyệt bật ra để bạn đăng nhập ở bước 4.

Các bước

  1. Mở PowerShell thường ngay trong thư mục bạn sẽ làm việc với Claude Code: mở File Explorer tới thư mục đó, bấm vào thanh địa chỉ, gõ powershell rồi Enter.
  2. Dán lệnh này rồi Enter: 
    npx -y webcake-landing-mcp install
  3. Lần đầu có thể hỏi Ok to proceed? (y) → gõ y → Enter.
  4. Nó hỏi câu 1 — chọn môi trường. Ở đây gõ số rồi Enter (không phải bấm mũi tên):
    Câu 1 · Chọn môi trường
    Gõ 1 rồi Enter (đây là prod — môi trường thật). Bấm luôn Enter cũng được vì prod là mặc định. Hai lựa chọn còn lại chỉ dành cho đội kỹ thuật Webcake.
  5. Nó hỏi câu 2 — cách đăng nhập:
    Câu 2 · Cách đăng nhập
    Gõ 1 rồi Enter (đăng nhập bằng trình duyệt). Gõ xong, trình duyệt tự bật ra — sang bước 4 ngay.
    Đây là lý do bạn không cần vào Webcake copy mã nào cả.
Đã làm xong bước nàyĐã chọn prod và browser, trình duyệt vừa bật ra
4

Đăng nhập tài khoản Webcake

Mục tiêu: Đây là chỗ tài khoản Webcake của bạn được nối vào Claude. Đăng nhập ngay trên trình duyệt, không phải copy mã gì cả.

Các bước

  1. Trình duyệt vừa tự mở trang Webcake → đăng nhập tài khoản Webcake của bạn nếu nó hỏi.
  2. Webcake hỏi có cho phép kết nối không → bấm nút đồng ý (Authorize / Allow).
  3. Quay lại cửa sổ lệnh. Nó hỏi 2 câu cuối:
    Câu 3 · WEBCAKE_ORG_ID
    Câu này không bắt buộc — cứ bấm Enter để bỏ qua.
    Câu 4 · Chọn ứng dụng
    Danh sách hiện ra: 1) Claude Desktop · 2) Claude Code … 12) All.
    Gõ 1 rồi Enter (chọn Claude Desktop). Không phải bấm Space để tick.
    Đừng gõ 12 — đó là "All", không phải số 1.
    Không chọn Claude Desktop ở đây thì Claude sẽ không thấy Webcake — đây là lỗi hay gặp nhất.
  4. Chờ chạy xong, hiện dòng báo đã cấu hình (Configured) là được.
🔒
Đăng nhập đúng tài khoản Webcake của bạn. Đăng nhập nhầm là trang landing sau này bị tạo vào tài khoản người khác. Mã đăng nhập (Access Key) coi như mật khẩu — không gửi lên nhóm chat, không để lọt vào ảnh chụp màn hình.
⚠️
Trình duyệt không tự mở? Cửa sổ lệnh thường in sẵn một đường link — copy link đó dán vào trình duyệt rồi đăng nhập như trên.
🔑
Chỉ khi đăng nhập trình duyệt không xong, công cụ mới hỏi WEBCAKE_JWT — tức là đòi bạn dán mã. Lúc đó mới cần vào Webcake lấy mã: Webcake → Settings → Access code → Generate API keys, copy rồi dán vào. Bấm Enter bỏ qua cũng được, sau này chạy npx -y webcake-landing-mcp login để đăng nhập lại.
Đã làm xong bước nàyĐã đăng nhập Webcake và máy báo cấu hình xong
5

Đóng và mở lại Claude

Mục tiêu: Claude chỉ nạp danh sách công cụ lúc khởi động. Chưa mở lại thì chưa thấy Webcake.

Các bước

  1. Tắt hẳn Claude Desktop. Cách chắc nhất: mở Task Manager (Ctrl + Shift + Esc) → tìm dòng Claude → chuột phải → End task. (Hoặc: bấm mũi tên nhỏ ở khay hệ thống cạnh đồng hồ → chuột phải icon Claude → Quit.)
  2. Bấm dấu X ở góc cửa sổ không tắt hẳn — làm vậy Webcake sẽ không hiện.
  3. Mở lại Claude Desktop.
Đã làm xong bước nàyĐã tắt hẳn và mở lại Claude
6

Kiểm tra và dùng thử

Mục tiêu: Nhìn tận mắt thấy Webcake trong danh sách rồi mới yên tâm.

Các bước

  1. Mở Claude Desktop → vào phần cài đặt kết nối (Settings → Connectors) — phải thấy webcake-landing trong danh sách. Không thấy → xem mục Lỗi hay gặp.
  2. Thử thật — gõ vào khung chat của Claude:
    Dựng cho tôi một landing page thu email đơn giản: một phần đầu trang có tiêu đề, một form thu email và một nút bấm.
  3. Claude sẽ xin phép dùng công cụ Webcake — bấm đồng ý. Xong nó trả về link trang trong tài khoản Webcake của bạn.
✅
Thấy link trang là xong. Từ giờ chỉ cần mở Claude là dùng được, không phải cài lại. Đổi sang máy khác thì làm lại từ bước 1.
Đã làm xong bước nàyClaude dựng được trang trong tài khoản Webcake
?

Lỗi hay gặp

Claude Code thấy webcake-landing (✓ Connected) nhưng Claude Desktop không thấy
Lúc chạy lệnh cài, ở câu chọn ứng dụng bạn chỉ gõ 2 nên chỉ Claude Code được khai báo. Kiểm nhanh — dán dòng này vào PowerShell: 
Get-ChildItem "$env:APPDATA\Claude\claude_desktop_config.json","$env:LOCALAPPDATA\Packages\Claude_*\LocalCache\Roaming\Claude\claude_desktop_config.json" -EA 0 | Select-String webcake
Hiện ra dòng có chữ webcake = đã khai báo, chỉ cần thoát hẳn Claude Desktop ở khay hệ thống rồi mở lại. Không hiện gì = chưa khai báo → chạy lại lệnh cài, câu chọn ứng dụng gõ 1,2.

Đang gấp thì cứ dùng Claude Code làm tiếp — bên đó đã nối xong, không phải chờ.
(Chỉ Claude Code) Chạy xong hết rồi mà claude mcp list không thấy webcake-landing
Chỉ liên quan nếu bạn dùng Claude Code. Bạn đã chạy lệnh cài ở thư mục khác với thư mục đang mở Claude Code — hay gặp nhất là chạy trong cửa sổ quyền quản trị, vì cửa sổ đó luôn đứng ở C:\Windows\System32. Cách chữa: mở cửa sổ lệnh thường, đứng trong thư mục làm việc, chạy lại lệnh cài. Chỉ mất một phút.
'node' is not recognized hoặc command not found: node
Chưa cài Node.js, hoặc cài rồi mà chưa đóng mở lại cửa sổ lệnh. Làm lại bước 1, khởi động lại máy nếu cần.
PowerShell báo đỏ khi chạy Set-ExecutionPolicy
Thường do máy công ty bị khoá bằng chính sách nhóm. Mở PowerShell bằng Run as administrator, chạy lại lệnh đó, rồi đóng cửa sổ đó ngay và quay về PowerShell thường. Vẫn bị chặn thì nhờ bộ phận kỹ thuật công ty.
Chạy báo lỗi missing_env
Thiếu mã đăng nhập. Chạy lại lệnh đăng nhập: npx -y webcake-landing-mcp login
Trang landing bị tạo vào nhầm tài khoản
Lúc trình duyệt mở ra bạn đã đăng nhập nhầm tài khoản Webcake, hoặc mã cũ còn lưu. Đăng nhập lại đúng tài khoản rồi chạy npx -y webcake-landing-mcp login
Icon Webcake là quả cầu trắng
Chỉ là Claude còn giữ icon cũ, không phải lỗi kết nối. Xoá kết nối rồi cài lại là hiện đúng.
Claude nói không thấy công cụ Webcake
Chưa tắt hẳn Claude rồi mở lại. Làm lại bước đóng mở Claude — Claude Desktop phải Quit hẳn (Task Manager → End task), không phải bấm X.
Claude tự mở trang webcake.io trong trình duyệt và bảo bạn đăng nhập, thay vì tự dựng trang trả link
Dấu hiệu công cụ Webcake chưa được nạp — Claude không thấy nó nên mò vào web làm tay. Công cụ thật không bắt bạn mở trình duyệt đăng nhập, mà tự dựng trang rồi trả link. Cách chữa: tắt hẳn Claude Desktop rồi mở lại (Task Manager → End task, không phải bấm X). Vẫn vậy thì chạy lại lệnh cài npx -y webcake-landing-mcp install, ở câu chọn ứng dụng nhớ gõ 1 để khai báo Claude Desktop, rồi tắt/mở lại.
Dựng trang thì báo lỗi 404 (hôm qua chạy được, nay hỏng)
Thường do cấu hình trỏ nhầm môi trường. Chạy lại lệnh cài ép về đúng bản thật: npx -y webcake-landing-mcp install --env prod → chọn đăng nhập trình duyệt → tắt/mở lại Claude Desktop. Vẫn 404 thì có thể đăng nhập nhầm tài khoản Webcake — chạy npx -y webcake-landing-mcp login rồi đăng nhập đúng tài khoản.
Mở thư mục AppData\Roaming\Claude mà không thấy khai báo nào
Nếu bạn tải Claude Desktop từ Microsoft Store thì file cấu hình không nằm ở đó, mà ở AppData\Local\Packages\Claude_…\LocalCache\Roaming\Claude\. Lệnh kiểm ở dòng đầu bảng này tìm cả hai chỗ nên cứ dùng nó, khỏi mò thư mục.
💡
Muốn dùng Webcake ở nhiều thư mục khác nhau (chỉ áp cho Claude Code): mở cửa sổ lệnh trong thư mục mới đó rồi chạy lại đúng lệnh cài npx -y webcake-landing-mcp install — nhanh thôi, không phải cài lại Node. Cách đỡ mệt nhất là dùng một thư mục làm việc cố định cho cả khoá.
Vướng mãi không xong thì nhắn cho page — đây là chỗ dễ tắc nhất, đội ngũ hỗ trợ trực tiếp nhanh hơn.

Tự kiểm máy chủ Webcake còn hoạt động không

Chỉ dùng khi nghi ngờ lỗi từ phía Webcake, không bắt buộc. Dán vào cửa sổ lệnh:

curl https://mcp.toolvn.io.vn/health

Kết quả mong đợi — có chữ "ok":true:

{"ok":true,"server":"webcake-landing","transport":"streamable-http","endpoint":"/mcp"}

Muốn gỡ kết nối

npx -y webcake-landing-mcp uninstall
🕸Nối Apify vào Claude Code› 🔧Cài đặt Git (Windows / Mac)› ↩Quay lại 10 việc chuẩn bị khóa IFY›
Nhắn tin cho page