SuperAPI AI 工具集

mcp-oauth-setup

智能体与模型

查看项目

更新于 10-16 00:03

技能介绍

用途:为 MCP(Model Context Protocol)服务器连接实现灵活认证。OAuth 提供商可自动发现端点并动态注册客户端,用户只需提供 MCP 服务器 URL 并点击 Connect;bearer/API key 提供商支持管理员共享凭证与按智能体独立凭证。

主要能力:基于 RFC 8414 的授权服务器元数据发现(GET /.well-known/oauth-authorization-server)、RFC 7591 动态客户端注册(POST /oauth/register)、RFC 7636 PKCE(S256)授权码安全;credential_mode 分为 shared(管理员一份凭证供所有智能体使用)与 per_agent(每个智能体独立凭证),且适用于所有认证类型。

使用方式:数据库需两张表,分别存 MCP 服务器配置(OAuth 元数据与共享令牌)和按智能体凭证,密钥静态加密,discovered_tools 存为 JSON 数组。OAuth 流程为发现元数据、注册客户端、跳转授权、回调换令牌、存储并同步工具。控制器需注意 Turbo Drive 会吞掉跨域 302,外部跳转应改用 meta refresh;state 用签名且 10 分钟过期的消息,验证后为字符串键;PKCE 的 code_challenge 为 SHA-256 摘要的 URL 安全 Base64 无填充。工具同步采用 Streamable HTTP 两步握手:先发 initialize 取 Mcp-Session-Id,再带该头发 tools/list,需设置 Accept: application/json, text/event-stream,并兼容 SSE 与 JSON 两种响应。

适用场景:构建 MCP 连接管理后台、集成第三方 MCP 提供商(如 Linear、Sentry、Granola、Render)、实现带认证的工具同步、为已有连接器系统添加 OAuth。

限制:并非所有 MCP 服务器都支持 OAuth,部分(如 Render)使用 bearer token 并在 MCP 协议层处理账户选择;OAuth 发现可能返回 404,需回退到 bearer 或 API key。资料未提供具体收费、价格或平台信息。