Tích hợp AI

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

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 MCP khác, hãy cài đặt MCP server bên dưới. Nếu bạn đang tích hợp từ một agent chat thông thường 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à truy xuất ngữ cảnh có cấu trúc. MCP server của Meshy đóng gói Meshy REST API thành một tập hợp các công cụ mà agent 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 tự viết mã HTTP.

MCP server là mã nguồn mở và được phát hành trên npm với tên @meshy-ai/meshy-mcp-server. Mã 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 trang API Keys trong Developer Platform. MCP server sẽ đọ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

Muốn dùng một gói skill dựng sẵn thay thế? 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 được viết sẵn (tạo → kiểm tra → 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ác 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 chức năng.

Tạo mô hình 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 cho một lưới preview

Xử lý hậu kỳ

  • 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 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ó khung xương

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à 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/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 về 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 phần mềm slicer đã cài đặt và khởi chạy mô hình trong một trong số đó (chạy cục bộ trên máy của bạn; không gọi Meshy API)
  • meshy_analyze_printability — hiện tại trả về một danh sách kiểm tra khả nă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 khả dụng.
  • 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ác công cụ có thể thay đổi. Danh sách chính thức nằm tại mã nguồn MCP server.

Prompt mẫu

Đưa các prompt sau vào chat có hỗ trợ MCP của bạn để 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 agent 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ó đến các bề mặt dạng 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 polling bất đồng bộ đúng cách, 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 lấy dữ liệ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.

Cả ba tệp này đều được tạo lại mỗi khi trang tài liệu được build, 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

Is the MCP server stateless?
Yes. Your MESHY_API_KEY is used per request and never persisted on the server side.
Does MCP cost the same as the REST API?
Yes — every MCP tool call maps to a single REST call and consumes credits at the exact same rate. See the Pricing page for the full matrix.
What are the rate limits?
The MCP server shares the same rate-limit plane as the REST API. See the Rate Limits page for per-tier limits.
What Meshy data can the MCP access?
Only what the MESHY_API_KEY can access via REST. Scopes and permissions are identical.
How do I report issues?
File an issue at the meshy-mcp-server repository: https://github.com/meshy-dev/meshy-mcp-server/issues