文档与快速上手
最简单的方式是把提示词发给 Cursor、Trae、WorkBuddy 等能运行命令的 AI 工具,在专家模式或工作模式里直接聊天;也可以使用 REST API 做自动化部署。
方式一 — 用 AI Agent 部署(MCP)
将 27c.site 作为 MCP 服务——这一步由你的 AI 自己完成。把首页那条提示词发给 Cursor、Trae、WorkBuddy 等支持运行命令的 AI 工具,或其他 AI 应用里的专家模式/工作模式;它会自行把 27c-site 接入,再写代码、生成图片、整理页面并部署。普通快速模式通常不支持。你全程不需要接触 API Key,也不用改任何配置文件。
现成可用的提示词
请把下面这段中英混合的提示词发给支持运行命令的 AI 应用,或直接发给 AI 编程工具里的 AI,建议使用专家模式或工作模式——它会自行安装 MCP、写代码并完成发布:
"在 27c.site 上创建账号并部署我的网站。你可以是独立 AI 应用,也可以是 AI 编程工具里的 AI;请使用 27c-site MCP 工具完成全部流程。如果当前客户端无法安装 MCP,就读取服务器指令并使用 HTTP API 继续,不要把技术限制推回给我。请写好网站代码,生成需要的图片并一键发布;普通快速模式不支持。完成后告诉我线上地址。创建账号后请明确提醒我牢记平台用户名和密码:AI 可能遗忘,密码丢失后没有任何渠道找回或重置。全程使用简体中文回复。"
可用 MCP 工具
- register / login — 创建或登录账号;会话自动完成认证
- deploy — 部署文件 [{path, content | base64}]
- upload — 大体积二进制文件(base64 输入;用于超过 ~120KB 的文件)
- list_deployments / rollback — 历史记录与一键恢复
- change_subdomain、create_api_key、get_me
- get_skill — 新站点强制的设计规范;get_agent_prompt — 完整指令
- delete_account — 不可逆操作;Agent 会先向你二次确认
- setup_database — 站点需要记住业务数据时(订单/预约/目录/库存/评论等)按实际功能自动启用
方式二 — REST API
基础地址: https://27c.site。所有端点返回 JSON:{ success, data | error }。需要认证的端点使用 Authorization: Bearer YOUR_API_KEY——Key 仅在注册/登录时返回一次。
| 端点 | 认证 | 请求体 / 说明 |
|---|---|---|
POST/api/register | — | { username, password, subdomain?, domain? } → 返回 API Key |
POST/api/login | — | { username, password } → 返回 API Key |
GET/api/me | Key | 当前用户名、子域名与域名 |
POST/api/deploy | Key | { files: [{ path, content | base64 }], note? } — 增量部署:本次未包含的文件会保留 |
POST/api/upload | Key | Multipart 表单;用于超过 ~120KB 的文件 |
GET/api/deployments | Key | 部署历史(?limit=,最大 100) |
POST/api/rollback/{id} | Key | 恢复到历史部署 |
POST/api/subdomain | Key | { subdomain } — 更换子域名 |
POST/api/domain | Key | { domain } — 切换到另一个平台域名;原域名将不再解析 |
POST/api/password | Key | { current_password, new_password } — 修改密码 |
POST/api/apikeys | Key | { name? } — 轮换:替换现有 Key |
POST/api/db/setup | Key | { name?, columns?: [{ name, type? }] } — 给站点分配唯一一张数据表,返回 { table, token, columns };可重复调用(幂等) |
POST/api/db | — | { token, action: add | list | get | patch | remove, ... } — 站点数据行;token 仅对该表有效,公开可嵌入页面 |
DELETE/api/account | Key | { confirm: true } — 永久删除账号、网站与历史 |
GET/api/health | — | 存活探针 |
文件规则
- 路径不得包含 ..、\ 或 //,且不能以 / 开头
- 根目录的 index.html 会作为 / 提供;你的网站上线于 https://yourname.27c.site
数据存储(免费,内置)
每个站点都能保存自己的业务数据——订单、预约、会员、目录、库存、投票、评论、点赞、计数器,或任何你的网站需要记住的内容——无需自己写后端。AI 会根据网站功能自动判断字段,不会套用固定的表单模板。
站点页面随后即可在访客浏览器里直接读写——整个 API 就这么多:
示例——在页面里保存与读取
// Save a form submission (runs inside your site's page)
await fetch("https://27c.site/api/db", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ token: TABLE_TOKEN, action: "add", data: { name, message } })
});
// List the saved rows
await fetch("https://27c.site/api/db", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ token: TABLE_TOKEN, action: "list" })
});
限额
| 项目 | 限制 |
|---|---|
| Base64 部署单文件 | ~120KB(超过请用 /api/upload) |
| 每次部署 / 上传文件数 | 200 |
| 上传单文件 / 单次请求 | 25MB / 100MB |
| 注册 | 5 次/小时/IP |
| 登录 | 20 次/小时/IP |
| 部署 / 上传 | 60 次/小时/用户 |