Skip to main content
MCP

自定义 MCP 服务

除官方 MCP 服务外，阿里云百炼还支持以下三种自定义 MCP 服务部署方式：使用脚本部署、从 AI 网关导入、从阿里云 OpenAPI 导入。

使用脚本部署

对于自行开发或开源社区的 MCP 服务代码，阿里云百炼支持使用函数计算 FC进行托管。 以部署开源社区的 Knowledge Graph Memory MCP 服务为例：
Knowledge Graph Memory MCP 服务：该服务使大模型能够记录个性化信息，并在后续交互中调用这些信息进行回复。
1

创建 MCP 服务

前往 MCP 管理，点击 创建 MCP 服务。选择 使用脚本部署，点击 部署服务。
2

配置 MCP 服务

按照以下指引填写配置，确认无误后提交部署。
配置项用途本案例的配置
服务名称 / 描述用于区分不同的 MCP 服务，不影响大模型的判断和调用。服务名称：长期记忆；描述：该服务使大模型能够记录个性化信息，并在后续交互中调用这些信息进行回复。
安装方式npx：启动使用 Node.js 开发的 MCP 服务；uvx：启动使用 Python 开发的 MCP 服务；http：连接到一个已有的、运行在别处的远程 MCP 服务器。选择：npx
部署方式（仅限 npx/uvx）基础模式：适用于按需启动、节省成本、可以承受较慢响应的场景。极速模式：适用于持续运行、快速响应、可以承受较高成本的场景。保持 基础模式，关闭 极速模式
部署地域（仅限 npx/uvx）为获得最佳响应速度，建议选择靠近其他已有云服务的地域。若不确定如何选择，推荐使用"北京"地域。选择：北京
MCP 服务配置如需部署开源社区 MCP 服务，请直接粘贴从 MCP 服务详情页获取的配置代码。见下方示例
请务必核实 MCP 服务的来源和源代码，以免遭受钓鱼攻击。
并非所有 MCP 服务都支持 npx/uvx/http 方式部署。若缺少相应配置代码，则无法直接部署到阿里云百炼。
配置代码示例：
{
"mcpServers": {
"memory": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-memory"
]
}
}
}
自定义开发的 MCP 服务配置模板：
{
"mcpServers": {
"本地 MCP 服务": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@your_acc_name/your_pkg_name"
],
"env": {
"YOUR_ENV_KEY": "YOUR_ENV_VALUE"
}
},
"远程 MCP 服务": {
"type": "sse/streamableHttp",
"url": "https://your-mcp-server/sse"
}
}
}
3

管理 MCP 服务

提交部署后，可查看部署状态、测试工具效果以及修改服务配置。
  • 查看部署状态：可前往函数计算 FC 控制台查看 MCP 服务的详细部署状态。（可选）建议启用日志服务，方便实时查看服务运行状态。
  • 测试工具效果：在 工具 页可测试 MCP 服务的运行效果。
  • 修改服务配置：部署后，仅支持编辑 服务名称 和 描述。如需修改 部署方式、部署地域、安装方式 和 MCP 服务配置，必须先停止当前部署，在修改配置后重新部署。
4

使用 MCP 服务

部署完成后，即可将自定义 MCP 服务添加到智能体或工作流中使用，详见官方 MCP 服务中的配置步骤。

从 AI 网关导入

对于已有的自建或第三方业务接口，可使用 AI 网关将 RESTful API 升级为 MCP 服务。通过阿里云百炼，可以快速导入在 AI 网关托管的 MCP 服务。
1

导入准备

请确保已在 AI 网关托管了 MCP 服务。
2

导入 MCP 服务

前往 MCP 管理，单击 创建 MCP 服务。选择 从 AI 网关导入，单击 导入服务。
3

配置 MCP 服务

按照下表指引填写配置信息，确认无误后单击 确认导入。
配置项配置说明示例
网关所在地域AI 网关所在地域华东 1（杭州）
网关实例AI 网关实例test
选择 MCP 服务AI 网关托管的 MCP 服务test
选择接入点系统会自动生成一个可供测试的接入点。[自动生成]
4

完成导入

导入完成后，可在 MCP 管理 > 自定义服务 查看从 AI 网关导入的 MCP 服务。

从阿里云 OpenAPI 导入

如需通过操作阿里云云资源创建服务，可使用 OpenAPI 开发者门户将官方 OpenAPI 快速发布为 MCP 服务。
1

导入准备

请确保在 OpenAPI 开发者门户创建过 MCP 服务。
2

导入 MCP 服务

前往 MCP 管理，点击 创建 MCP 服务。选择 从阿里云 OpenAPI 导入，点击 导入服务。
3

配置 MCP 服务

配置项配置说明示例
服务名称需要导入的 OpenAPI MCP 服务。oss
访问阿里云 OpenAPI 角色阿里云百炼访问 OpenAPI 时的角色。可使用已有角色，或创建新角色。BailianMcpRoleFoross
权限策略前往 RAM 权限策略创建权限策略并授予角色。[自动生成]
4

完成导入

导入完成后，可在 MCP 管理 > 自定义服务 查看从 OpenAPI 导入的 MCP 服务。
MCP
Skill
更新日志