自定义接入mcp-j9九游会登录

费用说明

• 创建自定义mcp服务不涉及计费。
• 在调用自定义mcp服务时，可能会涉及到第三方平台服务的使用费用，请以第三方平台的计费规则为准。
• 如果使用kms对密钥进行加密存储，超出20,000次免费调用额度后按实际调用次数计费，详见。

前提条件

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

操作步骤

1. 登录。
2. 在左侧导航栏选择“开发中心 > 组件库 ”，单击左上角“mcp”页签，进入mcp管理界面。
3. 在mcp管理界面，单击右上角的“创建mcp > 空白创建”创建mcp服务。
4. 在“空白创建”的弹框中，输入mcp服务的配置信息，参数说明请参考表1。

   表1 mcp服务参数说明

   参数	说明	示例
   服务名称	mcp服务名称，用于区分不同的mcp服务实例，不会对大模型的判断和调用产生影响。 命名规则： 命名要求：仅支持以中文或英文字母开头。 支持字符：中文、英文、数字、中划线（-）、下划线（_）。 长度限制：2~64个字符。	网页内容抓取
   服务描述	mcp服务的描述信息，帮助用户理解服务功能。例如，一个强大的mcp服务器，可以轻松地将网页内容抓取并转换为各种格式（html、json、markdown、纯文本）。	该服务器使大型语言模型能够检索和处理网页内容，将html转换为markdown格式，以便于更轻松地使用。
   服务图标	系统默认提供mcp服务图标。输入名称和描述后，单击可以自动生成头像。用户也可以自定义图标，自定义图标步骤如下： 鼠标移动至系统默认图标上，单击鼠标左键。 上传已准备好的应用图标。 支持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服务安装方式示例	使用http，json编辑模式。 { "mcpservers": { "example-sse": { "url": "https://example.com?key=<您在服务j9九游会登录官网上申请的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时，鼠标移动至“鉴权配置”右侧的上，可查看密钥的加密方式。平台默认使用kms加密 默认密钥方式对认证密钥进行加密存储，防止信息泄露。 加密机制：使用用户选择的密钥派生dek进行加密，默认密钥为kms-agentarts/default。 费用说明：实例不收费，每月提供20,000次免费调用额度。解密时支持缓存，但敏感数据较多时可能超出免费次数。如需更换加密方式，具体请参考更换密钥的加密方式。超出后按实际调用次数计费，详见。	无需鉴权

5. 配置完成后，单击“安装”提交mcp部署任务。您可在“mcp 列表”中查看服务状态，如果显示“部署失败”，请单击“查看原因”排查问题后重试。
   图2 查看失败原因