---
title: "安装 WEPPY Roblox 插件"
summary: "从 hope1026/weppy-roblox-mcp 安装 weppy-roblox-ai-toolkit@hope1026-roblox-mcp。插件会登记本地 Roblox MCP。"
category: mcp
level: starter
surfaces: [cli, app, ide]
tags: ["MCP", "WEPPY", "Roblox", "plugins"]
canonical: /tips/weppy-roblox-codex-plugin/
---

# 安装 WEPPY Roblox 插件

从 hope1026/weppy-roblox-mcp 安装 weppy-roblox-ai-toolkit@hope1026-roblox-mcp。插件会登记本地 Roblox MCP。

WEPPY Roblox 插件先 marketplace add hope1026/weppy-roblox-mcp，再装 weppy-roblox-ai-toolkit。官方 Codex CLI 专节把这条插件和 MCP 拆开：插件会带 Roblox Studio 工作流技能，并登记本机 stdio MCP；只要连 Studio、不要技能时才手写 `mcp add`。

这不是 Roblox 官方 Studio MCP，也不是 VS Code 里的 WEPPY Roblox Explorer。先在 Roblox Studio 装 **WEPPY Roblox Studio Plugin**，Plugins 页点 WEPPY → Connect。本机看板默认 `http://localhost:3002`。Node.js 要 18+。MCP 包和 Studio 插件必须同一发行版，对不上就一起更新，再重启 Studio 后重连。

在**普通终端**加 marketplace，不要在 Codex TUI 里跑：

```bash
codex plugin marketplace add hope1026/weppy-roblox-mcp
codex plugin add weppy-roblox-ai-toolkit@hope1026-roblox-mcp
codex plugin list
```

`.agents/plugins/marketplace.json` 的 name 是 `hope1026-roblox-mcp`，插件 name 是 `weppy-roblox-ai-toolkit`，显示名是 WEPPY AI Agent Plugin。所以 CLI 是 `weppy-roblox-ai-toolkit@hope1026-roblox-mcp`。官方文档只写完 marketplace 后开 TUI `/plugins` 再 Install plugin；现行 CLI 动词是 `add` 不是 `install`。`plugin add` 失败就按文档走 `/plugins`。桌面 Plugins 搜 WEPPY 效果一样。0.154 起可先检查当前会话；未显示插件时再新开会话。

插件会把 MCP 登记成：

```toml
[mcp_servers.weppy-roblox-mcp]
command = "npx"
args = ["-y", "@weppy/roblox-mcp@latest"]
```

这是 **stdio**，不要 `url`，不要 `codex mcp login`。bundled `.mcp.json` 表名就是 `weppy-roblox-mcp`。已经装了插件就**不要**再 `mcp add` 重复的服务配置。

只要 MCP、不装技能时，官方 Method 2：

```bash
codex mcp add weppy-roblox-mcp -- npx -y @weppy/roblox-mcp@latest
```

`codex mcp get weppy-roblox-mcp` 应看到 command 是 `npx`。装完在 Studio 里 Connect，再让它说当前选中了什么。连不上先看 Studio 是否 Connected，以及 3002 有没有被防火墙拦。MCP 起不来可在终端直接跑 `npx -y @weppy/roblox-mcp@latest` 看报错。插件没出现在目录里：

```bash
codex plugin marketplace upgrade hope1026-roblox-mcp
```

官方一键 `install.sh` 会给 Codex 加 marketplace，并提示你去 Plugin Directory 装插件；检测不到插件时回退 `mcp add weppy-roblox-mcp`。那是安装器路径，不是 `plugin add` 的替代写法。改画布、写脚本、开 Playtest 保留操作审批。

网页 Cloud 不读取 `~/.codex/config.toml`。配置后重新打开会话。核对：`codex plugin list` 看到 `weppy-roblox-ai-toolkit@hope1026-roblox-mcp` 为 installed, enabled；`codex mcp get weppy-roblox-mcp` 的 command 是 `npx`。

## 来源

- [WEPPY · Codex CLI Setup](https://weppyai.com/en/docs/agents/codex-cli/)
- [WEPPY · Getting Started](https://weppyai.com/en/docs/getting-started/)
- [hope1026/weppy-roblox-mcp](https://github.com/hope1026/weppy-roblox-mcp)