常见安装及 OAuth 错误
排查 AdsZera Agent 插件安装、MCP 登录和 OAuth 授权失败的常见问题。
安装失败
如果插件安装失败,请确认使用的是当前 AI 桌面应用绑定的 CLI,而不是其他 npm 或 Homebrew 安装的同名命令。
如果插件已安装但工具不可见,请创建一个新任务或新会话,因为插件工具通常在会话启动时加载。
OAuth 失败
如果 MCP 登录返回 401,请检查是否完成 AdsZera 登录和授权同意页。未登录请求会返回 OAuth challenge,引导客户端读取受保护资源元数据。
如果提示组织未开通内测,请把组织 ID 加入 MCP_ALLOWED_ORG_IDS 后重新登录。错误 audience、跨组织访问或过期 token 都会被拒绝。