Skip to main content
POST
创建 OAuth 会话

请求头

kimi-api-version
enum<string>

本次请求使用的 API 版本,格式为 YYYY-MM-DD。发送 2026-09-01-beta 即使用本文档所述版本。/v1/files* 之外必传:未携带请求头将被拒绝并返回 400 invalid_request_error;在 /v1/files* 上缺省时选择兼容行为。所有端点对未知取值均返回 400 invalid_request_error。 平台当前支持的 API 版本。新的日期版本发布时加入;版本在公告的 Sunset 日期后移除。

可用选项:
2026-09-01-beta

路径参数

id
string
必填

凭据库(Vault)ID。

请求体

application/json

发起 MCP OAuth 授权流程的请求体。

mcp_server_url
string
必填

要授权访问的 MCP 服务器 URL。

Required string length: 1 - 2048
display_name
string

授权完成后创建的凭据的显示名称。省略时回退为服务器 URL。

Maximum string length: 128
client
object

要使用的 OAuth 客户端。省略时会向授权服务器自动注册一个客户端(动态客户端注册)。

响应

OAuth 会话 ID 与待打开的 authorize_url

需在弹窗中打开的提供方 authorize URL。

oauth_session_id
string
必填

OAuth 会话 ID,用于轮询授权状态。

authorize_url
string
必填

提供方的 authorize URL(已应用 PKCE S256)。请在弹窗中打开。

mcp_server_url
string
必填

规范化后的 MCP 服务器 URL——成功时即为凭据的键。