Hướng Dẫn Cài Đặt AutoCAD MCP (Bản Trọn Gói)

1. Yêu cầu

Windows 10/11
Có kết nối Internet
Không cần quyền Admin
AutoCAD LT 2024+ (hoặc AutoCAD bản đầy đủ — bản đầy đủ luôn hỗ trợ AutoLISP)
winget có sẵn (mặc định có trên Windows 10 22H2+/Windows 11; nếu thiếu, cập nhật "App Installer" từ Microsoft Store)

2. Cách chạy

Tải file install-autocad-mcp-full.bat
Double-click để chạy (cửa sổ Command Prompt màu đen sẽ mở ra)
Làm theo hướng dẫn trên màn hình

⚠️ Nếu ở bước cài Python, Git hoặc uv, cửa sổ báo "Hãy đóng cửa sổ này và chạy lại file" — hãy đóng cửa sổ và double-click chạy lại file lần nữa. Đây là điều bình thường: sau khi cài xong 1 công cụ, cần mở phiên Command Prompt mới để nhận đường dẫn (PATH) mới.

3. File này tự làm gì

Bước	Nội dung
1/6	Kiểm tra `winget`
2/6	Cài Python 3.12 (nếu chưa có) — `--scope user`, không cần Admin
3/6	Cài Git (nếu chưa có)
4/6	Cài `uv` — trình quản lý gói Python (nếu chưa có)
5/6	`git clone` repo `autocad-mcp` vào `C:\MCP\autocad-mcp`, rồi `uv sync` để cài thư viện
6/6	Tạo AutoCAD Bundle tự nạp LISP + tự cập nhật `claude_desktop_config.json`

Chạy lại file bao nhiêu lần cũng an toàn (không cài đè, không hỏng cấu hình cũ — các bước đều tự kiểm tra trước khi làm).

4. Bước 6 — Auto-load LISP là gì

Trước đây phải mở AutoCAD, gõ APPLOAD (hoặc NETLOAD), rồi chọn tay 2 file:

mcp_dispatch.lsp
attribute_tools.lsp

và phải lặp lại mỗi lần mở AutoCAD / mở bản vẽ mới.

File cài đặt này tạo sẵn một AutoCAD Application Bundle tại:

%APPDATA%\Autodesk\ApplicationPlugins\AutoCAD_MCP.bundle\

AutoCAD tự động quét thư mục này mỗi khi khởi động và mỗi khi mở bản vẽ mới, tự nạp 2 file LISP ở trên (đọc trực tiếp từ C:\MCP\autocad-mcp\lisp-code\) — không cần làm gì thêm trong AutoCAD nữa.

5. Kiểm tra sau khi cài

Trong AutoCAD (đóng và mở lại AutoCAD sau khi cài):

Xem dòng lệnh (command line) có xuất hiện:

=== MCP Dispatch v3.1 loaded ===
Attribute tools loaded successfully

Trong Claude Desktop (đóng và mở lại):

Vào Settings → Developer → MCP Servers
Phải thấy mục autocad-mcp
Thử hỏi Claude: "Can you help me with AutoCAD?" hoặc yêu cầu vẽ 1 đường thẳng để kiểm tra kết nối thực tế

6. Vị trí các file quan trọng

Thành phần	Đường dẫn
Mã nguồn + Python venv	`C:\MCP\autocad-mcp\`
AutoCAD auto-load bundle	`%APPDATA%\Autodesk\ApplicationPlugins\AutoCAD_MCP.bundle\`
Cấu hình Claude Desktop	`%APPDATA%\Claude\claude_desktop_config.json`

7. Khắc phục sự cố

Lỗi	Cách xử lý
"Khong tim thay winget"	Cập nhật App Installer từ Microsoft Store, chạy lại file
"command not found" sau khi cài Python/Git/uv	Đóng hết cửa sổ Command Prompt đang mở, mở lại, chạy lại file
Clone repository thất bại	Kiểm tra Internet / VPN / firewall công ty có chặn GitHub không
`uv sync` thất bại	Chạy lại file; nếu vẫn lỗi, mở `C:\MCP\autocad-mcp` bằng cmd và chạy tay `uv sync` để xem chi tiết lỗi
Mở AutoCAD không thấy dòng "MCP Dispatch v3.1 loaded"	Kiểm tra đã đóng hẳn và mở lại AutoCAD chưa (bundle chỉ nạp lúc khởi động). Kiểm tra thư mục `...\AutoCAD_MCP.bundle\Contents\MCPLoader.lsp` có tồn tại không
AutoCAD hỏi hộp thoại bảo mật khi nạp LISP	Bình thường có thể xảy ra lần đầu; bundle đã tự thêm `C:\MCP\autocad-mcp\lisp-code` vào `TRUSTEDPATHS`, các lần mở sau sẽ không hỏi lại
Claude Desktop không thấy `autocad-mcp`	Kiểm tra đã đóng hoàn toàn Claude Desktop (kể cả icon dưới khay hệ thống) rồi mở lại chưa

8. Gỡ cài đặt (nếu cần)

Xoá thư mục: C:\MCP\autocad-mcp
Xoá thư mục bundle: %APPDATA%\Autodesk\ApplicationPlugins\AutoCAD_MCP.bundle
Xoá mục "autocad-mcp" trong %APPDATA%\Claude\claude_desktop_config.json