本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
使用合作伙伴管理的连接器
合作伙伴管理的连接器连接 AWS DevOps 合作伙伴托管的模型上下文协议 (MCP) 服务器的代理。示例包括合作伙伴的可观察性或事件管理服务。合作伙伴将连接器发布在 AWS DevOps 代理工具存储库
使用连接器,您无需查找合作伙伴的端点网址、OAuth 网址或范围。您选择一个终端节点并仅输入自己的证书,然后 AWS DevOps 代理通过连接器生成其余的注册信息。当合作伙伴为其 MCP 服务器发布连接器时,请使用连接器。有关注册任何其他 MCP 服务器的说明,请参见 注册 MCP 服务器。
在本主题中, 连接器 指合作伙伴的定义,以及 MCP 服务器 表示您从中创建的注册。例如,控制台使用相同的术语 删除 MCP 服务器。
连接器会注册 MCP 服务器,因此其工具的工作方式与您自己注册的 MCP 服务器相同。连接器还提供以下功能:
固定配置 — 端点网址、身份验证方法以及 OAuth 网址和范围来自连接器。你无法改变它们。
推荐技能 — 您可以安装连接器在将其添加到代理空间时推荐的技能。稍后,你可以安装更多,打开或关闭它们,或者删除它们。
警报 webhook — 将连接器添加到代理空间时, AWS DevOps 代理创建一个 webhook,这样来自合作伙伴产品的警报就可以开始调查。一些连接器还会为您定义警报负载。
合作伙伴管理的连接器的工作原理
以下列表描述了谁运行连接器的服务器以及您的数据去向:
服务器操作 — 合作伙伴运营并支持 MCP 服务器。 AWS 不能操作它。要获得服务器方面的帮助,请使用 支持 控制台中连接器的链接。
连接器维护 — 每个连接器显示一个 Partner-managed 要么 AWS-管理 徽章。维护连接器定义的徽章名称。
证书 — 您的凭据仅适用于连接器定义中的网址。
请求 — 您为合作伙伴账户选择的终端节点属于合作伙伴所在的地区或站点。它可能在外面 AWS 您的代理空间的区域。与你连接的任何 MCP 服务器一样,向服务器发出的请求然后离开 AWS 地区。
注册和版本
以下列表描述了注册与代理空间和连接器版本的关系:
注册范围 — 您只需要注册一个连接器即可 AWS 账户。然后将其添加到每个需要它的代理空间中。
版本 — 注册会保留您注册的连接器版本。当合作伙伴弃用连接器时,该连接器将不再出现在 可用 部分,你无法再次注册。它的卡在下面 目前已注册 节目 已弃用,还有那个页面 查看全部 opens 可以命名取代它的连接器。现有注册会一直有效,直到您注销为止。
推荐技能
推荐技能是合作伙伴为其联系人推荐的技能,例如在调查期间使用合作伙伴工具的指导。推荐的技能来自中的技能目录 AWS DevOps 代理工具存储库
已安装的推荐技能与其他技能一起出现在您的代理空间中。它的内容来自目录,因此您无法对其进行编辑。代理加载它的方式与任何其他技能相同。有关技能的更多信息,请参阅 DevOps 代理技能。
开始前的准备工作
要使用合作伙伴管理的连接器,请确认您具备以下条件:
合作伙伴的账户,可以创建连接器所需的证书,例如 API 密钥或 OAuth 客户端。连接器的设置指南列出了合作伙伴产品中的步骤。
允许在中注册能力提供者并向代理空间添加功能 AWS DevOps 代理控制台。
(可选)现有的私有连接,前提是您通过私有网络到达合作伙伴的终端节点。有关私有连接的更多信息,请参阅 连接到私有托管的工具。
有关适用于任何 MCP 服务器的安全注意事项的更多信息,例如仅将所需工具列入许可名单,请参阅 安全注意事项。
寻找连接器
在注册连接器之前,请先查找连接器以查看其设置指南和推荐技能。你可以从 能力提供者 页面或来自代理空间。
在 “能力提供者” 页面上查找连接器
要在上找到连接器 能力提供者 页面,完成以下步骤:
打开 AWS DevOps 代理控制台位于 https://console.aws.amazon.com/devops-agent/
。 在导航窗格中,选择 能力提供者。
在 可用 部分,找到连接器。要缩小列表范围,请在中输入其名称 寻找能力,或者选择一个类别。每张卡片都显示连接器的徽章、描述和类别。
选择连接器的名称。
连接器的页面打开。要跳过它开始注册,你可以选择 注册 改为在卡片上。
从代理空间中查找连接器
要从代理空间中查找连接器,请完成以下步骤:
打开 AWS DevOps 代理控制台位于 https://console.aws.amazon.com/devops-agent/
,然后选择您的代理空间。 选择功能选项卡。
在连接器类别的部分中,例如 遥测, 通讯,或 DevOps,选择 添加。
在 添加权能,下面 Partner-managed 连接器,选择 注册。
在连接器列表中,选择 选择 用于连接器。
连接器的页面打开。
连接器页面显示的内容
连接器页面显示以下信息:
合作伙伴、连接器版本及其类别
合作伙伴文档和支持的链接
连接器的设置指南
连接器推荐的技能
要开始注册,请选择 注册。有关说明,请参阅 注册连接器。
注册连接器
当您注册连接器时, AWS DevOps 代理在您的中创建 MCP 服务器注册表 AWS 连接器定义中的帐户。注册分为四个步骤。控制台会跳过连接器不需要的步骤。
第 1 步:MCP 服务器详细信息
在此步骤中,命名 MCP 服务器并选择位置 AWS DevOps 代理连接。步骤标题包括连接器的名称,例如 示例 Corp MCP 服务器详细信息。
如果该步骤显示 安装指南,在填写表格之前将其展开,然后完成合作伙伴的步骤。它们展示了如何创建您在其中输入的凭据 步骤 3:身份验证配置。要保留步骤的副本,请选择 复制。
输入以下信息:
姓名 — 输入此 MCP 服务器的短名称。控制台填写连接器的名称,您可以更改该名称。使用字母、数字、连字符 (
-) 和下划线 (_)。您的姓名必须是唯一的 AWS 账户。 AWS DevOps 代理会将名称添加到每个工具名称的开头,工具名称最多可以包含 64 个字符,因此名称要简短。端点 — 一些合作伙伴提供多个终端节点,例如区域站点。如果是,请选择您在合作伙伴处开设的账户使用的终端节点。否则,控制台会显示连接器的端点。端点 URL 显示在 AWS CloudTrail 登录您的账户。
连接器字段 — 有些连接器要求提供更多值,例如您在合作伙伴处的实例名称。每个字段都显示连接器为其提供的标签。输入您在合作伙伴处开设的账户中的金额。
使用私有连接连接到端点 —(可选)选择此选项可通过现有的私有连接将请求路由到合作伙伴的端点。对于使用 OAuth 的连接器,您可以为令牌交换选择单独的私有连接。
高级配置 —(可选)选择由客户管理的 AWS 密钥管理服务 (AWS KMS) 用于加密注册的密钥。有关加密的更多信息,请参阅 静态加密 DevOps 代理人。
选择下一步。
第 2 步:身份验证方法
在此步骤中,您可以选择方式 AWS DevOps 代理对合作伙伴的产品进行身份验证。只有当连接器提供多种身份验证方法时,您才会看到此步骤。连接器定义方法的顺序。选择下列选项之一:
API 密钥 — AWS DevOps 代理使用您在合作伙伴产品中创建的密钥进行身份验证,因此您可以控制其权限。
OAuth 客户端凭证 — AWS DevOps 代理使用您在合作伙伴产品中创建的客户端 ID 和密钥进行身份验证。
登录到 伙伴 (例如, 登录 Example Corp) — AWS DevOps 在您登录合作伙伴的产品后,代理会代表您行事。
使用动态客户注册登录 — AWS DevOps 代理向合作伙伴注册自己的 OAuth 客户端,然后在您登录后代表您行事。
选择下一步。
步骤 3:身份验证配置
在此步骤中,您输入身份验证方法所需的凭据。这个 由连接器定义 部分显示了连接器设置的值,您无法更改这些值。
控制台跳过此步骤 使用动态客户注册登录。它还会跳过此步骤 登录到 伙伴 当连接器提供自己的 OAuth 客户端时。
API 密钥
对于 API 密钥,请为连接器列出的每个标头输入一个值。连接器设置标头名称和任何前缀,例如 Bearer ,所以只输入密钥。
OAuth 客户端凭证
要获得 OAuth 客户端证书,请完成以下步骤:
输入 客户端 ID 和 客户机密 您在合作伙伴的产品中创建的。
(可选)添加 其他范围 和 其他交换参数。 AWS DevOps 除了连接器定义的范围和参数外,代理还会请求它们。
登录合作伙伴
对于 登录到 伙伴,完成以下步骤:
如果连接器不提供自己的 OAuth 客户端,请输入 客户端 ID 和 客户机密 您在合作伙伴的产品中创建的。如果合作伙伴支持代码交换证明密钥 (PKCE),则可以将客户机密留空。
(可选)添加 其他范围。
选择下一步。
第 4 步:查看并注册
要完成注册,请完成以下步骤:
查看详情。要更改步骤,请选择 编辑 在该步骤的部分中。
选择注册。
如果您选择了登录方法,请在控制台打开的合作伙伴页面上登录,然后批准访问权限。
控制台返回到 AWS DevOps 代理,注册已完成。如果您是从代理空间注册的,则控制台随后会打开将连接器添加到该代理空间的步骤。如果你是从注册的 能力提供者 页面,参见 向代理空间添加连接器。
如果注册失败,控制台将保持审核步骤并显示错误。更正详细信息,然后选择 注册 再次。
向代理空间添加连接器
向代理空间添加连接器时,可以选择代理可以在那里使用的工具,也可以选择安装连接器的推荐技能。如果您从中注册了连接器 能力提供者 页面,从您的代理空间开始:
打开 AWS DevOps 代理控制台位于 https://console.aws.amazon.com/devops-agent/
,然后选择您的代理空间。 选择功能选项卡。
在连接器类别的部分中,选择 添加。
在 添加权能,找到您从连接器注册的 MCP 服务器,然后选择 添加。
第 1 步:选择工具
在此步骤中,您将选择代理可以在此代理空间中使用的工具。仅选择您的代理空间所需的工具。如果您将工具归类为只读或变异,请为每个工具选择一个分类。有关分类工具的更多信息,请参阅 使用定向行动。有关代理空间中最大 MCP 工具数量的更多信息,请参阅 配额。
一些连接器还显示 Webhook 身份验证类型。选择合作伙伴的产品如何通过 Agent Space 的警报 webhook 进行身份验证: HMAC (默认)或 API 密钥。定义自己的警报的连接器会为您设置此警报。
要跳过可选技能步骤,请选择 跳至 “查看并保存”。否则,请选择下一步。
第 2 步:选择推荐技能(可选)
只有当连接器推荐技能时,您才会看到此步骤。在此步骤中,选择要安装的推荐技能。控制台列出了连接器推荐的技能,但未选择任何技能。代理空间中已安装的一项技能显示 已启用 要么 已禁用,而且你无法选择它。选择要安装的技能,然后选择 下一步。
步骤 3:查看并保存
要将连接器保存到代理空间,请完成以下步骤:
查看工具、技能和 警报 webhook 键入。要更改它们,请选择 编辑 在他们的栏目中。
选择保存。
AWS DevOps 代理将 MCP 服务器添加到代理空间,然后安装您选择的技能。如果某项技能安装失败,则会有通知列出该技能,MCP 服务器将留在代理空间中。要重试,请在代理空间中编辑连接器,然后选择技能。有关说明,请参阅 在代理空间中编辑连接器。
设置警报 webhook
在你选择之后 保存,控制台打开 设置警报 webhook。每次将连接器添加到代理空间时它都会打开,但编辑连接器时不会打开。设置 Webhook 后,发送给它的每条警报都会在代理空间中开始调查。
要设置 webhook,请完成以下步骤:
复制 Webhook 网址, 标题 要么 签名密钥,以及 请求正文 要么 请求正文格式。要将 URL 和密钥保存在文件中,请选择 下载 .csv 文件。 AWS DevOps 特工只出示一次秘密。
选择 我已经保存并存储了我的 URL 和凭证,然后选择 完成了。
在合作伙伴的产品中设置 webhook。有关说明,请参阅连接器的设置指南。
这些值的作用如下:
Webhook 网址 — 合作伙伴的产品向其发送警报的 URL。
标题 — 对于使用持有者代币的 webhook,
Authorization: Bearer合作伙伴产品在每次请求中发送的标头。签名密钥 — 对于签署请求的 webhook 来说,是合作伙伴产品用来签署的秘密
timestamp:body和 HMAC-SHA256。合作伙伴的产品将时间戳发送到x-amzn-event-timestamp标题和中的签名x-amzn-event-signature标题。请求正文 — 对于定义警报的连接器,警报负载。当警报触发时,合作伙伴的产品会填写其模板值。
请求正文格式 — 对于任何其他连接器,每个警报必须使用的 JSON 格式。为每个提醒赋予唯一的权限
incidentId。
其中的哪一个 标题 要么 签名密钥 你看到的取决于 webhook 的身份验证方式。要么由连接器进行设置,要么你选择它 选择工具。这不取决于您在注册连接器时选择的身份验证方法。
有关 webhook 的身份验证和负载的更多信息,请参阅 调用 DevOps 通过 Webhook 进行代理。有关替换丢失机密的更多信息,请参阅 轮换 webhook 凭证。
连接器出现的位置
在 能力 选项卡中,连接器出现在其第一个类别的部分中: 遥测, 管道, 通讯,或 DevOps。连接器,其第一类是 云,或者该目录不再列出,将显示在 MCP 服务器 部分。
在代理空间中编辑连接器
您可以在 Agent Space 中更改连接器的工具,并安装、启用、禁用或删除其推荐技能。要编辑连接器,请完成以下步骤:
打开 AWS DevOps 代理控制台位于 https://console.aws.amazon.com/devops-agent/
,然后选择您的代理空间。 在 能力 选项卡,在其部分中选择 MCP 服务器,然后选择 编辑。
开启 选择工具,更换工具。控制台从您保存的工具开始。如果 MCP 服务器不再列出已保存的工具,则控制台会将该工具从选择中移除并显示警告。
开启 选择推荐技能,选择要保留或安装的技能。要移除已安装的技能,请将其清除。
(可选)开启 设置技能状态,开启或关闭所有已安装的技能。代理仅使用已开启的技能。只有当至少一项技能保持安装状态时,您才会看到此步骤。
开启 查看并保存,查看每项技能的更改,然后选择 保存。
AWS DevOps 代理保存您的更改,警报 webhook 保持不变。在你保存之前,评论会警告你更改是否移除技能。如果代理空间中的另一个连接器推荐了您禁用或移除的技能,它还会警告您,因为该更改也适用于该连接器。您可以稍后再次安装已移除的技能。
如果技能变更失败,则会收到通知列出,您的其他更改将保留。要重试,请再次编辑连接器。
从代理空间移除连接器
要从代理空间中移除连接器,请完成以下步骤:
打开 AWS DevOps 代理控制台位于 https://console.aws.amazon.com/devops-agent/
,然后选择您的代理空间。 在 能力 选项卡,在其部分中选择 MCP 服务器,然后选择 移除。
在 删除 MCP 服务器,查看确认信息,然后选择 移除。
MCP 服务器已从代理空间中移除。将其删除还会删除代理空间中安装的连接器推荐技能。这包括您自己安装的推荐技能。如果代理空间中的其他连接器也推荐某项技能,则该技能将保持安装状态。在删除任何技能之前,确认会命名技能或给出技能数量。您不能撤消此操作。
如果 AWS DevOps 代理无法检查安装了哪些技能,确认信息是这样。在这种情况下,技能将保持安装状态,并且 移除 仅删除 MCP 服务器。
更新或取消注册连接器
要查找连接器注册,请完成以下步骤:
打开 AWS DevOps 代理控制台位于 https://console.aws.amazon.com/devops-agent/
。 在导航窗格中,选择 能力提供者。
在下面 目前已注册,找到连接器的卡,然后选择 查看全部。
在 注册,选择 MCP 服务器。
如果注册使用 登录到 伙伴 要么 使用动态客户注册登录,您无需取消注册即可再次登录,例如在合作伙伴撤消访问权限之后。选择 行动,然后选择 更新。在审阅步骤中,离开 授权网址 空,选择 更新,然后在合作伙伴的页面上登录。 AWS DevOps 代理刷新其访问权限,您的客户端凭证和代理空间关联保持不变。
要更改 API 密钥或 OAuth 客户端凭据,或者使用更新版本的连接器,请注销 MCP 服务器并重新注册连接器。要取消注册,请先从每个使用 MCP 服务器的代理空间中删除 MCP 服务器。有关说明,请参阅 从代理空间移除连接器。然后选择 MCP 服务器,选择 行动,然后选择 取消注册。控制台会立即注销 MCP 服务器,无需您确认。
对合作伙伴管理的连接器进行故障排除
使用以下信息解决合作伙伴管理的连接器的常见问题。
“此连接器未为您选择的端点定义 URL”
此错误表示连接器定义不包括您选择的端点。要解决这个问题,请选择另一个端点。如果错误仍然存在,请联系连接器的支持人员。
注册失败,因为该名称正在使用中
您的 MCP 服务器名称必须是唯一的 AWS 账户。要解决此问题,请在中输入其他名称 第 1 步:MCP 服务器详细信息,然后再次注册。
警报 webhook 页面不显示任何凭据
如果 设置警报 webhook 显示错误而不是标题或签名密钥, AWS DevOps 代理没有返回 webhook 的凭证。要获得一个,请旋转 webhook。有关说明,请参阅 轮换 webhook 凭证。
警报无法启动调查
合作伙伴的产品必须完全按照控制台显示的方式发送请求。要解决这个问题,请完成以下步骤:
在合作伙伴的产品中,检查网络挂钩是否使用控制台中的网络挂钩网址。
检查每个请求是否包含
Authorization标题,或x-amzn-event-timestamp和x-amzn-event-signature已签名 webhook 的标头。检查请求正文是否匹配 请求正文 要么 请求正文格式 来自控制台。
有关更多故障排除步骤,请参阅 网络挂钩疑难解答。