OAuth 让你通过登录服务账号并确认权限的方式完成授权,无需在发布表单中填写账号密码。独立连接器使用 OAuth 2.0;插件包含 OAuth MCP 服务时,也可以按发布页提供的入口完成授权。
确认你的 MCP 服务和登录授权页面可访问,准备一个具备测试权限的服务账号,并配置下面的回调地址。发布中心的 Qoder 登录与服务账号登录分别处理:登录发布中心后,仍需完成你的服务授权。
在你的 OAuth 服务端,将下列地址加入允许的重定向地址列表(Redirect URI / Callback URL)。地址需完整匹配,包括协议、域名和路径。
当前测试发布页面展示的也是正式回调地址。通过发布中心授权时,使用页面显示的回调地址;对接独立测试链路时,使用对应的测试回调地址。
保存后检查授权请求中的
填写连接器信息,或在插件发布流程中打开对应 MCP 服务的审核测试资料区,然后按以下步骤操作:
如果页面提供测试账号选项,你可以改用专门的测试账号和密码,并附服务网站、登录步骤和测试用例。若登录还涉及验证码、组织选择或特定权限,请说明如何完成测试,不要提交一组无法复现的凭证。
如果两种方式都无法提供,选择无法提供,说明原因、服务用途和支持的工具。API Key 服务按审核测试资料说明准备,不使用 OAuth 回调。
除正常授权外,请测试拒绝授权、账号无权限和授权失效时的反馈。服务的权限范围和凭证有效期按你的服务配置核对。
接入前准备
确认你的 MCP 服务和登录授权页面可访问,准备一个具备测试权限的服务账号,并配置下面的回调地址。发布中心的 Qoder 登录与服务账号登录分别处理:登录发布中心后,仍需完成你的服务授权。
配置回调白名单
在你的 OAuth 服务端,将下列地址加入允许的重定向地址列表(Redirect URI / Callback URL)。地址需完整匹配,包括协议、域名和路径。
| 使用场景 | 回调地址 |
|---|---|
| 正式接入,以及当前测试发布页面的授权 | https://mcp.qoder.cn/api/mcp/oauth_callback |
| 独立测试链路 | https://mcp-test.qoder.cn/api/mcp/oauth_callback |
redirect_uri,确认它与白名单中的地址完全一致。不要将发布页、登录页或你的服务首页作为回调地址。
在发布中心完成在线授权
填写连接器信息,或在插件发布流程中打开对应 MCP 服务的审核测试资料区,然后按以下步骤操作:
- 选择 OAuth 授权,点击前往 OAuth 登录授权。
- 在打开的服务页面登录你的测试账号,核对请求的权限并确认授权。
- 返回发布页面,检查授权结果。看到授权成功后,再核对返回的 MCP 信息是否对应本次提交的服务。
- 在客户端用该账号连接服务,执行一条代表性工具调用,确认能得到预期结果,并把步骤写进自测报告。
不方便在线授权时
如果页面提供测试账号选项,你可以改用专门的测试账号和密码,并附服务网站、登录步骤和测试用例。若登录还涉及验证码、组织选择或特定权限,请说明如何完成测试,不要提交一组无法复现的凭证。
如果两种方式都无法提供,选择无法提供,说明原因、服务用途和支持的工具。API Key 服务按审核测试资料说明准备,不使用 OAuth 回调。
自测授权过程
除正常授权外,请测试拒绝授权、账号无权限和授权失效时的反馈。服务的权限范围和凭证有效期按你的服务配置核对。
授权失败时排查
- 无法打开授权页:检查服务网站、登录入口和网络可达性。
- 登录后没有返回:核对授权请求中的
redirect_uri与白名单是否完全一致。 - 返回后没有成功结果:检查是否完成权限确认,以及发布页是否收到授权结果。
- 授权成功但工具调用失败:检查测试账号的业务权限、工具参数和服务端返回。