Playground — PageFire MCP

MCP（Model Context Protocol）是 AI 客户端与外部工具之间的标准协议。把 PageFire 接入 Claude、Cursor 后，你只需用自然语言描述，AI 就会调用 PageFire 的工具，把 HTML、Markdown、整站打包直接发布成公网 HTTPS 页面——几秒完成，链接可长期固定，全程不碰部署流程。

01 · 接入

配置一次

在「接入」页复制 .mcp.json，填入你的 Bearer Token，加入 AI 客户端。

02 · 对话

说一句话

"把这份报告发布成网页" —— AI 自动选用合适的工具完成发布。

03 · 上线

拿到链接

立刻获得 HTTPS 子域名，直接分享；想更新就让 AI 用同名重发，链接不变。

deploy_page

单页 HTML

发布一段 HTML 字符串，立即得到独立 HTTPS 子域名，适合 AI 生成的报告与落地页。

html title? did? access? password? ttl_days? pin? spa?

deploy_markdown

Markdown 渲染

Markdown 渲染成精致排版网页，支持 light / dark / sepia 三主题，代码高亮、表格、任务列表开箱即用。自动剥离 YAML frontmatter。

markdown theme? title? did? access? pin?

deploy_docs

多页文档站

多篇 Markdown 文件自动生成带左侧导航 + 右侧目录的文档站，无需 index.md（自动推断入口），.md 链接自动改写为 .html。

files[] title? theme? did? pin?

deploy_files

多文件站点

逐文件发布 HTML + CSS + JS，支持子目录结构，二进制文件用 base64 编码传输。

files[] did? spa? pin?

deploy_zip

整站打包

上传 ZIP 包自动解压发布，支持 SPA 模式（客户端路由 fallback 到 index.html）。

zip_base64 did? spa? pin?

deploy_presentation

PDF / PPTX

上传 PDF（浏览器原生查看）或 PPTX（自动提取文本+图片，渲染为 remark.js 幻灯片，保留原始文件可下载）。

pdf|pptx title? theme? did? pin?

deploy_markdown

Markdown 幻灯片

mode="slide" 将 Markdown 渲染为全屏演示幻灯片，← → 键盘翻页，代码高亮，三主题。

markdown mode="slide" theme? title? pin?

set_access

修改访问控制

随时切换已有站点的访问方式：public（公开）/ password（密码保护）/ private（私有），无需重新发布内容。

did access password?

list_deployments

列出部署

列出当前 API Key 下的所有站点，返回 URL、状态、文件数、大小、创建时间。

include_expired?

get_deployment

查询单个部署

获取指定站点的完整详情，包括 URL、文件列表、访问控制、过期时间。

did

delete_deployment

删除部署

立即删除指定站点及其全部文件，释放存储配额，不可恢复。

did

pin_deployment

永久保留

将临时站点（设有 TTL）标记为永久保留，跳过自动 GC 清理。

did

set_space_id

自定义子域名

设置当前 API Key 的 space_id 段（全局唯一），影响该 Key 下所有站点的子域名。

space_id

1

获取 Token
在控制台注册并创建 API Key（pf_ 开头）。

2

配置连接
以 Claude Desktop / Claude Code 为例，在项目根目录创建 .mcp.json（加入 .gitignore）：

{
  "mcpServers": {
    "pagefire": {
      "type": "http",
      "url": "https://mcp.pagefire.hkting.com/mcp",
      "headers": { "Authorization": "Bearer <你的token>" }
    }
  }
}

方式二 · stdio 桥接（连不上时的兜底）：若上面的 HTTP 直连报 Failed to connect，但浏览器 / Node 能访问该域名，多为客户端运行时 TLS 被网络按指纹拦截。改用本机 Node 的 mcp-remote 桥接同一端点：

{
  "mcpServers": {
    "pagefire": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.pagefire.hkting.com/mcp",
               "--header", "Authorization:${AUTH_HEADER}", "--transport", "http-only"],
      "env": { "AUTH_HEADER": "Bearer <你的token>" }
    }
  }
}

⚠️ token 须经 env.AUTH_HEADER 传入、header 写成 Authorization:${AUTH_HEADER}（无空格）；写成 "Authorization: Bearer ..." 会因空格拆断导致工具调用 UNAUTHORIZED。

方式三 · npm 连接器包（最简，推荐）：已发布 pagefire-mcp，token 只走环境变量、无 URL、无 header 坑：

{
  "mcpServers": {
    "pagefire": {
      "command": "npx",
      "args": ["-y", "pagefire-mcp@latest"],
      "env": { "PAGEFIRE_TOKEN": "pf_<你的token>" }
    }
  }
}

3

对话发布
重启客户端后直接说："帮我把这份内容发布成网页"，AI 自动调用工具完成发布。

端点https://mcp.pagefire.hkting.com/mcp

传输Streamable HTTP · MCP 2025-03-26

鉴权Authorization: Bearer pf_xxx

其他客户端

Cursor

Settings → MCP → Add new global MCP server，填入端点 URL 与 Authorization header。Cursor 不读取 .mcp.json，需在全局设置里配置。

OpenAI Codex

在 codex.yaml 的 mcp_servers 下添加：type: http、url、headers.Authorization。

其他

任何支持 Streamable HTTP transport 的 MCP 客户端均可，填入端点 URL 与 Bearer Token 即可。

CLI

CLI · 终端 / CI 发布

不需要 AI 客户端，直接从终端或 CI 流水线发布。

1

安装

npm install -g pagefire-mcp

或免安装直接用：

npx pagefire-mcp@latest <命令>

2

设置 Token

# macOS / Linux
export PAGEFIRE_TOKEN=pf_你的token

# Windows
set PAGEFIRE_TOKEN=pf_你的token

3

发布命令

pagefire deploy ./dist   # 把目录打包发布为整站（等价于 deploy_zip）
pagefire deploy-docs ./docs   # 多个 .md 文件生成带侧栏的文档站
pagefire deploy-markdown ./README.md   # 单个 Markdown 文件渲染为网页
pagefire deploy-page ./index.html   # 发布单页 HTML

运行 pagefire --help 查看全部命令与选项。

🔑

登录后即可用你自己的 API Key 实时测试

去登录 / 注册

了解、接入并实测 MCP

配置一次

说一句话

拿到链接