SuperAPI AI 工具集

aws-sso-refresh

部署与运维

查看项目

更新于 10-16 07:17

技能介绍

用途:当 AWS MCP 工具因 SSO 令牌过期而失败时,使用该技能刷新认证。常见错误包括“Token has expired and refresh failed”“Error when retrieving token from sso”“The SSO session associated with this profile has expired”“ExpiredTokenException”,以及任何提及认证或令牌问题的 AWS MCP 工具失败。

主要能力:调用 mcp__aws-sso__refresh_aws_sso_token 工具,自动从 MCP 配置文件中查找正确的 AWS 配置文件、启动 SSO 登录流程并打开浏览器进行认证。支持两种参数方式:推荐传入服务器名,如 mcp__aws-sso__refresh_aws_sso_token(server: "bedrock-kb"),工具会搜索多个 MCP 客户端配置(Claude Code、Claude Desktop、Cursor、VS Code、Gemini CLI 等)以找到该服务器的 AWS_PROFILE;也可直接传入配置文件,如 mcp__aws-sso__refresh_aws_sso_token(profile: "MCPServerReadAccess")。必须至少提供 server 或 profile 之一,工具不使用默认配置文件,以避免意外的认证操作。

使用方式:当 AWS MCP 操作因令牌过期失败时,先识别失败的 MCP 服务器,再以服务器名调用刷新工具,提示用户在浏览器中完成认证,等待工具返回成功或失败状态,然后重试原操作。示例:mcp__bedrock-kb__ListKnowledgeBases 失败后,调用 mcp__aws-sso__refresh_aws_sso_token(server: "bedrock-kb"),成功返回包含 profile、profileSource 和 message 的结果,再重试 ListKnowledgeBases。

适用场景:适用于使用 AWS SSO 认证的 MCP 工具链,尤其是多个 MCP 服务器共享同一配置文件时,刷新后所有使用该配置文件的服务器均可恢复工作。

限制:SSO 登录会打开浏览器窗口,需确保用户可访问;令牌通常数小时后过期;工具对浏览器认证有 2 分钟超时;若配置文件查找失败,应先询问用户使用哪个配置文件再重试;不得在未提供 server 或 profile 参数时调用该工具。其他细节暂未提供。