接入文档

省点时间 MCP 开放平台 · v1

概述

本平台把两条产品线的能力以标准 MCP 工具形式开放:快工场(AI 内容创作)与快视(视频号矩阵管理与发布)。两条线各有独立端点,权限范围、计费方式与护栏都不同,按需接其一或两个都接。

• 认证: OAuth 2.1 授权码 + PKCE;支持自动发现与动态客户端注册(免申请、免审核)。也可用访问令牌(PAT)走 Authorization 头。
• 账号: 用户用省点时间统一账号登录授权(手机验证码 / 微信扫码;快视 / 快发 / 快工场按手机号自动关联),而不是某一个产品的账号。
• 身份: 工具的 org/user 身份永远来自 access token,请求参数里传身份字段会被剥离

快速接入

任何支持「Streamable HTTP + OAuth」的 MCP 客户端,只需要端点 URL。授权流程会自动在浏览器完成。

Claude Code(CLI)

claude mcp add --transport http shengdian-kgc https://mcp.timexxs.com/kgc
claude mcp add --transport http shengdian-ks  https://mcp.timexxs.com/ks
# 首次调用工具时会自动打开浏览器,用省点时间账号完成授权

Claude 桌面端 / claude.ai

设置 → 连接器(Connectors)→ 添加自定义连接器 → 粘贴对应端点 → 按提示完成授权。两条产品线各加一个连接器。

Codex CLI

# ~/.codex/config.toml
[mcp_servers.shengdian-kgc]
url = "https://mcp.timexxs.com/kgc"

[mcp_servers.shengdian-ks]
url = "https://mcp.timexxs.com/ks"

旧版本 Codex 需要在配置中开启 rmcp 客户端(experimental_use_rmcp_client = true);以你所用版本的官方文档为准。

Cursor

// .cursor/mcp.json
{ "mcpServers": {
  "shengdian-kgc": { "url": "https://mcp.timexxs.com/kgc" },
  "shengdian-ks":  { "url": "https://mcp.timexxs.com/ks" }
} }

认证与授权

自动发现

GET https://id.timexxs.com/.well-known/oauth-authorization-server   # RFC 8414 AS 元数据
GET https://id.timexxs.com/.well-known/oauth-protected-resource     # RFC 9728 资源元数据
GET https://id.timexxs.com/.well-known/oauth-protected-resource/kgc   # 快工场线资源元数据
GET https://id.timexxs.com/.well-known/oauth-protected-resource/ks    # 快视线资源元数据
# 未带 token 访问任一端点会返回 401 + WWW-Authenticate,其中的 resource_metadata
# 指向该产品线的 path-scoped 元数据,客户端据此发现授权服务器与该线的 scope 列表

动态客户端注册(RFC 7591,开放注册)

curl -X POST https://id.timexxs.com/register \
  -H 'content-type: application/json' \
  -d '{"client_name":"我的 Agent","redirect_uris":["https://your.app/callback"]}'
# → { "client_id": "sdt-…", … }   同一 IP 每天限 20 次注册

授权与令牌

• 授权端点 https://id.timexxs.com/authorize:用户用手机验证码或微信登录省点时间账号,看到你的应用名、权限范围,并可设置每日消费上限(默认 100 点)
• 令牌端点 https://id.timexxs.com/token:授权码换 token(必须 PKCE);access token 有效 60 分钟,请求了 offline_access 时才附带 refresh token,有效 30 天且每次刷新轮换(旧 refresh token 重放会吊销整族令牌)
• 权限范围 —— 快工场:kgc.read(读取)/ kgc.generate(生成,消耗点数);快视:ks.read(读取,含预检 —— 它虽是只读语义但每次消耗一次 AI 调用)/ ks.write.material(素材导入与删除)/ ks.publish(发布与取消定时任务)。另有 offline_access:只有请求它时才会签发 refresh token。
• 用户可随时在 https://id.timexxs.com/consents 撤销授权;撤销后所有令牌立即失效(401 consent_revoked)

访问令牌 / 手动 Authorization(不弹授权页的客户端)

部分客户端(如 workbuddy、Trae)不会自动打开浏览器完成 OAuth,但支持在请求头里加 Authorization。为此用户可在 https://id.timexxs.com/consents 自助签发访问令牌(Personal Access Token),粘贴到客户端配置的请求头即可 —— 端点仍按产品线各用各的:

{
  "mcpServers": {
    "shengdian": {
      "type": "http",
      "url": "https://mcp.timexxs.com/kgc",
      "headers": { "Authorization": "Bearer <你的访问令牌>" }
    }
  }
}

• 令牌以 sdt_pat_ 开头,明文只在签发时显示一次,服务端只存哈希
• 签发时可选权限范围(快工场 read / generate,快视 read / 素材写入 / 发布)、每日点数上限与有效期(30/90/365 天或永久)
• 每日点数上限只对快工场生效 —— 快视不扣点,该数值对它没有意义,约束它的是调用频率限流
• 勾选快视权限时,令牌会在创建那一刻钉死它代表哪个快视账号(有多个快视账号的用户可在表单里选);之后不能更改,也不随账号中心的首选账号变化 —— 要换账号请撤销后重建。令牌代表哪个账号,可以让客户端调 ks_whoami 自查。
• 可在授权管理页随时撤销,撤销后立即失效(401 invalid_token)

调用 MCP

标准 MCP over Streamable HTTP(JSON-RPC 2.0)。手工调试示例:

# 工具清单
curl -X POST https://mcp.timexxs.com/kgc \
  -H 'authorization: Bearer <access_token>' \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

# 调用工具(改写文案)
curl -X POST https://mcp.timexxs.com/kgc \
  -H 'authorization: Bearer <access_token>' \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{
        "name":"text_rewrite",
        "arguments":{"content":"新店开业全场8折","platforms":["小红书"]}}}'

工具目录

快工场 · 读取(scope: kgc.read)

快工场 · 生成(scope: kgc.generate)

异步类工具(成片/复刻/文生视频等)提交后返回 task_id,用 task_status 轮询进度与结果。快工场的发布工具(publish_video)尚未开放。

快视 · 视频号矩阵(端点 https://mcp.timexxs.com/ks)

发布是异步的:ks_publish_video 返回 taskId,用 ks_get_publish_task 查结果;支持定时发布,未发出前可用 ks_cancel_publish_task 取消。快视的发布没有两段式确认(它不扣点,confirm_token 那套只在快工场线上),防重完全依赖你传的 idempotencyKey 与站内 30 分钟同内容防重 —— 所以外部调用必须传。

快发 · 多平台数据(scope: kf.read,只读)

快发是多平台视频分发工具(抖音/快手/小红书/B站等)。本线为只读数据面;发布由快发桌面客户端完成 —— 省点时间智能助手与快发同机运行且用户开启协作时,可把发布任务投递给快发执行。需省点时间账号已关联快发账号;不扣算力点,按频率限流(kf:read 60/min)。

计费与护栏(快工场线)

• 价格:与快工场站内完全一致,无 API 加价;MCP 接入本身免费
• 余额预检:点数不足直接返回 INSUFFICIENT_CREDITS,不会产生半途扣费
• 每日上限:用户授权时自设(默认 100 点/天),超出返回 DAILY_LIMIT_EXCEEDED,次日自动恢复
• 两段式确认:能精确报价、且单次预计消耗 ≥ 50 点的调用会先返回 CONFIRM_REQUIRED + confirm_token + 预估点数;5 分钟内携带 confirm_token 以完全相同的参数重调即执行

# 两段式示例:首次调用返回
{"code":"CONFIRM_REQUIRED","message":"本次调用预计消耗约 60 点算力…",
 "quote_points":60,"confirm_token":"ct-…"}

# 确认执行:原参数 + confirm_token 重调
{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{
  "name":"video_from_text",
  "arguments":{"prompt":"海边日出延时","duration":10,"confirm_token":"ct-…"}}}

限流

快工场线不额外限流(它由扣点与每日上限兜底)。快视线按令牌限流,并且是按桶而不是按工具计 —— 同一个桶里的几个工具共用配额:

预检单独一桶:它在 scope 上归读取,但每次都要烧一次 AI 调用,与普通读接口不是一个量级。超限返回 RATE_LIMITED,按提示等待后重试即可。

幂等

快工场:消耗类调用建议携带 idempotency_key(参数级唯一串,超过 64 字符会被截断,请自己控制在 64 以内)。相同 key 在 48 小时内重放会直接返回首次结果,不重复扣点 —— 网络重试安全。

"arguments":{"prompt":"…","idempotency_key":"order-20260705-001"}

快视:语义不同,别混用。ks_publish_video 的 idempotencyKey 是参数级、由快视后端处理(SETNX 租约 + 内容指纹),不走网关那套 48 小时重放缓存 —— 网关对快视线是关闭的。发布必须传它,否则一次网络重试就是一条重复发布。

"arguments":{"finderUsername":"…","materialId":"…","idempotencyKey":"pub-20260827-001"}

错误码

安全模型

• 身份不可伪造:org/user 只从 token 解出并注入,请求参数中的身份字段一律剥离
• 最小暴露:白名单之外的内部工具与内部参数对第三方完全不可见
• 发布类单独授权:发布能力永远是一个独立且默认不勾选的 scope(ks.publish),不因"整链授权"而顺带获得。快视的发布不走两段式确认(它不扣点),防重靠必传的 idempotencyKey 与 ks:publish 限流。
• 令牌卫生:refresh 轮换 + 重放吊销整族;撤销即时生效
• 可审计:快工场的每笔消耗打标到应用(client_id),用户账单可见"哪个应用在花点";快视无扣点账单,但发布记录会落到该快视账号名下

FAQ

Q:接入要申请/审核吗?
不用。动态客户端注册开放,注册即用;滥用由限流与封禁机制兜底。

Q:我(开发者)需要付钱吗?
不需要。快工场消耗的是授权用户自己账户的算力点,单价与其站内操作一致;快视不扣点,由用户自己的快视会员资格覆盖。两条线你都无需为用量付费。

Q:用户需要什么账号?
需要一个省点时间账号(手机验证码或微信登录;快视 / 快发 / 快工场按手机号自动关联)。要用快工场的工具,该手机号名下需有快工场账号;要用快视的工具,需有快视账号,且消耗资源的能力要求付费的快视会员。关联关系在账号中心可以查看和管理。

Q:用户有多个快视账号会怎样?
一个令牌只代表其中一个。通过授权页接入的客户端跟随账号中心的首选账号;访问令牌在创建时钉死账号、不跟随。让客户端调 ks_whoami 就能确认当前代表哪个账号。

Q:快发 / 快客的能力何时开放?
在路线图中。文档会随开放更新。

Q:遇到问题找谁?
工单/联系方式见快工场站内「联系客服」;技术问题建议附上调用的 jti(token claims 内)与时间点。