将MCP与AEM as a Cloud Service结合使用 using-mcp-with-aem-as-a-cloud-service
简介 introduction
许多Adobe Experience Manager (AEM)团队现在都在集成开发环境(IDE)和基于聊天的应用程序（如Cursor、OpenAI ChatGPT、Anthropic Claude和Microsoft Copilot Studio）中工作。 这些应用程序支持模型上下文协议(MCP)，它允许应用程序以标准化方式向大型语言模型(LLM)公开后端工具。
通过AEM的MCP集成，不同的角色可以围绕相同的内容进行协作：
- 开发人员可以从其IDE或聊天应用程序编排内容操作和工作流
- 从业者和内容架构师可以在AI帮助下管理网站和内容片段并导入资源，同时保留AEM的现有权限模型。
本文介绍了AEM的MCP功能提供了哪些功能，支持哪些MCP应用程序，如何配置这些功能，以及如何在实践中使用该功能。
为什么MCP对AEM客户有用 why-mcp-is-useful-for-aem-customers
现代IDE和聊天应用程序使用MCP作为LLM调用MCP服务器后面公开的工具的一种方式。 客户可以使用自然语言描述其意图，而不是根据低级API规范编写代码。 例如，类似 的提示“更新所有页面上此促销活动的主页横幅” 允许LLM调用相应的MCP工具，然后与AEM的API交互。
主要优势包括：
- 自然语言交互而不是API管道
MCP工具描述了哪些操作可用以及如何调用它们。 LLM使用这些模式来确定要调用哪些工具以及使用哪些参数。 - 跨应用程序的一致体验
相同的AEM MCP工具可用于多个MCP兼容应用程序，使团队能够在调用相同的底层AEM功能时，在最高效的地方工作。 - 已保留安全和治理
对AEM MCP工具的请求在经过身份验证的用户身份下运行，每个工具都强制实施用户的现有AEM权限。 人工智能辅助的操作遵循与AEM中的手动工作相同的访问规则。
AEM提供的MCP服务器 mcp-servers-provided-by-aem
AEM将MCP服务器公开为HTTP端点。 下面列出的端点与以下对象相关：
https://mcp.adobeaemcloud.com/adobe/mcp/
MCP服务器 mcp-servers
/content/content-readonly/cloudmanager每个MCP服务器公开的特定工具可能会随着时间的推移而不断演变。 在实践中，您可以要求启用了MCP的应用程序通过提示来发现工具，例如：
"List all AEM MCP tools available from this server and describe what they do."
MCP客户端使用MCP协议来检索工具列表和模式，然后LLM可以使用。
请参阅Content MCP Server教程和Cloud Manager MCP Server视频，了解有关它们的功能以及如何使用它们的详细信息。
支持的MCP应用程序 supported-mcp-applications
AEM的MCP服务器设计为可与定义的一组兼容MCP的应用程序配合使用。 每个应用程序都提供自己的配置体验，但高级步骤类似。
聊天应用程序（Web和桌面） chat-applications
- 克洛德
- OpenAI ChatGPT
开发人员工具（IDE扩展、桌面应用程序、CLI） developer-tools
- Anthropic Claude代码（CLI、JetBrains、VS代码、光标）
- 增强代码（CLI、JetBrains、VS代码、光标）
- 增强缩进桌面应用程序
- Cline(JetBrains、VS Code、Cursor)
- 光标
- GitHub Copilot（JetBrains， VS代码）
- Kiro（桌面应用程序、CLI）
- OpenAI代码（桌面应用程序）
- OpenAI代码CLI
- 温德surf
企业平台 enterprise-platforms
- Microsoft Copilot Studio
设置概述 setup-overview
为AEM配置MCP涉及两个主要部分：
- 每个MCP客户端应用程序中的配置，以便应用程序知道如何连接到AEM MCP服务器并执行OAuth登录
- 在开始提示之前选择MCP服务器，以便MCP客户端知道要使用它。
包含以下两个步骤的分步指南适用于：
AEM配置 aem-configuration
默认情况下，单个用户在AEM中拥有的权限可管理对AEM MCP服务器的访问。 当用户通过MCP客户端应用程序进行身份验证时，MCP工具会强制实施与AEM中的手动操作相同的访问规则。 用户只能执行已授权他们执行的操作。
允许的MCP客户端应用程序 permitted-mcp-client-applications
默认情况下，允许在支持的MCP应用程序下列出的所有应用程序。
限制MCP服务器 restricting-mcp-servers
默认情况下，所有MCP服务器都会被列入允许列表。 作为管理员，您可以选择在组织、项目或环境级别限制对特定MCP服务器的访问。 此限制让您能够精细地控制贵组织内的用户可以使用哪些MCP功能。
管理MCP客户端访问 managing-mcp-client-access
如果贵组织的策略需要，管理员还可以禁用对特定MCP客户端应用程序的访问。 如果您希望Adobe启用对其他MCP客户端产品的支持，请发送指向产品网站的链接。 如果您需要允许列表自定义MCP客户端，请联系。
对于所有MCP服务器相关请求，请随时通过 aemcs-mcp-feedback@adobe.com 联系我们
MCP客户端应用程序配置 mcp-client-application-configuration
每个用户都执行此步骤，或者MCP客户端应用程序的管理员可以在支持时执行此步骤。 不同应用程序的配置详细信息略有不同。 MCP客户端发展迅速，并且正在积极开发对远程MCP服务器的支持。 您可能需要启用开发人员模式才能访问添加远程服务器的功能，但常规过程是：
- 添加一个或多个AEM MCP服务器URL
- 从上表中配置一个或多个MCP端点。 例如：
https://mcp.adobeaemcloud.com/adobe/mcp/content-readonly
- 从上表中配置一个或多个MCP端点。 例如：
- 触发连接
- 保存或激活配置，以便MCP客户端应用程序尝试连接到AEM MCP服务器
- 使用Adobe ID登录
- 出现提示时，请完成Adobe登录流程，以便应用程序能够获得与您的Adobe ID关联的OAuth令牌
- 验证发现的工具
- 一旦通过验证，应用程序就会从服务器发现MCP工具。 然后，您可以开始提示LLM执行AEM操作。
有关支持的应用程序的完整列表，请参阅支持的MCP应用程序。
身份验证 authentication
Adobe托管的MCP服务器实施OAuth，并与Adobe的Identity System集成。
- 当MCP客户端应用程序连接到AEM MCP服务器时，用户会看到Adobe登录对话框并使用其 Adobe ID 进行身份验证
- 成功登录后，系统会验证您的组织是否允许MCP客户端应用程序，以及是否允许请求的MCP服务器。 如果任一检查失败，则会显示错误消息。
- 验证后，MCP服务器会颁发应用程序用于后续工具调用的令牌
- MCP工具会尊重用户的AEM权限。 只有有权在AEM中修改内容片段的用户才能通过MCP修改它。
此方法可确保AI辅助的操作符合您现有的AEM安全和治理模型。
将MCP与AEM结合使用 using-mcp-with-aem
配置AEM和MCP客户端应用程序后，您可以在选择的应用程序中工作，并提示LLM执行AEM操作。 LLM读取MCP工具架构，选择要调用的工具，并根据需要对这些工具进行排序，以满足您的请求。
示例用例 example-usecases
一些典型的情况包括：
-
环境发现
- 列出环境和许可证以决定运行工作流的位置。
-
站点管理
- 列出站点
- 创建、读取、更新和删除页面和页面内容。
-
内容片段管理
- 搜索内容片段
- 创建新片段
- 当营销活动消息更改时，更新现有片段。
-
正在导入资产
- 导入具有状态检查的资源
示例工作流 example-workflows
以下示例说明了LLM如何将MCP工具链接在一起。
-
使用页面引用的内容片段
- 获取页面内容 — 调用诸如
get-aem-page-content之类的工具以检索页面并找到fragmentPath属性。 - 解析片段路径 — 使用
resolve_fragment_path将路径转换为UUID。 - 获取片段数据 — 调用
get_fragment以检索当前字段。 - 更新片段 — 调用
patch_fragment以将更改应用于片段内容。
- 获取页面内容 — 调用诸如
-
基于模型创建新内容
- 发现模型 — 使用
list_models查看哪些内容片段模型可用。 - 检查模型 — 使用
get_model了解模型的字段架构。 - 创建内容 — 使用
create_fragment创建一个新片段，其值派生自您的提示。
- 发现模型 — 使用
-
安全更新现有内容
- 读取当前数据 — 使用
get_fragment检索现有数据和ETag。 - 应用JSON修补程序 — 将
patch_fragment与ETag和JSON修补程序文档一起使用以更新片段，支持开放式并发。
- 读取当前数据 — 使用
从用户的角度来看，这些工作流可以通过提示来启动，例如：
"Create a new content fragment for the spring campaign based on our hero banner model and fill in its fields from this brief."
LLM自动选择并协调必要的MCP工具。
期望管理 expectation-management
在通过MCP使用LLM时，请牢记以下几点：
-
功能强大，但不是万无一失
LLM可以完成复杂的任务，但容易偶尔出错。 相同的提示可能会产生稍微不同的结果或演示，但没有明显的原因。 始终在将更改应用于生产内容之前审查输出。 -
不断发展的功能
LLM模型正在不断改进。 随着时间的推移，他们在发现组合MCP工具以实现目标的新方法方面变得更加智能。 今天需要多个提示的任务明天可以无缝地处理单个提示。 -
人力监督是必不可少的：
把LLM想成需要监督的知识渊博的助手。 它拥有广泛的知识，可以设计创造性的解决方案，但它受益于您的指导和审查。 验证结果（尤其是关键操作的结果），并在输出与预期不符时提供反馈。 -
对于自动确认工具执行要小心
某些MCP客户端应用程序（如Claude）提供了自动确认LLM请求的工具执行的选项。 虽然此选项可以方便地用于只读操作（如搜索或检索内容），但请谨慎使用更新或删除内容的工具。 在确认修改AEM环境的操作之前，请查看每个工具执行请求。
限制 limitations
AEM当前支持在支持的MCP应用程序下列出的应用程序中配置MCP服务器。
如果要使用其他MCP客户端应用程序，请随时联系aemcs-mcp-feedback@adobe.com，请求支持其他客户端或列入允许列表自定义客户端。