用魔搭账号登录你的应用:ModelScope OAuth 统一身份接入指南

简介: 魔搭社区正式开放OAuth 2.0/OIDC统一登录能力,支持一键授权、获取用户信息、代理操作及细粒度权限控制。AI Skill可自动完成接入与部署,4步即可集成,助应用无缝融入2000万+开发者生态。

让你的应用接入魔搭社区 2000万+开发者生态。

1、为什么需要统一账号登录?

你是否遇到过这些场景:

  • 在魔搭创空间部署了一个 Web 应用,希望直接复用魔搭的用户体系
  • 想知道"谁在用我的应用",但缺乏身份识别能力
  • 用户反馈"又要记一套密码",注册转化率低

现在,魔搭社区已正式开放 OAuth 2.0 / OIDC 统一身份认证能力。你的应用只需接入几行代码,用户就能通过魔搭账号一键登录 — 无需额外注册,即来即用。

2、它能做什么?

魔搭 OAuth 基于标准的 OAuth 2.0 协议和 OIDC(OpenID Connect)身份认证协议,支持:

能力

说明

一键登录

用户点击"用魔搭账号登录",跳转魔搭授权页,授权后自动回到你的应用

获取用户信息

获取用户名、昵称、头像等公开信息(scope: profile

代理操作

经用户授权,可代表用户读取私有仓库、管理MCP 服务,其余服务正在陆续公开中

权限可控

用户随时可在魔搭的访问控制页面撤回授权

完整的授权范围(scope)列表和 OpenAPI 文档见:魔搭 OAuth 接入文档

3、最快接入方式:让 AI 帮你写

如果你使用 Cursor 等支持 Agent Skill 的 AI 编程工具,最快的接入方式是让 AI 直接帮你完成。我们准备了两个开箱即用的 Skill:

Skill 1:ModelScope OAuth 接入

Skill 地址:

https://modelscope.cn/skills/@ModelScope/modelscope-oauth-skill

安装这个 Skill 后,你只需要告诉 AI:

"给我的应用接入魔搭账号登录"

AI 就会按照最佳实践,自动完成后端接口和前端页面的编写,包括:

  • OAuth 授权 URL 生成
  • 回调处理与 Token 交换
  • 用户信息获取与入库
  • 创空间反向代理的适配

Skill 2:魔搭创空间部署

Skill 地址:

https://modelscope.cn/skills/@hicicada/modelscope-studio-deploy

帮助你将应用打包并部署到魔搭创空间,包括 Dockerfile 编写、持久化存储配置、端口设置等。

两个 Skill 配合使用,从开发到部署到接入登录,AI Agent 可以端到端完成。

4、演示案例

demo:

我们以一个创空间部署为例,完整演示如何接入魔搭 OAuth。

体验地址:https://modelscope.cn/studios/modelscope/modelscope-oauth-demo

用户打开应用后,只需点击"使用 ModelScope 账号登录",即完成 OAuth 授权和测试各类授权后接口。

真实案例:

我们以一个真实项目 — "魔搭共建者共创平台" 为例,也同步邀请魔搭的共建者来真实提交相关议题和痛点。

体验地址:

https://www.modelscope.cn/studios/MSEO/ModelScopeBuilders(体验密码:2022)


如果你想了解背后的原理,或者需要手动接入,请继续阅读。

5、手动接入:4 步详解

第一步:注册 OAuth 互联应用

  1. 登录 魔搭社区,进入 首页 → 访问控制 → 互联应用
  2. 创建新应用,填写名称和回调地址
  3. 获取 Client IDClient Secret

重要:回调地址(Redirect URI)应使用创空间的 host 地址(如 https://your-app.ms.show\),而不是 modelscope.cn/studios/... 路径。详见下方"踩坑指南"。

第二步:后端 — 生成授权 URL

当用户点击登录时,后端生成一个跳转到魔搭授权页的 URL:

// Node.js / Express
app.get('/api/auth/oauth/url', (req, res) => {
  const redirectUri = req.query.redirect_uri
  const state = crypto.randomUUID()
  const params = new URLSearchParams({
    client_id: process.env.OAUTH_CLIENT_ID,
    redirect_uri: redirectUri,
    response_type: 'code',
    scope: 'openid profile',
    state,
  })
  res.json({
    url: `https://www.modelscope.cn/oauth/authorize?${params}`,
    state,
  })
})

第三步:后端 — 处理回调,获取用户信息

用户在魔搭授权后,会被重定向回你的应用,URL 中携带 code 参数。后端用这个 code 换取 access_token,再用 token 获取用户信息:

app.post('/api/auth/oauth/callback', async (req, res) => {
  const { code, redirect_uri } = req.body
  // 1. code → access_token
  const tokenRes = await fetch('https://www.modelscope.cn/oauth/token', {
    method: 'POST',
    headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
    body: new URLSearchParams({
      grant_type: 'authorization_code',
      client_id: process.env.OAUTH_CLIENT_ID,
      client_secret: process.env.OAUTH_CLIENT_SECRET,
      code,
      redirect_uri,
    }),
  })
  const { access_token } = await tokenRes.json()
  // 2. access_token → 用户信息(二选一)
  // 方式 A:OIDC 标准 userinfo 端点(推荐)
  const userRes = await fetch('https://www.modelscope.cn/oauth/userinfo', {
    headers: { Authorization: `Bearer ${access_token}` },
  })
  const userInfo = await userRes.json()
  // userInfo: { sub, name, preferred_username, picture, email, ... }
  // 方式 B:OpenAPI 端点(返回更多魔搭平台字段)
  // const userRes = await fetch('https://modelscope.cn/openapi/v1/users/me', {
  //   headers: { Authorization: `Bearer ${access_token}` },
  // })
  // const { data } = await userRes.json()
  // data: { username, nickname, avatar_url, email, description }
  // 3. 在你的数据库中创建或更新用户
  // ...
  res.json(user)
})

第四步:前端 — 触发登录 & 处理回调

// 发起登录
const handleLogin = async () => {
  const redirectUri = window.location.origin  // 关键:使用前端真实地址
  const { url } = await fetch(
    `/api/auth/oauth/url?redirect_uri=${encodeURIComponent(redirectUri)}`
  ).then(r => r.json())
  window.location.href = url  // 跳转到魔搭授权页
}
// 页面加载时检测回调
useEffect(() => {
  const code = new URLSearchParams(window.location.search).get('code')
  if (!code) return
  fetch('/api/auth/oauth/callback', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      code,
      redirect_uri: window.location.origin,
    }),
  })
    .then(r => r.json())
    .then(user => {
      // 登录成功,存储用户信息
      window.history.replaceState({}, '', window.location.pathname)
    })
}, [ ])

就这么简单。 四步完成,你的应用就拥有了魔搭社区的统一身份能力。

6、避坑指南:创空间部署的特殊注意

在实际将"共建者共创平台"部署到魔搭创空间的过程中,我们积累了一些有价值的经验:

1. redirect_uri 必须由前端提供

创空间的容器运行在反向代理后面,后端通过 req.headers['host']不是真实 host,需通过 x-forwarded-host 获取,参考 这里

2. Client Secret 不要写死在代码里

通过创空间的环境变量注入 OAUTH_CLIENT_IDOAUTH_CLIENT_SECRET,不要提交到代码仓库。

3. 回调地址使用 host 域名

创空间应用有两种访问方式:

类型

示例

OAuth 兼容性

Studio 路径

https://modelscope.cn/studios/owner/name\

❌ 不适用

host 地址

https://owner-name.ms.show\

✅ 推荐

两者的对应关系:Studio 路径中的 owner/name 拼接为 owner-name,即 host 地址为 https://{owner}-{name}.ms.show。例如:

注意:owner 和 name 中的大写字母在 host 地址中会转为小写

OAuth 重定向 URL 必须使用 host 地址,因为 Studio 路径是通过 modelscope.cn 的 iframe 嵌入的,window.location.origin 返回的是 https://modelscope.cn\ 而非应用自身地址,无法用于 OAuth 回调。

7、更多授权能力

除了基础的用户身份信息,魔搭 OAuth 还支持更丰富的授权范围:

scope

能力

典型场景

openid

获取 id_token 和 access_token

基础身份认证

profile

获取用户名、昵称、头像等

用户展示

read-repos

读取用户的模型和数据集

资产管理工具

manage-mcp-deployment

管理用户的 MCP 服务部署

MCP 管理平台

list-operational-mcp

获取用户已部署的 MCP 服务

MCP 仪表盘

更多 scope 持续开放中。

8、总结

维度

说明

接入成本

Skill 模式:一句话搞定;手动模式:前后端各 20 行代码

协议标准

OAuth 2.0 + OIDC,行业通用

用户体验

一键授权,无需注册

安全机制

授权码模式 + 可随时撤回

扩展性

丰富的 scope,持续开放更多 API

如果你正在魔搭创空间上构建应用,不妨试试接入魔搭 OAuth — 让你的用户少记一个密码,让你的应用融入千万开发者生态。


相关链接:

目录
相关文章
|
4天前
|
机器学习/深度学习 人工智能 监控
MiniMax M2.7开源: 模型开始迭代自己了!
MiniMax M2.7正式开源!作为M2系列新一代旗舰,首次实现“模型参与自我迭代”范式:自主驱动RL训练、优化Harness架构。软件工程(SWE-Pro 56.22%)、专业办公(GDPval-AA ELO 1495)、互动娱乐能力全面跃升,支持SGLang/vLLM/Transformers本地部署。
394 6
|
7天前
|
JavaScript API 开发工具
OneKey Gateway 把API转Agent CLI/MCPs/Skills 格式的全能转换器
OneKey Gateway 是面向智能体生态的 API 统一接入网关,支持将单一后端 API 自动转换为 CLI、MCP、Skills 库、REST 路由等多种 Agent 接入格式,免去维护多语言 SDK 的繁琐工作,大幅提升开发者集成效率。
|
20天前
|
人工智能 Linux API
阿里云+本地全平台部署OpenClaw|iMessage集成+大模型千问/Coding Plan API+避坑指南
2026年,AI自动化框架OpenClaw(原Clawdbot)凭借云端+本地双部署、多模型兼容与iMessage深度集成能力,成为连接苹果生态与AI能力的核心工具。阿里云提供轻量服务器、ECS、计算巢三种一键部署方案,本地支持MacOS、Linux、Windows11全系统运行,搭配阿里云千问大模型、免费Coding Plan API,可实现iMessage消息收发、自然语言交互、任务自动化执行,满足个人效率管理、移动AI助手、轻量业务开发等场景需求。
230 14
阿里云+本地全平台部署OpenClaw|iMessage集成+大模型千问/Coding Plan API+避坑指南
|
7天前
|
存储 人工智能 安全
Hermes Agent爆火,聊聊与OpenClaw 到底区别在哪
本文对比近期爆火的Hermes Agent与OpenClaw两大AI Agent框架,从设计理念、记忆系统、技能生成、安全机制等维度解析差异,分析适用场景与互补用法,帮你快速判断哪款更适合自己的自动化需求。
1230 8
|
2月前
|
自然语言处理 前端开发 测试技术
魔搭社区+OpenVINO™ 加速部署 Qwen3-ASR 实战
通义千问新推Qwen3-ASR语音识别模型(1.7B/0.6B),支持52种语言及方言,具备高鲁棒性与流式长音频转写能力。联合魔搭社区与Intel® OpenVINO™,实现Intel平台极致加速部署,提供完整开源教程、Notebook示例及Gradio交互Demo。(239字)
1574 6
|
8天前
|
人工智能 JSON 编解码
【SpringAIAlibaba新手村系列】(15)MCP Client 调用本地服务
本章从 MCP Client 视角说明如何连接上一章提供的本地服务,并把远端工具接入 ChatClient。重点讲解 Streamable-HTTP 配置、ToolCallbackProvider 的注入方式,以及模型如何通过 JSON-RPC 消息完成工具调用与结果回传。
178 21
|
15天前
|
传感器
300 万对 RGB-D 深度数据集 LingBot-Depth-Dataset,正式开源!
LingBot-Depth-Dataset是目前最大规模真实场景RGB-D数据集,含300万高质量样本(200万实采+100万渲染),覆盖6款主流深度相机,总规模2.71TB。填补了高保真、多设备深度数据空白,助力空间智能与具身智能发展。
166 20

热门文章

最新文章

下一篇
开通oss服务