设置Experience Manager Guides MCP服务器

MCP服务器端点

Experience Manager Guides通过单个HTTP端点公开其MCP功能。

要了解环境的当前工具列表，请询问您的助手：

List all Experience Manager Guides tools available from the author https://author-pXXXX-eXXXX.adobeaemcloud.com and describe what they do.

为您的组织请求访问权限

对Experience Manager Guides MCP服务器的访问是每个组织​选择加入。 在您组织中的任何人都可以连接之前：

• 必须在AEM as a Cloud Service环境中启用Experience Manager Guides。
• 贵组织的IMS组织ID （组织ID）必须由Adobe Guides团队列入允许列表。

要请求获取访问权限，请联系您的Adobe客户成功团队。

设置

您不会在本机安装任何内容。 您将客户端指向服务器URL，并通过Adobe IMS登录流进行身份验证。

克洛德

遵循官方演练：为AEM MCP设置Claude。 添加自定义连接器时，请使用Experience Manager Guides端点：

https://mcp.adobeaemcloud.com/adobe/mcp/guides

光标/Visual Studio代码

将服务器添加到MCP配置。 对于游标，将其添加到.cursor/mcp.json：

{
  "mcpServers": {
    "aem-guides": {
      "url": "https://mcp.adobeaemcloud.com/adobe/mcp/guides"
    }
  }
}

对于仅支持本地(stdio)服务器的客户端，使用mcp-remote桥接到远程终结点：

{
  "mcpServers": {
    "aem-guides": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.adobeaemcloud.com/adobe/mcp/guides"]
    }
  }
}

您可以使用模型上下文协议(MCP)将受支持的AI客户端连接到Experience Manager Guides本地实例。 建立连接后，客户端可以访问您的AEM用户帐户可用的Experience Manager Guides操作。

使用​ 您的AEM标识和权限 ​执行所有操作。 连接的客户端只能查看或修改您的AEM帐户有权访问的内容和资源。

身份验证使用带有Proof Key for Code Exchange (PKCE)的OAuth 2.0授权代码流。 首次连接客户端时，您可以使用AEM进行身份验证。 成功验证后，连接会自动刷新访问令牌。

您可以连接以下客户端：

先决条件

在连接客户端之前，请与AEM管理员合作以验证以下配置：

1. 验证是否已部署MCP功能。：确保已部署MCP功能并在Experience Manager Guides实例上运行。

2. 配置Granite基本URL。：在AEM Web控制台配置管理器(/system/console/configMgr)中，找到​ Experience Manager Guides OAuth PKCE令牌包装器 ​配置，并验证是否已配置Granite基本URL。 如果Granite基本URL配置不正确，则客户端无法建立连接。

3. 配置Day CQ链接外部化器。：在AEM Web控制台配置管理器中，找到​ Day CQ链接外部化器 ​配置，并验证外部创作URL是否指向正确的AEM创作实例。 在OAuth发现期间使用外部作者URL。 URL不正确可能会阻止客户端完成连接。

   有关更多详细信息，请查看配置AEM Guides内部部署的MCP连接设置

4. 获取MCP服务器URL。： MCP服务器URL使用以下格式：

   code language-none
   http(s)://<AEM-HOST>/bin/guides/v1/mcp/sse

   note
   NOTE
   配置客户端时使用完整的SSE端点。 请勿在URL中添加结尾斜杠。

   例如：

   内部AEM创作实例：

   code language-none
   http://10.42.42.20:4502/bin/guides/v1/mcp/sse

   公共AEM创作实例：

   code language-none
   https://author.example.com/bin/guides/v1/mcp/sse

5. 验证您的AEM凭据和权限。：您必须拥有有效的AEM实例帐户。 使用您用于登录到AEM用户界面的相同凭据。 通过MCP可用的操作取决于分配给此帐户的权限。

连接克劳德桌面

Claude Desktop支持桌面扩展(.mcpb)。 Experience Manager Guides MCP扩展将打包连接配置，因此您无需手动编辑MCP JSON配置。

1. 获取aem-guides-mcp.mcpb扩展文件。

2. 打开​ Claude Desktop ​并导航到​设置>扩展。

3. 通过双击文件或将其拖到“扩展”窗口中来安装aem-guides-mcp.mcpb。

   在“安装”对话框中显示​Adobe Experience Manager Guides MCP。

4. 选择​安装。

5. 在​ Experience Manager Guides MCP服务器URL ​字段中，输入AEM实例的完整SSE端点。

   例如：

   code language-none
   http://<AEM-HOST>:4502/bin/guides/v1/mcp/sse

6. 选择​ 保存 ​并确保该扩展已启用。

连接ChatGPT

您可以在ChatGPT中将Experience Manager Guides MCP服务器配置为自定义连接器。

1. 验证您的MCP服务器在公共HTTPS URL上是否可用，格式如下：

   code language-none
   https://<PUBLIC-AEM-HOST>/bin/guides/v1/mcp/sse

   在浏览器中打开端点，并验证您是否可以在没有证书警告或连接错误的情况下访问主机。

2. 在ChatGPT中，打开​设置>插件。

   note
   NOTE
   连接器的可用性取决于您的ChatGPT计划和工作区配置。 工作区管理员可能需要启用自定义连接器或开发人员连接器。

3. 选择选项以添加或创建插件。

4. 指定连接器详细信息：

   • 名称：​输入Experience Manager Guides或其他描述性名称。
   • MCP服务器URL：​输入公共HTTPS SSE终结点。
   • 身份验证：​选择​OAuth。

   您无需提供OAuth客户端ID或客户端密钥。 MCP服务器支持自动客户端注册。

5. 创建连接器。

连接光标

通过将服务器详细信息添加到MCP配置，在光标中配置Experience Manager Guides MCP服务器。

1. 在光标中，导航到​自定义> MCP > New。

   光标打开~/.cursor/mcp.json配置文件。

2. 添加Experience Manager Guides MCP服务器配置。

   例如：

   code language-json
   { "mcpServers": { "aem-guides": { "url": "http://10.42.34.176:4502/bin/guides/v1/mcp/sse", "type": "http" } } }

3. 将示例URL替换为AEM实例的MCP SSE端点。

4. 保存配置。

5. 启用配置的MCP服务器。