Versatile的资产中心提供多种MCP资源,用户通过简单安装即可快速集成调用。同时,平台支持灵活拓展,兼容开源社区MCP及自主开发MCP服务的接入。在Agent应用开发中集成MCP服务,可显著提升工具调用能力。
前提条件
如果需要接入自主开发的MCP服务,需确保该服务已完成独立部署。
自主开发的MCP服务需在服务器或本地上独立部署,并通过测试确保其能够正常运行。
创建MCP服务
- 登录Versatile智能体平台,在左侧导航栏“个人空间”区域,选择进入所需空间。
如果已选择团队空间,界面显示为实际的团队空间名称,而非“个人空间”。
图1 选择团队空间
- 在左侧导航栏选择“开发中心 > 组件库 > 我的MCP”,单击“创建”创建MCP服务。
- 在创建MCP服务的弹框中,您可以选择空白模板或平台提供的其他MCP服务模板,如图2所示。然后单击“下一步”继续操作。
对于资产中心中未安装的预置MCP,您也可以按照以下步骤进入服务创建页面:在“资产中心 > MCP广场 ”页签,将鼠标光标移至MCP卡片上,单击
“安装”按钮。
- 空白模板:适用于安装开源社区的MCP或接入自主开发的MCP服务。
- 平台预置MCP:适用于安装平台预置的MCP。
图2 创建MCP服务
- 配置MCP服务,参数的具体说明请参考表1所示。
表1 创建MCP服务参数说明
参数 |
说明 |
服务图标 |
MCP服务的图标,支持SVG、PNG、JPG、JPEG。 |
服务名称 |
MCP服务名称,用于区分不同的MCP服务实例,不会对大模型的判断和调用产生影响。
命名规则:
- 命名要求:仅支持以中英文开头;
- 支持字符:中英文、数字、中划线(-)、下划线(_);
- 长度限制:2~64个字符。
|
服务描述 |
MCP服务的描述信息,帮助用户理解服务功能。例如,一个强大的MCP服务器,可以轻松地将网页内容抓取并转换为各种格式(HTML、JSON、Markdown、纯文本)。 |
服务介绍 |
更详细地介绍该MCP服务的一些功能。例如,使用方式,关键能力,使用场景,注意事项等。 |
安装方式 |
选择MCP服务的安装方式,支持以下三种方式:
- NPX:当MCP基于Node.js开发时选择NPX方式。
- UVX:当MCP基于Python开发时选择UVX方式。
- SSE:适用于与已部署在外部环境的远程MCP服务器建立连接,例如,接入自主开发的MCP服务。
|
输入MCP服务配置 |
支持使用表单编辑或使用JSON格式编辑。
- 使用JSON格式编辑,当使用JSON格式编辑时,将明文显示加密变量值,加密变量以_encrypt_开头,请谨慎操作。
- 安装平台预置的MCP时,默认展示当前MCP的服务配置,一般无需修改,部分服务需要填写API Key,请登录该MCP服务的官网获取。
例如,百度地图的服务配置如下,“BAIDU_MAP_API_KEY”需要登录百度地图官网获取。
{
"mcpServers": {
"baidu-map": {
"command": "npx",
"args": [
"-y",
"@baidumap/mcp-server-baidu-map"
],
"env": {
"BAIDU_MAP_API_KEY": "xxx"
}
}
}
}
- 如果部署开源社区的MCP,请在开源社区该MCP服务详情页获取配置代码。
- 如果选择SSE方式接入自主开发的MCP服务,服务配置模板如下,请将“url”更换为该MCP服务的实际部署地址。
{
"mcpServers": {
"example-sse": {
"url": "https://example.com?key=<您在服务官网上申请的key>"
}
}
}
- 使用表单编辑
- 参数值:填写参数值时,多个参数值之间使用英文逗号分隔。例如,-y,@baidumap/mcp-server-baidu-map。
- 环境变量:单击“添加环境变量”,输入键值对,配置环境变量,例如,BAIDU_MAP_API_KEY: XXX。
- URL:外部环境部署的MCP服务的地址。例如https://example.com?key=<您在服务官网上申请的key>。仅在选择SSE方式安装时需要配置。
- 请求头:单击“添加请求头”,输入键值对,配置请求头。
加密功能:单击输入框右侧的密文图标,可将参数值加密显示 |
- 单击“保存”。MCP安装完成后,可以在“我的MCP”页面查看创建成功的MCP。
- 创建完成之后,可以在“我的MCP”页面查看MCP的部署状态,部署成功的MCP才能在智能体或工作流使用。
更多操作
MCP服务创建完成后,可根据需要执行如表2所示的操作。
表2 更多操作
操作 |
步骤 |
删除MCP服务 |
删除后,MCP服务会下线,请谨慎操作。
在“我的MCP”页面,在MCP卡片上单击“删除”按钮,注意此操作将导致MCP服务下线,请谨慎操作。 |
查看MCP服务概览 |
在“我的MCP”页面,单击MCP卡片,选择“概览”页签,可以查看MCP的服务描述、服务介绍、能力以及使用说明等信息。 |
查看工具 |
在“我的MCP”页面,单击MCP卡片,选择“工具”页签,可以查看MCP支持的工具详情并测试工具运行效果。 |