千问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 服务,实现联网搜索。
1
安装依赖
本示例基于
mcp>=2.0 编写,运行需 Python 3.10+。mcp>=2.0 会自动安装 httpx2 依赖。若你已装了 mcp<2.0,运行本示例会报以下错误,请先升级:ModuleNotFoundError: No module named 'httpx2'ImportError: cannot import name 'streamable_http_client' from 'mcp.client.streamable_http'
pip install -U "mcp>=2.0"。若无法升级到 2.x(例如 Python < 3.10),可参考 mcp 1.x 的旧 API:将 httpx2.AsyncClient(headers=...) 改为直接给 streamablehttp_client(url, headers=...) 传 headers,并将 tool.input_schema 改回 tool.inputSchema。2
配置千问AI平台 API Key 到环境变量
请参考 配置 API Key 完成配置。
3
编写代码
4
运行代码
运行代码,结果如下: