跳转到主要内容
MCP

外部调用

千问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,复制平台提供的命令在终端执行:
qodercli mcp add -s user --transport http WebFetch https://dashscope.aliyuncs.com/api/v1/mcps/WebFetch/mcp --header "Authorization: Bearer ${DASHSCOPE_API_KEY}"
执行后重启 Qoder CLI,即可在对话中让模型调用其工具。
若模型无法调用 MCP,请参考下方常见问题。

通过 SDK 进行开发集成

通过 MCP SDK 调用千问AI平台 MCP 服务,编码更加灵活。 以下示例使用 OpenAI SDK 与 MCP SDK 调用千问AI平台联网搜索增强版(EnhancedSearch)MCP 服务,实现联网搜索。
1

安装依赖

pip install openai mcp
2

配置千问AI平台 API Key 到环境变量

请参考 配置 API Key 完成配置。
3

编写代码

# -*- coding: utf-8 -*-
# 使用 OpenAI SDK + MCP SDK 调用千问AI平台联网搜索增强版(EnhancedSearch)MCP 服务
import os
import asyncio
import json
from openai import OpenAI
from mcp.client.streamable_http import streamablehttp_client
from mcp import ClientSession

async def main():
    api_key = os.getenv("DASHSCOPE_API_KEY")
    if not api_key:
        print("错误:请设置环境变量 DASHSCOPE_API_KEY")
        return
    mcp_url = "https://dashscope.aliyuncs.com/api/v1/mcps/EnhancedSearch/mcp"
    headers = {"Authorization": f"Bearer {api_key}"}
    # 1. 连接 MCP Server,获取可用工具列表
    async with streamablehttp_client(mcp_url, headers=headers) as (read, write, _):
        async with ClientSession(read, write) as session:
            await session.initialize()
            tools_result = await session.list_tools()
            # 转换为 OpenAI function calling 格式
            openai_tools = []
            for tool in tools_result.tools:
                openai_tools.append({
                    "type": "function",
                    "function": {
                        "name": tool.name,
                        "description": tool.description or "",
                        "parameters": tool.inputSchema or {"type": "object", "properties": {}},
                    },
                })
            # 2. 调用 DashScope(OpenAI 兼容接口)
            client = OpenAI(
                api_key=api_key,
                base_url="https://dashscope.aliyuncs.com/compatible-mode/v1",
            )
            messages = [{"role": "user", "content": "搜索一下千问AI平台MCP的最新进展"}]
            print("正在联网搜索...")
            print("=" * 50)
            # 3. 多轮工具调用循环
            while True:
                response = client.chat.completions.create(
                    model="qwen-max",
                    messages=messages,
                    tools=openai_tools or None,
                )
                choice = response.choices[0]
                msg = choice.message
                if not msg.tool_calls:
                    print(msg.content)
                    break
                messages.append(msg)
                for tc in msg.tool_calls:
                    args = json.loads(tc.function.arguments)
                    result = await session.call_tool(tc.function.name, args)
                    tool_content = ""
                    for block in result.content:
                        if hasattr(block, "text"):
                            tool_content += block.text
                    messages.append({
                        "role": "tool",
                        "tool_call_id": tc.id,
                        "content": tool_content,
                    })

if __name__ == "__main__":
    asyncio.run(main())
4

运行代码

运行代码,结果如下:
正在联网搜索...
==================================================
千问AI平台 MCP(Model Context Protocol)是一项新推出的服务,允许用户在千问AI平台上统一接入和管理 MCP 服务。最新进展包括:
1. 支持通过 MCP 商店快速接入多种 MCP 服务(如联网抓取、联网搜索增强版等)。
2. 提供 Streamable HTTP 协议,支持外部应用通过标准 HTTP 调用。
3. 支持在 Qoder CLI、Codex、Claude Code、Cursor 等客户端中一键或手动配置。
4. 开发者可通过 MCP SDK 灵活编码集成至自有项目。

常见问题

无法连接 MCP 服务怎么办?

  1. API Key 错误:请确认使用了有效的千问AI平台通用 API Key。
  2. 额度用尽:部分 MCP(如联网搜索增强版)存在每月额度限制,额度用尽后自动停止。
其他报错及常见问题请参考 MCP 常见问题

模型正常对话且 MCP 无报错,但无法成功地调用 MCP 怎么办?

大模型需要明确的指令才能准确地调用 MCP 服务。请在提示词中明确工具名称和工具能力。示例:调用千问AI平台联网搜索增强版 MCP 服务,搜索杭州未来三天的天气并汇总。