Dùng Claude MCP để vẽ chi tiết máy hoàn chỉnh trong AutoCAD

Chương 1

Giới thiệu: MCP là gì và vì sao Claude vẽ được AutoCAD

1.1. MCP (Model Context Protocol) là gì?

MCP (Model Context Protocol) là một chuẩn mở do Anthropic công bố vào cuối năm 2024. Nó định nghĩa cách một mô hình AI kết nối với các công cụ và nguồn dữ liệu bên ngoài — giống như cách USB định nghĩa một chuẩn cắm chung cho mọi thiết bị.

Trong hệ MCP có hai phía:

• MCP server: chương trình chạy trên máy của bạn, cung cấp một danh sách tools (công cụ) mà AI có thể gọi — ví dụ tool "vẽ đường tròn", tool "tạo layer", tool "chèn block".
• MCP client: ứng dụng chứa AI — ở đây là Claude Desktop. Khi bạn chat, Claude đọc danh sách tools của server, quyết định gọi tool nào, với tham số gì, và server thực thi lệnh đó trong phần mềm thật.

Hiểu đơn giản: MCP cho Claude một "kênh lệnh" vào phần mềm. Claude không tự vẽ bằng chuột — nó gọi các tool theo đúng thứ tự, và phần mềm đích (AutoCAD) mới là nơi bản vẽ thật sự thay đổi.

1.2. Vì sao dùng Claude + AutoCAD?

Cách làm việc thay đổi tận gốc: thay vì tự tay gõ lệnh LINE, CIRCLE, RECTANGLE hàng trăm lần, bạn mô tả kết quả bằng lời và Claude điều khiển AutoCAD vẽ. Cách này mạnh nhất ở những việc có ba đặc điểm:

• Lặp đi lặp lại: vẽ lưới lỗ bu-lông 8×12, hàng cột cách đều nhau, 40 block thiết bị xếp theo dây chuyền.
• Tốn thời gian nhưng dễ mô tả: dọn layer lộn xộn về đúng quy ước, đánh số thiết bị hàng loạt, ghi chú giống nhau cho nhiều chi tiết.
• Có quy luật rõ ràng: mọi kích thước, khoảng cách, tên gọi đều nói được bằng câu chữ và con số cụ thể.

Ngược lại, việc cần cảm nhận hình khối, phán đoán kỹ thuật hay đọc bản vẽ giấy thì vẫn là việc của kỹ sư. Claude qua MCP là một "tay vẽ" cực nhanh và không biết mệt — nhưng nó vẽ đúng những gì bạn mô tả, kể cả khi bạn mô tả sai. Chương 9 sẽ nói kỹ về giới hạn này.

1.3. Phân biệt quan trọng: MCP chính chủ của Autodesk KHÔNG vẽ được

Đây là điểm rất nhiều người nhầm. Khi tìm "AutoCAD MCP" bạn sẽ gặp hai loại server hoàn toàn khác nhau:

• MCP chính chủ của Autodesk (Product Help MCP Server): chỉ cho Claude đọc tài liệu help của các sản phẩm Autodesk để trả lời câu hỏi kiểu "lệnh này dùng thế nào". Nó không chạm vào bản vẽ, không vẽ được bất cứ thứ gì.
• MCP cộng đồng (ở đây là multiCAD-mcp): điều khiển AutoCAD thật qua COM/AutoLISP, có tools vẽ, sửa, ghi kích thước, xuất bản vẽ. Đây mới là thứ hướng dẫn này dùng.

Chương 2

Chuẩn bị: máy, phần mềm và kiến thức nền

Trước khi cài đặt, hãy kiểm tra đủ 5 mục dưới đây. Thiếu một mục, quá trình cài ở Chương 3 sẽ dừng giữa chừng — thường là ở đúng bước khó gỡ nhất.

Kiểm tra nhanh trước khi sang Chương 3

• Mở PowerShell, gõ py --version — phải hiện Python 3.10 trở lên. Nếu chưa có, cài Python từ python.org và nhớ tick ô Add python.exe to PATH khi cài.
• Mở AutoCAD, tạo một bản vẽ mới trống — AutoCAD phải chạy ổn định, không báo lỗi license.
• Mở Claude Desktop và đăng nhập thành công, chat thử một câu bất kỳ.
• Chọn sẵn một thư mục cố định để chứa mã nguồn MCP server, ví dụ C:\CAD\. Đường dẫn này sẽ xuất hiện trong file config ở Chương 3 — chọn đường dẫn ngắn, không dấu tiếng Việt, không khoảng trắng để tránh lỗi không đáng có.

Chương 3

Cài đặt từng bước với multiCAD-mcp

Làm đúng thứ tự 5 bước dưới đây. Sau mỗi bước đều có khung Kết quả mong đợi — nếu chưa thấy đúng dấu hiệu đó thì dừng lại xử lý ngay, đừng làm tiếp, vì các bước sau đều dựa trên bước trước.

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

cd C:\CAD
git clone https://github.com/AnCode666/multiCAD-mcp.git
cd multiCAD-mcp
uv sync --dev
uv run python -m pip install --upgrade pywin32

py -m venv .venv
.venv\Scripts\Activate.ps1
pip install -r requirements.txt
py -m pip install --upgrade pywin32

C:\Users\<tên-user>\AppData\Roaming\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "multiCAD": {
      "command": "C:\\CAD\\multiCAD-mcp\\.venv\\Scripts\\python.exe",
      "args": ["C:\\CAD\\multiCAD-mcp\\src\\server.py"]
    }
  }
}

Chương 4

Cơ bản: vẽ hình, layer, di chuyển và copy

Chương này dạy bạn "ngữ pháp" tối thiểu khi ra lệnh cho Claude: nêu rõ đối tượng gì, ở đâu, kích thước bao nhiêu, thuộc tính gì. Câu chat càng đủ bốn yếu tố này, kết quả càng đúng ngay lần đầu.

4.1. Vẽ hình cơ bản

Đằng sau hai câu chat này, Claude lần lượt gọi tool tương ứng với lệnh CIRCLE và LINE của AutoCAD, điền tọa độ và bán kính bạn đã nêu. Các hình quen thuộc khác — RECTANGLE, ARC, POLYLINE — cũng ra lệnh theo đúng mẫu câu trên: tên hình + tọa độ + kích thước.

4.2. Quản lý layer

Layer là cách AutoCAD phân loại đối tượng theo chức năng (nét chính, nét đứt, đường tâm, kích thước...). Ra lệnh cho Claude quản lý layer cũng bằng câu chữ thường:

Claude sẽ tạo layer mới với màu chỉ định, rồi quét bản vẽ, chọn mọi đường tròn và đổi thuộc tính layer của chúng. Việc này làm tay rất chán khi bản vẽ có hàng trăm đối tượng — đúng kiểu việc MCP làm tốt nhất.

4.3. Di chuyển và copy hàng loạt

Lưu ý cách diễn đạt: nói rõ số bản copy, khoảng cách và hướng/trục. Với "di chuyển tất cả", Claude hiểu là toàn bộ đối tượng trong bản vẽ — hãy chắc chắn đó đúng là ý bạn trước khi bấm Allow for This Chat.

Chương 5

Trung cấp: block, attribute, dimension và dimstyle

Đây là chương bước ngoặt: từ "vẽ từng nét" lên "lắp ráp từ linh kiện chuẩn". Block là nền tảng của mọi bản vẽ chuyên nghiệp — và là nền tảng cho thư viện riêng ở Chương 7.

5.1. Tạo block từ đối tượng có sẵn

Vẽ một đối tượng mẫu một lần (ví dụ mặt bằng một lò nung), chọn nó trong AutoCAD, rồi ra lệnh:

Đằng sau, Claude chạy quy trình tương đương lệnh BLOCK: gom các đối tượng đã chọn thành một định nghĩa block duy nhất. Base point (điểm gốc chèn) là điểm "tay cầm" của block — khi chèn, block sẽ bám vào con trỏ tại đúng điểm này. Chọn base point tại tâm (với vật tròn/xoay) hoặc tại một góc chuẩn (với vật chữ nhật) sẽ giúp việc đặt block sau này chính xác và dễ đoán.

5.2. Chèn block hàng loạt bằng lệnh INSERT

Mỗi lần chèn (tương đương lệnh INSERT) chỉ tạo một tham chiếu tới định nghĩa block — bản vẽ không nặng thêm bao nhiêu dù bạn chèn 3 hay 300 block. Đây là khác biệt cốt lõi giữa block và copy: copy nhân bản hình học, block nhân bản tham chiếu.

5.3. Đọc và ghi block attribute

Attribute là dữ liệu chữ gắn trong block: tên máy, mã thiết bị, công suất... Mỗi lần chèn một block, các giá trị này có thể khác nhau dù hình học giống hệt. Với Claude, việc đọc/ghi attribute là việc giao tiếp hai chiều rất đáng giá:

5.4. Dimension và ghi chú — ghi kích thước, ghi chữ

Dimension qua MCP tương ứng với họ lệnh DIMLINEAR, DIMDIAMETER, DIMRADIUS... của AutoCAD: Claude chọn hai điểm đo, đặt đường kích thước và AutoCAD tự tính con số. Ghi chú文字 là đối tượng text thường — dùng cho vật liệu, yêu cầu kỹ thuật, tiêu đề hình vẽ.

5.5. Dimstyle — thiết lập kiểu kích thước một lần, dùng mãi

Dimstyle quy định toàn bộ diện mạo của dimension: kiểu mũi tên, cỡ chữ số, khoảng cách đường dóng, đơn vị (mm), số lẻ thập phân. Nếu không thiết lập, mỗi dimension Claude tạo ra sẽ theo style mặc định — thường sai chuẩn trình bày của bản vẽ kỹ thuật Việt Nam.

Chương 6

Nâng cao: vẽ chi tiết trục (shaft) hoàn chỉnh

Đây là bài tập xuyên suốt của hướng dẫn: dùng mọi kỹ năng đã học để vẽ một chi tiết trục bậc hoàn chỉnh — đúng việc bạn sẽ làm thật ngoài công việc. Thông số chi tiết mẫu:

Chương 7

Xây dựng thư viện block riêng: tạo một lần, dùng mãi

Vẽ một cái máy mất một buổi; biến nó thành block chuẩn trong thư viện thì lần sau Claude đặt nó vào bất kỳ bản vẽ nào chỉ bằng một câu chat. Chương này là phần "đầu tư" — làm kỹ một lần, hưởng lợi mọi dự án về sau, đặc biệt là các dự án lớn như bố trí dây chuyền sản xuất với hàng chục thiết bị lặp lại.

7.1. Cách tạo một block chuẩn

Một block gọi là "chuẩn" khi nó thỏa bốn tiêu chí:

• Tên theo quy ước — nhìn tên biết ngay loại thiết bị và số thứ tự (xem mục 7.4). Không đặt tên kiểu Block1, may moi, final2.
• Base point hợp lý — đặt tại tâm (thiết bị tròn/xoay) hoặc góc chuẩn dưới–trái (thiết bị chữ nhật). Base point là điểm bạn sẽ dùng để định vị khi chèn; đặt tùy tiện thì mỗi lần chèn là một lần đoán.
• Hình học sạch — vẽ trên layer 0 để block kế thừa màu/layer của nơi nó được chèn vào; không để sót đường thừa, điểm lạc, đối tượng trùng nhau.
• Attribute đầy đủ — tối thiểu có mã, tên và thông số chính (công suất). Attribute là phần "dữ liệu" giúp Claude tìm, lọc và thống kê thiết bị trong bản vẽ.

Quy trình thực tế: vẽ thiết bị mẫu trong một bản vẽ nháp → dọn sạch → ra lệnh cho Claude tạo block theo Chương 5 → kiểm tra base point và attribute → lưu vào thư viện theo mục 7.2.

7.2. Tổ chức thư viện: một folder tập trung, mỗi loại máy một file DWG

Cách tổ chức bền vững nhất: mỗi loại máy là một file DWG riêng (trong file đó vẽ 1 block chuẩn của máy), tất cả nằm trong một folder tập trung duy nhất, chia thư mục con theo nhóm thiết bị:

D:\ThuVienBlock\
└── MayMoc\
    ├── LO_NUNG_01.dwg
    ├── MAY_CAN_02.dwg
    ├── BANG_TAI_03.dwg
    └── CAU_TRUC_01.dwg

Cách khác: gom block vào Tool Palette của AutoCAD để kéo–thả bằng chuột. Tool Palette tiện khi bạn tự vẽ tay; còn khi làm việc qua Claude + MCP, thư viện dạng file DWG trong folder rõ ràng sẽ dễ ra lệnh bằng câu chữ hơn ("chèn block từ file MAY_CAN_02.dwg trong thư viện").

7.3. Quản lý hiệu quả, không tốn tài nguyên

• Ưu tiên XREF cho thiết bị lớn/lặp lại nhiều: bản vẽ layout chỉ chứa link tham chiếu tới file thư viện, nên dung lượng nhỏ, mở và lưu nhanh; khi nhà cung cấp đổi model máy, bạn chỉ sửa file trong thư viện.
• Thư viện tập trung một folder duy nhất: dễ backup, dễ chuyển máy, dễ chỉ cho Claude đúng đường dẫn. Tuyệt đối tránh block nằm rải rác trong hàng chục bản vẽ dự án khác nhau — đó là cách thư viện "chết" nhanh nhất.
• Không nhồi nhét chi tiết thừa vào block thư viện: block mặt bằng thiết bị chỉ cần biên dạng, vị trí đấu nối và attribute chính. Chi tiết bu-lông, mối hàn thuộc về bản vẽ chế tạo, không thuộc block layout.

7.4. Gọi Claude dùng block trong thư viện qua MCP

Khi thư viện đã có, câu chat mẫu điển hình:

7.5. Quy ước đặt tên cho dự án lớn

Với dự án cỡ dây chuyền sản xuất thép — hàng chục loại thiết bị, nhiều bản vẽ, nhiều người cùng làm — quy ước đặt tên không còn là "nên có" mà là bắt buộc. Mẫu quy ước dùng nhất quán cho cả tên block, tên file DWG và attribute MA:

TIEN_TO_LOAI_MA
Ví dụ:  LO_NUNG_01    (lò nung số 1)
        MAY_CAN_02    (máy cán số 2)
        BANG_TAI_03   (băng tải số 3)

Ba attribute bắt buộc có trong mọi block của dự án:

Nhờ ba attribute này, Claude có thể trả lời các câu hỏi thống kê ngay trên bản vẽ: "tổng công suất các máy cán", "liệt kê thiết bị chưa có CONG_SUAT" — việc mà đọc bằng mắt trên layout lớn là gần như không thể.

7.6. Backup và quản lý phiên bản

• Backup theo ngày: nén toàn bộ folder D:\ThuVienBlock\ thành file ZIP kèm ngày tháng (ví dụ ThuVienBlock_2026-10-19.zip) và cất ở một nơi khác — ổ cứng ngoài hoặc cloud. Thư viện tích lũy nhiều tháng công sức, mất là làm lại từ đầu.
• Git cho file DWG — dùng được nhưng phải hiểu giới hạn: DWG là file nhị phân, Git không hiển thị được diff nội dung và kho Git sẽ phình nhanh theo số phiên bản. Nếu dùng Git, chỉ commit khi block thay đổi thật, kèm commit message ghi rõ "sửa gì" (ví dụ: "MAY_CAN_02: đổi base point về tâm, thêm attribute CONG_SUAT") — vì bạn không xem lại được diff, message chính là nhật ký thay đổi duy nhất.
• Không bao giờ sửa thẳng file thư viện khi đang vội: mở file, lưu một bản sao có hậu tố ngày, sửa trên bản sao, kiểm tra xong mới thay thế file chuẩn.

Chương 8

Đóng gói thành LISP chạy local: Claude viết một lần, bạn dùng mãi không tốn token

MCP rất mạnh cho việc mới và việc khó — nhưng nếu ngày nào bạn cũng nhờ Claude làm đúng một việc cũ, bạn đang trả tiền token cho cùng một logic hết lần này đến lần khác. Chương này dạy cách thoát khỏi vòng lặp đó: nhờ Claude viết một lần thành file AutoLISP (.lsp), nạp vào AutoCAD, và từ đó chạy local mãi mãi — không cần mở Claude, không cần mạng, 0 token.

8.1. Vấn đề: mỗi lần vẽ qua MCP là một lần tốn token

Mỗi câu chat qua MCP đều tốn token ở cả hai chiều:

• Token chiều vào (input): câu lệnh của bạn cộng với toàn bộ ngữ cảnh hội thoại và danh sách tools của MCP server mà Claude phải "đọc lại" để biết mình có công cụ gì. Hội thoại càng dài, phần này càng phình.
• Token chiều ra (output): chuỗi tool call Claude sinh ra để vẽ — một việc vẽ lặp 50 đối tượng có thể là hàng chục tool call nối tiếp nhau.

Với việc làm một lần (thiết kế mới, xử lý tình huống lạ) thì chi phí đó xứng đáng. Nhưng với việc lặp đi lặp lại y hệt — vẽ dãy lỗ bu-lông, vẽ mặt bích, đánh số thiết bị — thì mỗi lần chạy lại là một lần trả tiền cho cùng một bài toán đã giải xong. Chưa kể tốc độ: mỗi lần phải chờ Claude suy luận và qua lại nhiều vòng chat, trong khi bản chất việc đó chỉ cần vài mili-giây tính toán.

8.2. Vì sao chọn AutoLISP làm đường đóng gói chính

AutoLISP là ngôn ngữ lập trình tích hợp sẵn trong AutoCAD từ hàng chục năm nay. Một chương trình AutoLISP là một file văn bản thuần đuôi .lsp — mở bằng Notepad cũng đọc được. Ba lý do khiến chương này đặt LISP lên hàng đầu, trước mọi lựa chọn khác:

• Chạy được cả trên AutoCAD LT 2024 trở lên (bản Windows). Đây là điểm nhiều người không biết: từ phiên bản 2024, bản LT — vốn bị cắt gần hết khả năng tự động hóa — đã hỗ trợ AutoLISP. Nghĩa là máy chỉ có LT vẫn chạy được mọi ví dụ trong chương này, dù không dùng được MCP server loại .NET như Chương 2–3.
• Không cần compile. Viết xong là chạy: nạp file vào AutoCAD là lệnh có hiệu lực ngay. Không Visual Studio, không build, không phiên bản .NET phải khớp.
• Dễ sửa. Muốn đổi đường kính mặc định, thêm một câu hỏi nhập liệu, sửa một con số — mở file text, sửa đúng dòng đó, nạp lại. Chính vì code ngắn và đọc được, bạn cũng kiểm chứng được Claude đã viết gì trước khi cho nó chạy trên bản vẽ thật.

Nguyên tắc phân vai: Claude là người viết code, AutoCAD là nơi chạy code. Việc của bạn chuyển từ "ra lệnh vẽ từng lần" sang "mô tả quy trình một lần cho rõ" — mục tiếp theo chỉ cách mô tả đó.

8.3. Cách nhờ Claude viết LISP: mô tả một lần cho rõ

Khác với chat vẽ trực tiếp (nơi bạn có thể nói thiếu rồi bổ sung), code LISP sẽ chạy không có Claude bên cạnh để hỏi lại. Vì vậy câu yêu cầu viết code phải đủ năm thứ: tên lệnh, dữ liệu nhập, hình học đầu ra, đơn vị/layer, và yêu cầu code hoàn chỉnh. Mẫu câu chat dùng lại được cho mọi việc:

• Nói rõ tên lệnh (viết hoa, ngắn, không trùng lệnh gốc của AutoCAD) — đây là từ bạn sẽ gõ mỗi lần chạy.
• Liệt kê từng dữ liệu nhập theo đúng thứ tự bạn muốn bị hỏi. LISP hỏi gì là do bạn định trước, không có chuyện "tự hiểu".
• Yêu cầu "code hoàn chỉnh, chạy độc lập" để Claude không viết tắt kiểu "phần còn lại tương tự" — căn bệnh phổ biến khi nhờ AI viết code dài.
• Bảo Claude viết comment và chuỗi thông báo không dấu (ví dụ "Da nap lenh") nếu bạn lưu file bằng Notepad với encoding mặc định — chữ tiếng Việt có dấu trong file .lsp lưu sai encoding sẽ thành ký tự rác khi AutoCAD đọc.

8.4. Nạp file bằng APPLOAD và gọi lệnh

Nhận code từ Claude xong, quy trình cố định bốn bước — áp dụng giống hệt cho mọi file .lsp về sau:

1. Lưu file: dán code vào Notepad hoặc VS Code, lưu với tên đúng như đã thống nhất (ví dụ BOLTPAT.lsp) vào thư mục thư viện (mục 8.10). Nếu dùng Notepad, ở hộp thoại lưu hãy chọn Save as type: All Files để file không bị thêm đuôi .txt thành BOLTPAT.lsp.txt.
2. Nạp vào AutoCAD: gõ lệnh APPLOAD → trong hộp thoại Load/Unload Applications, duyệt tới file .lsp → bấm Load → bấm Close.
3. Kiểm tra dòng thông báo: dòng lệnh (Command line) phải hiện câu thông báo ở cuối file, dạng Da nap xong BOLTPAT.LSP - go lenh BOLTPAT de chay. Thấy dòng này là nạp thành công; không thấy nghĩa là code có lỗi cú pháp — copy thông báo lỗi ở Command line gửi lại cho Claude sửa.
4. Gọi lệnh: gõ tên lệnh (BOLTPAT) → Enter → trả lời lần lượt các câu hỏi trên Command line → xem kết quả.

Muốn lệnh tự có mặt mỗi lần mở AutoCAD: mở APPLOAD → ở mục Startup Suite bấm Contents... → Add... → chọn các file .lsp của bạn. Từ đó mỗi bản vẽ mở lên là các lệnh đã nạp sẵn, không cần APPLOAD lại.

8.5. Ví dụ 1 — BOLTPAT: vẽ dãy lỗ bu-lông thẳng hàng

Việc kinh điển nhất của cơ khí và layout: một dãy lỗ cách đều nhau trên thanh giằng, ray đỡ, bản mã. Qua MCP, mỗi lần vẽ là một lần chat và tốn token; đóng gói thành LISP thì gõ một lệnh, trả lời bốn câu hỏi, xong.

;;; ============================================================
;;; BOLTPAT.LSP - Ve day lo bu-long thang hang theo truc X
;;; Lenh: BOLTPAT
;;; Nhap: so lo, khoang cach tam hai lo lien tiep,
;;;       duong kinh lo, diem bat dau (tam lo dau tien)
;;; Don vi: mm. Lo duoc ve tren layer hien hanh.
;;; ============================================================
(defun c:BOLTPAT (/ n kc dk p0 i pt)
  (setq n  (getint  "\nSo lo: "))
  (setq kc (getdist "\nKhoang cach giua 2 lo lien tiep (mm): "))
  (setq dk (getdist "\nDuong kinh lo (mm): "))
  (setq p0 (getpoint "\nChon tam lo dau tien: "))
  (if (and n kc dk p0 (> n 0))
    (progn
      (setq i 0)
      (repeat n
        (setq pt (list (+ (car p0) (* i kc)) (cadr p0) 0.0))
        (entmake
          (list
            '(0 . "CIRCLE")
            (cons 10 pt)
            (cons 40 (/ dk 2.0))
          )
        )
        (setq i (1+ i))
      )
      (princ (strcat "\nDa ve " (itoa n) " lo."))
    )
    (princ "\nChua du thong so - chua ve gi.")
  )
  (princ)
)
(princ "\nDa nap xong BOLTPAT.LSP - go lenh BOLTPAT de chay.")
(princ)

Đọc nhanh cấu trúc để thấy LISP không hề đáng sợ: defun c:BOLTPAT khai báo lệnh tên BOLTPAT; bốn lệnh getint / getdist / getpoint là bốn câu hỏi hiện trên Command line; vòng repeat lặp đúng số lỗ, mỗi vòng dùng entmake tạo một đối tượng CIRCLE tại tọa độ x tăng dần. Toàn bộ "trí tuệ" của việc vẽ dãy lỗ chỉ có vậy — và nó chạy lại chính xác như thế ở mọi lần sau.

8.6. Ví dụ 2 — FLANGE: vẽ mặt bích tròn với vòng lỗ chia đều

Nâng độ khó lên một nấc: lỗ không nằm trên đường thẳng mà chia đều trên một vòng tròn (đường kính vòng chia PCD — Pitch Circle Diameter), cộng thêm vòng ngoài và lỗ trong của mặt bích. Đây là chi tiết xuất hiện khắp nơi trong đường ống và thiết bị của nhà máy. LISP xử lý bằng hàm polar — tính tọa độ điểm theo góc và khoảng cách, việc mà bảo Claude tính tay qua chat là dễ sai nhất.

;;; ============================================================
;;; FLANGE.LSP - Ve mat bich tron + lo bu-long chia deu tren PCD
;;; Lenh: FLANGE
;;; Nhap: tam mat bich, D ngoai, D lo trong, D vong chia (PCD),
;;;       so lo, duong kinh 1 lo. Don vi: mm.
;;; ============================================================
(defun c:FLANGE (/ ctr dout din pcd n dl i ang pt)
  (setq ctr  (getpoint "\nChon tam mat bich: "))
  (setq dout (getdist ctr "\nDuong kinh ngoai (mm): "))
  (setq din  (getdist ctr "\nDuong kinh lo trong (mm): "))
  (setq pcd  (getdist ctr "\nDuong kinh vong chia PCD (mm): "))
  (setq n    (getint  "\nSo lo bu-long: "))
  (setq dl   (getdist ctr "\nDuong kinh 1 lo (mm): "))
  (if (and ctr dout din pcd n dl (> n 0))
    (progn
      ;; Vong ngoai va lo trong
      (entmake (list '(0 . "CIRCLE") (cons 10 ctr) (cons 40 (/ dout 2.0))))
      (entmake (list '(0 . "CIRCLE") (cons 10 ctr) (cons 40 (/ din 2.0))))
      ;; Cac lo bu-long chia deu tren vong PCD
      (setq i 0)
      (repeat n
        (setq ang (* i (/ (* 2.0 pi) n)))
        (setq pt (polar ctr ang (/ pcd 2.0)))
        (entmake (list '(0 . "CIRCLE") (cons 10 pt) (cons 40 (/ dl 2.0))))
        (setq i (1+ i))
      )
      (princ (strcat "\nDa ve mat bich " (itoa n) " lo."))
    )
    (princ "\nChua du thong so - chua ve gi.")
  )
  (princ)
)
(princ "\nDa nap xong FLANGE.LSP - go lenh FLANGE de chay.")
(princ)

Thử ngay với bộ số của một mặt bích quen thuộc: D ngoài 220, lỗ trong 110, PCD 180, 8 lỗ Ø18. Chạy xong, dùng lệnh DIST đo khoảng cách từ tâm tới một tâm lỗ bất kỳ — phải đúng 90 (bán kính PCD) ở mọi lỗ. Đó là độ chính xác mà vẽ tay bằng lệnh ARRAYPOLAR lặp lại nhiều lần khó giữ được đều như vậy.

8.7. Ví dụ 3 — TAGNUM: đánh số nhãn thiết bị tăng dần bằng click

Ví dụ thứ ba thuộc nhóm "việc nhỏ mà ngày nào cũng gặp": gắn nhãn mã thiết bị lên layout. Gõ tay từng nhãn TB-01, TB-02... vừa chậm vừa dễ trùng số. LISP dưới đây hỏi tiền tố và số bắt đầu một lần, sau đó bạn chỉ việc click — mỗi click ra một nhãn, số tự tăng, Enter để dừng. Dùng chung với quy ước attribute MA ở Chương 7 là layout của bạn luôn nhất quán.

;;; ============================================================
;;; TAGNUM.LSP - Danh so nhan thiet bi tang dan tai diem click
;;; Lenh: TAGNUM
;;; Nhap: tien to (vd TB-), so bat dau, chieu cao chu.
;;; Sau do click tung vi tri de dat nhan, Enter de ket thuc.
;;; Nhan duoc can giua tai diem click.
;;; ============================================================
(defun c:TAGNUM (/ prefix start h pt txt)
  (setq prefix (getstring T "\nTien to (vd TB-): "))
  (setq start  (getint "\nSo bat dau: "))
  (setq h      (getdist "\nChieu cao chu (mm): "))
  (if (and prefix start h)
    (while
      (setq pt
        (getpoint
          (strcat "\nClick vi tri dat nhan "
                  prefix (itoa start) " (Enter de dung): ")))
      (setq txt (strcat prefix (itoa start)))
      (entmake
        (list
          '(0 . "TEXT")
          (cons 10 pt)
          (cons 40 h)
          (cons 1 txt)
          (cons 72 1)   ; can giua theo chieu ngang
          (cons 73 2)   ; can giua theo chieu doc
          (cons 11 pt)
        )
      )
      (setq start (1+ start))
    )
  )
  (princ)
)
(princ "\nDa nap xong TAGNUM.LSP - go lenh TAGNUM de chay.")
(princ)

8.8. Khi LISP không đủ: .NET add-in (chỉ nhắc qua)

Một số ít việc vượt quá tầm của LISP: cần cửa sổ giao diện riêng với nhiều ô nhập và bảng dữ liệu, xử lý hàng chục nghìn đối tượng đòi tốc độ cao, kết nối cơ sở dữ liệu hoặc phần mềm khác, hay đóng gói phát hành cho người khác mà không muốn lộ mã nguồn. Khi đó mới tới lượt .NET add-in: tạo project trong Visual Studio, tham chiếu các thư viện của AutoCAD (AcMgd.dll, AcDbMgd.dll, AcCoreMgd.dll), viết lệnh, build ra file .dll, nạp bằng lệnh NETLOAD và đóng gói dạng .bundle để AutoCAD tự nạp khi khởi động. Đổi lại: cần AutoCAD bản full (LT không chạy .NET add-in), mọi thay đổi đều phải build lại, quy trình dài hơn hẳn. Kết luận thực dụng: mặc định cứ LISP trước — nó đáp ứng phần lớn nhu cầu thực tế; .NET là phương án dành cho thiểu số trường hợp LISP thật sự không kham nổi.

8.9. So sánh: khi nào MCP trực tiếp, khi nào đóng gói LISP

Quy tắc ngón tay cái: một việc bạn đã nhờ Claude vẽ qua MCP tới lần thứ ba với cùng một logic, thì đó là ứng viên đóng gói LISP. Ngược lại, việc mới, việc lạ, việc cần suy luận — cứ để MCP lo, đừng cố ép thành code cứng.

8.10. Lưu LISP vào thư viện chung để tái sử dụng

File .lsp cũng là tài sản tích lũy như block ở Chương 7 — đối xử với nó cùng một kỷ luật: một thư mục tập trung duy nhất, đặt ngay cạnh thư viện block để backup một lần được cả hai:

D:\ThuVienLISP\
├── BOLTPAT.lsp
├── FLANGE.lsp
├── TAGNUM.lsp
└── MUCLUC.txt

• Một file = một lệnh chính, tên file trùng tên lệnh (BOLTPAT.lsp chứa lệnh BOLTPAT) — nhìn tên file là biết phải gõ gì.
• Luôn có comment đầu file: tên lệnh, chức năng, dữ liệu nhập, lần sửa gần nhất. Ba ví dụ trong chương này đều theo đúng mẫu đó — giữ thói quen này cho mọi file về sau.
• File MUCLUC.txt là danh mục một dòng một lệnh (tên lệnh — làm gì — khi nào dùng). Nó cứu bạn khỏi cảnh "nhớ mang máng mình từng có lệnh vẽ cái này" sau vài tháng; và khi nhờ Claude viết lệnh mới, dán luôn mục lục vào câu chat để Claude tránh đặt trùng tên và tái sử dụng phong cách code cũ.
• Dùng chung cho cả nhóm: đặt thư mục thư viện trên ổ mạng nội bộ, mỗi máy chỉ cần thêm các file vào Startup Suite một lần (mục 8.4) là cả nhóm có chung một bộ lệnh — sửa một file ở thư viện là mọi người cùng được bản mới ở lần mở AutoCAD kế tiếp.
• Backup chung với thư viện block theo đúng quy trình ở mục 7.6: nén cả hai thư mục kèm ngày tháng. Thư viện LISP còn nhẹ hơn block rất nhiều (toàn file text vài KB) — không có lý do gì để không sao lưu thường xuyên.

Chương 9

Mẹo & xử lý lỗi: khi mọi thứ không chạy như ý

Hệ Claude + MCP + AutoCAD có ba mắt xích (Claude Desktop → MCP server → AutoCAD), lỗi có thể nằm ở bất kỳ mắt xích nào. Nguyên tắc gỡ lỗi: xác định đúng mắt xích trước, sửa sau — đừng cài lại tất cả trong hoảng loạn.

9.1. Lỗi 1: MCP server không hiện trong Claude Desktop

Triệu chứng: bấm icon tools trong ô chat mà không thấy server multiCAD. Ba nguyên nhân chiếm gần như toàn bộ các trường hợp:

• JSON sai cú pháp — thừa/thiếu dấu phẩy, thiếu dấu ngoặc đóng, hoặc dấu \ trong đường dẫn chưa viết thành \\. Claude Desktop gặp JSON lỗi sẽ bỏ qua config một cách lặng lẽ.
• Đường dẫn tương đối hoặc sai — command trỏ tới py hệ thống thay vì python trong .venv, hoặc thư mục cài đặt đã bị di chuyển sau khi cấu hình.
• Chưa thoát hẳn app — đóng cửa sổ chưa đủ; phải chuột phải icon khay hệ thống → Exit, rồi mở lại.

Nơi tìm bằng chứng: thư mục log %APPDATA%\Claude\logs\ — file log của MCP ghi rõ server nào khởi động thất bại và vì sao (thường là đường dẫn không tồn tại hoặc Python báo lỗi thiếu thư viện).

9.2. Lỗi 2: AutoCAD không phản hồi lệnh

• Chưa mở AutoCAD (hoặc chưa mở bản vẽ nào): server không có đích để gửi lệnh. Mở AutoCAD và một bản vẽ mới trước khi chat.
• Cửa sổ AutoCAD mất focus / bị cửa sổ khác che: một số thao tác cần cửa sổ AutoCAD ở trạng thái hoạt động — đưa nó lên foreground rồi thử lại.
• Dialog modal đang mở: một hộp thoại (ví dụ hộp thoại in, hộp thoại hỏi lưu file) đang treo sẽ chặn mọi lệnh mới. Đóng hoặc hủy dialog đó trước.
• AutoCAD đang chờ bạn hoàn tất một lệnh dở dang: bấm Esc vài lần để hủy lệnh đang treo, rồi ra lệnh lại qua Claude.

9.3. Lỗi 3: Lệnh FILLET/CHAMFER không chạy

Đây là lỗi "đặc sản" đã nhắc ở Chương 6: fillet/chamfer tương tác chọn cạnh phức tạp, một số đường gọi lệnh dạng headless (không giao diện) xử lý không ổn. Cách xử lý: chuyển sang điều khiển qua live app — AutoCAD mở sẵn, cửa sổ đang active — và cho Claude chạy lại riêng bước đó, sau đó zoom kiểm tra kết quả từng vai bậc.

9.4. Best practices — thói quen của người dùng MCP lâu dài

• Luôn test trên bản vẽ nháp trước. Mọi câu lệnh mới, mọi quy trình mới đều chạy thử trên file nháp; chỉ khi kết quả đúng mới áp lên bản vẽ thật.
• Làm việc trên bản copy, không làm trên bản vẽ gốc. Trước buổi làm việc với MCP, nhân bản file gốc (hậu tố ngày hoặc _MCP). Lệnh hàng loạt sai một câu chat có thể sửa đổi hàng trăm đối tượng trong vài giây.
• Xem lại từng tool call trước khi approve. Nút Allow for This Chat tiện thật, nhưng hãy đọc lướt tham số Claude sắp gửi — đặc biệt với lệnh xóa, di chuyển "tất cả", và ghi đè attribute hàng loạt.
• Đọc source của MCP server trước khi cấp quyền ghi. MCP server là chương trình chạy bằng quyền của bạn trên máy của bạn. Với server cộng đồng, hãy đọc qua mã nguồn (hoặc ít nhất kiểm tra repo, số người dùng, lịch sử cập nhật) trước khi cho nó quyền sửa bản vẽ thật.
• Ra lệnh nhỏ, kiểm tra thường xuyên. Năm câu chat ngắn, mỗi câu kiểm tra một lần, an toàn hơn một câu chat "làm hết từ A đến Z" rất nhiều.

9.5. Giới hạn phải chấp nhận

• MCP cho "kênh lệnh", không cho "nhận thức". Claude không nhìn thấy vật thật hay ảnh chụp để tự suy ra kích thước. Mọi con số phải do bạn cung cấp chính xác — nó vẽ đúng những gì bạn nói, kể cả khi bạn nói sai.
• Không deterministic. Cùng một câu hỏi, hai lần chạy có thể cho chuỗi tool call hơi khác nhau (thứ tự lệnh, cách chia bước). Với bản vẽ quan trọng, đừng ngạc nhiên vì sự khác biệt này — hãy dựa vào bước kiểm tra, không dựa vào "lần trước nó làm đúng".
• Bản vẽ phức tạp dễ lỗi thầm lặng. XREF lồng nhau nhiều lớp, ràng buộc (constraint) nặng, block động phức tạp là những nơi tool call có thể "thành công" về mặt kỹ thuật nhưng kết quả hình học không như ý. Càng phức tạp, càng phải kiểm tra bằng mắt kỹ.