# 通过 MCP 连接 Creght｜Creght

> Creght MCP server 接入指南：https://creght.cn/api/mcp 与 https://creght.com/api/mcp，Claude Code、Cursor、Claude 的配置方式，site:read / site:write 授权，站点、CMS、表单、素材工具一览与常见报错。

[![Creght](https://ugc.talizen.com/_assets/site/2061660904709165056/1780797461299__creght_logo.png)API for AI](/)

[查看 llms.txt](/llms.txt)

概览

- [Creght AI 编程指南](/api.md)
- [通过 MCP 连接 Creght](/api/mcp-server.md)

AI 可发现性

- [如何优化 llms.txt](/api/optimize-llms-txt.md)

站点配置

- [配置 talizen.config.ts](/api/talizen-config.md)
- [实现基于域名的多语言路由](/api/domain-locale-routing.md)

后端

- [在服务端调用外部 API 并管理缓存](/api/ssr-external-api-cache.md)
- [使用 Func 构建站点后端能力](/api/func-backend.md)
- [JSON 表：定义、读写与查询](/api/func-json-tables.md)
- [上传文件：直传与 Func 内生成](/api/func-assets-upload.md)
- [超时配置与流式响应](/api/func-timeout-streaming.md)
- [使用 Func 接入支付宝电脑网站支付](/api/func-alipay-payment.md)
- [表单提交 webhook：实时推送与验签](/api/form-webhook.md)

集成

- [使用集成发送邮件与验证码](/api/func-email-integration.md)
- [使用集成接入支付宝支付](/api/func-alipay-integration.md)
- [使用集成接入 Stripe 支付](/api/func-stripe-integration.md)
- [使用集成调用 OpenAI 模型](/api/func-ai-integration.md)
- [使用集成接入文字转语音](/api/func-tts-integration.md)

登录与用户

- [注册时验证邮箱](/api/auth-verified-registration.md)
- [实现找回密码与修改密码](/api/auth-password-reset.md)
- [在 Func 里实现登录](/api/auth-func-login.md)
- [在 Func 里查询用户](/api/func-user-directory.md)

本页目录

- [地址](#endpoint)
- [接入客户端](#connect)
- [Claude Code](#claude-code)
- [Cursor 及其他用 JSON 配置的客户端](#cursor)
- [Claude 网页版 / 桌面版](#claude-ai)
- [授权与权限](#auth)
- [工具](#tools)
- [站点](#tools-site)
- [CMS](#tools-cms)
- [表单](#tools-form)
- [素材](#tools-asset)
- [典型流程](#workflow)
- [限制](#limits)
- [排障](#debug)

概览/通过 MCP 连接 Creght

# 通过 MCP 连接 Creght

让 Claude、Cursor 等 AI 助手用你的账号操作 Creght：地址、各客户端接入方式、OAuth 授权与权限、全部 MCP 工具的参数与返回，以及 CMS 直接上线、单文件 20 MB 等限制。

复制 Markdown 链接

Creght 提供一个 MCP server，AI 助手（Claude、Cursor 等）连上以后可以用你的账号列站点、看发布状态和访问统计、读写 CMS 内容、读表单提交、上传素材、发布站点。授权走浏览器里的 OAuth，不需要复制任何密钥。

**本文范围**

地址、在各客户端里怎么接入、授权与权限、全部工具的参数与返回，以及几条不看就会踩的限制。站点代码的拉取、修改和推送不在 MCP 里，继续用 creght CLI。

面向用户的接入说明（不含工具细节）见 [在 AI 助手里连接 Creght](/docs/ai/connect-mcp.md)。

## 地址

| 账号所在站点 | MCP 地址 |
| --- | --- |
| creght.cn | `https://creght.cn/api/mcp` |
| creght.com | `https://creght.com/api/mcp` |

- 路径是 `/api/mcp`， **不是** `/mcp`。 `https://creght.cn/mcp` 返回的是编辑器页面，客户端会报「不是合法的 MCP 响应」。
- 两个站点的账号和数据互不相通：在 creght.cn 注册的账号只能连 creght.cn 的地址。
- 传输方式是 Streamable HTTP（无会话，每次调用一问一答），不支持旧的 SSE 传输。

## 接入客户端

下面以 creght.cn 为例，creght.com 的账号把地址换掉即可。

### Claude Code

```
claude mcp add --transport http creght https://creght.cn/api/mcp
```

加好后在 Claude Code 里运行 `/mcp`，选中 creght 完成授权。

### Cursor 及其他用 JSON 配置的客户端

在 `~/.cursor/mcp.json`（或项目里的 `.cursor/mcp.json`）加：

```
{
  "mcpServers": {
    "creght": { "url": "https://creght.cn/api/mcp" }
  }
}
```

其他客户端只要支持「远程 MCP + OAuth」，填同一个地址即可，不用填 client id、secret 或 token。

### Claude 网页版 / 桌面版

设置 → 连接器 → 添加自定义连接器，URL 填 `https://creght.cn/api/mcp`，高级设置里的 OAuth 字段留空。

## 授权与权限

第一次调用时服务端返回 401，客户端会自动打开浏览器：登录 Creght 账号，在授权页确认后回到客户端。整个过程客户端自己完成，你只需要点「同意」。

- **授权页上的应用名是客户端自己报的，标着「未验证」**，页面上同时显示回调地址。回调地址不是你正在用的客户端（比如本机 `127.0.0.1`、 `claude.ai`）时不要同意。
- 权限分两档： `site:read`（所有读工具）和 `site:write`（写 CMS、上传素材、发布站点、管理 webhook）。客户端没有申请 scope 时只给 `site:read`，这时调用写工具会报权限不足。
- 拿到的权限不会超过账号本身：能看到的站点就是你自己的项目和被邀请加入的项目，读写能力和你在该项目里的角色一致。
- access token 有效 1 小时，客户端用 refresh token 自动续期；refresh token 30 天内用过一次就重新计时，所以常用的客户端不需要反复授权。

## 工具

所有工具都要 `project_id`（站点相关的还要 `site_id`），先调 `list_sites` 拿到。

### 站点

| 工具 | 权限 | 参数 | 返回 / 说明 |
| --- | --- | --- | --- |
| `list_sites` | 读 | 无 | `sites[]`：project\_id、project\_name、site\_id、site\_name |
| `site_status` | 读 | `project_id`、 `site_id` | 是否发布、线上版本、 `live_url`（优先自定义域名，没发布过是空串）、 `preview_url`、 `has_changes`（工作区相对线上有没有改动） |
| `site_publish` | 写 | `project_id`、 `site_id`、 `note`（可选，记进版本历史） | 把预览里看到的内容发布上线，和 `creght publish` 相同。没有改动时报错。返回发布后的状态和 version\_id、version\_no |
| `visit_stats` | 读 | `project_id`、 `site_id`、 `start_at` / `end_at`（Unix 秒，可选）、 `limit`（每个维度前几名，默认 20） | `summary`（pv / uv / ip）、 `trend`（按 UTC 日期）、 `breakdowns`（国家、城市、设备、浏览器、系统、来源域名、渠道、页面）。不填时间是最近 30 天；超出套餐可查范围的起点会被收窄，以返回的 `start_at` 为准 |

### CMS

| 工具 | 权限 | 参数 | 返回 / 说明 |
| --- | --- | --- | --- |
| `cms_collections` | 读 | `project_id` | `collections[]`：id、key、name、desc |
| `cms_collection` | 读 | `project_id`、 `collection`（key 或 id） | 集合信息和字段定义 `fields`（JSON Schema）。写内容前先看它 |
| `cms_content_list` | 读 | `project_id`、 `collection`、 `limit`（默认 20，最多 100）、 `offset`、 `status`（ `online` / `offline`）、 `search` | `total`、 `has_more`、 `list[]`：id、slug、status、body、created\_at、updated\_at |
| `cms_content_create` | 写 | `project_id`、 `collection`、 `slug`（集合内唯一）、 `body` | 新内容的 id。 **建好立即在线上可见** |
| `cms_content_update` | 写 | `project_id`、 `collection`、 `id`、 `slug`（可选）、 `body`（可选） | `body` 与已有内容合并，没传的字段不变。 `updated: false` 表示提交的值和原来一样。 **改动立即上线** |

### 表单

| 工具 | 权限 | 参数 | 返回 / 说明 |
| --- | --- | --- | --- |
| `form_list` | 读 | `project_id` | `forms[]`：id、key、name、desc、fields、submissions\_total |
| `form_submissions` | 读 | `project_id`、 `form_id`（可选，id 或 key）、 `since`（RFC3339，可选）、 `cursor`、 `limit`（默认 50，最多 200） | 按提交顺序返回，带 `next_cursor`。增量同步时把上次的 `next_cursor` 传回来，不会重复也不会漏。不返回提交者 IP，只给按 IP 解析的国家代码 |
| `form_webhook_create` / `list` / `delete` / `test` | `list` 读，其余写 | 表单一有提交就实时推到你的 https 地址，见 [表单提交 webhook](/api/form-webhook.md) |

### 素材

| 工具 | 权限 | 参数 | 返回 / 说明 |
| --- | --- | --- | --- |
| `asset_upload` | 写 | `project_id`、 `site_id`、 `filename`（带扩展名）、 `content_base64`（也接受 `data:` URL）、 `content_type`（可选） | 公开地址 `url`，可以直接用在页面和 CMS 内容里。和 `creght upload` 相同，同一个文件重复上传会复用。 **单个文件最多 20 MB**（base64 之前） |

## 典型流程

发一篇博客并上线：

1. `list_sites` 找到站点的 `project_id`、 `site_id`。
2. `cms_collections` 找到博客集合， `cms_collection` 看字段定义。
3. 有封面图就先 `asset_upload`，把返回的 `url` 填进对应字段。
4. `cms_content_create` 写入。内容此时已经在线上的列表页和详情页里了， **不需要** 再调 `site_publish`。

`site_publish` 只在站点代码改过之后用：发布的是工作区里的页面代码和配置（也就是预览地址上看到的版本），CMS 内容不经过它。

## 限制

- **CMS 没有草稿。** `cms_content_create` 和 `cms_content_update` 都是直接上线。要先给人审，就先写到本地、确认后再调。
- **`site_publish` 对所有访客立即生效。** 调用前先让人在 `preview_url` 上确认过。
- `body` 的键和类型要和 `cms_collection` 返回的 `fields` 一致。
- 没有删除 CMS 内容、改集合结构、改站点代码的工具。这些用编辑器或 creght CLI。
- `asset_upload` 的文件内容要整段放进一次调用，超过 20 MB 会直接报错。更大的文件用 `creght upload`。

## 排障

| 现象 | 原因 |
| --- | --- |
| 客户端报响应不是 JSON / 不是合法的 MCP 响应 | 地址写成了 `/mcp`，改成 `/api/mcp` |
| 授权页登录不上，提示账号不存在 | 用错了站点：creght.cn 的账号连了 creght.com 的地址（或反过来）。改地址后删掉这个 server 重新添加 |
| 读工具能用，写工具报权限不足 | 客户端只申请了 `site:read`；或者你在这个项目里只有只读角色 |
| 找不到某个站点 | 这个项目不属于你、也没邀请你。 `list_sites` 的结果就是你能操作的全部 |
| `site_publish` 报没有改动 | 工作区和线上一致， `site_status` 的 `has_changes` 为 false 时不用发 |
| `asset_upload` 报请求太大 | 文件超过 20 MB，改用 `creght upload` |

![Creght](https://ugc.talizen.com/_assets/site/2061660904709165056/1780797461299__creght_logo.png)

此网站使用 [Creght](/) 创建

![微信客服](https://fsu.creght.com/site/2066727200882692096/1785119134612__image.png?w=3072&fmt=webp)

微信客服

## 链接

- [SaaS 官网生成器](/saas-website-builder.md)
- [价格](/price.md)
- [解决方案](/solution.md)
- [客户案例](/customers.md)
- [AI 模型对比](/ai-models.md)
- [帮助中心](/help.md)
- [联系我们](/contact.md)
- [更新记录 & 博客](/blogs.md)
- [退款说明](/tuikuan.md)

## 资源

- [全部资源](/resources.md)
- [模板](/templates.md)
- [组件库](https://blocks.creght.com/)
- [动效库](/design/effects.md)
- [Figma to Creght](/figma2creght.md)
- [API](/api.md)

## 产品对比

- [对比上线了](/creght-vs-sxl.md)
- [对比凡科建站](/creght-vs-fkw.md)
- [Creght vs 自己写代码](/compare/self-coding.md)
- [Creght vs 外包](/compare/outsourcing.md)
- [Creght vs Framer](/compare/framer.md)
- [Creght vs WordPress](/compare/wordpress.md)

## 协议

- [用户协议](/legal/terms.md)
- [隐私政策](/legal/privacy.md)
- [可接受使用政策](/legal/acceptable-use.md)

## 社交媒体

- [小红书](https://www.xiaohongshu.com/user/profile/5a38606811be10715f4895b6)
- [哔哩哔哩](https://space.bilibili.com/513308095)

[蜀ICP备2023038192号-2](https://beian.miit.gov.cn)

免费方案评估

> 全站页面清单：[/llms.txt](/llms.txt)