1. 从零到上线个人网站部署到底卡在哪很多同学第一次做个人网站代码写得挺顺一到部署就卡住。脑子里第一反应是「得买服务器、得注册域名、得配 Nginx」然后算一下成本和时间热情直接掉一半。其实现在做个人网站尤其是静态页或者轻量前端项目完全不需要自己买服务器。EdgeOne Pages 这类边缘全栈平台提供免费额度配合 MCPModel Context Protocol把部署动作直接接进 AI 编辑器从生成代码到线上可访问十几分钟就能跑通。这篇要解决的核心问题就一个edgeone pages mcp 怎么配合 Qwen3-Coder 把个人网站快速部署上线。适合谁看会一点前端、用过 AI 编辑器Qoder、Cursor、Cline 都行、想把自己的主页或小作品挂到公网的人。不需要你有服务器运维经验也不需要你懂 CDN 原理跟着配置走就行。整条链路分两段。第一段是简易版用一个静态 HTML 页面先跑通「部署」这个动作确认账号、Token、项目名这些基础环节没问题。第二段是进阶版在 AI 编辑器里配好 EdgeOne Pages MCP让 Qwen3-Coder 生成页面代码然后通过 MCP 工具直接部署最后在控制台绑定域名。两段都跑完你就有了一个可以发给别人访问的网址。我试过把这两段拆开做原因是如果一上来就配 MCP一旦部署失败你分不清是 Token 错了、项目名错了还是 MCP 配置本身有问题。先用简易版确认平台侧是通的再上 MCP排障会快很多。这里还要提一个关键点Qwen3-Coder 这类模型在 AI 编辑器里调用时需要一个统一的 API Key 入口。TaoToken 在这里的作用就是把模型调用统一到一个 Key 上你不用在多个平台之间来回切换配置。官网地址是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 入口是 https://taotoken.net/api 。后面配置 MCP 和模型时都会用到。先说清楚一个概念避免后面混淆。EdgeOne Pages 的 API Token 和 TaoToken 的 API Key 是两个东西前者是 EdgeOne 平台用来授权你部署项目的凭证后者是给 AI 编辑器调用模型用的。两个都要配但用途不同。很多人第一次配的时候把这两个搞混结果 MCP 报 401其实是 Token 填错了位置。2. TaoToken 前置统一 Key 与 EdgeOne Pages 项目准备在动 MCP 之前先把两个「前置账号」理清楚一个是模型侧的 TaoToken一个是部署侧的 EdgeOne Pages。这两步做完后面配置才有东西可填。先说 TaoToken。它的定位是统一模型调用入口你拿到一个 API Key 之后在 AI 编辑器里配置 Base URL 和 Key就能调用包括 Qwen3-Coder 在内的模型。操作路径是打开 https://taotoken.net/api 进入控制台找到 API Keys 页面创建一个 Key。创建时给它起个名字比如edgeone-blog方便以后区分。创建完复制出来这个 Key 只显示一次丢了就得重建。拿到 Key 之后在 AI 编辑器里配置模型。以 Qoder 为例在设置里找到模型配置填入Base URLhttps://taotoken.net/apiAPI Key你刚创建的那串Model IDQwen3-Coder具体以控制台模型列表为准配好之后编辑器里选模型时就能看到 Qwen3-Coder。这一步先确认模型能正常对话再往下走。如果模型都调不通后面 MCP 部署更没法排障。再说 EdgeOne Pages。打开 EdgeOne 官网点「免费开始」进入控制台。注意这里有个坑一定要点「免费开始」这个入口不要点其他登录方式否则可能进到不同的产品线页面。进去之后先创建一个示例项目。控制台里会有模板选第一个 Landing page demo 就行它会自动帮你部署一个初始版本。这一步的目的是先有一个真实存在的项目拿到它的项目名后面 MCP 配置里要填。项目创建完回到管理页面找到 API Token 菜单创建一个 Token。名字和有效期随意填比如名字叫mcp-deploy有效期选最长。创建完它会显示一串 Token右侧有复制按钮复制下来。这串 Token 就是EDGEONE_PAGES_API_TOKEN的值。同时记下你的项目名。比如你选的模板项目叫landing-page-demo那EDGEONE_PAGES_PROJECT_NAME就填这个。项目名在控制台项目列表里能看到别填错填错了 MCP 部署会找不到目标项目。到这里你手上有三样东西TaoToken 的 API Key、EdgeOne 的 API Token、EdgeOne 的项目名。这三样是后面配置的核心先放在手边。注意EdgeOne 的 API Token 和 TaoToken 的 API Key 不要混用。前者填在 MCP 配置的env里后者填在编辑器的模型配置里。混了就是 401。3. 可复制配置MCP 片段与编辑器 settings这一节是整篇最核心的部分直接给可复制的配置片段。你照着填路径和字段名保持一致基本不会出问题。先配 MCP。在 AI 编辑器里找到 MCP Server 配置入口。以 Qoder 为例点右上角头像进入设置找到 MCP Server 这一块。不同编辑器入口位置不一样Cursor 在 Settings 里的 MCP 面板Cline 在侧边栏的 MCP Servers 图标但配置格式基本一致都是 JSON。把下面这段粘进去{ mcpServers: { edgeone-pages-mcp-server: { command: npx, args: [edgeone-pages-mcp], env: { EDGEONE_PAGES_API_TOKEN: 替换为你的EdgeOne API Token, EDGEONE_PAGES_PROJECT_NAME: 替换为你的项目名例如 landing-page-demo } } } }两个替换点EDGEONE_PAGES_API_TOKEN填你在 EdgeOne 控制台创建的那串 TokenEDGEONE_PAGES_PROJECT_NAME填你的项目名。注意项目名不要带引号以外的多余空格JSON 里字符串就是字符串。如果你用的是 Cline 或者别的支持 MCP 的编辑器配置结构一样只是外层可能多一层mcpServers的包装。核心是command用npxargs是edgeone-pages-mcpenv里两个变量填对。配完保存编辑器一般会提示你重启 MCP 服务或者重新加载。重启之后在 MCP 面板里应该能看到edgeone-pages-mcp-server处于已连接状态。如果显示红色或者报错先看下一节的排障。接下来配模型。还是在编辑器设置里找到模型配置填 TaoToken 的信息{ baseUrl: https://taotoken.net/api, apiKey: 替换为你的TaoToken API Key, model: Qwen3-Coder }不同编辑器字段名可能略有差异比如有的叫base_url有的叫apiBase但值是一样的。Base URL 一定是https://taotoken.net/api不要加多余的路径。Model ID 填Qwen3-Coder如果控制台里显示的是带版本号的以控制台为准。这里有个细节MCP 配置和模型配置是两套独立的配置。MCP 负责「部署」这个动作模型负责「生成代码」这个动作。两者都配好才能实现「让 Qwen3-Coder 写页面然后通过 MCP 部署」。如果你用的是 Claude Code 这类工具配置方式类似但要注意 Claude Code 的 MCP 配置通常在~/.claude/settings.json或者项目级的.mcp.json里。格式还是上面那个 JSON 结构。Claude Code 的模型接入如果走 TaoTokenBase URL 同样填https://taotoken.net/apiKey 填 TaoToken 的 Key。配好之后建议先做一个最小验证在编辑器里让模型说一句话确认模型通了然后在 MCP 面板里看服务状态确认 MCP 通了。两个都通再进下一步。提示如果你在 MCP 配置里用了npx确保本地 Node.js 环境正常。npx edgeone-pages-mcp第一次运行会去下载包网络不通会卡住。可以先在终端手动跑一次npx edgeone-pages-mcp --help看看能不能拉起来。4. 验证请求从生成页面到访问成功配置通了之后开始实际生成和部署。这一步的目标是让 Qwen3-Coder 生成一个个人主页然后通过 MCP 部署最后拿到一个可访问的网址。先在编辑器里新建一个项目目录比如my-homepage。然后在对话里给 Qwen3-Coder 下指令。指令要具体别只说「帮我做个网站」那样生成的东西太泛。可以这样说帮我生成一个个人主页的静态页面包含 1. 顶部导航栏有「首页」「项目」「关于」三个链接 2. 首屏一个自我介绍区域标题是我的名字副标题一句话简介 3. 下面一个项目卡片区域放三个项目卡片每个卡片有标题、描述、链接 4. 底部一个联系方式区域 技术要求单个 index.html 文件内联 CSS不依赖外部框架响应式布局。Qwen3-Coder 会生成一个完整的index.html。生成之后先别急着部署在本地打开看看效果。如果样式有问题继续对话让它改比如「导航栏在手机上换行了改成汉堡菜单」或者「项目卡片间距太小加大到 24px」。改到满意为止。本地确认没问题后通过 MCP 部署。在支持 MCP 的编辑器里通常可以直接在对话里说「用 edgeone-pages-mcp-server 部署当前项目」或者「把 my-homepage 部署到 EdgeOne Pages」。编辑器会调用 MCP 工具把当前目录的文件上传到 EdgeOne Pages。部署过程中编辑器会返回日志。你会看到类似「Uploading files」「Deploying」「Deployment successful」这样的输出。如果成功它会给你一个预览 URL形如https://xxx.edgeone.app或者你项目对应的域名。复制这个 URL在浏览器打开应该能看到你刚生成的页面。验证清单逐项确认页面能正常打开没有 404样式和本地一致没有错位导航链接能跳转如果是锚点链接手机浏览器打开也正常响应式生效EdgeOne 控制台的项目列表里能看到这次部署的记录如果这些都过了说明整条链路是通的。接下来是域名绑定。在 EdgeOne 控制台找到你的项目进入域名管理添加自定义域名。前提是你得有一个域名。域名可以在阿里云等平台购买便宜的几块钱一年。添加后按提示配置 DNS 解析通常是加一条 CNAME 记录指向 EdgeOne 给的地址。解析生效后用你的域名访问能看到页面就成功了。如果你没有自己的域名也可以先用平台给的默认域名。默认域名能用只是不够个性化。等确认整条链路没问题再考虑买域名绑定。注意域名解析生效需要时间通常几分钟到几十分钟。如果刚配完访问不了先等一会儿别急着反复改配置。5. 常见错排查401、local proxy failed 与 OAuth这一节列几个真实会遇到的报错以及对应的排查方向。这些错我都踩过按顺序查基本能定位。报错一401 Unauthorized这是最常见的。MCP 部署时报 401说明 EdgeOne 的 API Token 不对或者过期了。排查步骤检查EDGEONE_PAGES_API_TOKEN是否填对有没有多余空格回 EdgeOne 控制台确认 Token 还在有效期内确认这个 Token 有部署权限创建时如果选了只读权限部署会失败如果 Token 刚重建过旧 Token 会失效要更新配置如果是模型调用时报 401那是 TaoToken 的 Key 问题。检查 Base URL 是不是https://taotoken.net/apiKey 有没有复制完整。Key 只显示一次如果丢了就重建一个。报错二local proxy failed / connection refused这个通常出现在 MCP 服务启动阶段。原因是npx edgeone-pages-mcp没拉起来。排查本地 Node.js 是否安装版本是否太旧建议 18 以上终端手动跑npx edgeone-pages-mcp看报什么错如果是网络问题导致包下载失败检查网络环境编辑器里 MCP 配置的command路径是否正确有的环境需要写npx的绝对路径报错三reading choices of undefined这个报错一般出现在模型调用返回结构异常时。常见原因是 Base URL 配错了比如多加了/v1或者少了路径导致返回的不是标准结构。确认 Base URL 就是https://taotoken.net/api不要自己拼路径。另外确认 Model ID 填的是控制台里存在的模型填错模型名也可能返回异常结构。报错四OAuth / 授权失败如果你在配置过程中遇到 OAuth 相关报错通常是因为走了错误的登录入口。EdgeOne 这边一定要从「免费开始」进入不要从其他 OAuth 入口进。如果已经进了错误页面退出重新从官网入口进。MCP 本身不需要 OAuth它用的是 API Token所以如果 MCP 报 OAuth大概率是编辑器把 MCP 配置和别的登录流程混了检查配置文件里有没有多余的 auth 字段。报错五部署成功但访问 404部署日志显示成功但打开 URL 是 404。排查确认部署的目录里有index.html且文件名大小写正确确认项目名填对了部署到了正确的项目如果是子路径部署确认访问路径对不对控制台里看部署记录确认文件确实上传了报错六域名绑定后访问不了域名配了但打不开。排查DNS 解析是否生效用nslookup 你的域名看解析结果CNAME 记录是否填对有没有和已有的 A 记录冲突EdgeOne 控制台里域名状态是否显示「已生效」如果用了 HTTPS证书是否签发完成这些错排查下来基本覆盖了从配置到部署到访问的主要环节。遇到报错先看错误码再对照上面的方向查比盲目改配置快。6. 语义一致 CTA把 Key 和部署链路固定下来整条链路跑通之后建议把配置固定下来别每次重新配。MCP 配置和模型配置都保存在编辑器里换项目时只需要改EDGEONE_PAGES_PROJECT_NAME。TaoToken 的 Key 如果长期用可以在控制台里管理需要轮换时重建一个更新到编辑器配置里就行。如果你后面要长期做编码和 Agent 类的任务可以考虑用 Coding Plan把模型调用和部署流程都固定在一套配置里。模型对话入口可以用来验证模型是否正常接入文档里有更详细的参数说明。API Keys 页面用来管理你的 Key。具体入口模型对话https://taotoken.net/api?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentCoding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content控制台https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentAPI Keyshttps://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content最后说一个实用技巧每次部署前先在本地把页面跑一遍确认没问题再通过 MCP 部署。部署后立刻打开 URL 验证别等域名配完再验。域名绑定是最后一步先把默认域名跑通再上自定义域名。这样出问题时你能快速判断是部署环节的问题还是域名环节的问题。回滚也简单EdgeOne 控制台里有部署历史选上一个版本重新发布就行。