設定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

Cursor / Visual Studio Code

將伺服器新增至您的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帳戶有權存取的內容和資源。

驗證使用OAuth 2.0授權代碼流程及Proof Key for Code Exchange (PKCE)。 第一次連線使用者端時，您會使用AEM進行驗證。 成功驗證後，連線會自動重新整理存取權杖。

您可以連線下列使用者端：

先決條件

在連線使用者端之前，請與您的AEM管理員合作以驗證下列設定：

1. 確認MCP功能已部署。：確認MCP功能已部署並在您的Experience Manager Guides執行個體上執行。

2. 設定Granite基底URL。：在AEM Web Console Configuration Manager (/system/console/configMgr)中，找到​ Experience Manager Guides OAuth PKCE權杖包裝函式 ​設定，並確認Granite基底URL已設定。 如果Granite基底URL未正確設定，使用者端將無法建立連線。

3. 設定Day CQ Link Externalizer。：在AEM Web Console Configuration Manager中，找到​ Day CQ Link Externalizer ​設定，並確認外部作者URL指向正確的AEM作者執行個體。 OAuth探索期間會使用外部作者URL。 不正確的URL會導致使用者端無法完成連線。

   如需詳細資訊，請檢視設定AEM Guides On-Premise的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

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伺服器。