MCP 发布接口

AI 客户端（Cline、豆包等）可通过下列 HTTP 接口把生成的静态页面直接发布到你的站点，资源全部写入腾讯云 COS，复用 site_id 体系。

1. 获取 MCP 密钥

前往 个人中心 → MCP / API 密钥 创建，密钥仅显示一次，请妥善保存。

所有 MCP 接口统一使用 Header 鉴权：

Authorization: Bearer {mcp_secret_key}

2. 发布站点 POST /api/mcp/publish

未传 site_id 时会新建站点（需传 package_id + custom_domain，且账号存在有效套餐）；传 site_id 时增量覆盖已有站点文件。

POST /api/mcp/publish
Content-Type: application/json
Authorization: Bearer mcp_xxxxxxxx

{
  "site_id": "www.example.com-45127896", // 可选，已有站点
  "name": "AI 生成的站点",            // 新建站点时使用
  "custom_domain": "www.example.com",// 新建站点必填（不含 http/https）
  "package_id": 1,                    // 新建站点必填（账号已购买的套餐ID）
  "files": [
    { "path": "index.html", "content": "<h1>Hello</h1>", "encoding": "utf8" },
    { "path": "css/app.css", "content": "Ym9keXtjb2xvcjojMzMzfQ==", "encoding": "base64" }
  ]
}

响应：

{
  "code": 200,
  "msg": "MCP 发布成功",
  "data": {
    "site_id": "www.example.com-45127896",
    "created": true,
    "file_count": 2,
    "total_size": 1024,
    "preview_url": "https://cdn-domain/www.example.com-45127896/",
    "cname": "www.example.com.cdn.dnsv1.com"
  }
}

3. 其他 MCP 接口

方法	接口	说明
GET	/api/mcp/sites	当前账号站点列表（含 site_id、预览地址）
GET	/api/mcp/site_info?site_id=xxx	站点详情与 CNAME 解析地址
GET	/api/mcp/packages	当前有效套餐与在售套餐（取 package_id）
POST	/api/mcp/delete_site	删除站点并清空 COS 全部文件

4. 约束说明

• 只接收单个静态文件内容（utf8 文本或 base64），不接收 zip 等压缩包，服务端不做任何解压
• 仅允许静态资源后缀：html/css/js/json/图片/字体/媒体等，禁止 php/jsp/exe/sh 等可执行与脚本文件
• 单文件大小、单次文件数受平台配置限制；存储占用受套餐存储配额限制
• 平台不统计流量、不做流量上限，请放心批量发布
• 站点根目录建议包含 index.html 作为入口

5. curl 示例

curl -X POST https://viwolf.cn/api/mcp/publish \
  -H "Authorization: Bearer mcp_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"name":"demo","package_id":1,"files":[{"path":"index.html","content":"<h1>hi</h1>"}]}'