PageOn

PageOn · AI 工具

连接 AI 工具

让 AI 工具生成的 HTML 自带编辑能力。配置一次,在交付文件前调用 PageOn 即可。

1. 选择你的 AI 工具

先连接,再确认工具可用,最后生成一份免费可编辑 HTML。

Codex:使用 PageOn 插件

按安装指南下载并安装插件,在浏览器中登录 PageOn 并授权,然后返回 Codex 新建任务。无需手动复制凭据。

打开 Codex 插件安装指南

下载的插件连接 pageon.cc 正式服务,通过个人插件市场安装;公共插件市场暂未上架。

手动连接 Codex(不安装插件)
创建或复制个人访问凭据

把个人凭据保存在本地安全配置中,并通过 PAGEON_TOKEN 环境变量传给启动 AI 工具的进程。不要把真实凭据写进对话、HTML 或项目配置。

将下面的配置合并到 ~/.codex/config.toml,保留已有配置。已连接插件时无需重复手动配置。重启 Codex 后,在 /mcp 中检查 PageOn。

[mcp_servers.pageon]
url = "https://pageon.cc/mcp"
bearer_token_env_var = "PAGEON_TOKEN"
客户端官方配置说明

浏览器授权只适用于已向 PageOn 注册的客户端,例如现有 Codex 插件。手动连接使用个人 Bearer 凭据;仅支持 OAuth 的其他客户端不能仅凭服务地址直接接入。

2. 确认工具已连接

打开客户端的 MCP 工具列表(Codex 和 Claude Code 可使用 /mcp),确认 PageOn 已连接并能看到下面四个工具。只检查连接和工具列表不会扣积分,也不会上传 HTML。

  • create_html_upload

    准备临时上传

  • enhance_html

    免费文字编辑与文字批注

  • enhance_html_premium

    角色形象批注与高级离线工具:每份 HTML 1 Credit,需明确授权

  • complete_html_upload

    本地保存并回读确认后清理临时文件

请检查 PageOn MCP 连接并列出可用工具。这一步不要上传文件,也不要调用增强或付费工具。

工具名可能带客户端前缀。若只看到已保存的服务地址、没有工具,先重新连接;仍失败时查看下面的排错说明。

3. 生成第一份可编辑 HTML

生成一份包含标题和段落的简单 HTML 页面,使用 PageOn 的免费 enhance_html 添加基础编辑能力,并保存为相邻的新 HTML 文件,保留原文件。允许把本次 HTML 发送给 PageOn 临时处理。保存并回读确认后清理临时文件,不使用付费工具。

客户端会根据工具说明完成上传、转换、下载与保存。打开新 HTML 后,应能点击“编辑”、修改文字,再“保存副本”。

AI 工具的预览环境可能禁止脚本或下载;此时下载文件后在浏览器打开。动态页面重新渲染可能覆盖修改,请查看返回的兼容性提示。

普通增强及文字批注免费,零积分也可使用。角色形象批注、高级离线工具和去品牌每份 HTML 消耗 1 Credit,必须另行明确授权;连接成功不代表同意付费。

个人访问凭据

访问凭据统一在个人空间管理。登录后,可在 AI 接入页面创建、复制或撤销凭据。

前往个人空间管理凭据
开发者参考:参数、文件流程与计费

连接成功后,需要自行实现客户端或排查文件流程时再看这里。

服务地址
https://pageon.cc/mcp
传输方式
Streamable HTTP
请求头
Authorization: Bearer YOUR_PAGEON_TOKEN
通用配置示例
{
  "mcpServers": {
    "pageon": {
      "type": "http",
      "url": "https://pageon.cc/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_PAGEON_TOKEN"
      }
    }
  }
}

选择支持 Streamable HTTP 和自定义请求头的 AI 工具,添加以下连接。将占位符替换为自己的凭据;字段名称以工具的设置界面为准。

要求 AI 工具创建上传会话并直传文件,再调用 enhance_html,下载结果 JSON 并把 html 字段保存为新的 HTML 文件;确认保存后清理临时文件,保留原文件。

推荐流程:create_html_upload 提交 fileName、字节大小 size、lang 和 tier,直传文件后,向增强工具提交 sessionId 和 credential。这里的 credential 是上传会话返回的短期凭据,不是账户访问凭据;不要将账户凭据放进工具参数。高级导出还需相同 requestId。下载 resultUrl 指向的 JSON(若返回 resultUrls,则按顺序下载并拼接字节后解析),保存 html,回读确认后调用 complete_html_upload,传入 sessionId、credential 和相同 tier。

会话模式返回结果下载地址。普通增强的结果 JSON 包含完整 HTML、建议文件名、兼容性信息和 creditsUsed: 0。普通增强免费,余额为 0 也可使用,文件内支持基础文字编辑和文字批注,文字批注不扣积分。角色形象批注(内置角色、自定义图片与随机动画)、离线高级工具栏(字体、颜色、透明度、复制、同级拖拽、历史与还原)和去品牌,请明确授权付费并调用 enhance_html_premium:每份 HTML 扣 1 Credit,使用当前凭据所属账户的积分;需额外传入 UUID requestId,重试保持相同 ID 和全部输入,成功后的重复请求不再扣费。7 天内且输出版本未变化时可恢复文件;扣费结果不确定时不要换 ID 重试。

打开文件默认浏览,点击“编辑”后修改文本与 SVG 文字,点击“保存副本”下载。Runtime 随文件保留,无需登录即可离线编辑。原页面的字体、图片和脚本可能仍需网络。

文件与隐私

文件通过私有临时存储进行转换,本地保存确认后删除云端原文件和结果,异常残留由定时任务清理。会话还保存短期文件名、大小、归属、凭据摘要和有效期;调用日志不保存正文。原页面脚本会保留,但不会在服务端执行。

限制与排错

单份 HTML 最大 50 MB(UTF-8),与官网一致。建议文件不超过 10 MB;较大文件上传和处理需要更长时间,请耐心等待。使用 create_html_upload 签名直传,再用会话调用增强工具;内联兼容路径限 1 MiB,MCP 控制请求限 2 MiB。每个凭据每分钟最多 60 次请求,包含连接与工具发现请求。

401:检查凭据或登录授权是否到期、失效或已撤销;使用环境变量配置时,确认 PAGEON_TOKEN 已传给当前客户端进程。429:触发速率或临时存储容量限制,请稍后重试。413:50 MiB 内文件请使用签名直传,超限文件需缩小。503:服务暂不可用。预览未显示编辑入口时,请下载文件后打开。

AI 工具 MCP 接入指南 | PageOn