Skip to main content

配置 OAuth

OAuth 让你通过登录服务账号并确认权限的方式完成授权,无需在发布表单中填写账号密码。独立连接器使用 OAuth 2.0;插件包含 OAuth MCP 服务时,也可以按发布页提供的入口完成授权。

接入前准备

确认你的 MCP 服务和登录授权页面可访问,准备一个具备测试权限的服务账号,并配置下面的回调地址。发布中心的 Qoder 登录与服务账号登录分别处理:登录发布中心后,仍需完成你的服务授权。

配置回调白名单

在你的 OAuth 服务端,将下列地址加入允许的重定向地址列表(Redirect URI / Callback URL)。地址需完整匹配,包括协议、域名和路径。
使用场景回调地址
正式接入,以及当前测试发布页面的授权https://mcp.qoder.com/api/mcp/oauth_callback
独立测试链路https://mcp-test.qoder.ai/api/mcp/oauth_callback
当前测试发布页面展示的也是正式回调地址。通过发布中心授权时,使用页面显示的回调地址;对接独立测试链路时,使用对应的测试回调地址。 保存后检查授权请求中的 redirect_uri,确认它与白名单中的地址完全一致。不要将发布页、登录页或你的服务首页作为回调地址。

在发布中心完成在线授权

填写连接器信息,或在插件发布流程中打开对应 MCP 服务的审核测试资料区,然后按以下步骤操作:
  1. 选择 OAuth 授权,点击前往 OAuth 登录授权。
  2. 在打开的服务页面登录你的测试账号,核对请求的权限并确认授权。
  3. 返回发布页面,检查授权结果。看到授权成功后,再核对返回的 MCP 信息是否对应本次提交的服务。
  4. 在客户端用该账号连接服务,执行一条代表性工具调用,确认能得到预期结果,并把步骤写进自测报告。
打开了登录页或完成了登录,还不能说明接入已完成;请继续检查授权返回和工具调用结果。页面仍停在授权中、未收到返回或调用失败时,按下文排查。 这次在线授权用于审核测试。扩展发布后,连接服务仍需完成相应账号的授权,你的测试账号不会作为所有连接的默认身份。

不方便在线授权时

如果页面提供测试账号选项,你可以改用专门的测试账号和密码,并附服务网站、登录步骤和测试用例。若登录还涉及验证码、组织选择或特定权限,请说明如何完成测试,不要提交一组无法复现的凭证。 如果两种方式都无法提供,选择无法提供,说明原因、服务用途和支持的工具。API Key 服务按审核测试资料说明准备,不使用 OAuth 回调。

自测授权过程

除正常授权外,请测试拒绝授权、账号无权限和授权失效时的反馈。服务的权限范围和凭证有效期按你的服务配置核对。

授权失败时排查

  • 无法打开授权页:检查服务网站、登录入口和网络可达性。
  • 登录后没有返回:核对授权请求中的 redirect_uri 与白名单是否完全一致。
  • 返回后没有成功结果:检查是否完成权限确认,以及发布页是否收到授权结果。
  • 授权成功但工具调用失败:检查测试账号的业务权限、工具参数和服务端返回。
反馈问题时,请提供发生时间、客户端版本、复现步骤和脱敏后的错误信息,不要附完整令牌。 下一步:调试与验证连接器;提审资料见自测报告。