用途:把任意 SaaS API 添加为一等公民集成。提供 service name 后,ops-integrate 会探索认证模式、测试连通性,并把该 API 注册到本地 partner registry 中。适用于需要把 HubSpot、Stripe、SendGrid 等第三方服务接入工作流的场景。
主要能力:\n1) 发现 API 细节:在未提供 --url 时,用 WebSearch 查找官方 API 文档 URL、基础 API URL、认证模式(bearer token / api-key header / basic auth / oauth2)、API key 获取 URL 以及健康/测试端点(如 /healthz、/v1/ping、/me)。\n2) 与用户确认:通过 AskUserQuestion 展示发现结果,让用户选择看起来正确、修改 base URL、修改 auth type 或取消。\n3) 收集凭据:提示粘贴凭据(仅本地保存),由服务名派生 key 名 <lowercase_service_name>_api_key。\n4) 健康检查:用 curl 对健康端点发起请求,HTTP 200-299 显示成功,否则显示状态码;未配置凭据时跳过并提示。\n5) 注册:把 base_url、auth_type、credential_key、health_endpoint、added 写入 preferences.json 的 partner_registry。\n\n使用方式:运行 /ops:integrate <service-name> 添加集成;带 --list 参数时列出已注册集成,显示为服务名、base_url、auth_type 表格。偏好文件路径为 ${CLAUDE_PLUGIN_DATA_DIR:-$HOME/.claude/plugins/data/ops-ops-marketplace}/preferences.json。可用 jq 读写注册表与凭据,例如列出全部集成、查询单个集成、读取凭据、删除集成。写入采用 tmpfile 原子替换。\n\n限制:凭据仅保存在本地 preferences.json;健康检查依赖所选端点可达;资料未提供更多关于错误处理、并发或凭据加密的说明。