Skip to main content

MCP

模型上下文协议(Model Context Protocol, MCP)可帮助大模型使用外部工具与数据。本文介绍通过 Responses API接入 MCP 的方法。

使用方式

使用 Responses API,在 tools 参数中配置MCP Server信息。
查找与开通 MCP 服务,请参见开通云部署 MCP 服务。
支持配置SSE协议的 MCP Server。
最多添加 10 个 MCP Server。
# 导入依赖与创建客户端...
mcp_tool = {
    "type": "mcp",
    "server_protocol": "sse",
    "server_label": "my-mcp-service",
    "server_description": "MCP 服务功能描述,帮助模型理解使用场景。",
    "server_url": "https://your-mcp-server-endpoint/sse",
    "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
    }
}

response = client.responses.create(
    model="qwen3.8-max",
    input="你的问题...",
    tools=[mcp_tool]
)

print(response.output_text)

支持的模型

  • 千问Max:Qwen3.8-Max系列、Qwen3.7-Max系列
  • 千问Plus:Qwen3.7-Plus系列、Qwen3.6-Plus系列、Qwen3.5-Plus系列
  • 千问Flash:Qwen3.8-Flash系列、Qwen3.7-Flash系列、Qwen3.6-Flash系列、Qwen3.5-Flash系列
  • Qwen3.8开源系列
  • Qwen3.6开源系列(qwen3.6-27b除外)
  • Qwen3.5开源系列
仅支持通过 Responses API 调用。

快速开始

以接入网页解析(WebParser)MCP 服务为例,展示如何通过 Responses API 调用 MCP 工具。需要先开通网页解析(WebParser)MCP 服务。 需要已获取与配置 API Key并配置API Key到环境变量。
请将示例代码中 MCP 工具配置的 server_url 和 headers 替换为您实际使用的 MCP 服务信息。
import os
from openai import OpenAI

client = OpenAI(
    # 若没有配置环境变量,请用百炼API Key将下行替换为:api_key="sk-xxx"(不建议),
    api_key=os.getenv("DASHSCOPE_API_KEY"),
    # 以下为华北2(北京)地域的URL,调用时请将 {WorkspaceId} 替换为真实的业务空间ID,各地域的URL不同。
    base_url="https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1"
)

# MCP 工具配置
mcp_tool = {
    "type": "mcp",
    "server_protocol": "sse",
    "server_label": "WebParser",
    "server_description": "网页解析(WebParser)MCP 服务,一个专用于网页内容解析的工具包。",
    "server_url": "https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/mcps/WebParser/sse",
    "headers": {
        "Authorization": "Bearer " + os.getenv("DASHSCOPE_API_KEY")
    }
}

response = client.responses.create(
    model="qwen3.8-max",
    input="https://help.aliyun.com/zh/model-studio/mcp 里支持哪些模型?",
    tools=[mcp_tool]
)

print("[模型回复]")
print(response.output_text)
print(f"\n[Token 用量] 输入: {response.usage.input_tokens}, 输出: {response.usage.output_tokens}, 合计: {response.usage.total_tokens}")
运行以上代码可获取如下回复:
[模型回复]
根据阿里云百炼的官方文档,MCP(Model Context Protocol)目前支持的模型如下:

*   千问Max系列:Qwen3.8-Max系列、Qwen3.7-Max系列
*   千问Plus系列:Qwen3.7-Plus系列、Qwen3.6-Plus系列、Qwen3.5-Plus系列
*   千问Flash系列:Qwen3.8-Flash系列、Qwen3.7-Flash系列、Qwen3.6-Flash系列、Qwen3.5-Flash系列
*   千问开源系列:Qwen3.8开源系列、Qwen3.6开源系列(注:qwen3.6-27b 除外)、Qwen3.5开源系列

特别注意:
MCP 功能仅支持通过 Responses API 调用。

[Token 用量] 输入: 20698, 输出: 711, 合计: 21409

流式输出

MCP 工具调用可能涉及多次外部服务交互,建议启用流式输出,实时获取工具调用过程与回复内容。
import os
from openai import OpenAI

client = OpenAI(
    # 若没有配置环境变量,请用百炼API Key将下行替换为:api_key="sk-xxx",
    api_key=os.getenv("DASHSCOPE_API_KEY"),
    # 以下为华北2(北京)地域的URL,调用时请将 {WorkspaceId} 替换为真实的业务空间ID,各地域的URL不同。
    base_url="https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1"
)

mcp_tool = {
    "type": "mcp",
    "server_protocol": "sse",
    "server_label": "WebParser",
    "server_description": "网页解析(WebParser)MCP 服务,一个专用于网页内容解析的工具包。",
    "server_url": "https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/mcps/WebParser/sse",
    "headers": {
        "Authorization": "Bearer " + os.getenv("DASHSCOPE_API_KEY")
    }
}

stream = client.responses.create(
    model="qwen3.8-max",
    input="https://help.aliyun.com/zh/model-studio/mcp 里支持哪些模型?",
    tools=[mcp_tool],
    stream=True
)

for event in stream:
    # 模型回复开始
    if event.type == "response.content_part.added":
        print("[模型回复]")
    # 流式文本输出
    elif event.type == "response.output_text.delta":
        print(event.delta, end="", flush=True)
    # 响应完成,输出用量
    elif event.type == "response.completed":
        usage = event.response.usage
        print(f"\n\n[Token 用量] 输入: {usage.input_tokens}, 输出: {usage.output_tokens}, 合计: {usage.total_tokens}")
运行以上代码可获取如下回复:
[模型回复]
根据阿里云百炼(Model Studio)官方文档,目前 MCP(Model Context Protocol)功能支持的模型如下:

*   千问 Max 系列:
    *   Qwen3.8-Max 系列
    *   Qwen3.7-Max 系列
*   千问 Plus 系列:
    *   Qwen3.7-Plus 系列
    *   Qwen3.6-Plus 系列
    *   Qwen3.5-Plus 系列
*   千问 Flash 系列:
    *   Qwen3.8-Flash 系列
    *   Qwen3.7-Flash 系列
    *   Qwen3.6-Flash 系列
    *   Qwen3.5-Flash 系列
*   千问开源系列:
    *   Qwen3.6 开源系列(注:不支持 qwen3.6-27b 模型)
    *   Qwen3.5 开源系列

注意:目前 MCP 功能仅支持通过 Responses API 进行调用。

[Token 用量] 输入: 20784, 输出: 867, 合计: 21651

参数说明

mcp 工具支持以下参数:

参数

必填

说明

type

是

固定为 "mcp"。

server_protocol

是

与 MCP 服务的通信协议,当前仅支持 "sse"。

server_label

是

MCP 服务的标签名称,用于标识该服务。

server_description

否

MCP 服务的功能描述,供模型理解该服务的能力与适用场景。建议填写以提升模型调用准确性。

server_url

是

MCP 服务的端点 URL。

headers

否

连接 MCP 服务时携带的请求头,例如 Authorization 等认证信息。

示例:
{
    "type": "mcp",
    "server_protocol": "sse",
    "server_label": "WebParser",
    "server_description": "网页解析(WebParser)MCP 服务,一个专用于网页内容解析的工具包。",
    "server_url": "https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/mcps/WebParser/sse",
    "headers": {
        "Authorization": "Bearer YOUR_DASHSCOPE_API_KEY"
    }
}

计费说明

计费包含以下部分:
  • 模型推理费用:按模型的 Token 用量计费。
  • MCP 服务费用:以各 MCP 服务的计费为准。
Token Plan
模型体验
模型调优
模型压缩
用量统计与性能监控
资产中心
服务支持