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