Tiếng Việt
Blender Bridge MCP
Blender Bridge MCP là một máy chủ MCP dành cho Blender: nó cung cấp cho bất kỳ ứng dụng nào hỗ trợ MCP các công cụ để làm việc trong Blender của bạn. Claude Code, Codex, Cursor và các agent khác có thể đọc cảnh, chạy mã lệnh, kiểm tra kết quả qua ảnh chụp màn hình và tinh chỉnh cảnh theo yêu cầu của bạn. Máy chủ được tích hợp sẵn bên trong ứng dụng Blender Bridge, do đó không cần tải xuống hoặc xây dựng riêng bất cứ thứ gì.
MCP là gì
MCP (Model Context Protocol) là tiêu chuẩn mở được các ứng dụng AI sử dụng để kết nối với các công cụ bên ngoài. Máy chủ thông báo cho agent biết những hành động nào khả dụng, và agent sẽ gọi chúng khi tác vụ cần đến. Với Blender Bridge MCP, danh sách đó có thêm các hành động trong Blender: đọc cảnh, chạy mã lệnh, chụp ảnh màn hình, kết xuất một khung hình, xuất mô hình, đưa cảnh trở về một điểm lưu trạng thái cảnh.
Hai cách kết nối
| Cục bộ | Theo địa chỉ máy chủ | |
|---|---|---|
| Dành cho | Ứng dụng AI và Blender cùng nằm trên một máy tính; MCP trao đổi trực tiếp với ứng dụng | Ứng dụng trò chuyện hoặc ứng dụng trên bất kỳ thiết bị nào, bao gồm cả cùng một máy tính, và làm việc cùng nhau; các lệnh đi qua máy chủ Blender Bridge |
| Cách thức | Cấu hình stdio từ ứng dụng Blender Bridge | Địa chỉ https://mcp.blenderbridge.com/mcp và tài khoản Blender Bridge của bạn |
| Nơi áp dụng | Claude Desktop, Claude Code, Codex, Cursor, VS Code, Windsurf, Antigravity, JetBrains AI Assistant, Gemini CLI, Cline, Kiro, Zed, LM Studio, Trae, Qwen Code, Kimi Code, Cherry Studio, CodeBuddy, Tongyi Lingma | ChatGPT, Claude, Mistral Le Chat, Perplexity, Gemini (tài khoản cá nhân tại Hoa Kỳ, 18+, tiếng Anh, bật Keep Activity) và các ứng dụng khác chấp nhận địa chỉ máy chủ |
Một kết nối có thể hoạt động với Blender trên máy tính này và sau khi bạn đăng nhập, có thể hoạt động với máy tính của bạn ở nơi khác.
Cách kết nối
Đầu tiên, hãy đăng nhập vào ứng dụng Blender Bridge bằng tài khoản đã xác nhận email và có quyền truy cập còn hiệu lực. Nếu bạn chưa có tài khoản, hãy bắt đầu bằng việc cài đặt ứng dụng.
Cách nhanh nhất: hướng dẫn thiết lập
Trong ứng dụng Blender Bridge, hãy mở cửa sổ kết nối, chọn MCP và sao chép hướng dẫn thiết lập. Dán hướng dẫn này vào cuộc trò chuyện của ứng dụng và yêu cầu kết nối Blender Bridge MCP. Các agent có thể chỉnh sửa cài đặt của chính mình, chẳng hạn như Codex, Claude Code và Cursor, sẽ tự thêm kết nối. Nếu ứng dụng không thể làm điều đó, AI sẽ cho bạn biết nơi cần thêm cấu hình.
Thủ công: cấu hình stdio
Sao chép cấu hình MCP trong ứng dụng; cấu hình này đã chứa sẵn lệnh, các đối số và biến môi trường cho bản cài đặt của bạn, do đó bạn không bao giờ phải nhập đường dẫn thủ công.
- Claude Desktop — Settings → Developer → Edit Config, thêm cấu hình vào.
- Cursor, Windsurf, Antigravity, Gemini CLI, Cline, Kiro — tệp cài đặt MCP của ứng dụng, dưới dạng máy chủ stdio.
- VS Code — lệnh MCP: Add Server hoặc
.vscode/mcp.json, nơi khóa cấp cao nhất làserverschứ không phảimcpServers. - JetBrains AI Assistant — phần cài đặt AI Assistant, tại mục MCP.
- Zed — cài đặt context server.
- Qwen Code —
settings.jsonhoặcqwen mcp add. - Kimi Code —
kimi mcp add. - Trae — cài đặt MCP, Add → Add Manually.
- Cherry Studio — Settings → MCP Servers.
- CodeBuddy — tệp
.mcp.json. - Tongyi Lingma — các dịch vụ MCP của plugin.
Sau khi thêm máy chủ, hãy bật máy chủ và làm mới danh sách công cụ; khởi động lại ứng dụng nếu được yêu cầu.
Theo địa chỉ máy chủ
Trong cài đặt trình kết nối hoặc cài đặt máy chủ MCP, hãy thêm https://mcp.blenderbridge.com/mcp, đăng nhập bằng tài khoản Blender Bridge của bạn và yêu cầu AI liệt kê các máy tính của bạn rồi chọn một máy. Ứng dụng Blender Bridge phải đang chạy trên máy tính đó.
Những gì agent có thể làm
| Tác vụ | Công cụ |
|---|---|
| Hiểu cảnh | get_scene_state, take_screenshot, get_blender_info |
| Dựng và thay đổi cảnh | execute_blender_code — bất kỳ mã Python nào của Blender, kèm theo một bước được đặt tên |
| Theo dõi một thao tác kéo dài | get_blender_operation_status, cancel_blender_operation |
| Quay lại một bước | scene_checkpoints — các bước của AI được lưu dưới dạng các điểm lưu trạng thái cảnh, và thao tác quay lại một điểm khả dụng có thể được hoàn tác; undo_last_action |
| Hiểu rõ Blender | lookup_blender_api — tài liệu tham khảo API cho các phiên bản Blender khả dụng: 3.6, 4.2, 4.4, 4.5, 5.0, 5.1 và 5.2, search_blender_manual — hướng dẫn sử dụng Blender 5.2, get_blender_recipe — công thức cho các tác vụ phổ biến |
| Sử dụng tài nguyên có sẵn | find_free_assets — texture từ Poly Haven và ambientCG, mô hình và môi trường HDRI từ Poly Haven |
| Làm việc theo ảnh tham chiếu | set_reference_image, compare_reference_render — một bức ảnh làm tham chiếu và so sánh cạnh nhau |
| Kết xuất | render_project_image — một khung hình PNG trong thư mục dự án; đối với các tác vụ kết xuất dài và hoạt ảnh, AI sẽ bắt đầu kết xuất dưới nền thông qua execute_blender_code: một bản sao của cảnh sẽ được kết xuất trong một tiến trình Blender riêng biệt, có tiến độ và khả năng dừng |
| Lưu và xuất file | save_blend_file, export_model — GLB cho web và Godot, FBX cho Unity và Unreal Engine, USDZ cho AR, STL cho in 3D |
| Tự thiết lập | open_blender, select_blender, ensure_blender_extension, restart_blender_with_extension, check_connection |
| Làm việc cùng nhau | invite_collaborator, accept_collaboration, end_collaboration |
Agent sẽ tự chọn công cụ. Bạn chỉ cần mô tả tác vụ, ví dụ: "dựng một khu rừng low-poly cho game di động và xuất dưới dạng FBX cho Unity".
Nếu agent không thấy Blender
- Yêu cầu AI kiểm tra kết nối với Blender. Blender Bridge sẽ báo chính xác những gì còn thiếu: ứng dụng chưa chạy, Blender đang đóng, tiện ích Blender Bridge chưa được cài đặt. AI sẽ tự mở Blender, cài đặt tiện ích và khởi động lại Blender.
- Nếu ứng dụng hoàn toàn không thấy máy chủ, hãy sao chép lại cấu hình từ ứng dụng, bật máy chủ và làm mới danh sách công cụ, hoặc khởi động lại ứng dụng.