Kết nối Claude Code, Codex hoặc Cursor thế nào?
Mỗi agent một lệnh (ví dụ dùng đường dẫn Linux; thay bằng đường dẫn của bạn):
# Claude Code, cho mọi project trên máy này
claude mcp add --scope user wireframe -- /usr/bin/wf-mcp-server
# Codex
codex mcp add wireframe -- /usr/bin/wf-mcp-server
Với Cursor, đặt cùng lệnh đó vào ~/.cursor/mcp.json dưới mcpServers, kèm "type": "stdio". VS Code đọc .vscode/mcp.json và gọi danh sách này là servers, không phải mcpServers — sai khoá thì mục đó bị bỏ qua mà không báo gì. Client khác chỉ cần lệnh: không tham số, không biến môi trường.
Bấm Allow thì chuyện gì xảy ra?
Lần đầu agent gọi một công cụ, khung AI của WireFrame hiện một thẻ — "claude-ai wants to take command of this design over MCP" — với hai nút Allow và Decline. Không có gì chạy cho tới khi bạn bấm Allow; agent được báo là đang chờ, và các lệnh gọi đó không bị tính. Quyền này kéo dài tới khi agent ngắt kết nối, lần kết nối sau sẽ hỏi lại, và nút Revoke trong khung AI thu hồi quyền. Mỗi WireFrame chỉ cho một client kết nối cùng lúc.
Để kiểm tra kết nối, hỏi agent "Is WireFrame busy?" (WireFrame có đang bận không?). Nó gọi is_busy và trả lời rằng agent đang rảnh. Sau đó bảo nó liệt kê những gì làm được trên board đang mở (list_design_tools) và đọc hướng dẫn start_here bằng read_guide. Cả ba đều miễn phí.
Một phiên thiết kế diễn ra thế nào?
Khi bạn bấm Allow, agent của bạn nắm quyền chỉ huy thiết kế, còn agent riêng của WireFrame, Penalty, trở thành phi công phụ.
Agent của bạn thiết kế. Nó có 33 công cụ riêng: viết BOM (submit_bom), xác nhận các linh kiện nó đã kiểm tra (confirm_parts), viết phần nối dây (submit_netlist), vẽ các trang sơ đồ (submit_blocks) và đẩy netlist lên board (update_pcb). Qua call_tool, nó dùng được các công cụ thiết kế mà Copilot của WireFrame dùng — bộ đặt linh kiện, bộ tối ưu layout, các giai đoạn của router, đổ đồng, bộ giải toàn vẹn nguồn và tín hiệu, phép kiểm tra board: 117 công cụ trên một project có cả sơ đồ và board đang mở. Phần suy luận là của agent; phép đo và phép kiểm tra là của WireFrame, từ cùng đoạn mã trả lời khung Copilot.
Nó giao cho Penalty những việc có giới hạn rõ. ask_penalty giao cho agent của WireFrame một việc — tìm ứng viên cho một linh kiện, phác symbol từ datasheet, review những gì agent của bạn đã viết — còn run_command chạy một lệnh gạch chéo như /layout place,route. Câu trả lời kết thúc bằng những gì WireFrame đo được là Penalty đã thay đổi, theo từng linh kiện và từng net.
Nó biết khi nào xong. design_status trả về ERC, các phép kiểm tra board, kết nối còn hở, toàn vẹn tín hiệu và khả năng sản xuất trong một câu trả lời, kèm done và những gì còn lại. Công cụ chạy lâu, như đề xuất layout hay phân tích nhiệt, chạy thành một job khi vượt quá thời gian một lệnh gọi; job_status trả kết quả, stop huỷ nó.
Những điều bạn có thể hỏi bằng lời thường:
| Hỏi agent |
Công cụ trả lời |
| "Đây là yêu cầu: chọn linh kiện và nối dây" |
read_guide → submit_bom → confirm_parts → submit_netlist |
| "Thử bốn cách đặt linh kiện, giữ cách đi dây tốt nhất" |
evaluate_layouts → apply_layout |
| "Tìm chỗ rail 3V3 bị sụt áp" |
power_setup_rail → power_run_ir_drop → power_suggest_fixes |
| "Kiểm tra board trước khi gửi nhà mạch" |
check_board, check_manufacturing |
Nói rõ điều bạn muốn trước khi agent bắt đầu. Ở những chỗ công cụ thiết kế ghi là phải hỏi người dùng — số lớp đồng, tách sản phẩm thành nhiều board — agent mà bạn giao quyền chỉ huy sẽ tự quyết. Nếu bạn đã có sẵn số lớp hay kích thước board, hãy ghi vào yêu cầu.
Điều gì phải chờ bạn, và agent không làm được gì?
- Làm trên bản sao trước. Mọi công cụ sẽ dời linh kiện, đặt đồng hay sửa luật đều làm trên một bản sao và báo nó sẽ làm gì (
propose_layout, evaluate_layouts, preview_patch, power_preview_fix). Thay đổi chỉ tới board qua một bước áp dụng, như apply_layout; checkpoint_board giữ một bản sao có tên mà restore_board đặt lại được.
- Bản sửa tốc độ cao và bản sửa nguồn chờ người duyệt.
apply_approved_patch và power_apply_approved_fix chỉ áp dụng những gì bạn đã duyệt trong cửa sổ của chính WireFrame.
- Các phép kiểm tra vẫn giữ nguyên.
confirm_parts từ chối linh kiện không qua kiểm tra, như nút Confirm của bạn; edit_schematic từ chối chỉnh sửa gây ra lỗi. Mỗi thay đổi là một bước undo, ghi tên client đã làm nó.
- Không làm qua MCP: xuất Gerber (làm trong ứng dụng), đóng project còn thay đổi chưa lưu, hay cho client thứ hai kết nối cùng lúc.
"Xong" nghĩa là các phép kiểm tra đều qua. Nhiệt, nhiễu và một lượt review độc lập vẫn phải làm, và bạn kiểm tra file trước khi đặt mạch.
Cái gì được tính lượt, cái gì miễn phí?
Bạn trả cho thay đổi, không trả cho việc xem.
| Việc xảy ra |
Lượt MCP |
| Một thay đổi trên thiết kế: BOM, nối dây, trang sơ đồ, layout được áp dụng, vùng đồng được sửa |
1 |
ask_penalty, run_command, build_blocks |
1, cộng credit AI mà lượt làm việc của Penalty tiêu |
| Đọc, kiểm tra, phân tích, layout thử mà không áp dụng |
0 |
| Kết nối, liệt kê công cụ, đọc hướng dẫn, lệnh gọi bị từ chối |
0 |
Phần suy luận của chính agent không tiêu credit AI nào của WireFrame. Gói Pro có 500 lượt mỗi tháng, sau đó dùng gói MCP bổ sung (7.999 lượt, hiệu lực mười hai tháng); gói Max không có trần hằng tháng, theo giới hạn sử dụng hợp lý trong Điều khoản. Giá: trang bảng giá.
Thiết kế của bạn đi đâu?
Cầu nối nói chuyện với WireFrame qua một local socket trong thư mục người dùng của bạn; không mở cổng mạng nào. Công cụ đọc project từ ổ đĩa của bạn và trả lời agent; agent làm gì với câu trả lời là chuyện giữa bạn và nhà cung cấp agent. Riêng với MCP, WireFrame chỉ gửi về tài khoản của bạn số lượt đã dùng và tên agent đã dùng chúng.
Nếu agent không kết nối được, nó nhắc lại đúng lời của WireFrame; hướng dẫn giải thích từng câu, kèm cách xử lý, ở mục When it does not connect.
Đọc tiếp: MCP server · mỗi công cụ làm gì · tra cứu công cụ MCP · những gì chờ bạn duyệt · Tải WireFrame EDA