Tích hợp AI

Kết nối các AI agent và trợ lý lập trình với Meshy, sử dụng Meshy MCP server để gọi công cụ, hoặc dùng llms.txt và llms-full.txt để đọc tài liệu.

Nếu bạn dùng Claude Code, Cursor, Windsurf, Codex, hoặc một MCP client khác, hãy cài đặt MCP server. Nếu chat agent của bạn không hỗ trợ MCP, hãy trỏ nó đến https://docs.meshy.ai/llms.txt thay thế.

MCP là gì

Model Context Protocol (MCP) là một tiêu chuẩn mở cho phép các trợ lý AI gọi các công cụ bên ngoài và nhận ngữ cảnh có cấu trúc. Meshy MCP server bọc Meshy REST API thành các công cụ mà agent của bạn có thể gọi. Với chúng, agent có thể tạo một mô hình, kiểm tra một tác vụ, và tải xuống kết quả mà không cần viết tay mã HTTP.

MCP server là mã nguồn mở. Nó được xuất bản trên npm với tên @meshy-ai/meshy-mcp-server, và mã nguồn của nó nằm trong kho meshy-mcp-server trên GitHub.

Bạn cần một khóa API Meshy. Tạo một khóa trên trang API Keys của Developer Platform. MCP server đọc khóa đó từ biến môi trường MESHY_API_KEY.

Cài đặt MCP server

Để cài đặt server, hãy dùng tab tương ứng với AI client của bạn. Thay msy_YOUR_API_KEY bằng khóa API của bạn.

# Detects installed AI clients and configures Meshy for each
npx add-mcp @meshy-ai/meshy-mcp-server --env MESHY_API_KEY=msy_YOUR_API_KEY

npx skills add meshy-dev/meshy-3d-agent

Các công cụ có sẵn

MCP server cung cấp Meshy REST API dưới dạng các công cụ sau, được nhóm theo chức năng.

Tạo mô hình 3D

• meshy_text_to_3d: tạo một lưới xem trước chưa có texture từ một prompt văn bản
• meshy_image_to_3d: tạo một mô hình 3D từ một hình ảnh
• meshy_multi_image_to_3d: tạo một mô hình 3D từ nhiều hình ảnh của cùng một đối tượng
• meshy_text_to_3d_refine: thêm texture cho một lưới xem trước

Hậu xử lý

• meshy_remesh: thay đổi topology hoặc số đa giác của một mô hình hiện có, hoặc cả hai
• meshy_retexture: áp dụng một texture mới cho một mô hình hiện có
• meshy_rig: thêm khung xương cho một nhân vật 3D dạng người
• meshy_animate: áp dụng hoạt hình cho một nhân vật đã có rig
• meshy_convert: chuyển đổi một mô hình sang định dạng tệp khác
• meshy_resize: đổi kích thước một mô hình theo kích thước thực tế
• meshy_uv_unwrap: tạo một bố cục UV mới cho một mô hình
• meshy_text_to_motion: tạo một hoạt hình từ một prompt văn bản
• meshy_list_animations: tra cứu các ID hành động hoạt hình dựng sẵn, miễn phí

Creative Lab

• meshy_creative_lab: biến một bức ảnh thành một sản phẩm Creative Lab hoàn chỉnh (chạy các tác vụ prototype và build)

Tạo hình ảnh

• meshy_text_to_image: tạo một hình ảnh 2D từ văn bản
• meshy_image_to_image: tạo một hình ảnh 2D từ một hình ảnh tham chiếu

Quản lý tác vụ

• meshy_get_task_status: kiểm tra trạng thái tác vụ và các URL tải xuống
• meshy_list_tasks: liệt kê các tác vụ gần đây, có thể lọc theo loại hoặc trạng thái
• meshy_cancel_task: xóa một tác vụ. Meshy sẽ xóa và hoàn lại tín dụng cho một tác vụ PENDING, và xóa một tác vụ đã hoàn thành. Một tác vụ IN_PROGRESS không thể bị hủy, và API sẽ trả về 409.
• meshy_download_model: tải xuống một tệp mô hình đã hoàn thành và lưu nó cục bộ

Không gian làm việc

• meshy_list_models: liệt kê các mô hình Văn bản sang 3D gần đây của bạn. Với các loại tác vụ khác, hãy dùng meshy_list_tasks.

In 3D

• meshy_send_to_slicer: tìm các phần mềm cắt lớp đã cài đặt trên máy tính của bạn, và trả về một lệnh để mở mô hình trong một trong số đó. Nó chạy cục bộ và không gọi Meshy API.
• meshy_analyze_printability: kiểm tra khả năng in FDM của một mô hình miễn phí, bao gồm tính kín nước, thể tích, lỗ hổng, cạnh non-manifold, và mặt suy biến
• meshy_process_multicolor: chuyển đổi một mô hình có texture thành một tệp 3MF đa màu để in
• meshy_repair_printability: sửa chữa một mô hình để in FDM
• meshy_auto_split: tách một mô hình thành các phần có thể in riêng biệt

Tài khoản

• meshy_check_balance: kiểm tra số tín dụng còn lại của bạn
• meshy_list_usage: liệt kê các tác vụ API đã hoàn thành của nhóm bạn và số tín dụng mỗi tác vụ đã dùng, dành cho các nhóm Studio và Enterprise

Ví dụ về prompt

Để bắt đầu, hãy thử các prompt sau trong chat được bật MCP của bạn:

Generate a 3D fox from the prompt "a cartoon fox sitting", preview it, then
texture it with PBR maps. Download the final GLB to ./outputs.

Take the image at https://example.com/sculpture.jpg and convert it into a
riggable 3D character. Use `should_remesh: true` and 50k target polycount.

What's my current Meshy credit balance?

List my last 10 successful text-to-3d tasks and download the top 3 as GLB
into ./downloads/.

llms.txt và llms-full.txt

Nếu agent của bạn không hỗ trợ MCP, hoặc bạn muốn đưa tài liệu Meshy trực tiếp vào một prompt, hãy trỏ nó đến các phiên bản văn bản thuần của tài liệu:

• llms.txt: một chỉ mục gọn nhẹ với hướng dẫn tích hợp, chẳng hạn như cách theo dõi các tác vụ bất đồng bộ, xác thực, giới hạn tốc độ, lựa chọn mô hình, và các lỗi thường gặp.
• llms-full.txt: mọi trang API trong một tệp duy nhất, để một agent có thể đọc tài liệu chỉ trong một yêu cầu.
• Markdown theo từng trang: thêm .md vào bất kỳ URL endpoint nào, ví dụ https://docs.meshy.ai/api/text-to-3d.md.

Meshy tái tạo lại cả ba tệp này mỗi khi trang tài liệu được build, để chúng khớp với tài liệu HTML.

Câu hỏi thường gặp

MCP server có phải là stateless không?

Nó không lưu trữ thông tin xác thực của bạn. Server giữ MESHY_API_KEY của bạn trong bộ nhớ và không bao giờ ghi nó ra đĩa. Theo mặc định, nó lưu các mô hình đã tải xuống, cùng với metadata của chúng, trong một thư mục meshy_output trong thư mục làm việc của nó. Để lưu một tệp tải xuống ở nơi khác, hãy cung cấp cho công cụ tải xuống một đường dẫn save_to.

MCP có tốn chi phí giống REST API không?

Có. Các lệnh gọi công cụ MCP thực hiện cùng các lệnh gọi REST và sử dụng tín dụng với cùng tỷ lệ. Xem trang Giá để biết mọi mức giá.

Giới hạn tốc độ là gì?

Các lệnh gọi của MCP server được tính vào cùng giới hạn tốc độ với các lệnh gọi REST API của bạn. Xem trang Rate limits để biết giới hạn của từng gói.

MCP server có thể truy cập những dữ liệu Meshy nào?

Chỉ những gì khóa API MESHY_API_KEY của bạn có thể truy cập thông qua REST API, với cùng quyền hạn.

Làm thế nào để tôi báo cáo sự cố?

Hãy mở một issue trong kho meshy-mcp-server trên GitHub: https://github.com/meshy-dev/meshy-mcp-server/issues