> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coze.cn/llms.txt
> Use this file to discover all available pages before exploring further.

扣子编程内置了 MCP （Model Context Protocol）客户端能力，允许你基于已有的 MCP 服务创建自定义插件，轻松、高效地将外部的 MCP 工具能力集成到扣子编程，从而扩展低代码智能体、工作流的能力边界。
## 使用场景 {#a9dcb281}
当你想要将自定义部署的 MCP 工具或第三方产品的官方 MCP 工具集成到扣子编程时，可以通过**创建插件**方式完成这一集成操作。整个过程无需复杂编码，仅通过配置化操作即可完成集成。

1. 在扣子编程，基于 MCP 服务创建自定义插件。
2. 在创建过程中，需要提供 MCP 工具的 URL 等配置信息。
3. 创建并发布插件后，在低代码智能体、工作流中调用该插件，即可使用 MCP 工具所提供的能力。

例如，某第三方地图产品已提供 MCP Server 能力，当你需要在扣子编程中搭建地图插件时，无需从零开发。你可以先基于该产品的 MCP Server 生成对应的 MCP 工具，然后在扣子编程基于 MCP 服务创建插件，即可快速生成一个具备路径规划、位置查询等地图能力的扣子编程插件。
## 费用说明 {#87c4fa31}
在扣子编程基于 MCP 服务创建插件不会产生扣子费用。需要注意的是，你选择的 MCP 服务涉及第三方调用，可能产生第三方产品的费用，具体收费标准以第三方产品的规定为准。
## 使用限制 {#9b225db5}
基于**扣子付费插件**封装的 MCP 工具，不支持二次封装为新的扣子编程插件。
## 步骤一：创建插件 {#94dc18e0}
1. 登录[扣子编程](https://code.coze.cn/home)。
2. 在页面顶部选择目标工作空间，然后在左侧导航栏中单击**资源库**。


3. 在页面右上角，选择 **+资源** > **插件**。
4. 配置插件信息并单击**确认**。
   1. 设置基础信息。
      <!-- @cols-width: 247,515 -->
      | | | \
      |**配置项** |**说明** |
      |---|---|
      | | | \
      |插件名称 |自定义插件名称，用于标识当前插件。建议输入清晰易理解的名称，便于大语言模型搜索与使用插件。 |
      | | | \
      |一句话介绍 |对插件核心功能进行简短、精炼的概括。 |
      | | | \
      |插件描述 |插件的描述信息，一般用于记录当前插件的用途。 |
      | | | \
      |插件图标 |单击默认图标后，您可以上传本地图片文件作为新的图标。 |
      | | | \
      |类型 |选择**MCP**。 |
      | | | \
      |私网连接 |**企业旗舰版**套餐支持通过私网连接服务。 |\
      | |选择**私有网络管理**中已创建的私网连接。如果没有可用的私网连接，请联系企业超级管理员或管理员创建私网连接，具体请参见[管理私网连接](/guides/private_link)。 |
      | | | \
      |插件 URL |插件的访问地址或相关资源的链接，此处为 MCP 工具的 URL。 |\
      | |:::tip 说明 |\
      | |插件 URL 必须为域名格式，暂不支持 IP 格式的 URL 地址。 |\
      | |::: |
      | | | \
      |Header 列表 |HTTP 请求头参数列表。您需要根据 MCP 自身的参数配置要求来填写。 |

   2. 设置授权方式。
      基于 MCP 创建自定义插件时，支持如下授权方式。
      <!-- @cols-width: 253,649 -->
      | | | \
      |**配置项** |**说明** |
      |---|---|
      | | | \
      |不需要授权 |无需授权，不指定授权参数。 |
      | | | \
      |Service > Service token / API key |**Service token / API key** 服务认证方式是指 API 通过秘钥或令牌校验请求者的身份。配置参数说明如下： |\
      | | |\
      | |* **位置**：选择秘钥或令牌在 API 请求中的位置，及 **Header**（请求头）或是 **Query** （查询参数）内。 |\
      | |* **Parameter name**：秘钥或令牌对应的参数名称。 |\
      | |* **Service token / API key**：秘钥或令牌的值。后续根据该值进行服务认证。 |
      | | | \
      |Service > OAuth 2.0 & OIDC |OIDC 一种广泛使用的授权框架，它基于 OAuth 2.0 协议之上，提供了身份验证和授权的功能。配置参数说明如下： |\
      | | |\
      | |* **grant_type**：根据 GrantType 来选择使用的 OAuth Flow，支持的 Flow 包括： |\
      | |   * TokenExchange：用于在不同服务之间交换令牌。 |\
      | |   * ClientCredential：用于客户端凭据授权流程，适用于没有用户直接参与的情况。 |\
      | |* **endpoint_url**：授权服务器的端点 URL，用于发送授权请求和接收响应。配置时需要指定授权服务器的地址，以便客户端可以正确地向服务器发起请求。 |\
      | |* **audience**：资源服务器，客户端告诉授权服务器它希望代表用户访问哪个资源服务器。配置时需要指定资源服务器的标识符。 |\
      | |* **scope**：客户端请求的权限范围。对于 OIDC，通常需要包含`openid`作用域，以请求身份验证，配置时需要根据需要请求的权限范围来设置。 |\
      | |* **client_id**：客户端在授权服务器注册时获得的唯一标识符，配置时需要使用在授权服务器注册应用时获得的 client_id。 |
      | | | \
      |OAuth > standard |OAuth 是一种常用于用户代理身份验证的标准，它允许第三方应用程序在不共享用户密码的情况下访问用户下的特定资源。 |\
      | | |\
      | |* **client_id**：注册 OAuth 后获取的唯一标识符。 |\
      | |* **client_secret**：与 client_id 匹配的密码。 |\
      | |* **client_url**：重定向授权 URL，在授权过程中，扣子编程会将用户引导至 `[client_url]?response_type=code&client_id=[client_id]&scope=[scope]&state=****&redirect_uri=[扣子编程的回调安全地址]`。 |\
      | |* **scope**：您的应用需要访问的资源范围或级别。 |\
      | |* **authorization_url**：获取用户令牌（token）的 URL。当用户通过上述 client_url 引导链接授权成功后，三方服务会返回用于获取 token 的 code，并跳转至扣子编程的回调安全地址，此时，扣子会通过对应参数向 authorization_url 对应地址发起请求，获取用户的 access_token。 |\
      | |* **authorization_content_type**：向 OAuth 发送授权请求时的内容类型或数据格式。 |


## 步骤二：试运行 {#d3087cf1}
基于 MCP 服务成功创建插件后，系统将**自动同步**并添加对应的所有 **MCP 工具**到工具列表中。你无需手动添加工具参数，可直接进行试运行。例如 maps_weather 工具用于查询天气，你可以在 `city` 参数输入`杭州`，当 `Response` 中正确返回杭州天气信息时，则表示调试成功。

::::cols
@col 50
![Image=1945x671](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/9dc34ef6887a44d5889fb87de74c7c39~tplv-goo7wpa0wc-image.image)


@col 50
![Image=1957x911](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/dba476dae66c4cc789b8104c77dd5037~tplv-goo7wpa0wc-image.image)

::::

## 步骤三：发布插件 {#25d35def}
当添加的工具调试成功后，则可以发布插件。插件成功发布后，才能在智能体、工作流中使用该插件。

1. 在插件页面，单击**发布**。
   ![Image=681x231](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/2974fc41c62149428ae662c72eca1c4a~tplv-goo7wpa0wc-image.image)
2. 确认是否需要收集个人信息，再进行发布。
   ![Image=369x171](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/ce3defd401f04de0913d09343e8b5a48~tplv-goo7wpa0wc-image.image)

## 上架到商店 {#c5a7f561}
你可以将插件上架到扣子插件商店或企业插件商店。不能同时上架扣子插件商店和企业插件商店，仅支持选择其中一个渠道。

* **上架扣子插件商店**
   对于通用功能、不涉及敏感数据且具有广泛适用性的公开插件，你可以将其上架到扣子商店，以便更多扣子用户发现、使用。详情请参考[将插件上架到插件市场](/guides/publish_plugin_to_store)。
* **上架企业插件商店**
   仅企业旗舰版支持。
   对于企业自主开发的涉及核心业务逻辑、数据敏感信息或仅限内部场景使用的插件，你可以将其上架到企业插件商店，供企业成员使用。详情请参考[管理企业插件](/guides/enterprise_plugin_store)。