连接器（Connector）用于将 ArkClaw 与外部系统或平台连接，使 Agent 能调用外部工具、读取外部数据或执行外部服务中的操作。通过为 ArkClaw 添加不同的连接器，您可以灵活扩展其能力边界，让 ArkClaw 直接操作不同的外部工具、读取外部数据或调用外部服务。本文主要介绍如何查看、开启 ArkClaw 连接器，以及如何创建自定义连接器来接入第三方或自建服务。 ## 连接器来源 |来源 |说明 | |---|---| |官方预置 |由火山引擎提前配置的连接器，仅需进行简单授权、关联等操作即可使用。[了解更多](https://docs.volcengine.com/docs/87732/2548828?lang=zh#D0MuzGjV) | |自定义 |由您自行创建的连接器，可接入第三方服务或私有服务，仅可在当前 ArkClaw 中使用。[了解更多](https://docs.volcengine.com/docs/87732/2596227#UN8hlPwf) | ## 操作步骤 ### 查看连接器详情开启连接器前，您可以查看目标连接器功能、范围、计费与使用方式等信息，确保其满足您的业务要求。 1. 登录 [ArkClaw 控制台](https://console.volcengine.com/arkclaw/)。 2. 切换至目标 ArkClaw 页面，并单击页面右上角 Claw 详情页图标。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_72e4ba287d462bdd7df7d9e33e63d362.png) 3. 选择“工具套件 \> 连接器”页签。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_8a211f50437b62379e3d724c5ee025b9.png) 4. 单击目标连接器卡片，了解当前连接器的作用、计费规则、功能范围及提示词示例等信息。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_d31b7bef88b4ed126c146a2f555015c2.png) ### 配置 ArkClaw 连接器 1. 登录 [ArkClaw 控制台](https://console.volcengine.com/arkclaw/)。 2. 切换至目标 ArkClaw 页面，并单击页面右上角 Claw 详情页图标。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_72e4ba287d462bdd7df7d9e33e63d362.png) 3. 选择“工具套件 \> 连接器”页签。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_47c10f53737cf90e92b24e8f4cb20ea1.png) 4. 单击目标连接器卡片的![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_7361e3491df6d5cbece827580789ab86.png) 图标，根据指引完成授权。[了解更多](https://docs.volcengine.com/docs/87732/2548828#t4OhMXav) ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_114fffa1b5a5d55c95d23226d6ffc1e9.png) 5. 后续，您可以在目标 ArkClaw 对话框的快捷入口中开启/关闭连接器，并在对话中指定连接器完成任务。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_bfb24975f631ad34b29d9b5710e66d83.png) ### 管理自定义连接器 #### 创建自定义连接器若预置连接器不满足您的需求，或您希望使用自建连接器，可以创建自定义连接器。 1. 登录 [ArkClaw 控制台](https://console.volcengine.com/arkclaw/)。 2. 切换至目标 ArkClaw 页面，并单击页面右上角 Claw 详情页图标。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_72e4ba287d462bdd7df7d9e33e63d362.png) 3. 选择“工具套件 \> 连接器”页签，单击“+ 自定义”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_47c10f53737cf90e92b24e8f4cb20ea1.png) 4. 配置如下信息，单击“确定”按钮 **。** 手动配置 * **基础信息** |参数 |说明 | |---|---| |连接器名称 |自定义连接器名称。 | |服务端点 URL |指定调用连接器的远程服务地址。 | |传输协议 |指定访问远程服务地址的网络传输协议。支持：

* **Streamable HTTP**：基于 HTTP 协议的流式传输方式，支持在单次连接中动态传输数据，兼容性好、部署简单。适用于大多数远程 MCP 服务。 | |连接器描述 |简要描述当前连接器的使用场景、功能等信息。 | * **认证方式** 无需认证当前连接器无需任何身份认证，添加后即可直接使用。适用于提供公开服务、无访问限制的连接器。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_b6fb44bb333d7d67b21ae819f0f62a00.png) API Key 当前连接器通过 API Key 进行身份认证。添加连接器时，您需要填写服务商提供的 API Key，系统将在请求时自动携带该密钥完成鉴权。 |参数 |说明 | |---|---| |传递位置 |指定 API Key 的传递方式。支持：

* **Header**：表示在请求头中传递 API Key。需配置：

* **Header 名称**：指定 API Key 在请求 Header 中的字段名，例如 `Authorization`。

* **Key 前缀**：指定 API Key 值前附加的前缀，最终格式为` {前缀} {API Key}`，例如：`Bearer tiku8*****`。

* **Query**：表示在请求 URL Query 中传递 API Key。需配置：

* **Query 参数名**：指定 API Key 在请求 URL Query 中的参数名，例如 `api_key`。 | |API Key |指定调用连接器使用的 API Key 值。 | 导入 JSON 文件配置您可以将连接器配置 JSON 内容或 JSON 文件上传至火山引擎，快速完成创建。 |参数 |说明 | |---|---| |连接器名称 |自定义连接器名称。 | |粘贴 JSON |填写目标连接器配置的 JSON 信息，配置项说明请参见 [连接器配置示例](https://docs.volcengine.com/docs/87732/2596227#y3jG4spt)。 | |上传 JSON 文件 |上传包含目标连接器配置信息的 JSON 文件，配置项说明请参见 [连接器配置示例](https://docs.volcengine.com/docs/87732/2596227#y3jG4spt)。 | |连接器描述 |简要描述当前连接器的使用场景、功能等信息，最多不超过 50 字。 | #### 修改自定义连接器配置您可以按需修改已创建连接器的配置，确保其随时满足您的业务需求。 1. 登录 [ArkClaw 控制台](https://console.volcengine.com/arkclaw/)。 2. 切换至目标 ArkClaw 页面，并单击页面右上角 Claw 详情页图标。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_72e4ba287d462bdd7df7d9e33e63d362.png) 3. 选择“工具套件 \> 连接器”页签。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_47c10f53737cf90e92b24e8f4cb20ea1.png) 4. 单击目标连接器卡片。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_9d4079d6152d58d38b4c6e7e91ae1d51.png) 5. 单击“编辑”按钮，按需修改连接器配置信息，参数详情可参考 [创建自定义连接器](https://docs.volcengine.com/docs/87732/2596227#UN8hlPwf)。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_99a546bde3d188a4c3c2dc63ab636dab.png) 6. 单击“确定”按钮，完成修改操作。 #### 删除自定义连接器若您不再使用自定义连接器，可将其删除。

注意

删除操作不可恢复，请确认当前连接器未被任务使用。

1. 登录 [ArkClaw 控制台](https://console.volcengine.com/arkclaw/)。 2. 切换至目标 ArkClaw 页面，并单击页面右上角 Claw 详情页图标。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_72e4ba287d462bdd7df7d9e33e63d362.png) 3. 选择“工具套件 \> 连接器”页签。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_47c10f53737cf90e92b24e8f4cb20ea1.png) 4. 单击目标连接器卡片。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_9d4079d6152d58d38b4c6e7e91ae1d51.png) 5. 单击“删除”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_188f90aff17cda7ba9ccd52d72dc8e5d.png) 6. 在弹窗中确认注意信息，单击“删除”按钮完成操作。 ## 附录 ### 连接器配置示例 * **无需认证** ```JSON { "mcpServers": { "my_mcp": { "url": "https://example.com/mcp", "transport": "streamable-http" } } } ``` **参数说明：** |参数 |说明 | |---|---| |my_mcp |请替换为自定义连接器名称。 | |url |指定调用连接器的远程服务地址。 | |transport |指定访问远程服务地址的网络传输协议。支持：

* `streamable-http`：基于 HTTP 协议的流式传输方式，支持在单次连接中动态传输数据，兼容性好、部署简单。适用于大多数远程 MCP 服务。 | * **API Key** ```JSON { "mcpServers": { "my_mcp": { "url": "https://example.com/mcp", "transport": "streamable-http", "auth": { "type": "api_key", "in": "header", "name": "api_key", "value": "" } } } } ``` **参数说明** |参数 |说明 | |---|---| |my_mcp |请替换为自定义连接器名称。 | |url |指定调用连接器的远程服务地址。 | |transport |指定访问远程服务地址的网络传输协议。支持：

* `streamable-http`：基于 HTTP 协议的流式传输方式，支持在单次连接中动态传输数据，兼容性好、部署简单。适用于大多数远程 MCP 服务。 | |auth |指定连接器认证信息。

* `type`：指定认证方式。支持：

* `api_key`：通过 API Key 进行认证。

* `in`：指定 API Key 的传递方式。支持：

* `header`：表示在请求头中传递 API Key。

* `query`：表示在请求 URL Query 中传递 API Key。

* `name`：指定 API Key 在请求中的字段名。

* `value`：指定调用连接器使用的 API Key 值。 |

ArkClaw 企业版