文档

文档与快速上手

让你用 AI 建好的网站彻底活起来 - 上传、免费上线、连接你的 AI，然后用自然语言管理一切。这里是从 A 到 Z 的全部。

Yetty 是什么

你用自己的 AI 建了一个网站 - 静态 HTML、CSS 和资源文件。Yetty 把它变成一个真正的、有人管理的网站：带 SSL 的托管、内容编辑、潜在客户捕获、SEO、数据分析、版本化更新和自己的域名 - 你的设计像素级保留。这一切都能用自然语言运营，通过你的 AI 或一个简单的后台。

静态网站效果最佳（正是 AI 工具产出的那种）。完整的 JavaScript 应用包（SPA）需要先做静态导出。

快速开始

创建账号

免费 - 无需信用卡，无需密码。输入邮箱，我们会发送一键登录链接。

上传你的网站

拖入压缩包（index.html 在顶层）。50 个页面以内转换免费。

上线 - 免费

发布到免费的 Yetty 地址，SSL 已配好。Site 套餐可绑定自己的域名。

这三步都可以在后台完成，也可以完全由你的 AI 通过 MCP 完成 - 见下一节。

连接你的 AI（MCP）

整个平台是一个统一控制平面，通过 Model Context Protocol 访问。连接你已经在用的智能体 AI - Claude Code、Cursor、Windsurf、Codex，以及 Claude 和 ChatGPT。

有两种连接方式 - 两者给你的 AI 完全相同的工具：

OAuth - 无需密钥。在 Claude.ai、Claude Desktop 或 ChatGPT 中把 yetty 添加为连接器并点击连接：登录 Yetty 并授权即可。什么都不用粘贴。跳到连接器 →
API 密钥。在终端和编辑器中（Claude Code、Cursor、Windsurf、Codex），粘贴一次密钥即可 - 步骤见下。

第一次用？连接你的 AI 提供针对你所用应用的复制粘贴式配置 - 选择 Claude、Cursor、ChatGPT 等，它会把关联 yetty 的说明直接交给你的 AI。

还没有账号？先发送，再邮件批准

你的 AI 发送网站前，你不需要先注册。它可以立即把文件暂存在 Yetty - 不会处理任何内容 - 然后给你发一封一键批准邮件。你批准后，账号创建、网站构建、AI 拿到密钥：全程不用离开聊天。

整个流程都在 MCP 上 - 无需密钥，开始时甚至不需要账号：

yetty_batch_start → 返回一个 park_ref（pk_…）。
每个文件调用一次 yetty_batch_file（batch_ref = 那个 pk_…，加上 path 和 content，图片/字体用 content_base64）- 每次都返回 received_bytes + sha256 供校验。
yetty_batch_end - 关闭暂存批次（此时仍未处理任何内容）。
yetty_signup {email, park_ref} - 给你（站主）发送批准链接邮件。
你点击它 → 免费账号创建完成，网站开始构建。
yetty_claim_status {park_ref} - 批准后，把 API 密钥（仅显示一次）和上线 URL 交给你的 AI，以完整工具集重新连接。

暂存文件有大小上限，48 小时未批准会自动删除，所以试一试毫无成本。已有账号？跳过这一步，用下方的密钥或 OAuth 连接。

会话过期或连接断了？你的 AI 无需任何菜单即可帮你重新登录：它调用 yetty_login {email}（无需认证也能用 - 即使 MCP 传输本身挂了，用普通 curl 也行），你点一下邮件里的链接，yetty_login_status 就会交给它一个新密钥和精确的重连命令。

1 · 获取你的 API 密钥

在后台打开 API 密钥 → 创建 API 密钥。复制它（仅显示一次），粘贴到设置中 yk_your_key 的位置。（Claude.ai / Claude Desktop / ChatGPT 用户可跳过 - 你们通过 OAuth 连接，无需密钥。）

2 · 把 yetty 加入你的 AI

只需一个 URL + 你的密钥 - 无需安装，没有文件。

Claude Code：

claude mcp add --transport http yetty \
  https://app.yetty.ai/mcp \
  --header "Authorization: Bearer yk_your_key"

Cursor · Windsurf · 任何 MCP 客户端 - 添加一个 HTTP 服务器：

{
  "mcpServers": {
    "yetty": {
      "url": "https://app.yetty.ai/mcp",
      "headers": { "Authorization": "Bearer yk_your_key" }
    }
  }
}

Claude.ai、Claude Desktop 与 ChatGPT 不使用密钥 - 它们通过 OAuth 连接。见下方连接器 →（也提供本地 Python stdio 服务器，可从终端推送网站。）

3 · 开口就行

连接完成后，用自然语言和你的网站对话：

“上传我的网站并放上线。”
“写一篇关于周四特惠的博客文章 - 然后发布。”
“绑定我的域名 example.com。”
“这周多少访问？哪个页面最火？”
“撤销昨天的改动。”
“发布前检查一下线上网站有没有死链。”

从你的 AI 推送网站

发送真实文件。让 AI 上传网站时，交给它实际构建好的文件 - 别让它重新打印或重新生成 HTML。重新生成的副本与你的设计不符，看起来会是坏的。Yetty 运行保真守卫，校验字节数（及逐文件 sha256）并回传 regeneration_risk 标记，让你的 AI 在上线之前就发现问题。

你的 AI 有三种发送文件的方式 - 都会传输你的精确字节，最终进入同一个构建流程：

文件批次 - 推荐。无需压缩包，每个文件都会校验：yetty_batch_start → 每个文件一次 yetty_batch_file（每次返回 received_bytes + sha256，你的 AI 可与本地副本比对，只重发不一致的那个文件）→ yetty_batch_end 开始构建。每个 path 保留文件夹结构（css/style.css）；二进制文件用 content_base64。
分块压缩包。最适合单次调用装不下大上传的聊天客户端：yetty_upload_begin → yetty_upload_chunk（约 24 KB 一块，按序发送）→ 带 zip_ref 调用 yetty_create_site。
单个压缩包。一次调用装得下时：带 zip_base64（网站文件夹本体压缩后）调用 yetty_create_site。

然后轮询 yetty_publish_status(upload_id) 直到构建就绪，再用 yetty_publish_site 上线。超出免费页面上限的上传会返回 held - 调用 yetty_start_transform 来构建（会消耗预估积分）。更新已上线的网站会创建一个待确认版本，等你点头（见更新与回滚）。

全部 MCP 工具

大多数工具接收网站的不透明 site 令牌（来自 yetty_status）- 绝不是数字 id。发送网站类工具是例外：它们负责创建网站。

工具	作用
发送网站
`yetty_create_site`	用你的文件构建一个新的托管网站（或其新版本）- 逐字节托管，随后配上 CMS、潜在客户、SEO、数据分析和版本管理。接收 `zip_base64`、`zip_ref`（分块）或文件批次。运行保真守卫；小网站（≤ 免费页面上限）立即免费构建。
`yetty_batch_start` · `yetty_batch_file` · `yetty_batch_end`	推荐。逐文件发送网站，无需压缩包。每次 `batch_file` 返回 `received_bytes` + `sha256` 供校验；`batch_end` 触发构建（或作为已有 `site` 的新版本应用）。
`yetty_upload_begin` · `yetty_upload_chunk`	以约 24 KB 的 base64 分块传输大压缩包（精确字节，无大小限制），然后带 `zip_ref` 调用 `yetty_create_site`。
`yetty_publish_status`	按 `upload_id` 轮询构建 - 阶段（held → queued → transforming → transformed），然后返回新的 `site` 令牌 + 预览 URL。
`yetty_start_transform`	构建一个 `held` 状态的上传（超出免费页面上限的那种）；消耗预估积分。`(upload_id)`
发布与管理
`yetty_status`	你的账号、套餐、积分和站点 - 每个都带 `site` 令牌，外加逐站的设置报告（还缺什么：SEO、社交图、域名、潜在客户），让你的 AI 能引导你。
`yetty_publish_site`	把网站发布到其 Yetty 地址上线（免费）。`(site)`
`yetty_site_versions`	列出/管理版本：`publish=<n>`、`schedule={version,when}` 或 `rollback_to=<n>`。更新在你发布前保持待确认。`(site)`
`yetty_reprocess_site`	对站点已存文件重新运行转换（无需重新上传）→ 生成一个待审阅的新版本；你的内容编辑会延续，线上网站在你确认前不受影响。`(site)`
`yetty_visual_check`	在两种视口下截取线上网站与其存储预览并做像素级比对 → `diff_pct`。0% = 线上呈现与存储内容完全一致 - 逐字节还原，肉眼可见。`(site)`
洞察与健康
`yetty_site_analytics`	真实流量 - 总量 + 最近 N 天浏览量、独立访客、热门页面。`(site, days?)`
`yetty_list_leads`	站点最近通过表单获得的潜在客户。`(site)`
`yetty_integrations`	潜在客户/事件目的地：`add={kind:webhook\|email,target}`、`remove=<id>`，或列出。`(site)`
`yetty_check_links`	确定性健康检查 - 抓取线上网站并标记 404 的内部链接。发布前后都可运行。`(site)`
`yetty_publish_check`	首次发布就绪清单：每页的 SEO 标题与描述、社交分享图、favicon、潜在客户目的地、自己的域名，以及（可选）死链扫描。返回逐项通过/未通过。`(site, check_links?)`
`yetty_site_suggestions`	主动巡检 - 一份友好、按优先级排序的常规建议清单，让网站看起来更完整（社交图、感谢页、Meta 描述、favicon、自定义 404、图片替代文本）。不消耗积分。`(site)`
整理你的内容（Live 套餐）
`yetty_taxonomies`	为你的文章和集合创建或列出分类与标签。`(site)`
`yetty_terms`	管理某个分类法下的词条 - 先搭好层级，再添加、重命名、移动、合并、删除或批量导入。`(site, taxonomy)`
`yetty_assign_terms`	给页面或集合项打上词条。像草稿一样暂存 - 用 `yetty_publish_drafts` 发布。`(site, object, terms)`
`yetty_taxonomy_settings`	开启或关闭分类与标签 - 全站开关、按集合的例外，批量修改始终先预览。`(site)`
`yetty_taxonomy_suggestions`	yetty 在你的网站里发现了现成的分类与标签 - 启用前先看看它的建议。`(site)`
`yetty_permalinks`	你网站的地址簿：每个集合项和词条页的网址。设置自定义地址后，旧地址会自动 301 跳转，链接和排名都不受影响。`(site)`

Claude 与 ChatGPT 连接器（OAuth）

无需终端，无需密钥。在 Claude.ai、Claude Desktop 或 ChatGPT 中把 yetty 添加为连接器，直接在聊天里管理网站 - 与后台和终端拥有完全相同的能力。

打开你的 AI 的连接器设置（Claude：Settings → Connectors；ChatGPT：Settings → Connectors），选择添加自定义连接器。
指向 https://app.yetty.ai/mcp。
点击连接 - 你会被引导到 yetty 登录并授权访问（OAuth）。批准后即完成关联。

然后就在聊天里和你的网站对话 - “发布我的网站”“这周多少访问？”“撤销昨天的改动”。你可以随时在 Yetty 后台撤销授权。

管理你的网站

以下所有功能，后台和你的 AI 都能用：

真正的编辑器

页面的真实板块变成可编辑卡片，带有类型化的文本、链接和图片字段。编辑先存为可预览的草稿，然后发布 - 每次发布都是一个可回滚的版本。设计从不被触碰（逐字节还原）。更多 →

SEO

逐页的标题与 Meta 描述，带实时字数统计，外加友好 URL。

潜在客户

每个表单自动捕获到潜在客户收件箱；邮件提醒 + 推送到 Zapier、Make、CRM 或 Google 表格的签名 Webhook。

数据分析

真实访问量、独立访客、热门页面与趋势 - 或者直接问你的 AI“有多少访问？”。

内容集合

博客文章、活动和项目会被识别为内容集合，以逐项卡片编辑 - 可添加和删除。

媒体与 AI 图片

替换图片，或用 AI（Gemini）生成符合品牌调性的视觉素材 - 可选尺寸（1K–4K）和宽高比，还能添加参考图让它贴合你的品牌。消耗积分。

编辑你的网站

Yetty 会读取你建好的网站，把每个页面拆成你一眼就能认出的真实组成部分 - 首屏、功能栏、价格表、联系表单 - 每个都用通俗语言命名。你直接编辑这些部分：不用学主题，不用碰原始 HTML。

板块就是页面的真实组成部分，每个都用你听得懂的话命名，你永远清楚自己在改什么。
列表即卡片。重复出现的内容 - 博客文章、团队成员、项目 - 以逐项卡片形式编辑，可添加和删除。
类型化字段。链接字段就是链接，图片字段直接换图 - 不碰标记语言，不会弄坏布局。
编辑精确回填。发布时，你的改动逐字节嵌回页面 - 设计从不会被重新渲染或改动。
重新上传保留编辑。推送新代码后，只要字段还在，你保存的编辑就会延续；如果代码改了那段文字，则以新代码为准。你写的东西绝不会悄悄丢失。

草稿、预览、发布 - 不会意外上线

编辑本身绝不会直接触碰线上网站。每次改动都走同一条安全路径：

保存草稿。编辑字段并保存后，它会存为草稿。线上网站保持不变 - 访客看到的仍是当前版本。
预览待发布的改动。打开预览，在别人看到之前，看看应用改动后网站的确切样子。反复编辑、预览，直到满意。
发布。满意后点击发布，草稿即上线 - 并记录为一个版本，你随时都有还原点。
随时回滚。上线后又反悔了？一键回滚到任何早期版本。什么都不会丢。

从你的 AI 操作：已发布的内容编辑和上传一样都会版本化 - yetty_site_versions(site) 列出它们，rollback_to=<n> 恢复早期版本。见更新与回滚。

集成与 Webhook

潜在客户始终会保存到你的收件箱。若想同时即时送达，在后台 → 集成（或让你的 AI 来做）添加一个目的地：一个邮箱，或指向 Zapier、Make、你的 CRM 或 Google 表格 Apps Script 的 Webhook。

每个事件以 JSON 形式 POST 并附带签名：

POST your-webhook-url
X-Yetty-Signature: sha256=HMAC-SHA256(secret, body)

{
  "event": "lead.created",
  "site_id": 212,
  "form": "contact",
  "data": { "name": "Ada", "email": "[email protected]", "message": "…" },
  "created_at": "2026-08-06T18:20:00Z"
}

从你的 AI 操作：yetty_integrations(site="<token>", add={kind:"webhook", target:"https://hooks.zapier.com/…"})。用添加时返回的密钥验证签名。

更新与回滚

网站改了？重新上传（或让你的 AI 来）。Yetty 会存为一个新版本并精确展示改动 - 页面、文本、板块，甚至一个悬停颜色。对线上网站的更新会等你确认（线上不受影响）- 审阅改动摘要后，立即发布或排期稍后发布。上线后不满意？一键回滚到任何版本。什么都不会丢。

从终端操作：用 yetty_submit_site(zip_path, site="<token>") 重新上传；然后 yetty_site_versions(site, publish=<n>)，或 schedule={version:<n>, when:"2026-08-09 09:00"}，或 rollback_to=<n>。

你的自己的域名

先在 Yetty 地址上免费开始。准备好后，用 Site 套餐绑定自己的域名（每站 $13 - 我们不卖域名；你把 DNS 指向我们，我们负责带 SSL 提供服务）。

后台 → 托管与域名 → 添加域名（或让你的 AI 来做）。
在你的域名注册商处添加显示的 DNS 记录（验证用的 TXT、一条 A 记录、一条 www CNAME）。
验证通过 - SSL 自动签发。

价格

转换、上线和用任何 AI 进行 MCP 操控都免费。每站每月 $13 加上自己的域名（无徽标）、完整管理和每月 AI 积分。需要更多 AI？积分包有效期一年，永不重置。完整价格 →

常见问题

我需要重做网站吗？

不用 - Yetty 会原封不动地保留你已建好的网站。我们只在它周围搭建平台。

更新弄坏了东西怎么办？

它不可能偷偷改动：每次更新都是一个版本，附带通俗的改动清单，回滚只需一键。

我的 AI 真的什么都能做吗？

可以 - 发布、编辑、查看潜在客户、查看流量、绑定域名和回滚都可以通过 MCP 完成，后台同样可以。