把 Claude Code、Codex 或 Cursor 连接到 MonstarX

Claude Code、Codex 和 Cursor 这样的 AI 编程智能体很擅长写应用，但剩下的事都留给了你：找地方运行它、生成一个可以分享的链接、配域名、配数据库、做测试，还要让不懂开发的人也能继续修改它。MonstarX 负责的正是这些“剩下的事”。

把你的智能体和 MonstarX 连接一次，之后只要说“将此应用推送到 MonstarX”，它做好的应用就会出现在 MonstarX 上，在实时预览中运行，还附带一个可以分享的链接。从此以后，你可以在智能体里继续开发，也可以在 MonstarX 里继续，或者两边一起来：修改会双向同步。

智能体通过 MCP（Model Context Protocol，一种让 AI 工具使用其他服务的标准方式）连接。MonstarX 的 MCP 服务器地址是：

https://monstarx.com/mcp

完整的开发者指南请参阅 MonstarX 的 MCP 页面。

怎样连接我的智能体？

1. 打开 设置›API 与 MCP。在 连接编程智能体 下选择你的智能体。

   

2. 保持选择 浏览器登录，把页面显示的设置内容复制到你的智能体中。下面的标签页列出了最常用智能体的相同设置。

3. 智能体要求登录时，登录 MonstarX。浏览器会打开 MonstarX：登录后点击 允许。不需要密钥。

4. 告诉它：“将此应用推送到 MonstarX，并给我链接。”

Claude Code

Claude Code 的命令行工具、桌面应用的 Code 标签页和各 IDE 扩展共用一套设置。运行：

claude mcp add --transport http --scope user monstarx https://monstarx.com/mcp

然后在 Claude Code 中运行 /mcp，选择 monstarx，再选择 Authenticate（或运行 claude mcp login monstarx）。浏览器会打开 MonstarX：登录后点击 允许。

--scope user 让 MonstarX 在所有文件夹中都可用；去掉它则只添加到当前项目。

Codex

对于 OpenAI 的 Codex 命令行工具和 IDE 扩展，运行：

codex mcp add monstarx --url https://monstarx.com/mcp
codex mcp login monstarx

登录命令会打开浏览器：登录 MonstarX 后点击 允许。

Codex 默认在没有网络访问的情况下运行命令，而推送应用需要联网。Codex 询问时，请批准上传命令，或者为本次会话允许网络访问。

Cursor

在设置页面的 Cursor 设置中点击 添加到 Cursor，或者把 MonstarX 添加到 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "monstarx": {
      "url": "https://monstarx.com/mcp"
    }
  }
}

Cursor 会在 Settings → MCP 中列出 MonstarX，并提供登录按钮：登录后点击 允许。在 Cursor 的命令行智能体中运行：agent mcp login monstarx。

VS Code

对于 GitHub Copilot 的智能体模式，在设置页面的 VS Code 设置中点击 在 VS Code 中安装，或者运行：

code --add-mcp '{"name":"monstarx","type":"http","url":"https://monstarx.com/mcp"}'

第一次运行 MonstarX 工具时，VS Code 会要求你登录：登录后点击 允许。

Gemini CLI

运行：

gemini mcp add --transport http monstarx https://monstarx.com/mcp

然后在 Gemini CLI 中运行 /mcp auth monstarx，并在浏览器中点击 允许。

Windsurf

把 MonstarX 添加到 ~/.codeium/windsurf/mcp_config.json。第一次使用时，Cascade 会要求你登录：

{
  "mcpServers": {
    "monstarx": {
      "serverUrl": "https://monstarx.com/mcp"
    }
  }
}

Claude 应用

在 Free、Pro 和 Max 套餐中：依次进入 Customize → Connectors → Add custom connector，粘贴 https://monstarx.com/mcp，然后点击 Connect：登录 MonstarX 并点击 允许。在 Team 和 Enterprise 套餐中，由 Owner 在 Organization settings → Connectors 中添加，成员再点击 Connect。

同一个连接器在网页版、桌面应用和移动端都能使用。Claude 的聊天没有命令行，所以整个应用要通过 GitHub 导入，而不是直接上传。

ChatGPT

在 ChatGPT 设置中开启 Developer mode（Business 和 Enterprise 需管理员先允许），然后使用地址 https://monstarx.com/mcp 创建新应用或连接器，并选择 OAuth。每次运行会修改内容的工具前，ChatGPT 都会先征求你的确认。

设置页面还介绍了 Grok、Lovable、Bolt & v0、Replit、Figma 和 其他，也就是任何支持 MCP 的工具。包含更多客户端的完整开发者指南，可以通过 设置›API 与 MCP 顶部的 文档 打开。

如果我的智能体需要密钥怎么办？

Windsurf、Gemini CLI、脚本和 CI 使用 API 密钥，而不是浏览器登录。在 设置›API 与 MCP 的 API 密钥 下创建一个，然后把智能体的设置切换为 API 密钥，就能得到包含密钥的版本。关于创建、使用和吊销密钥，请参阅 API 与 MCP。请勿把密钥放进代码或聊天中：密钥可以代表你操作所有项目。

我可以让智能体做什么？

连接之后，用日常语言和你的智能体对话就行。试试这些：

• “将此应用推送到 MonstarX，并给我链接。”
• “将我的更改推送到 MonstarX。”
• “从 MonstarX 拉取最新版本，并与我的更改合并。”
• “让 MonstarX 添加 Stripe 结账功能，然后拉取它的更改。”
• “在 MonstarX 上发布。”

在没有命令行的聊天应用中（Claude 应用、ChatGPT），可以试试“在 MonstarX 上为我的美发店构建一个预约应用。”“将 github.com/me/my-app 导入 MonstarX。”或“MonstarX 正在我的 Harbour Watch 项目中做什么？”

提示

想让智能体自己完成设置？在 MonstarX 的 MCP 页面上点击 复制智能体设置提示，粘贴给智能体。它会阅读说明、自行连接、推送应用，然后把链接给你。

智能体推送应用时会发生什么？

1. 智能体向 MonstarX 申请一个一次性上传链接，然后用一条命令发送应用的文件夹。node_modules、构建产物和 .env 文件会留在你的电脑上，而且文件从不经过 AI 模型，所以大应用消耗的 token 并不比小应用多。

2. MonstarX 会检查这是什么样的应用（和 导入应用 时的检查相同），然后用它自己的依赖包在实时预览中运行。

3. 智能体会收到项目链接、MonstarX 的检查结果，以及应用还需要的密钥。

之后的每次推送都会在 版本 中成为一个新版本，以智能体命名（“由 Claude Code 推送”），并在聊天中附上一条说明，让你和 MonstarX 的构建助手知道改了什么。如果在你的智能体上次获取副本之后，有人在 MonstarX 中做了修改，推送会被拒绝，而不会覆盖对方的工作：智能体会先下载 MonstarX 上的版本，合并后再重新推送。

MonstarX 为我的智能体提供哪些工具？

工具	作用
get_account	你的账户、套餐和剩余用量
list_projects	你的项目，最近修改的排在最前
get_project	一个项目的概况：MonstarX 正在做什么、预览、发布状态、缺少的密钥
prepare_upload	一次性上传链接，以及把当前文件夹推送为新项目或新版本的命令
import_from_github	从 GitHub 仓库导入应用
push_files	直接写入几个文件，适合小修改或没有命令行的智能体
create_project	让 MonstarX 根据描述、图片或文档构建一个新应用
read_files	列出或读取项目的文件
download_project	一次性下载链接，以及解压项目的命令
send_message	让 MonstarX 的构建助手构建、回答或规划，就像你在工作区中输入一样
get_messages	读取项目的聊天，可选择等待 MonstarX 回复完毕
stop	停止 MonstarX 在某个项目中正在运行的任务
publish_project	让当前版本上线
set_secrets	把应用读取的密钥加密保存到“后端 → 密钥”中
get_logs	预览的状态和输出；可以启动已停止的预览

每个工具都只能操作你拥有的项目。只读的工具会被标记为只读，智能体运行它们时无需询问；发布则总是会先征求确认。

限制

• 上传： .tar.gz 格式（推送命令生成的格式）最大 100 MB，.zip 格式最大 50 MB。超过 10 MB 的文件会被排除，并列出清单。
• push_files： 每次调用最多 200 个文件，每个 400 KB，总计 2 MB。
• 链接： 上传和下载链接只能使用一次，有效期 15 分钟。
• 会删掉项目大部分内容的推送（文件数少于原来的四分之一）会被拒绝，这几乎总是因为选错了文件夹。
• MonstarX 正在构建时，对该项目的推送会被拒绝。
• 用量： 让 MonstarX 构建（send_message、create_project）会消耗套餐用量。推送、导入、下载、读取和发布则不会。
• API 密钥： 每个账户最多 20 个。浏览器登录在 90 天的使用期内保持有效。

故障排除

• 看不到 MonstarX 的工具。 大多数智能体在会话开始时加载服务器：请开始一个新会话。在 Claude Code 中，/mcp 会显示 MonstarX 是否已连接。
• 提示 “Sign in” 或未授权错误。 登录已过期，或者密钥已被吊销。重新登录（在 Claude Code 中运行 /mcp，或运行 codex mcp login monstarx），或者创建一个新密钥。
• Codex 无法上传。 它的沙盒阻止了网络访问：批准该命令，或者允许网络访问。
• 提示 “This upload has 3 files and the project has 214”。 命令在错误的文件夹中运行了。请在 package.json 所在的文件夹中运行。
• 提示 “The files in MonstarX changed since your copy was taken”。 在你上次推送之后，有人在 MonstarX 中做了修改。让你的智能体下载、合并后重新推送。
• 找不到私有 GitHub 仓库。 请先在 MonstarX 中连接 GitHub，请参阅 GitHub。
• 应用无法启动。 让你的智能体检查日志；缺少的密钥可以用 set_secrets 设置。

怎样断开智能体？

打开 设置›API 与 MCP，在 已连接的智能体 下点击对应智能体旁边的 断开连接，它会立即退出登录。使用密钥的智能体，在你 吊销 密钥后就会停止工作。请参阅 API 与 MCP。

常见问题

我需要 API 密钥吗？

通常不需要。大多数智能体通过浏览器登录：你登录 MonstarX 并点击 允许 即可。密钥适用于无法打开浏览器的智能体、脚本和 CI。

我的 .env 文件会被上传吗？

不会。推送命令会排除这些文件；即使有文件被传上来，MonstarX 也不会保存。请把密钥保存在 后端 → 密钥 中，或者让你的智能体使用 set_secrets。

可以同时在智能体和 MonstarX 中继续开发吗？

可以。从智能体推送，在 MonstarX 中构建，然后让智能体拉取最新版本。版本检查会防止任何一方覆盖另一方的修改。

哪些应用可以在 MonstarX 上运行？

MonstarX 应用和 Vite 应用（React、Vue、Svelte，包括所有 Lovable、Bolt 和 v0 导出的项目）可以在这里运行和发布。Next.js、Remix、Astro、Nuxt 和 SvelteKit 可以在预览中运行，但需要发布到它们自己的托管平台。其他应用可以重建为 Web 应用。

这和 MCP 连接器是一回事吗？

不是，方向正好相反。这里是你的智能体使用 MonstarX；而 MCP 连接器 是让 MonstarX 使用其他 MCP 服务器。

相关内容

从编程智能体开始把你在别处做好的应用推送过来，作为新项目。

API 与 MCP已连接的智能体和 API 密钥。

导入应用哪些应用能在 MonstarX 上运行，以及导入的流程。

GitHub把项目保存在 GitHub 仓库中。