# 自定义接入MCP 自定义接入是最灵活的MCP创建方式。您可以通过填写MCP服务的连接地址，将任意MCP服务接入平台供智能体调用。 该方式支持接入开源社区中的MCP（如GitHub、ModelScope上的开源MCP），也支持接入用户自主开发的MCP服务，适用于有特定业务系统对接需求、或需要使用社区开源MCP能力的场景。操作示例请参见[示例：快速接入ModelScope魔塔社区MCP工具集](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0318.html)。 #### 费用说明 - 创建自定义MCP服务不涉及计费。 - 在调用自定义MCP服务时，可能会涉及到第三方平台服务的使用费用，请以第三方平台的计费规则为准。 - 如果使用KMS对密钥进行加密存储，超出20,000次免费调用额度后按实际调用次数计费，详见[密码安全中心计费说明](https://support.huaweicloud.com/price-dew/dew_03_0001.html)。 #### 前提条件 - 已[开通AgentArts服务](https://support.huaweicloud.com/qs-agentarts/agentarts_04_0000.html)。 - 如果需要接入自主开发或私有部署的MCP服务，请确保该服务已完成部署并**可通过公网地址访问**。由于AgentArts为公有云服务，平台需要通过公网与MCP服务建立连接，无法直接访问内网或本地环境中的服务。 - 如果MCP服务需要鉴权，请提前准备好所需的鉴权信息（如API Key、OAuth 2.0的客户端ID和密钥等）。 #### 操作步骤 1. 登录[AgentArts智能体平台](https://console.huaweicloud.com/agentarts/#/home/overview)。 2. 在左侧导航栏选择"开发中心 \> 组件库"，单击左上角"MCP"页签，进入MCP管理界面。 3. 在MCP管理界面，单击右上角的"**创建MCP \> 空白创建**"创建MCP服务。 4. 在"空白创建"的弹框中，输入MCP服务的配置信息，参数说明请参考[表1]。 表1MCP服务参数说明 | 参数 | 说明 | 示例 | |:---|:---|:---| | 服务名称 | MCP服务名称，用于区分不同的MCP服务实例，不会对大模型的判断和调用产生影响。 - 命名要求：仅支持以**中文** 或**英文字** **母**开头。 - 支持字符：中文、英文、数字、中划线（-）、下划线（_）。 - 长度限制：2\~64个字符。 | 网页内容抓取 | | 服务描述 | MCP服务的描述信息，帮助用户理解服务功能。例如，一个强大的MCP服务器，可以轻松地将网页内容抓取并转换为各种格式（HTML、JSON、Markdown、纯文本）。 | 该服务器使大型语言模型能够检索和处理网页内容，将HTML转换为markdown格式，以便于更轻松地使用。 | | 服务图标 | 系统默认提供MCP服务图标。输入名称和描述后，单击![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002687949682.png "点击放大")可以自动生成头像。用户也可以自定义图标，自定义图标步骤如下： 1. 鼠标移动至系统默认图标上，单击鼠标左键。 2. 上传已准备好的应用图标。 支持png、jpeg、gif、jpg格式图片，且图片大小不大于200KB。 | 默认 | | 选择类型 | 选择安装MCP服务的类型。平台支持以下两类、四种MCP连接模式： 如果您获取的是MCP源码，推荐使用Stdio模式；如果您获取的是已部署服务的API地址，请选择HTTP模式。 - **Stdio（含NPX、UVX）** 选择该方式时，平台会在内部自动下载并启动MCP服务，无需用户自行部署。其中NPX适用于Node.js生态的MCP服务，UVX适用于Python生态的MCP服务。 - **HTTP（含Streamable HTTP、SSE** **）** 选择该方式时，MCP服务运行在外部环境中（如用户自建服务器、第三方MCP厂商提供的接口等），平台作为客户端通过网络地址发起连接。其中Streamable HTTP是MCP协议推荐的远程连接方式，SSE是较早期的远程连接方式，两者均只需提供MCP服务的接口地址即可接入。 平台提供两种配置录入方式，选择其中一种填写即可： - **表单编辑：** 直接在表单中填写MCP服务的连接地址，适合配置信息简单的场景。在表单编辑模式下，除了填写连接地址外或参数，还需要根据安装方式的不同配置以下信息。 环境变量：用于设置MCP服务运行时所需的变量参数，通常用来存放API Key、Token等敏感信息。 请求头：用于在平台向MCP服务发起请求时附加自定义的HTTP头部信息。部分MCP服务要求在请求头中传递鉴权凭证或其他标识参数。 - **JSON编辑** ：以标准JSON格式填写完整的MCP配置。**多数MCP厂商会提供完整的JSON配置，可以直接复制使用，无需额外再转换成表单。** 接入MCP服务时，MCP提供方通常会标注出MCP的安装方式，如果未明确写出，也可以从MCP的配置脚本中判断出来使用哪种方式进行安装。请选择合适的MCP安装方式。 图1各类MCP服务安装方式示例 ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002687789826.png "点击放大") | 使用HTTP，JSON编辑模式。 ``` { "mcpServers": { "example-sse": { "url": "https://example.com?key=<您在服务官网上申请的key>" } } } ``` | | 鉴权配置 | 选择调用MCP时是否需要鉴权。 仅选择HTTP类型时需要配置鉴权信息。 - **无需鉴权**：API可以公开访问，不需要任何形式的身份认证或授权。 - **API Key** ：在调用API时提供一个唯一的API Key进行鉴权。需配置以下信息：需填写密钥位置、密钥参数名称和取值。智能体在发起请求时，会自动把这个API Key添加到请求的Header（请求头）或Query（URL参数）中。 - 密钥位置：密钥是从Header中读取还是从Query中读取。 - 参数名称：API Key的鉴权参数名称。 - 参数值：API Key的具体值。 - **OAuth2.0** ：OAuth 2.0是一个开放授权协议，允许第三方应用在无需获取您账号密码的情况下，安全地获取您在其他服务中的资源访问权限。 - **授权服务器地址URL**：授权服务器的端点URL，用于发送授权请求和接收响应。平台会向该地址发送请求以获取Access Token。此地址由您所对接的API服务商提供 - **客户端id**：由API服务商分配的应用唯一标识，用来区分和识别不同的应用，通常在服务商的开发者后台创建应用后获得。 - **客户端密钥**：与客户端id配对的密钥，用于验证应用身份的合法性，确保只有被授权的应用可以使用。 - **请求的权限范围**：声明本次授权需要访问的资源范围，用于限制应用的访问权限。 **关于密钥加密：** 当服务配置类型为**HTTP** 时，鼠标单击"鉴权配置"右侧的![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717389437.png)上，可查看密钥的加密方式。平台默认使用**KMS加密+默认密钥** 方式对认证密钥进行加密存储，防止信息泄露。 - 加密机制：使用用户选择的密钥派生DEK进行加密，默认密钥为kms-agentarts/default。 - 费用说明：实例不收费，每月提供20,000次免费调用额度。解密时支持缓存，但敏感数据较多时可能超出免费次数。如需更换加密方式，具体请参考[更换密钥的加密方式](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0288.html)。超出后按实际调用次数计费，详见[密码安全中心计费说明](https://support.huaweicloud.com/price-dew/dew_03_0001.html)。 | 无需鉴权 | 5. 配置完成后，单击"安装"提交MCP部署任务。您可在"MCP 列表"中查看服务状态，如果显示"部署失败"，请单击"查看原因"排查问题后重试。 图2查看失败原因 ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717549323.png "点击放大")