概述
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 key——请在 Meshy 开发者平台 中创建
设置
方式 A：让你的助手自动安装（推荐）
在 Claude Code、Cursor 或 Codex 会话中粘贴：
帮我安装 Meshy MCP server。文档：https://github.com/meshy-dev/meshy-mcp-server 帮我在客户端设置里本地配置 MESHY_API_KEY。不要让我把 API key 粘贴到这个对话里。
方式 B：手动设置
按照 meshy.ai/mcp 或 GitHub README 中针对你所使用客户端的手动步骤操作。
验证连接
下一条消息发出后，服务器就会加载。向你的助手提问：“我的 Meshy 积分余额是多少？”
如果它能回答，说明你已经连接成功——接下来只需描述你想要的模型即可。
使用 ChatGPT？
在 ChatGPT Plugins 中添加 Meshy 3D，并使用你的 Meshy 账号登录。无需 API key，也无需本地设置，网页端和桌面端均可使用。
积分与安全
通过 MCP 进行的生成会消耗与你 API key 所关联账号的 API 积分，与直接调用 API 完全一致。
请像对待密码一样对待你的 API key：切勿将其粘贴到聊天中，也不要将其提交到源代码管理或共享配置文件中。
了解更多
面向 AI 助手的文档：docs.meshy.ai/api/ai.md
常见问题
1. MCP server 与浏览器中的 Meshy Agent 是同一个东西吗？
不是。Meshy 3D Agent 是 meshy.ai 上的聊天界面。MCP server 则是将 Meshy 的工具开放给 Claude Code、Cursor 或 Codex 等外部 AI 客户端使用。
2. 我的客户端没有列出 Meshy 工具。该怎么办？
请检查是否已安装 Node.js 18+，以及客户端的 MCP 设置中是否已配置 MESHY_API_KEY，然后重启客户端。参见 GitHub README 的疑难解答部分。
3. MCP 生成会使用与网页应用相同的积分吗？
MCP 生成会消耗 API key 所属账户的 API 积分。
4. 生成的模型会保存到哪里？
让助手下载你需要的格式即可，例如 GLB 或 FBX。本地下载的文件会保存在 meshy_output/ 目录下，可直接用于你的 DCC 应用或切片软件。
5. 我可以在多个工具中重复使用同一个 API key 吗？
可以，在你信任的多个客户端之间重复使用即可——但请勿将其写入共享或公开的配置文件中。