连接器（Connector）用于将 ArkClaw 与外部系统或平台连接，使 Agent 能调用外部工具、读取外部数据或执行外部服务中的操作。通过为 ArkClaw 添加不同的连接器，您可以灵活扩展其能力边界，让 ArkClaw 直接操作不同的外部工具、读取外部数据或调用外部服务。

本文主要介绍如何查看、开启 ArkClaw 连接器，以及如何创建自定义连接器来接入第三方或自建服务。

连接器来源

来源	说明
官方预置	由火山引擎提前配置的连接器，仅需进行简单授权、关联等操作即可使用。了解更多
自定义	由您自行创建的连接器，可接入第三方服务或私有服务，仅可在当前 ArkClaw 中使用。了解更多

操作步骤

查看连接器详情

开启连接器前，您可以查看目标连接器功能、范围、计费与使用方式等信息，确保其满足您的业务要求。

登录 ArkClaw 控制台。

切换至目标 ArkClaw 页面，并单击页面右上角 Claw 详情页图标。

选择“工具套件 > 连接器”页签。

单击目标连接器卡片，了解当前连接器的作用、计费规则、功能范围及提示词示例等信息。

配置 ArkClaw 连接器

登录 ArkClaw 控制台。

切换至目标 ArkClaw 页面，并单击页面右上角 Claw 详情页图标。

选择“工具套件 > 连接器”页签。

单击目标连接器卡片的图标，根据指引完成授权。了解更多

后续，您可以在目标 ArkClaw 对话框的快捷入口中开启/关闭连接器，并在对话中指定连接器完成任务。

管理自定义连接器

创建自定义连接器

若预置连接器不满足您的需求，或您希望使用自建连接器，可以创建自定义连接器。

登录 ArkClaw 控制台。

切换至目标 ArkClaw 页面，并单击页面右上角 Claw 详情页图标。

选择“工具套件 > 连接器”页签，单击“+ 自定义”按钮。

配置如下信息，单击“确定”按钮。

手动配置

导入 JSON 文件配置

基础信息

参数	说明
连接器名称	自定义连接器名称。
服务端点 URL	指定调用连接器的远程服务地址。
传输协议	指定访问远程服务地址的网络传输协议。支持： Streamable HTTP：基于 HTTP 协议的流式传输方式，支持在单次连接中动态传输数据，兼容性好、部署简单。适用于大多数远程 MCP 服务。
连接器描述	简要描述当前连接器的使用场景、功能等信息。

认证方式

无需认证

API Key

当前连接器无需任何身份认证，添加后即可直接使用。适用于提供公开服务、无访问限制的连接器。

修改自定义连接器配置

您可以按需修改已创建连接器的配置，确保其随时满足您的业务需求。

登录 ArkClaw 控制台。

切换至目标 ArkClaw 页面，并单击页面右上角 Claw 详情页图标。

选择“工具套件 > 连接器”页签。

单击目标连接器卡片。

单击“编辑”按钮，按需修改连接器配置信息，参数详情可参考创建自定义连接器。

单击“确定”按钮，完成修改操作。

删除自定义连接器

若您不再使用自定义连接器，可将其删除。

登录 ArkClaw 控制台。

切换至目标 ArkClaw 页面，并单击页面右上角 Claw 详情页图标。

选择“工具套件 > 连接器”页签。

单击目标连接器卡片。

单击“删除”按钮。

在弹窗中确认注意信息，单击“删除”按钮完成操作。

附录

连接器配置示例

无需认证

{
"mcpServers": {
"my_mcp": {
"url": "https://example.com/mcp",
"transport": "streamable-http"
}
}
}

参数说明：

参数	说明
my_mcp	请替换为自定义连接器名称。
url	指定调用连接器的远程服务地址。
transport	指定访问远程服务地址的网络传输协议。支持： streamable-http：基于 HTTP 协议的流式传输方式，支持在单次连接中动态传输数据，兼容性好、部署简单。适用于大多数远程 MCP 服务。

API Key

{
"mcpServers": {
"my_mcp": {
"url": "https://example.com/mcp",
"transport": "streamable-http",
"auth": {
"type": "api_key",
"in": "header",
"name": "api_key",
"value": "<API_KEY>"
}
}
}
}

参数说明

参数	说明
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 值。

参数	说明
传递位置	指定 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 文件，配置项说明请参见连接器配置示例。
连接器描述	简要描述当前连接器的使用场景、功能等信息，最多不超过 50 字。

ArkClaw 企业版