Thiết lập · khoảng 2 phút
Thiết lập
-
Bấm Add to Cursor và xác nhận trong Cursor. Hoặc thêm cấu hình bên dưới vào .cursor/mcp.json trong dự án của bạn (hoặc ~/.cursor/mcp.json cho mọi dự án).
.cursor/mcp.json{ "mcpServers": { "cyfendo": { "url": "https://mcp.cyfendo.com/mcp" } } } -
Khi Cursor hiển thị rằng Cyfendo cần đăng nhập, hãy bấm vào đó. Trình duyệt của bạn mở Cyfendo: đăng nhập và bấm Allow.
-
Cursor hỏi trước khi chạy các công cụ MCP. Để các kiểm tra của Cyfendo chạy mà không bị dừng, hãy tạo ~/.cursor/permissions.json chứa {"mcpAllowlist": ["cyfendo:*"]} (hoặc thêm "cyfendo:*" vào đó nếu tệp đã tồn tại). Bạn cũng có thể bấm Add to allowlist ở lần đầu Cursor hỏi.
-
Thêm chỉ dẫn bên dưới vào AGENTS.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 -
Hãy bắt đầu một cuộc chat agent mới để Cursor 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 AGENTS.md để Cursor 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 Cursor
- Bấm Copy ở chỉ dẫn bên dưới.
- Trong Cursor, mở Explorer (⇧⌘E trên Mac, Ctrl+Shift+E trên Windows và Linux). Nếu AGENTS.md đã có sẵn trong dự án, hãy mở nó rồi chuyển sang bước 4.
- Nếu chưa có, bấm chuột phải vào vùng trống bên dưới danh sách tệp, chọn New File…, gõ AGENTS.md rồi nhấn Enter. Tệp phải nằm ở cấp cao nhất của dự án, không nằm trong thư mục con.
- Dán chỉ dẫn vào cuối tệp rồi lưu (⌘S trên Mac, Ctrl+S trên Windows và Linux).
Không muốn sửa tệp? Hãy gửi cho agent của Cursor tin nhắn “Add this to AGENTS.md at the root of the project, word for word:” rồi dán chỉ dẫn vào ngay sau.
## 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 Cursor.
-
Kiểm tra rằng đã kết nối
Use Cyfendo to show my security status.
-
Kiểm tra một thay đổi
Check the files you just changed with Cyfendo.
-
Thu thập các kết quả đã hoàn tất
Collect any Cyfendo results that are ready.
-
Trước khi bạn xuất bản
I'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 Cursor 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.
Cursor chẳng phải đã review mã của nó rồi sao?
Agent của Cursor có thể review các thay đổi của chính nó, và Bugbot review các pull request. 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 Cursor gọi Cyfendo?
Nhờ chỉ dẫn trong AGENTS.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.
- Để dùng khóa API thay vì đăng nhập, thêm "headers": {"X-Cyfendo-Api-Key": "your key"} vào mục cyfendo.
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ó.