Kết nối Cyfendo với Claude Code

Một lệnh để thêm Cyfendo vào Claude Code.

Thiết lập · khoảng 2 phút

Thiết lập

  1. Chạy lệnh bên dưới trong terminal. --scope user giúp Cyfendo dùng được trong mọi dự án của bạn; dùng --scope project để chia sẻ với nhóm của bạn qua .mcp.json.

    Terminal 
    claude mcp add --transport http --scope user cyfendo https://mcp.cyfendo.com/mcp

  2. Trong Claude Code, chạy /mcp, chọn cyfendo và chọn Authenticate. Trình duyệt của bạn mở Cyfendo: đăng nhập và bấm Allow.

  3. Để các kiểm tra của Cyfendo chạy mà không dừng lại chờ phê duyệt, hãy chạy /permissions và thêm quy tắc cho phép mcp__cyfendo, hoặc chọn Yes, and don't ask again ở lần đầu Claude Code hỏi.

  4. Thêm chỉ dẫn bên dưới vào CLAUDE.md ở thư mục gốc của dự án (các thao tác bấm chuột được liệt kê cùng chỉ dẫn). Ở lần kiểm tra đầu tiên, Cyfendo cấp cho dự án một ID riêng và agent lưu ID đó trong cyfendo.json: hãy commit tệp này cùng mã của bạn.

    Lấy chỉ dẫn

  5. Hãy bắt đầu một phiên Claude Code mới để nó nhận chỉ dẫn.

Mới dùng Cyfendo? Hãy chọn Continue with Google để tạo tài khoản miễn phí ngay trong cùng một bước. Nếu bạn đăng ký bằng email, hãy xác nhận email trước, rồi bắt đầu lại việc kết nối từ ứng dụng của bạn.

Khuyên dùng

Cho agent biết khi nào cần kiểm tra

Dán nội dung này vào CLAUDE.md để Claude Code tự gọi Cyfendo sau các thay đổi có rủi ro và báo cho bạn khi có kết quả.

Cách thêm vào Claude Code

  1. Bấm Copy ở chỉ dẫn bên dưới.
  2. Nếu dự án của bạn đã lưu các chỉ dẫn cho agent trong AGENTS.md và không có CLAUDE.md, hãy dán chỉ dẫn vào cuối AGENTS.md rồi lưu: Claude Code chỉ đọc AGENTS.md khi không có CLAUDE.md.
  3. Nếu không, trong Claude Code, mở dự án của bạn và chạy /memory. Chọn CLAUDE.md của dự án (./CLAUDE.md): nó mở trong trình soạn thảo của bạn, và Claude Code sẽ tạo nó trước nếu chưa có.
  4. Dán chỉ dẫn vào cuối tệp rồi lưu.

Không muốn sửa tệp? Hãy gửi cho Claude tin nhắn “Add this to CLAUDE.md at the root of the project, word for word:” rồi dán chỉ dẫn vào ngay sau.

Để dùng cho mọi dự án, hãy chọn CLAUDE.md của người dùng (~/.claude/CLAUDE.md) trong /memory.

CLAUDE.md 
## Security checks (Cyfendo)
Cyfendo identifies this project by the project_id in cyfendo.json at the project root. Pass it in every Cyfendo call. If the file doesn't exist, the first check or scan creates the project: save the project_id it returns to cyfendo.json and keep the file with the code.
- At the start of each of my requests, call cyfendo_status and tell me about any earlier_results before doing anything else.
- When you finish a task that changed login, sessions, permissions, database access, payments, file uploads, API routes or secrets, call cyfendo_check_changes once with all the files the task changed (list deleted files under deleted) and a short label. Don't wait for the result.
- For a confirmed issue that is still current, fix it as its fix_steps describe, or call cyfendo_generate_fix and then cyfendo_get_fix for Cyfendo's tested patch and show me the diff before applying it. Then call cyfendo_verify_fix.
- When I say I'm getting ready to release, call cyfendo_scan_project with this repository as a git source if it is pushed to GitHub, GitLab or Bitbucket; otherwise upload the source files in parts. Tell me when it has finished.

Kiểm tra xem nó hoạt động

Thử ngay

Gửi một trong các tin nhắn sau cho agent của Claude Code.

  • Kiểm tra rằng đã kết nốiUse Cyfendo to show my security status.
  • Kiểm tra một thay đổiCheck the files you just changed with Cyfendo.
  • Thu thập các kết quả đã hoàn tấtCollect any Cyfendo results that are ready.
  • Trước khi bạn xuất bảnI'm getting ready to publish. Run a full Cyfendo security scan.

Trước khi ra mắt

Câu hỏi về bảo mật

Mã do Claude Code viết có an toàn không?

Thường thì nó chạy được, và mã chạy được vẫn có thể bị khai thác: một endpoint bỏ qua việc kiểm tra quyền sở hữu, một câu truy vấn được dựng từ dữ liệu người dùng nhập, một đường dẫn tệp lấy thẳng từ yêu cầu. Những lỗi này trông bình thường khi review, và vì thế chúng được phát hành.

Claude Code chẳng phải đã review mã của nó rồi sao?

Claude Code có thể review các thay đổi của chính nó, kể cả về bảo mật. Một lần review đọc mã và đánh giá xem nó có vẻ rủi ro hay không. Cyfendo thử một cuộc tấn công an toàn lên mã của ứng dụng bạn trong sandbox cô lập và chỉ báo cáo những vấn đề mà cuộc tấn công chứng minh được, mỗi vấn đề kèm các bước sửa. Agent của bạn sửa các vấn đề thật thay vì tranh cãi với cảnh báo giả.

Khi nào Claude Code gọi Cyfendo?

Nhờ chỉ dẫn trong CLAUDE.md: một lần ở cuối mỗi tác vụ có đụng đến đăng nhập, quyền hạn, truy cập dữ liệu, thanh toán, tải tệp lên, các route API hoặc secret, và một bản quét đầy đủ khi bạn nói rằng bạn sắp phát hành. Các thay đổi về style, văn bản và kiểm thử được bỏ qua.

Đọc thêm

Cần biết

  • Hãy commit cyfendo.json cùng mã của bạn: khi đó mọi bản clone của kho mã nguồn và mọi coding agent làm việc trên đó đều dùng chung kết quả Cyfendo của dự án. Nếu bạn sao chép mã sang một dự án riêng, hãy xóa cyfendo.json trong bản sao để nó nhận ID riêng.
  • Quét đầy đủ: khi dự án được đẩy lên GitHub, GitLab hoặc Bitbucket, hãy kết nối kho mã nguồn đó trong Cyfendo (Settings → Integrations → Git) và Cyfendo sẽ đọc trực tiếp, bất kể kích thước. Kho mã nguồn công khai không cần thiết lập. Nếu không, agent sẽ tải các tệp nguồn lên theo từng phần tối đa 50 tệp.
  • Để đăng nhập từ terminal mà không cần cửa sổ trình duyệt, chạy claude mcp login cyfendo.
  • Nếu kho mã nguồn của bạn đã dùng AGENTS.md, Claude Code có thể đọc tệp đó thay cho CLAUDE.md.
  • OAuth: chạy /mcp trong Claude Code để đăng nhập qua trình duyệt. Phương án dự phòng: truyền --header "X-Cyfendo-Api-Key: your key".

Khắc phục sự cố

Cửa sổ đăng nhập không mở

Trình duyệt của bạn đã chặn cửa sổ bật lên. Hãy cho phép popup cho trang của trình xây dựng ứng dụng, rồi bấm lại nút authorize hoặc connect.

Tôi không tìm thấy không gian làm việc cá nhân của mình

Với tài khoản business, không gian làm việc của riêng bạn chính là không gian làm việc business, nên nó mang tên tổ chức của bạn. Hãy chọn không gian được đánh dấu “your workspace”.

Bài kiểm tra kết nối thất bại

Kiểm tra URL máy chủ đúng chính xác là https://mcp.cyfendo.com/mcp (có /mcp ở cuối) và, nếu ứng dụng của bạn hỏi, giao thức là HTTP (Streamable HTTP), không phải SSE.

Một lần kiểm tra cứ ở trạng thái “running”

Việc chứng minh một cuộc tấn công mất vài phút, nên các kiểm tra chạy nền. Agent của bạn chỉ có thể báo kết quả khi bạn gửi tin nhắn cho nó: Cyfendo thông báo cho bạn khi một lần kiểm tra hoàn tất, sau đó hãy gửi cho agent của bạn “Collect any Cyfendo results that are ready.” Một lần kiểm tra ngừng thử nghiệm sau khoảng 15 phút và báo cáo những gì nó có.

Cập nhật lần cuối · Xem dạng Markdown