Amazon Quick Agents：通过MCP协议赋能外部工具与AI代理集成

Amazon Quick通过模型上下文协议（Model Context Protocol, MCP）支持外部集成，从而实现动作执行、数据访问及AI代理功能。用户可通过自行托管MCP服务器，并在Amazon Quick中配置相应的MCP集成，来对外暴露其应用程序功能。Amazon Quick作为MCP客户端，将连接至您的MCP服务器端点，以访问这些已公开的功能。连接建立后，Amazon Quick的AI代理和自动化流程即可调用您的工具，以检索数据并在您的产品中执行操作，同时严格遵循客户的身份验证、授权及治理规则。

Amazon Quick与MCP的集成，使得构建可复用的集成方案成为可能：只需一次性定义工具并发布稳定的端点，即可支持多个客户共享同一模型。您可以在Amazon Quick中构建AI代理和自动化流程，用于数据分析、企业知识搜索以及业务工作流的执行。客户无需为每个用例都构建自定义连接器，即可直接在Amazon Quick的工作流中无缝使用您的产品。

本文将通过六步流程，指导您如何构建新的MCP服务器，或验证并调整现有MCP服务器以适应Amazon Quick的集成。Amazon Quick用户指南详细描述了MCP客户端的行为和限制，为第三方合作伙伴使用MCP与Amazon Quick集成提供了详细的实施指南。

解决方案概述： Amazon Quick内置MCP客户端，您可通过配置该客户端来集成外部MCP服务器。该集成将发现服务器提供的工具和数据源，并将其提供给AI代理和自动化流程使用。Amazon Quick中的MCP集成支持动作执行和数据访问，包括知识库的创建。

前提条件：

• 拥有Amazon Quick Professional订阅资格。
• 拥有“Author”或更高权限的Amazon Quick用户，以便创建动作连接器。
• 远程MCP服务器端点能够被Amazon Quick访问。
• 您的MCP服务器支持用户身份验证、服务身份验证或无需身份验证的方式。
• 提供一组初始的产品功能作为API，以MCP工具的形式公开（建议从客户最常使用的操作开始）。

Amazon Quick MCP集成准备检查清单： 接下来，我们将逐步指导您完成与Amazon Quick的集成过程：

1. 选择MCP服务器的部署模型。
2. 实现与Amazon Quick兼容的远程MCP服务器。
3. 实现身份验证和授权。
4. 为Amazon Quick客户记录配置信息。
5. 在Amazon Quick中注册MCP集成。
6. 使用Amazon Quick内置的测试API工具测试您的动作和设置。

步骤1：选择MCP服务器部署模型： 决定如何托管您的MCP端点以及如何隔离不同租户。两种常见的模式如下：

• 共享多租户端点：一个MCP端点服务于多个客户。您的身份验证和授权层会将每个请求映射到相应的租户和用户，并在每次工具调用时确保租户隔离。
• 专用租户端点：每个客户都有一个唯一的MCP端点或服务器实例。您需要为每个租户提供稳定的URL和凭据。

步骤2：实现与Amazon Quick兼容的远程MCP服务器： 您的MCP服务器必须符合MCP规范，并满足Amazon Quick客户端的限制要求，重点关注传输方式、工具定义和操作限制。

注意事项：

• 传输和连接要求：
  • 通过公共端点（建议使用HTTPS）暴露您的MCP服务器。
  • 支持远程传输方式，Amazon Quick支持Server-Sent Events (SSE)和流式HTTP（HTTP流式传输更受欢迎）。
• 工具和资源要求：
  • 使用JSON格式定义MCP工具，以便Amazon Quick客户端能够通过listTools和callTool函数发现和调用这些工具。
  • 保持工具名称的一致性，并有意控制工具版本的行为（注册后Amazon Quick会认为工具列表是静态的，管理员需要重新建立连接以反映更改）。
  • 如果集成包含数据访问功能，请暴露数据源和资源，以便Amazon Quick能够使用这些数据创建知识库。

Amazon Quick MCP客户端的限制：

• 每个MCP操作的超时时间为300秒，超过此时间限制的操作会返回HTTP 424错误。
• 如果您的身份提供者或授权服务器不允许特定的回调URI，连接器创建可能会失败（详见步骤3）。

如果没有MCP服务器：

• 您可以自行使用MCP SDK构建和托管MCP服务器（支持流式HTTP或SSE）。
• 或者在Amazon Bedrock AgentCore Runtime上运行MCP服务器（该平台支持托管MCP服务器）。
• 或者使用Amazon Bedrock AgentCore Gateway将REST API或AWS Lambda函数转换为MCP兼容的格式。

步骤3：实现身份验证和授权： Amazon Quick MCP集成支持多种身份验证模式。根据客户的需求选择合适的模式，并在每次工具调用时实施相应的授权机制。

步骤4：为Amazon Quick客户记录配置信息： 在连接到Amazon Quick之前，使用MCP Inspector工具验证服务器的兼容性。该工具可作为通用MCP客户端，帮助您测试连接性、浏览工具目录并在受控环境中模拟工具执行。如果服务器通过验证，则说明其符合协议要求，可以准备进行集成。

步骤5：在Amazon Quick中注册MCP集成： 在服务器准备好后，客户可以在Amazon Quick控制台中创建MCP集成。具体步骤如下：

1. 使用具有“Author”权限的账户登录Amazon Quick控制台。
2. 选择“Integrations”选项。
3. 选择“Model Context Protocol (MCP)”并继续操作。
4. 输入端点URL、描述（可选）和必要的配置信息。
5. 选择相应的身份验证方式，并完成配置。
6. （如果需要）验证集成后的工具和数据功能。

步骤6：操作、监控和计量MCP服务器： 将MCP服务器视为生产级别的API接口，实施常规的运营控制措施（如日志记录、速率限制等）。

总结： Amazon Quick MCP集成为您的客户提供了标准化的方式，以便将AI代理和自动化流程连接到您的产品。通过将功能公开为MCP工具，客户可以在Amazon Quick控制台中配置连接并在多个工作流中使用这些工具。建议从少量高价值的功能开始，确保每次操作都在300秒的时间限制内完成，并详细记录端点和身份验证设置。在验证集成流程后，逐步扩展工具目录并添加必要的运营控制措施。