自定义接入MCP

自定义接入是最灵活的MCP创建方式。您可以通过填写MCP服务的连接地址，将任意MCP服务接入平台供智能体调用。

该方式支持接入开源社区中的MCP（如GitHub、ModelScope上的开源MCP），也支持接入用户自主开发的MCP服务，适用于有特定业务系统对接需求、或需要使用社区开源MCP能力的场景。操作示例请参见示例：快速接入ModelScope魔塔社区MCP工具集。

前提条件

如果需要接入自主开发或私有部署的MCP服务，请确保该服务已完成部署并可通过公网地址访问。由于AgentArts为公有云服务，平台需要通过公网与MCP服务建立连接，无法直接访问内网或本地环境中的服务。
如果MCP服务需要鉴权，请提前准备好所需的鉴权信息（如API Key、OAuth 2.0的客户端ID和密钥等）

约束与限制

单租户可创建的NPX和UVX类型MCP服务数量上限为400 个。如需查看配额详情或申请扩大配额，请参考申请扩大FunctionGraph配额。

费用说明

创建自定义MCP服务不涉及计费。
在调用自定义MCP服务时，可能会涉及到第三方平台服务的使用费用，请以第三方平台的计费规则为准。

操作步骤

登录AgentArts智能体开发平台，在左侧导航栏“个人空间”区域，选择目标空间。
在左侧导航栏选择“开发中心 > 组件库 ”，单击左上角“MCP”页签，进入MCP管理界面。
在MCP管理界面，单击右上角的“创建MCP > 空白创建”创建MCP服务。

图1 创建MCP

在“空白创建”的弹框中，输入MCP服务的配置信息，参数说明请参考表1。

表1 MCP服务参数说明
参数	说明	示例
服务图标	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服务安装方式示例	使用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时，鼠标移动至“鉴权配置”右侧的上，可参看密钥的加密方式。平台默认使用KMS加密 + 默认密钥方式对认证密钥进行加密存储，防止信息泄露。加密机制：使用用户选择的密钥派生DEK进行加密，默认密钥为kms-agentarts/default。费用说明：实例不收费，每月提供20,000次免费调用次数。解密时支持缓存，但敏感数据较多时可能超出免费次数。如需更换加密方式，具体请参考更换密钥的加密方式。	无需鉴权