Hướng dẫn tải Revit mới nhất và cài MCP cho Revit
Để sử dụng Autodesk Revit MCP, bạn cần cài đặt phiên bản Revit tương thích, tải bộ MCP phù hợp và thiết lập kết nối với AI client. Các bước dưới đây hướng dẫn quy trình cài đặt trên máy tính Windows.
Bước 1: Tải Revit mới nhất về máy
Trước tiên, hãy đăng nhập vào tài khoản Autodesk của bạn. Sau khi sign in vào Autodesk, vào Products → tìm sản phẩm Revit → chọn Install để mặc định cài đặt phiên bản mới nhất của Revit.
Để sử dụng Revit MCP theo yêu cầu tương thích đã nêu, hãy bảo đảm phiên bản Revit được cài đặt là 2027.2 trở lên. Nếu đang sử dụng Revit 2027 nhưng chưa cập nhật lên phiên bản 2027.2, bạn cần kiểm tra và cập nhật trước khi tiếp tục.
Giao diện Autodesk Account tại mục Products, hiển thị Autodesk Revit và tùy chọn Install
Bước 2: Tải và cài đặt MCP cho Revit
Sau khi tải Revit về máy, vào phần View details để tải Extensions của Revit. Chọn MCP và Date gần nhất để được truy cập MCP tốt nhất.
Lưu ý: Nếu cài Experimental Tool thì không cài Read Tool và Write Tool vì Experimental Tool đã bao gồm cả Read Tool và Write Tool. Các tool này sẽ tự xóa lẫn nhau nếu trùng.
Giao diện Extensions của Revit, hiển thị các bộ MCP và tùy chọn lựa chọn bản cập nhật
Sau khi tải về, mở lên chọn Install để cài đặt.
Nhấn Install ở cửa sổ trình cài đặt Revit MCP
Khi cài đặt hoàn tất, chọn Finish để hoàn thành.
Nhấn Finish ở cửa sổ để xác nhận hoàn tất cài đặt Revit MCP
Thiết lập MCP cho Claude Desktop
Sau khi cài đặt Revit MCP, bạn cần Thực hiện theo các bước sau để kết nối với Claude Desktop:
- Tắt hoàn toàn Claude Desktop: Mở Task Manager → tìm Claude → chọn End Task để đóng ứng dụng.
- Mở Revit trước: Khởi chạy Revit 2027.2 trở lên, sau đó mở Claude Desktop.
- Kiểm tra kết nối MCP: Trong Claude Desktop, vào Settings → Developer mode. Nếu mục Local MCP servers hiển thị Revit MCP thì đã kết nối thành công.
Lưu ý: Phải tải về và sử dụng Claude Desktop, không sử dụng phiên bản Claude (web) chạy trên trình duyệt.
Kết nối Revit MCP trên Claude Desktop, vào Settings → chọn Developer mode
Xử lý các trường hợp không kết nối được MCP:
Vào Settings → Developer mode → Edit Config để mở tệp claude_desktop_config.json.
Với file
.jsoncó thể dùng Visual Studio Code (VSCode) để xem và chỉnh sửa tệp JSON thuận tiện hơn. Trong trường hợp không có phần mềm chuyên dụng đọc code, hãy dùng Notepad.
Lưu ý: Trước khi thay đổi cấu hình, hãy sao lưu nội dung hiện tại của tệp JSON. Nếu tệp đã có cấu hình MCP khác, hãy kết hợp cấu hình mới với cấu hình hiện có thay vì ghi đè toàn bộ.
Sau đó copy các script sau vào file .json (Có thể nhờ Claude copy vào).
1. Đối với Cấu hình Revit MCP Server Read-Tools Technical Preview:
Sử dụng cấu hình sau nếu bạn cài đặt bộ Read-Tools Technical Preview:
{
"mcpServers": {
"Revit MCP Read-Tools Technical Preview": {
"command": "C:\\Program Files\\Autodesk\\Revit 2027 MCP Server Read-Tools Technical Preview\\Autodesk.RevitMcpServer.Stdio.exe",
"args": ["--ManageConfigurationWithAutodeskRevitPluginInstaller=true"]
}
}
}
2. Đối với cấu hình Revit MCP Server Write-Tools Technical Preview:
Nếu sử dụng bộ Write-Tools Technical Preview theo cấu hình bên dưới, hãy kiểm tra kỹ đường dẫn của từng máy chủ MCP trước khi lưu:
{
"mcpServers": {
"Revit MCP Read-Tools Technical Preview": {
"command": "C:\\Program Files\\Autodesk\\Revit 2027 MCP Server Write-Tools Technical Preview\\Autodesk.RevitMcpServer.Stdio.exe",
"args": [
"--tool-permission=StableReadOnly",
"--ManageConfigurationWithAutodeskRevitPluginInstaller=true"
]
},
"Revit MCP Write-Tools Technical Preview": {
"command": "C:\\Program Files\\Autodesk\\Revit 2027 MCP Server Write-Tools Technical Preview\\Autodesk.RevitMcpServer.Stdio.exe",
"args": [
"--tool-min-permission=Stable",
"--ManageConfigurationWithAutodeskRevitPluginInstaller=true"
]
}
}
}
3. Đối với cấu hình Revit MCP Server Experimental-Tools Technical Preview:
Nếu sử dụng Experimental-Tools Technical Preview, hãy thêm cấu hình tương ứng:
{
"mcpServers": {
"Revit MCP Experimental Technical Preview": {
"command": "C:\\Program Files\\Autodesk\\Revit 2027 MCP Server Experimental-Tools Technical Preview\\Autodesk.RevitMcpServer.Stdio.exe",
"args": ["--ManageConfigurationWithAutodeskRevitPluginInstaller=true"]
}
}
}
Sau khi chỉnh sửa, lưu tệp JSON, đóng hoàn toàn Claude Desktop rồi mở lại Revit trước khi khởi chạy Claude Desktop. Tiếp tục kiểm tra mục Local MCP servers để xác định trạng thái kết nối.
Lưu ý kỹ thuật: Các đường dẫn và tham số cấu hình trên được giữ theo nội dung hướng dẫn ban đầu. Hãy xác nhận chúng khớp với bộ MCP thực tế đã cài đặt trên máy. Đặc biệt, cấu hình Write-Tools ở trên sử dụng đường dẫn thư mục Write-Tools cho cả hai mục máy chủ, vì vậy cần kiểm tra lại tệp thực thi và tên server theo tài liệu của đúng phiên bản trước khi áp dụng.
Thiết lập MCP cho Cursor
Ngoài Claude Desktop, bạn cũng có thể cấu hình Revit MCP để sử dụng với Cursor. Tệp cấu hình MCP của Cursor theo hướng dẫn File .json của Cursor nằm ở:
%USERPROFILE%\.cursor\mcp.json
Mở tệp trên bằng trình chỉnh sửa văn bản hoặc Visual Studio Code. Nếu tệp đã có cấu hình MCP khác, hãy bổ sung cấu hình Revit MCP vào cấu trúc JSON hiện có và tránh ghi đè những máy chủ đang sử dụng.
1. Cấu hình Revit MCP Server Read-Tools Technical Preview:
Sử dụng cấu hình sau cho bộ Read-Tools Technical Preview:
{
"mcpServers": {
"Revit MCP Read-Tools Technical Preview": {
"command": "C:\\PROGRA~1\\Autodesk\\REVITP~2\\AUTODE~1.EXE",
"args": ["--ManageConfigurationWithAutodeskRevitPluginInstaller=true"]
}
}
}
2. Cấu hình Revit MCP Server Write-Tools Technical Preview:
Đối với bộ Write-Tools Technical Preview, sử dụng cấu hình dưới đây nếu các đường dẫn và tham số khớp với bộ cài thực tế:
{
"mcpServers": {
"Revit MCP Read-Tools Technical Preview": {
"command": "C:\\PROGRA~1\\Autodesk\\REVITP~2\\AUTODE~1.EXE",
"args": [
"--tool-permission=StableReadOnly",
"--ManageConfigurationWithAutodeskRevitPluginInstaller=true"
]
},
"Revit MCP Write-Tools Technical Preview": {
"command": "C:\\PROGRA~1\\Autodesk\\REVITP~2\\AUTODE~1.EXE",
"args": [
"--tool-min-permission=Stable",
"--ManageConfigurationWithAutodeskRevitPluginInstaller=true"
]
}
}
}
3. Cấu hình Revit MCP Server Experimental-Tools Technical Preview:
Nếu lựa chọn Experimental-Tools Technical Preview, sử dụng cấu hình sau:
{
"mcpServers": {
"Revit MCP Experimental Technical Preview": {
"command": "C:\\PROGRA~1\\Autodesk\\REVITP~2\\AUTODE~1.EXE",
"args": ["--ManageConfigurationWithAutodeskRevitPluginInstaller=true"]
}
}
}
Lưu ý: Các đường dẫn dạng PROGRA~1, REVITP~2 và AUTODE~1.EXE là đường dẫn rút gọn được giữ theo cấu hình ban đầu, không nên mặc định rằng chúng đúng trên mọi máy tính. Nếu Cursor không nhận diện được MCP, hãy xác minh đường dẫn thực tế đến tệp thực thi của Revit MCP Server và cập nhật lại trường command.
Sau khi lưu tệp mcp.json, khởi động lại Cursor nếu cần và kiểm tra danh sách công cụ MCP trong ứng dụng. Đồng thời, bảo đảm Revit đã được mở và phiên bản đang sử dụng đáp ứng yêu cầu tương thích.
Kiểm tra kết nối sau khi cài đặt Revit MCP
Vào Claude Desktop, "+" → Connectors → kiểm tra các Revit MCP đã được bật như trong hình là hoàn thành.
Hiển thị các kết nối Revit MCP đã được bật sau khi cài đặt và cấu hình thành công tại mục Connectors, Claude Desktop
Nếu MCP chưa hoạt động như mong đợi, hãy rà soát lại các yếu tố sau:
- Phiên bản Autodesk Revit có đáp ứng yêu cầu 2027.2 trở lên hay không?
- Bộ MCP đã cài có đúng với cấu hình JSON đang sử dụng hay không?
- Đường dẫn đến tệp thực thi trong trường command có chính xác hay không?
- Cấu trúc JSON có hợp lệ và không bị ghi đè các cấu hình khác hay không?
- Revit đã được mở trước khi khởi chạy AI client hay chưa?
- Bộ công cụ MCP có bị cài trùng hoặc xung đột với một bộ khác hay không?
Xem thêm:
Việc cài đặt Autodesk Revit MCP giúp kết nối mô hình Revit với các công cụ AI như Claude Desktop hoặc Cursor, hỗ trợ truy vấn thông tin và thực hiện những tác vụ được MCP cung cấp. Để sử dụng ổn định, bạn cần cài đúng phiên bản Revit, lựa chọn MCP phù hợp và kiểm tra cấu hình kết nối theo hướng dẫn. Nếu cần tư vấn thêm về phần mềm Revit bản quyền, các giải pháp BIM cũng như hỗ trợ cài đặt, có thể liên hệ ngay VietCAD:
- Email: [email protected]
- Hotline: 0913 920 632
