Skip to main content

认证

MCP API 使用百炼 API Key 鉴权,并通过工作空间 Endpoint 访问。

MCP API 使用阿里云百炼 API Key 鉴权。每个请求通过 HTTP Header 携带 API Key。

获取 API Key

  1. 登录阿里云百炼控制台。
  2. 前往 API Key 页面,创建并复制 API Key。
API Key 具有工作空间级权限。请妥善保管,不要写入代码仓库或公开渠道。

配置 Endpoint

https://{workspace_id}.cn-beijing.maas.aliyuncs.com/api/v1/mcp/servers
  • workspace_id:工作空间 ID。登录百炼控制台后,在右上角工作空间菜单中复制。

发起请求

将 API Key 配置到环境变量:
export DASHSCOPE_API_KEY="sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
每个请求携带 Authorization Header:
curl "https://{workspace_id}.cn-beijing.maas.aliyuncs.com/api/v1/mcp/servers/list?pageNo=1&pageSize=10" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY"

权限说明

  • 阿里云主账号可直接调用全部接口。
  • RAM 子账号需要获得对应权限授权。
  • API Key 的权限范围由控制台配置决定。
认证失败或缺少工作空间信息时,接口返回 403 AccessDenied。错误处理见MCP API 错误码。