MCP 服务-大模型服务平台百炼(Model Studio)-阿里云帮助中心

MCP（Model Context Protocol）是大模型与外部工具之间的标准协议。在控制台MCP 管理页面按服务卡片浏览与管理。

类型

市场：百炼托管，覆盖联网搜索、文档处理、地理数据可视化、图像服务、地图服务、数据库等分类，开箱即用。
自定义：点击创建MCP服务接入自有 MCP 服务器或第三方服务。支持四种类型：插件、脚本部署、AI 网关、阿里云 OpenAPI。

服务卡片

每张卡片显示名称、描述、服务 ID、分类标签、用户数与调用次数。

挂载到智能体

在智能体编辑页的MCP服务区点击添加 MCP 服务，从下拉选择已开通的服务。挂载后该服务下的全部工具默认启用，可在工具列表中按需关闭单个工具。通过 API 创建或更新智能体时，在 mcp_servers 字段中指定服务名称与类型，详见创建 Agent。

Bash

curl -X POST "https://{workspace_id}.cn-beijing.maas.aliyuncs.com/api/v1/agentstudio/agents" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "my-agent",
    "model": {"id": "qwen3-max"},
    "mcp_servers": [
      {"type": "official", "name": "web_search"}
    ]
  }'

Python

agent = client.agents.create(
    name="my-agent",
    model="qwen3-max",
    mcp_servers=[
        {"type": "official", "name": "web_search"},
    ],
)
print(agent.id)

Java

import com.alibaba.dashscope.agentstudio.AgentStudioClient;
import com.alibaba.dashscope.agentstudio.param.AgentCreateParam;
import com.alibaba.dashscope.agentstudio.model.Configs;

// 创建 MCP 服务配置
Configs.McpServerConfig mcp = new Configs.McpServerConfig();
mcp.setType("official");
mcp.setName("web_search");

// 创建智能体
AgentCreateParam param = AgentCreateParam.builder()
    .name("my-agent")
    .model("qwen3-max")
    .mcpServers(List.of(mcp))
    .build();
AgentStudioClient client = AgentStudioClient.builder().build();
Agent agent = client.agents().create(param);
System.out.println(agent.getId());

调用与审批

智能体调用 MCP 工具时，事件面板会展示工具调用与执行结果。审批机制与内置工具相同，详见发起会话。