🚀 AutoCAD, ZWCAD & Revit MCP

AutoCAD MCP và Revit MCP là các MCP Server giúp Claude (AI) điều khiển trực tiếp AutoCAD và Revit thông qua ngôn ngữ tự nhiên — vẽ đường thẳng, hình tròn, chữ, kích thước, chèn block, quản lý layer, vẽ sơ đồ P&ID, xuất bản vẽ sang PDF/DXF trong AutoCAD; tạo tường, sàn, phòng, grid, level, thống kê vật liệu trong Revit... mà không cần nhớ lệnh hay viết code LISP/API thủ công.

Bạn chỉ cần mô tả yêu cầu bằng tiếng Việt hoặc tiếng Anh trong Claude Desktop, Claude sẽ tự thực hiện trên AutoCAD hoặc Revit đang mở — kể cả khi chạy nền, không cần chuyển cửa sổ qua lại.

Chỉ 2 Bước:

1. Tải file: Click nút 📥 Tải bản trọn gói AutoCAD MCP bên dưới (file install-autocad-mcp-full.bat)
2. Chạy file: Double-click để chạy. File tự cài Python, Git, uv, AutoCAD MCP, và tự động nạp LISP mỗi lần mở AutoCAD (không cần NETLOAD/APPLOAD thủ công). Không cần quyền Admin.

Xem chi tiết trong HUONG_DAN_CAI_DAT_AUTOCAD_MCP.md (kiểm tra sau khi cài, khắc phục sự cố).

ZWCAD MCP dùng server multiCAD-mcp (mã nguồn mở, tác giả AnCode666) — kết nối trực tiếp vào ZWCAD đang mở qua Windows COM (không phải AutoCAD LT + LISP như phần 1), nên không cần nạp bundle/LISP, không cần APPLOAD/NETLOAD gì cả. Server này cũng hỗ trợ luôn AutoCAD, GstarCAD, BricsCAD nếu máy có cài các phần mềm đó. Repo: multiCAD-mcp.

Chỉ 2 Bước:

1. Tải file: Click nút 📥 Tải bộ cài ZWCAD MCP bên dưới (file install-zwcad-mcp-full.bat)
2. Chạy file: Double-click để chạy. File tự cài Python, Git, uv, clone multiCAD-mcp, tự kiểm tra/phục hồi file cấu hình server (src\config.json), và tự cập nhật claude_desktop_config.json. Không cần quyền Admin.

Mở sẵn ZWCAD (có thể để trống bản vẽ) trước khi thử lệnh trong Claude — server chỉ kết nối khi có lệnh gọi đầu tiên, ZWCAD không cần mở sẵn lúc chạy file cài.

Revit MCP là MCP Server giúp Claude (AI) điều khiển trực tiếp Autodesk Revit qua ngôn ngữ tự nhiên — tạo tường, sàn, phòng, grid, level, dimension, thống kê vật liệu, lọc/thao tác phần tử, chạy code C# động trong Revit... Repo: LuDattilo/revit-mcp-server — bản v2.2.0, 138 lệnh, hỗ trợ Revit 2023–2027.

⚠️ Trên mạng có nhiều bản “Revit MCP” trùng tên nhau. Bộ cài ở trang này dùng bản LuDattilo. Đừng cài kèm gói npm mcp-server-for-revit (bản đó là một dự án khác, đang dừng ở v1.0.0) — chạy song song cả hai sẽ tranh cổng.

Các Bước Cài Đặt:

1. Tải file: Click nút 📥 Tải bộ cài Revit MCP bên dưới (file install-revit-mcp-full.bat)
2. Chạy file: Double-click để chạy. File hỏi phiên bản Revit — để trống rồi bấm Enter là nó tự nhận diện và cài cho mọi bản Revit tìm thấy (2023–2027). Sau đó tự tải plugin từ GitHub release, kiểm tra đúng dung lượng, giải nén vào thư mục Addins, bỏ cờ chặn file tải từ mạng, và cập nhật claude_desktop_config.json. Không cần quyền Admin, không cần cài Node.js (bộ cài kèm sẵn node.exe riêng).
3. Mở Revit và MỞ MỘT PROJECT. Chưa mở project thì nút không ăn — plugin báo “Open a project to get started”.
4. Bật server: tab Revit MCP → bấm nút Revit MCP Switch. Trạng thái phải chuyển từ MCP Offline sang MCP Online.
   Server KHÔNG tự chạy khi mở Revit — mỗi lần mở Revit đều phải bấm lại nút này.
5. Thoát HẲN Claude Desktop (chuột phải icon dưới khay → Quit; bấm X chỉ ẩn xuống khay, sẽ KHÔNG đọc lại config) rồi mở lại.
6. Thử: hỏi Claude “lấy thông tin project Revit đang mở”. Ra được tên project và danh sách level là đã thông.

Cả 3 bộ cài ở trên đã tự động ghi mục MCP server vào claude_desktop_config.json — bước này chỉ dùng khi bạn muốn tự sửa tay (ví dụ: file .bat chạy lỗi ở bước cập nhật config, đang có sẵn MCP server khác muốn giữ lại, hoặc cần kiểm tra/sửa lỗi cấu hình).

Đường dẫn file: %APPDATA%\Claude\claude_desktop_config.json (thường là C:\Users\[TênUser]\AppData\Roaming\Claude\claude_desktop_config.json)

Chỉ dùng AutoCAD MCP:

{
  "mcpServers": {
    "autocad-mcp": {
      "command": "C:\\MCP\\autocad-mcp\\.venv\\Scripts\\python.exe",
      "args": ["-m","autocad_mcp"],
      "env": {
        "AUTOCAD_MCP_BACKEND":"auto"
      }
    }
  }
}

Dùng cả AutoCAD MCP + Revit MCP:

{
  "mcpServers": {
    "autocad-mcp": {
      "command": "C:\\MCP\\autocad-mcp\\.venv\\Scripts\\python.exe",
      "args": ["-m","autocad_mcp"],
      "env": {
        "AUTOCAD_MCP_BACKEND":"auto"
      }
    },
    "revit-mcp": {
      "command": "C:\\Users\\TenUser\\AppData\\Roaming\\Autodesk\\Revit\\Addins\\2024\\revit_mcp_plugin\\Commands\\RevitMCPCommandSet\\server\\runtime\\node.exe",
      "args": ["C:\\Users\\TenUser\\AppData\\Roaming\\Autodesk\\Revit\\Addins\\2024\\revit_mcp_plugin\\Commands\\RevitMCPCommandSet\\server\\build\\index.js"]
    }
  }
}

⚠️ Sửa TenUser thành tên user Windows của bạn, và 2024 thành phiên bản Revit đang dùng. Bộ cài .bat tự điền đúng hai chỗ này, nên bình thường bạn không phải gõ tay.

⚠️ Nếu file đã có sẵn mục mcpServers với server khác (vd circleqs...), chỉ thêm "autocad-mcp": {...} và/hoặc "revit-mcp": {...} vào bên trong mcpServers hiện có — không xoá các mục khác.

🖊️ Riêng ZWCAD MCP — cần sửa 2 file

ZWCAD MCP (multiCAD-mcp) cần 2 file cấu hình, khác với AutoCAD/Revit MCP chỉ cần 1 file:

1. C:\MCP\zwcad-mcp\src\config.json — cấu hình server (ProgID COM của ZWCAD, thư mục xuất file...). Sửa trực tiếp bằng Notepad, không qua Claude Desktop.
2. %APPDATA%\Claude\claude_desktop_config.json — khai báo MCP server cho Claude Desktop, giống AutoCAD/Revit MCP.

1. Nội dung src\config.json (đặt tại C:\MCP\zwcad-mcp\src\config.json):

{
  "debug": false,
  "logging_level": "INFO",
  "cad": {
    "autocad": { "type": "AUTOCAD", "prog_id": "AutoCAD.Application", "startup_wait_time": 20.0 },
    "zwcad": { "type": "ZWCAD", "prog_id": "ZWCAD.Application", "startup_wait_time": 15.0 },
    "gcad": { "type": "GCAD", "prog_id": "GCAD.Application", "startup_wait_time": 15.0 },
    "bricscad": { "type": "BRICSCAD", "prog_id": "BricscadApp.AcadApplication", "startup_wait_time": 15.0 }
  },
  "output": {
    "directory": "C:/MCP/zwcad-mcp/output",
    "format": "dwg",
    "allow_arbitrary_paths": false
  },
  "dashboard": {
    "port": 8888,
    "host": "127.0.0.1"
  }
}

Nếu file đã tồn tại (do .bat clone repo về nhưng lỗi ở bước sau), mở bằng Notepad, xoá hết, dán đè nội dung trên rồi lưu. Đây chính là nguyên nhân phổ biến nhất gây "Server disconnected" — file này bị lỗi cú pháp JSON hoặc thiếu khối cad.zwcad.

2. Chỉ dùng ZWCAD MCP (thêm vào claude_desktop_config.json):

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

Dùng cả AutoCAD MCP + ZWCAD MCP + Revit MCP:

{
  "mcpServers": {
    "autocad-mcp": {
      "command": "C:\\MCP\\autocad-mcp\\.venv\\Scripts\\python.exe",
      "args": ["-m","autocad_mcp"],
      "env": {
        "AUTOCAD_MCP_BACKEND":"auto"
      }
    },
    "zwcad-mcp": {
      "command": "C:\\MCP\\zwcad-mcp\\.venv\\Scripts\\python.exe",
      "args": ["C:\\MCP\\zwcad-mcp\\src\\server.py"]
    },
    "revit-mcp": {
      "command": "C:\\Users\\TenUser\\AppData\\Roaming\\Autodesk\\Revit\\Addins\\2024\\revit_mcp_plugin\\Commands\\RevitMCPCommandSet\\server\\runtime\\node.exe",
      "args": ["C:\\Users\\TenUser\\AppData\\Roaming\\Autodesk\\Revit\\Addins\\2024\\revit_mcp_plugin\\Commands\\RevitMCPCommandSet\\server\\build\\index.js"]
    }
  }
}

⚠️ ZWCAD MCP (multiCAD-mcp) tự nhận diện AutoCAD/GstarCAD/BricsCAD luôn, nên nếu chỉ cài ZWCAD MCP mà không cài AutoCAD MCP riêng, bạn vẫn có thể dùng nó để điều khiển AutoCAD (nếu máy có cài) — không bắt buộc phải chạy song song cả 2 mục autocad-mcp và zwcad-mcp.

Các Bước Thực Hiện Trong Claude Desktop:

1. Bấm nút 📋 Copy ở khối JSON phù hợp phía trên
2. Mở Claude Desktop
3. Vào Settings (biểu tượng bánh răng)
4. Chọn tab Developer
5. Bấm Edit Config — Claude Desktop sẽ mở file claude_desktop_config.json bằng trình soạn thảo mặc định
6. Chọn hết nội dung file cũ (Ctrl+A), dán đè JSON vừa copy (Ctrl+V)
7. Lưu lại file (Ctrl+S)
8. Thoát HẲN Claude Desktop: chuột phải vào icon dưới khay hệ thống → chọn Thoát hoặc Quit (chỉ bấm nút X sẽ KHÔNG đọc lại config mới, vì app chỉ ẩn xuống khay chứ không thoát hẳn)
9. Mở lại Claude Desktop, vào Settings → Developer kiểm tra thấy MCP server đã liệt kê