用途:Agent Auth MCP 提供通过 MCP 协议与 Agent Auth 提供方交互的工具,用于智能体认证相关操作。资料建议优先使用这些 MCP 工具,而非直接发起 HTTP 请求或自写代码。
主要能力:服务端暴露 17 个工具,分为四步流程。第一步发现:list_providers(先调用)、search_providers(按 intent 搜索)、discover_provider(按 url 查找)。第二步能力:list_capabilities、describe_capability(执行前必先调用以获取输入 schema)。第三步连接:connect_agent,返回 agent_id,mode 可选 delegated(默认)或 autonomous,preferred_method 可选 device_authorization(默认)或 ciba,还支持 login_hint、force_new。第四步使用:execute_capability、agent_status、sign_jwt、request_capability、disconnect_agent、reactivate_agent。另有主机管理:enroll_host、rotate_agent_key、rotate_host_key。
使用方式:通过 CLI 启动 auth-agent mcp,或带预配置提供方 auth-agent mcp --url https://api.example.com。在 Cursor/Claude Desktop 中可用 npx @auth/agent-cli mcp --url https://api.example.com 配置。CLI 与 MCP 暴露相同操作,共享存储 ~/.agent-auth/。
规则与限制:始终先用 list_providers;执行前先 describe_capability;连接后先 agent_status 确认状态;保存 connect_agent 返回的 agent_id;审批(device code URL 或 CIBA)需用户确认,需轮询 agent_status;错误返回 { error, code } 结构。连接时可用约束限制权限,约束类型有 eq、min/max、in/not_in。资料未提供收费、价格与性能信息。