在阿里云百炼中集成OpenAPI MCP Server

更新时间:
复制为 MD 格式

本文将为您介绍在阿里云百炼中如何集成OpenAPI MCP Server。

导入OpenAPI MCP Server

  1. 阿里云百炼控制台-MCP管理页面,单击创建MCP服务,并选择从阿里云OpenAPI导入。

  2. 在创建MCP服务页面,根据以下指引填写配置。

    配置项

    配置说明

    示例

    服务名称

    指定要导入的OpenAPI MCP服务的名称。

    mcp-demo

    访问阿里云OpenAPI角色

    阿里云百炼访问OpenAPI时的角色。您可使用已有角色,或在此处创建角色

    BailianMcpRoleDemo

    权限策略

    当访问阿里云OpenAPI角色为新建角色时,该角色将自动包含页面中显示的权限;若复用已有角色,您需要复制页面中的权限策略,并在RAM控制台-权限策略页面创建自定义权限策略,然后将该权限策略授予访问阿里云OpenAPI角色

    重要

    在后续向OpenAPI MCP Server中添加API时,必须在权限策略中补充相应的操作权限。

    [自动生成]

    完成配置后,单击确认导入

  3. 导入完成之后,可以在MCP管理页面查看刚导入的MCP Server以及查看MCP Server中的工具信息。

调试MCP

  1. 阿里云百炼控制台-应用管理页面,选择需要添加MCP的应用。如无现有应用,请先新增应用。

  2. 在应用配置页面,添加之前步骤中创建的自定义MCP服务。

    技能区域的MCP服务一栏,单击+ MCP

  3. 在文本对话中输入一段自然语言,以测试MCP的集成是否成功。例如,可以输入“查询杭州的ECS实例”进行验证。若集成成功,应用将调用MCP Tools中的Ecs-20140526-DescribeInstances并返回查询结果。

在程序中调用MCP

当您希望通过程序调用OpenAPI MCP Server时,可以在阿里云百炼中发布已集成MCP的应用。应用发布后,您即可在程序中通过调用该应用 来使用MCP Tools操作阿里云资源。

import os
from http import HTTPStatus
from dashscope import Application

response = Application.call(
    # 若没有配置环境变量,可用百炼API Key将下行替换为:api_key="sk-xxx"。但不建议在生产环境中直接将API Key硬编码到代码中
    api_key=os.getenv("DASHSCOPE_API_KEY"),
    app_id='xxx',  # 替换为实际的应用 ID
    prompt='查询杭州地域的ECS实例')

if response.status_code != HTTPStatus.OK:
    print(f'request_id={response.request_id}')
    print(f'code={response.status_code}')
    print(f'message={response.message}')
    print(f'请参考文档: https://help.aliyun.com/zh/model-studio/developer-reference/error-code')
else:
    print(response.output.text)

应用发布渠道

阿里云百炼支持将已创建的应用以多种方式分享或发布至不同平台,便于将 AI 能力集成到具体业务中,例如发布为钉钉机器人、微信公众号等,详情请参见应用分享