千问AI平台提供了全周期 MCP 服务,既支持挂载到 Managed Agent 由智能体自主调用,也支持通过外部调用集成至第三方应用或个人项目。
- 集成至客户端:支持在 Qoder CLI、Codex、Claude Code、Cursor 等客户端中一键或手动配置,快速实现外部调用。
- 集成至个人项目:通过 MCP SDK 调用,实现灵活编码和深度定制。
前提条件
MCP 商店的服务均为 One Key MCP,无需开通或订阅,用千问AI平台 API Key(DASHSCOPE_API_KEY)直接鉴权,首次调用自动生效。在 MCP 商店点击服务卡片,即可在服务详情页拿到接入地址和配置。
MCP 商店的服务由千问AI平台部署在云端,直接调用无需填写第三方服务商的 API Key。如需商业化服务定制,部分服务也支持填入自己的密钥;涉及输入敏感信息时,需通过创建 KMS 凭据进行加密。
外部调用 MCP 服务
集成至客户端
千问AI平台支持将 MCP 服务配置到 Qoder CLI、Codex、Claude Code、Cursor 等客户端中调用。在 MCP 商店点击服务卡片进入详情页,在外部调用区域选择目标客户端,平台会给出该客户端对应的接入方式。以下以联网抓取(WebFetch)服务为例,所有方式均使用千问AI平台 API Key(DASHSCOPE_API_KEY)鉴权。
- Qoder CLI
- Codex
- Claude Code
- Cursor
Qoder CLI 是面向软件开发的 Agentic 编码命令行工具。在外部调用区域选择 Qoder CLI,复制平台提供的命令在终端执行:执行后重启 Qoder CLI,即可在对话中让模型调用其工具。
若模型无法调用 MCP,请参考下方常见问题。
通过 SDK 进行开发集成
通过 MCP SDK 调用千问AI平台 MCP 服务,编码更加灵活。
以下示例使用 OpenAI SDK 与 MCP SDK 调用千问AI平台联网搜索增强版(EnhancedSearch)MCP 服务,实现联网搜索。
常见问题
无法连接 MCP 服务怎么办?
- API Key 错误:请确认使用了有效的千问AI平台通用 API Key。
- 额度用尽:部分 MCP(如联网搜索增强版)存在每月额度限制,额度用尽后自动停止。