用途:为 API 添加 API 密钥或客户端凭据认证,使智能体能够保护接口。默认语言为 Node,默认路径为组织级不透明 API 密钥;客户端凭据、M2M JWT 或 /oauth/token 属于另一条路径,需查看 references/client-credentials.md,且该路径不调用 createToken。
主要能力:创建组织级密钥并一次性输出 token、保存 tokenId;在每个请求服务端校验 token,无效、过期或已撤销返回 401,并可从 tokenInfo 取出 organizationId、userId;列出密钥;作废密钥(即时且幂等)。轮换流程为创建新密钥、更新消费方、验证、再作废旧密钥。
必要用法:从环境变量读取 SCALEKIT_ENVIRONMENT_URL、SCALEKIT_CLIENT_ID、SCALEKIT_CLIENT_SECRET,不得硬编码;不得使用 SCALEKIT_ENV_URL,环境 URL 已含协议时不要重复加 https://。组织 ID 需从仪表盘复制,不要编造 org_… 值。仓库尚无 Scalekit SDK 时才安装 @scalekit-sdk/node。不透明密钥使用 scalekit.token.validateToken,JWT 使用 scalekit.validateToken,二者不可混用。密钥明文仅从创建路径展示一次,需保存 tokenId 用于列出和作废,不得记录或提交密钥。即使环境变量缺失也要写出创建、校验、列出、作废代码,并请用户补全三项环境变量与组织 ID,不要等待实时创建。缺环境时可参考 setup-saaskit;需要 MCP 的 OAuth 2.1 用 add-mcp-oauth;SaaSKit 登录用 implement-saaskit;Python、Go、Java 或用户级密钥参考 references/languages.md。完成后停止,不写 MCP OAuth 或 SaaSKit 登录。