概觀
Meshy MCP(Model Context Protocol)伺服器可讓本機 AI 代理——例如 Claude Code、Cursor、Codex,以及任何其他支援 stdio MCP 伺服器的用戶端——直接在對話中呼叫 Meshy 的 3D 工具。
只要一次連線,就能讓你的代理使用 24 個 Meshy 工具:text to 3D、image to 3D、紋理貼圖、重新網格化、骨骼綁定、可列印性檢查、下載等。完整設定頁面請參閱 meshy.ai/mcp。
Meshy 3D Agent 與 Meshy MCP 的比較
Meshy 3D Agent 在你的瀏覽器中於 meshy.ai 內執行——無需設定。
Meshy MCP 將相同的產生工具帶入你已在使用的 AI 用戶端,讓你無需離開編輯器或終端機即可建立並下載 3D 資產。
必要條件
Node.js 18 或更新版本
Meshy API 金鑰——請在 Meshy Developer Platform 建立
設定
選項 A:讓你的代理安裝(建議)
在 Claude Code、Cursor 或 Codex 工作階段中貼上:
Install the Meshy MCP server for me. Docs: https://github.com/meshy-dev/meshy-mcp-server Help me configure MESHY_API_KEY locally in the client settings. Do not ask me to paste an API key into this chat.
選項 B:手動設定
請依照 meshy.ai/mcp 或 GitHub README 中適用於你的用戶端的手動步驟操作。
驗證連線
伺服器會在你下一則訊息時載入。請詢問你的代理:「我的 Meshy 點數餘額是多少?」
如果它有回答,就代表已連線 — 只要描述你想要的模型即可。
使用 ChatGPT?
從 ChatGPT Plugins 新增 Meshy 3D,並使用你的 Meshy 帳戶登入。不需要 API 金鑰或本機設定,且網頁版與桌面版皆可使用。
點數與安全性
透過 MCP 進行的產生作業會使用與你的 API 金鑰相連結帳戶中的 API 點數,就如同直接呼叫 API 一樣。
請將 API 金鑰視同密碼:切勿將其貼到聊天中,也不要將其提交到原始碼控制系統或共用設定檔中。
深入了解
教學課程:使用 Meshy API 與 MCP
供 AI 代理使用的文件:docs.meshy.ai/api/ai.md
常見問題
1. MCP 伺服器與瀏覽器中的 Meshy Agent 相同嗎?
不相同。Meshy 3D Agent 是 meshy.ai 上的聊天介面。MCP 伺服器則是將 Meshy 的工具提供給 Claude Code、Cursor 或 Codex 等外部 AI 用戶端使用。
2. 我的用戶端沒有列出 Meshy 工具。該怎麼辦?
請確認已安裝 Node.js 18 以上版本,且已在用戶端的 MCP 設定中設定 MESHY_API_KEY,然後重新啟動用戶端。請參閱 GitHub README 的疑難排解章節。
3. MCP 產生作業會使用與網頁應用程式相同的點數嗎?
這類作業會使用擁有你 API 金鑰之帳戶的 API 點數。
4. 產生的模型會存放在哪裡?
請代理下載你需要的格式,例如 GLB 或 FBX。本機下載的檔案會存放在 meshy_output/ 底下,可直接供你的 DCC 應用程式或切片軟體使用。
5. 我可以在多個工具中重複使用同一個 API 金鑰嗎?
可以,但僅限於你信任的用戶端;請勿將其放入共用或公開的設定檔中。