模型上下文协议 (MCP) 集成 - Amazon Quick Suite

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

模型上下文协议 (MCP) 集成

通过在 Amazon Quick Suite 中集成模型上下文协议 (MCP),您可以连接到 MCP 服务器以实现任务执行和数据访问功能。MCP 提供了一种将人工智能系统与外部工具和数据源连接起来的标准化方法。

您能做什么

借助 MCP 集成,您可以连接到 MCP 服务器,通过标准化协议执行操作和访问数据。

动作连接器

通过标准化的 MCP 协议连接到 MCP 服务器以执行操作和执行任务。

数据访问集成

通过 MCP 服务器访问数据源以创建知识库和检索信息。

开始前的准备工作

在设置 MCP 集成之前,请确保具备以下条件:

  • 具有适当访问权限的 MCP 服务器端点。

  • MCP 服务器的身份验证凭证。

  • Amazon Quick Suite 作者或更高版本用于操作连接器。

  • 亚马逊 Quick Suite 专业订阅

注意

MCP 集成仅支持远程服务器。HTTP 流式传输优先于服务器发送的事件 (SSE)。不支持本地 stdio 连接。不支持 VPC 连接。

以下是与 Amazon Quick Suite 和远程 MCP 服务器一起使用的常用 MCP 服务器的示例: URLs

:

热门的 MCP 服务器
Provider MCP 服务器网址
Asana https://mcp.asana.com/sse
Atlassian https://mcp.atlassian.com/v1/sse

AWS 知识 MCP 服务器

https://knowledge-mcp.global.api.aws

Box http://mcp.box.com/
HubSpot https://mcp.hubspot.com
HuggingFace https://huggingface.co/mcp
Intercom https://mcp.intercom.com/mcp
线性 https://mcp.linear.app/mcp
Monday https://mcp.monday.com/sse
概念 https://mcp.notion.com/mcp
PagerDuty https://identity.pagerduty.com/global/oauth/anonymous/.well-known/openid-configuration
Workato https://MCP_ID.apim.mcp.workato.com
扎皮尔

https://mcp.zapier.com/MCP_ID

下表仅显示了 MCPs 支持与 Amazon Quick Suite 配合使用的众多软件中的一部分。

注意

这些服务器需要适当的身份验证凭据。有关具体的身份验证要求,请参阅每个提供商的文档。

准备 MCP 服务器设置和身份验证

在 Amazon Quick Suite 中设置集成之前,请准备好您的 MCP 服务器配置和身份验证凭证。MCP 集成支持多种身份验证方法和配置方法。选择符合您的 MCP 服务器要求的方法:

用户认证 (OAuth)

MCP 服务器支持两种 OAuth 身份验证配置方法:

动态客户注册 (DCR)

当您的 MCP 服务器宣布支持动态客户端注册时,无需手动配置。MCP 客户端会自动向服务器注册自己,并在连接过程中接收必要的凭证。这种简化的方法无需手动收集客户端 IDs、密钥和端点 URLs。

手动配置

对于不支持 DCR 的 MCP 服务器,请从 MCP 服务器配置中收集以下信息:

  • 客户端 ID- OAuth 客户端 ID。

  • 客户密钥- OAuth 客户密钥。

  • 令牌网址- OAuth 令牌端点。

  • 身份验证 URL- OAuth 授权端点。

  • 重定向 URL- OAuth 重定向 URI。

服务认证(服务到服务)

从 MCP 服务器配置中收集以下信息:

  • 客户端 ID-服务客户端 ID。

  • 客户密钥-服务客户端密钥。

  • 令牌 URL-服务令牌端点。

API 密钥身份验证

从 MCP 服务器管理员那里收集以下信息:

  • API 密钥-MCP 服务器 API 密钥。

用户名/密码认证

从 MCP 服务器管理员那里收集以下信息:

  • 用户名-MCP 服务器用户名。

  • 密码-MCP 服务器密码。

设置 MCP 集成

准备好 MCP 服务器配置和身份验证凭证后,请按照以下步骤创建 MCP 集成:

  1. 在 Amazon Quick Suite 控制台中,选择集成。

  2. 单击 “添加”(加上 “+” 按钮)。

  3. 在创建集成页面上,输入集成详细信息:

    • 名称-您的 MCP 集成的描述性名称。

    • 描述(可选)-集成的目的。

    • MCP 服务器端点-MCP 服务器的 URL。

  4. 单击下一步

  5. 选择身份验证方法(用户或服务)。

  6. 提供相应的配置详细信息。

  7. 选择创建并继续

  8. 查看集成详细信息。

  9. 选择下一步

  10. 如果需要,可以与其他用户共享集成。

创建 MCP 集成后,将在集成创建完成后自动创建知识库。

管理知识库

设置 MCP 集成后,您可以从 MCP 数据源创建和管理知识库。

编辑现有知识库

您可以修改现有的 MCP 知识库:

  1. 在 Amazon Quick Suite 控制台中,选择知识库

  2. 从列表中选择您的 MCP 知识库。

  3. 选择操作,然后选择编辑知识库

  4. 根据需要更新您的配置设置,然后选择 “保存”。

创建其他知识库

您可以通过同一 MCP 集成创建多个知识库:

  1. 在 Amazon Quick Suite 控制台中,选择集成。

  2. 从列表中选择您现有的 MCP 集成。

  3. 选择操作,然后选择创建知识库

  4. 配置您的知识库设置,然后选择创建

有关知识库配置选项的详细信息,请参阅常用配置设置

评论集成

配置身份验证后,请查看 MCP 集成功能:

  1. 系统连接到 MCP 服务器并发现可用功能。

  2. 查看 MCP 服务器提供的可用操作和任务列表。

  3. 如果 MCP 服务器提供数据源,请验证数据访问能力。

  4. 确认集成配置和功能。

能力发现

MCP 集成会自动发现并列出:

  • 可用的工具和操作。

  • 数据源和资源。

  • 支持的协议和方法。

  • 服务器元数据和功能。

管理 MCP 集成

创建 MCP 集成后,您可以使用以下选项对其进行管理:

  • 共享集成-使组织中的其他用户可以使用该集成。

  • 查看工具-已启用的查看工具。

注意

MCP 集成取决于目标 MCP 服务器的可用性和配置。服务器或身份验证要求的更改可能会影响集成功能。

限制

在 Amazon Quick Suite 中使用 MCP 集成时,请注意以下限制:

  • MCP 操作有 60 秒的固定超时时间。超过此限制的操作会自动失败,并出现 HTTP 424 错误。

  • MCP 操作不支持自定义 HTTP 标头。仅传输标准系统标头。

  • 初始注册后,工具列表保持静态。必须手动刷新操作才能检测服务器端的更改。

  • 如果第三方提供商未将 Amazon Quick Suite 回调 URI 列入允许名单,则连接器创建可能会失败。

  • 服务器连接问题导致无需重试即可立即失败。