跳转到主要内容
MCP

MCP 简介

模型上下文协议(Model Context Protocol, MCP)旨在搭建大模型和外部工具之间的信息传递通道。通过 MCP 协议,开发者不用为每个外部工具编写复杂的接口,千问AI平台的智能体也能够接入海量第三方工具。

什么是 MCP

MCP(Model Context Protocol)是 Anthropic 提出的开源协议,规定了大模型与外部工具之间怎么通信。协议里有三个角色:
  • MCP Server:工具的提供方,声明自己有哪些工具、每个工具要什么参数。例如联网抓取 MCP Server 提供读取网页正文的工具,代码解释器 MCP Server 提供在沙盒中执行代码的工具。
  • MCP Client:工具的调用方,连接 Server、拉取工具列表、按模型的决定发起调用。
  • Host:承载模型和 Client 的应用,例如千问AI平台的智能体,或 Claude Code、Cursor 这类 MCP 客户端。
有了这层协议,同一个 MCP Server 可以被任何支持 MCP 的应用直接使用,不需要为每个应用单独写一遍对接代码。

One Key Service

千问AI平台 MCP 商店提供 One Key Service 体验——您只需一个千问AI平台 API Key,即可调用商店内的 One Key MCP 服务。
  • 无需二次开通:One Key MCP 服务无需单独开通或订阅,首次调用自动生效。
  • 统一鉴权:使用千问AI平台 API Key(DASHSCOPE_API_KEY)即可访问所有 One Key MCP 服务,无需为每个服务单独获取密钥。
  • 按量后付费:按实际调用量计费,无需预付费。部分服务提供免费额度,首次调用时自动激活,用完后转为按量计费。

如何使用 MCP

千问AI平台支持以下两种 MCP 服务:
  • 商店 MCP:MCP 商店上架的服务,所有用户可见,均为 One Key MCP——无需开通,用千问AI平台 API Key 直接调用。详见MCP 商店服务
  • 自定义 MCP:支持部署自有 MCP 服务或从开源社区接入,仅用户自己可见。详见自定义 MCP 服务
两类服务都有两种用法。

挂载到 Managed Agent

在智能体编辑页的 MCP 服务器 区点击 添加 MCP 服务,或在创建 / 更新智能体的 API 里用 mcp_servers 字段指定。挂载后该服务下的全部工具默认启用,智能体在会话中自主判断什么时候调用哪个工具。详见 Agent MCP

在 MCP 客户端或 SDK 中调用

每个 MCP 服务都提供 Streamable HTTP 接入地址,可以配置到 Qoder CLI、Codex、Claude Code、Cursor 等 MCP 客户端,也可以用 MCP SDK 在自己的项目里调用。详见 外部调用

计费说明

商店 MCP

MCP 商店的服务(含 One Key MCP)的计费模式因服务而异,具体服务的收费标准请在 MCP 商店对应服务卡片中查看。其中部分服务由第三方服务商提供,计量数据由服务商推送。

自定义部署 MCP 服务

根据服务的响应速度,千问AI平台提供以下两种计费模式:
基础模式极速模式
部署费用0.000036 元/秒
调用费率0.000156 元/秒0.000156 元/秒
计费规则无调用时不计费,有调用时按时长计费无调用时按部署时长计费,有调用时另按调用时长计费
适用场景偶尔调用,对启动速度要求不高需要长时间在线、调用频繁的场景