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 8 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

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.

8.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).

8.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.

8.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.

8.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.

8.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ỹ.