概述
Meshy MCP(Model Context Protocol,模型上下文协议)服务器让 Cursor、Claude Code 等 AI 编码代理可以直接在您的编码环境中调用 Meshy 的 3D 生成工具,它与网页版 Meshy Agent 相互独立。
Meshy Agent 与 Meshy MCP 的区别
网页版 Meshy Agent 运行在 meshy.ai 内,让您可以在浏览器中通过对话式界面生成资产。而 Meshy MCP 服务器则把相同的底层生成工具开放给任何兼容 MCP 的客户端(例如 AI 编码助手),让您无需离开开发环境即可请求 3D 模型。
安装
将 Meshy MCP 服务器添加到客户端的 MCP 配置中(例如 Cursor 或 Claude Code 的 MCP 设置文件),并按照该客户端的文档,将其指向 Meshy MCP 服务器的命令或端点。
添加您的 API 密钥
在 Meshy 账户设置中生成 API 密钥,并在 MCP 服务器的配置中进行设置(通常设为环境变量)。该密钥用于验证 MCP 服务器发出的请求,并对应您账户的积分余额。
支持的客户端
任何支持 Model Context Protocol 的客户端都可以连接 Meshy MCP 服务器,包括 Cursor 和 Claude Code。各客户端的配置步骤略有差异 — 具体的文件位置和语法,请参阅该客户端自身的 MCP 设置文档。
积分与安全
通过 MCP 服务器触发的生成任务,会像在网页应用或 API 中一样从您关联的 Meshy 账户扣除积分。请把 API 密钥当作机密信息 — 任何拿到它的人都可以消耗您账户的积分余额进行生成,因此请勿将其提交到源代码管理或共享配置文件中。
常见问题
1. MCP 服务器和浏览器中的 Meshy Agent 是同一个东西吗?
不是。Meshy Agent 是 meshy.ai 上基于浏览器的对话界面,而 MCP 服务器把 Meshy 的工具开放给 Cursor、Claude Code 等外部 AI 编码客户端。
2. 为什么我的编码代理检测不到 Meshy MCP 服务器?
请仔细检查 MCP 配置文件的语法,并确认服务器条目指向正确的命令或端点,然后重启客户端。
3. 通过 MCP 触发的生成与我的网页账户消耗同样的积分吗?
是的,它们与您的 API 密钥来自同一个账户余额。
4. 在多个编码工具之间共用我的 API 密钥安全吗?
您可以在自己信任的客户端之间复用同一个密钥,但请避免将其暴露在共享或公开的配置文件中。