Tích hợp AI

Meshy cung cấp hai kênh cho các tác nhân AI và trợ lý mã hóa: MCP server của Meshy để gọi công cụ, và llms.txt / llms-full.txt để nhập liệu 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 tương thích với MCP, hãy cài đặt MCP server dưới đây. 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ó đến https://docs.meshy.cn/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. MCP server của Meshy bao bọc Meshy REST API như một tập hợp các công cụ mà tác nhân của bạn có thể gọi — tạo mô hình, kiểm tra nhiệm vụ, tải xuống kết quả — mà không cần viết mã HTTP thủ công.

MCP server là mã nguồn mở và được phát hành trên npm dưới dạng @meshy-ai/meshy-mcp-server. Nguồn: github.com/meshy-dev/meshy-mcp-server.

Bạn cần một khóa API của Meshy. Tạo một khóa tại https://www.meshy.ai/settings/api. MCP server đọc nó 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

Thích một kỹ năng tích hợp sẵn hơn? Gói kỹ năng mã nguồn mở meshy-3d-agent cung cấp các quy trình làm việc của Meshy đã được viết sẵn (tạo → thăm dò → tải xuống) cho Claude Code, Cursor, và OpenClaw. Nó 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 khả năng.

Tạo 3D

  • meshy_text_to_3d — tạo một mô hình 3D 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 vào một 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 một khung xương vào một nhân vật 3D hình người
  • meshy_animate — áp dụng một hoạt hình cho một 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ý nhiệm vụ

  • meshy_get_task_status — kiểm tra trạng thái nhiệm vụ và URL tải xuống
  • meshy_list_tasks — liệt kê các nhiệm vụ gần đây, có thể lọc theo loại/trạng thái
  • meshy_cancel_task — hủy một nhiệm vụ đang chờ hoặc đang tiến hành
  • meshy_download_model — lấy một tệp mô hình đã hoàn thành và lưu cục bộ

Không gian làm việc

  • meshy_list_models — liệt kê tất cả cá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 có cuộc gọi Meshy API)
  • meshy_analyze_printability — hiện tại trả về một danh sách kiểm tra sẵn sàng in thủ công (độ 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 một tệp 3MF đa màu để in

Tài khoản

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

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

Ví dụ về Prompt

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

  • llms.txt — chỉ mục gọn + hướng dẫn tích hợp (mẫu thăm dò không đồng bộ đúng, quy tắc xác thực, giới hạn tốc độ, lựa chọn mô hình, lỗi thường gặp).
  • llms-full.txt — mỗi trang API được nối trong một tệp duy nhất để nhập liệu một lần.
  • Markdown từng trang: thêm .md vào bất kỳ URL endpoint nào. Ví dụ: https://docs.meshy.cn/api/text-to-3d.md.

Cả ba đều được tái tạo mỗi khi trang tài liệu được xây dựng, vì vậy 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ó trạng thái không?
Không. Khóa MESHY_API_KEY của bạn được sử dụng cho mỗi yêu cầu và không bao giờ được lưu trữ trên phía server.
MCP có chi phí giống REST API không?
Có — mỗi lần gọi công cụ MCP tương ứng với một lần gọi REST và tiêu thụ tín dụng với cùng tốc độ. Xem trang Giá để biết ma trận đầy đủ.
Giới hạn tốc độ là gì?
MCP server chia sẻ cùng mặt phẳng 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ì khóa MESHY_API_KEY có thể truy cập qua REST. Phạm vi và quyền là giống nhau.
Làm thế nào để báo cáo vấn đề?
Gửi một vấn đề tại kho lưu trữ meshy-mcp-server: https://github.com/meshy-dev/meshy-mcp-server/issues