Skip to main content

官方 MCP 服务

阿里云百炼的官方 MCP 服务开通后即可使用。阿里云百炼官方 MCP 服务既支持在平台内部(如智能体、工作流)直接集成,也支持通过外部调用集成至第三方应用或项目中。

One Key MCP

One Key MCP 服务无需手动开通,首次调用自动生效。以使用 Amap Maps 高德地图 MCP 服务为例:
目前 Amap Maps MCP 服务限时免费使用。
  1. 进入 MCP 广场:前往阿里云百炼 MCP 页面,浏览并选择带有 One Key 标识的 MCP 服务。
  2. 获取接入配置:在服务详情页的接入方式中,复制接入配置或点击一键配置到客户端。使用阿里云百炼 API Key(DASHSCOPE_API_KEY)即可完成鉴权,无需为该服务单独申请密钥。
  3. 开始调用:配置完成后即可调用。首次调用自动生效,无需手动开通。如服务提供免费额度,将自动激活。

需开通的广场 MCP

对于未标识为 One Key 的广场 MCP 服务,需手动开通后使用:
阿里云百炼采取了安全策略来保障云部署 MCP Server 的数据安全。对于敏感数据,云部署 MCP Server 会在创建时使用 KMS 进行加密管理。
  1. 前往阿里云百炼 MCP 页面,点击 Amap Maps 卡片。
    image
  2. 点击立即开通,点击确认开通,即可开通 Amap Maps MCP 服务。
    阿里云百炼已部署云端的 Amap Maps MCP 服务,开通试用服务无需填写AMAP_MAPS_API_KEY。如需商业化服务定制,也支持使用个人AMAP_MAPS_API_KEY。
    image
    对于涉及敏感信息的 MCP 服务,需通过创建 KMS 凭据加密这些信息。
    image

在智能体或工作流中配置 MCP 服务

智能体应用

在智能体应用中,大模型会根据输入对话来判断是否调用 MCP 服务。
  1. 创建智能体 前往阿里云百炼应用管理,点击创建应用,选择智能体应用立即创建。
  2. 添加 MCP 服务 智能体在回答时可以调用多个 MCP 服务,可同时添加最多 5 个 MCP 服务。
    image
  3. 测试 MCP 服务 智能体可以自动调用合适的 MCP 服务来解决问题。以下是几个参考使用场景:
    • 路程规划(单 MCP 服务)
    • 逐步思考(单 MCP 服务)
    • 气温趋势(多 MCP 服务)
    请确认已添加 Amap Maps MCP 服务,帮助智能体获取地理信息。在右侧对话窗格中发送一条测试消息:“现在出发,从杭州萧山国际机场到杭州西湖景区。请你提供三种公共交通出行方案”。智能体将多次调用 MCP 服务,完成路径规划和时间估算。
    image

工作流应用

MCP 服务可能有多个工具,但在工作流应用中,每个 MCP 节点只能使用一个工具,因此需要手动指定 MCP 节点的输入参数,再传递输出参数到下一个节点。 使用Amap Maps MCP 服务的 maps_weather工具,快速构建一个城市天气查询工作流。
在只使用 maps_weather工具时,工作流无法回答与天气查询无关的问题。
  1. 创建工作流 前往阿里云百炼应用管理,点击创建应用,选择工作流应用立即创建。
    image
  2. 设置开始节点 删除开始节点的两个默认参数。
    在这个案例中,只需使用默认的系统变量 query,故删去这两个参数。
    image
  3. 提取城市名称 为了将输入对话的自然语言解析为 MCP 节点需要的城市名称,从左侧工具栏中拖入一个大模型节点,命名为“信息提取”。请将此节点连接到开始节点,并按照指引填写参数。
    其他参数保持默认即可。

    参数名

    参数值

    模型配置

    通义千问-Max

    System Prompt

    你是一个信息提取专家,你的任务是帮助“查询天气工具”解析正确的输入参数。

    ---

    “查询天气工具”的描述如下:

    名称:maps_weather

    描述:根据城市名称或者标准adcode查询指定城市的天气

    输入参数:city [string] 城市名称或者adcode

    输出参数:result [string] 城市的天气预报

    ---

    你的输出是“查询天气工具”的输入,你只需要输出城市的名称即可。

    注意:你一次只能输出一个城市。

    User Prompt

    通过键入"/"来呼出变量菜单,选中“系统变量query。

    使用 MCP 节点前,通常需要将输入对话的自然语言转换为 MCP 节点的输入参数。因此,需要在 System Prompt 中描述 MCP 服务的功能和输入输出信息,以限定大模型的输出格式。
    image
  4. 查询天气信息
    使用高德 MCP 服务提供的天气查询工具,接收一个城市名,返回该城市的天气信息。
    从左侧工具栏中拖入一个 MCP 节点,按照图示选择 maps_weather 工具,确认节点配置。
    image
    将 MCP 节点命名为“天气查询工具”,然后将此节点连接到“信息提取”节点。
    点击节点左上角的箭头按钮,即可展开或收起节点配置。
    image
    点击 MCP 节点内 maps_weather 工具的配置按钮,修改输入为“引用:信息提取/result”。
    image
  5. 总结天气信息 为了将 MCP 服务返回的结果整理成便于阅读的自然语言,从左侧工具栏中拖入一个大模型节点,命名为“信息总结”。请将此节点连接到“天气查询工具”节点,并按照指引填写参数。
    其他参数保持默认即可:

    参数名

    参数值

    模型配置

    通义千问-Max

    System Prompt

    你是一个信息处理助手,你的任务是将用户输入的信息整合为自然语言。

    User Prompt

    通过键入"/"来呼出变量菜单,选中“天气查询工具result”

    image
  6. 输出查询结果 将此节点连接到“信息总结”节点,并按照指引填写参数,以获取最终的输出结果。

    参数名

    参数值

    输入框

    键入"/"来呼出变量菜单,选中“信息总结result

    image
  7. 测试查询效果 点击右上角“测试”按钮,输入“查询杭州天气”,查看工作流的输出结果。
    image

外部调用 MCP 服务

阿里云百炼支持通过外部调用将 MCP 服务集成至第三方应用或项目中,详情参考外部调用。
Agent 开发运行
Agent 上下文
Agent 治理与进化
应用广场