Tích hợp AI

Meshy cung cấp hai kênh cho các tác nhân AI và trợ lý lập trình: Meshy MCP server để gọi công cụ, và llms.txt / llms-full.txt để nạp tài liệu.

Nếu bạn đang tích hợp Meshy từ Claude Code, Cursor, Windsurf, Codex hoặc bất kỳ công cụ nào khác tương thích MCP, hãy cài đặt MCP server bên dưới. Nếu bạn đang tích hợp từ một tác nhân chat thông thường không hỗ trợ MCP, hãy trỏ nó tới 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 trợ lý AI gọi các công cụ bên ngoài và truy xuất ngữ cảnh có cấu trúc. Meshy MCP server bao bọc Meshy REST API thành một tập hợp công cụ mà tác nhân của bạn có thể gọi — tạo một mô hình, kiểm tra một tác vụ, tải kết quả xuống — mà không cần viết mã HTTP thủ công.

MCP server là mã nguồn mở và được xuất bản trên npm dưới dạng @meshy-ai/meshy-mcp-server. Mã nguồn: github.com/meshy-dev/meshy-mcp-server.

Bạn cần một khóa API Meshy. Tạo một khóa tại https://www.meshy.ai/settings/api. MCP server đọc khóa này từ biến môi trường MESHY_API_KEY.

Cài đặt nhanh

# 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

Thay vào đó muốn dùng một skill có thể dùng ngay? Gói skill mã nguồn mở meshy-3d-agent cung cấp sẵn các quy trình làm việc Meshy đã viết trước (tạo → thăm dò → tải xuống) cho Claude Code, Cursor và OpenClaw. Gói này gọi trực tiếp Meshy REST API — không cần MCP server.

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

Công cụ có sẵn

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

Tạo 3D

  • meshy_text_to_3d — tạo một mô hình 3D 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 vào lưới xem trước

Hậu xử lý

  • meshy_remesh — thay đổi topology và/hoặc số đa giác của một mô hình hiện có
  • 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 vào một nhân vật hình người 3D
  • meshy_animate — áp dụng một hoạt hình (animation) cho nhân vật đã được rig

Tạo hình ảnh

  • meshy_text_to_image — hình ảnh 2D từ văn bản
  • meshy_image_to_image — 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à URL tải xuống
  • meshy_list_tasks — liệt kê các tác vụ gần đây, tùy chọn lọc theo loại/trạng thái
  • meshy_cancel_task — hủy một tác vụ đang chờ hoặc đang thực hiện
  • meshy_download_model — lấy một tệp mô hình đã hoàn tất và lưu cục bộ

Không gian làm việc

  • meshy_list_models — liệt kê tất cả mô hình trong không gian làm việc của người dùng đã xác thực

In 3D

  • meshy_send_to_slicer — phát hiện các slicer đã cài đặt và khởi chạy mô hình trong một slicer (chạy cục bộ trên máy của bạn; không gọi Meshy API)
  • meshy_analyze_printability — hiện trả về danh sách kiểm tra thủ công về mức độ sẵn sàng để in (độ dày thành, phần nhô ra, lưới manifold, v.v.). Sẽ được nâng cấp lên phân tích tự động khi Meshy printability API có sẵn.
  • meshy_process_multicolor — chuyển đổi một mô hình có texture thành tệp 3MF nhiều màu để in

Tài khoản

  • meshy_check_balance — truy vấn tín dụng còn lại

Tên công cụ và hành vi có thể thay đổi theo thời gian. Danh sách chính thức nằm trong mã nguồn MCP server.

Prompt ví dụ

Thả các prompt này vào cuộc chat hỗ trợ MCP của bạn để làm điểm bắt đầu.

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 tác nhân của bạn không hỗ trợ MCP, hoặc bạn muốn nạp tài liệu Meshy trực tiếp vào một prompt, hãy trỏ nó tới các bề mặt văn bản thuần của chúng tôi:

  • llms.txt — chỉ mục gọn nhẹ + hướng dẫn tích hợp (mẫu thăm dò bất đồng bộ đúng, quy tắc xác thực, giới hạn tốc độ, lựa chọn mô hình, các lỗi thường gặp).
  • llms-full.txt — mọi trang API được nối lại trong một tệp duy nhất để nạp bằng một lần fetch.
  • 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.

Cả ba đều được tạo lại mỗi khi trang tài liệu được build, nên chúng không bao giờ lệch khỏi tài liệu HTML.

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

MCP server có stateless không?
Có. MESHY_API_KEY của bạn được sử dụng cho từng yêu cầu và không bao giờ được lưu giữ ở phía server.
MCP có chi phí giống REST API không?
Có — mỗi lần gọi công cụ MCP ánh xạ tới một lệnh gọi REST duy nhất và tiêu thụ tín dụng với đúng cùng mức. Xem trang Giá để biết ma trận đầy đủ.
Giới hạn tốc độ là gì?
MCP server dùng chung lớp giới hạn tốc độ với REST API. Xem trang Giới hạn tốc độ để biết giới hạn theo từng cấp.
MCP có thể truy cập dữ liệu Meshy nào?
Chỉ những gì MESHY_API_KEY có thể truy cập qua REST. Phạm vi và quyền là giống hệt nhau.
Tôi báo cáo sự cố bằng cách nào?
Tạo một issue tại kho lưu trữ meshy-mcp-server: https://github.com/meshy-dev/meshy-mcp-server/issues