搭配AEM as a Cloud Service使用MCP 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許可權。 AI輔助操作遵循的存取規則與AEM中的手動工作相同。
AEM MCP伺服器 aem-mcp-server
在2026年7月發行的AEM中,Adobe提供建議使用的統一AEM MCP伺服器,而非網域特定的MCP伺服器。 在聊天應用程式或編碼代理程式中設定單一URL,以存取不斷成長的工具集,涵蓋舊版特定網域的MCP伺服器所提供的大部分功能。
請注意,AEM MCP伺服器目前不包含Cloud Manager和雲端移轉MCP伺服器的功能。 如果您有需要,請在MCP使用者端中個別新增這些引數。
端點是https://mcp.adobeaemcloud.com/adobe/mcp/aem
26309)。 此外也支援資產上傳、下載、移動/複製/刪除和發佈/取消發佈資產,以及編輯中繼資料、檢查參考和識別未使用的資產。如果您有興趣,您必須註冊代理程式試用版或擁有付費授權,才能存取Experience Governance MCP。
請注意,AEM MCP伺服器是由AEM Claude Connector和AEM ChatGPT外掛程式所使用。
列出AEM MCP伺服器功能
若要檢視您的LLM可以使用哪些功能,請要求啟用MCP的應用程式使用下列提示來探索AEM MCP伺服器的功能:
List AEM capabilities with the AEM MCP Server
請注意,此高階功能清單與AEM MCP伺服器公開的原始工具清單不同。
網域特定的MCP伺服器 mcp-servers-provided-by-aem
AEM也會公開網域特定的MCP伺服器,但建議您改用AEM MCP伺服器。 請注意,由於目前不支援Cloud Migration或Cloud Manager MCP伺服器,因此您可以視需要個別進行設定。 下列端點相對於https://mcp.adobeaemcloud.com/adobe/mcp;例如,為Content MCP伺服器設定https://mcp.adobeaemcloud.com/adobe/mcp/content。
MCP伺服器 mcp-servers
/content26309)。/content-readonly26309)。 透過AEM Claude Connector和AEM ChatGPT外掛程式,您也可以支援資產下載、檢查參考和識別未使用的資產。/cloudmanager/experience-governance如果您有興趣,您必須註冊代理程式試用版或擁有付費授權,才能存取Experience Governance MCP。
/cloud-migration請參考Content MCP伺服器教學課程和Cloud Manager MCP伺服器影片,瞭解其功能及使用方式的詳細資訊。
支援的MCP應用程式 supported-mcp-applications
MCP伺服器的設計是要與一組定義的MCP相容應用程式搭配使用。 每個應用程式都有各自的設定體驗,但高階步驟類似。
聊天應用程式(網頁與案頭) 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
- Windsurf
企業平台 enterprise-platforms
- Amazon快速
- Microsoft Copilot Studio
設定概述 setup-overview
設定MCP包含兩個主要部分:
- 設定每個MCP使用者端應用程式,讓應用程式知道如何連線到AEM的MCP伺服器並執行OAuth登入。
- 在開始提示之前選取MCP伺服器,讓MCP使用者端知道要使用它。
涵蓋兩個步驟的逐步指南適用於:
AEM設定 aem-configuration
依預設,個別使用者在AEM中擁有的許可權可控制對MCP伺服器的存取。 當使用者透過MCP使用者端應用程式進行驗證時,MCP工具會強制實施與AEM中手動操作相同的存取規則。 使用者只能執行他們已被授權執行的動作。
允許的MCP使用者端應用程式 permitted-mcp-client-applications
依預設,允許列在支援的MCP應用程式下的所有應用程式。
限制MCP伺服器 restricting-mcp-servers
為了精確控制可用的MCP功能,請透過您的請求傳送電子郵件至Adobe支援: aemcs-mcp-feedback@adobe.com。
您可以要求下列限制:
- AEM MCP伺服器 — 完全停用、停用特定類別,或依類別變更預設的讀寫與唯讀行為(若支援,則根據AEM MCP伺服器資料表)。
- 網域特定MCP伺服器 — 停用特定伺服器。
依預設,限制會套用在組織層級。 如果您需要範圍較窄的限制,請選擇下列其中一個層級,並為該層級的 every 執行個體提供所需的行為:
- 程式識別碼 — 針對您擁有的每個程式分別列出所需的行為。
- 環境ID — 針對您擁有的每個環境分別列出所需的行為。
- 環境型別 (RDE、dev、stage、prod) — 針對您使用的每種環境型別,分別列出所需的行為。
管理MCP使用者端存取 managing-mcp-client-access
如果組織的原則要求,管理員也可以在組織層級停用特定MCP使用者端應用程式的存取權。 如果您希望Adobe啟用其他MCP使用者端產品的支援,請傳送產品網站的連結。 如果您需要允許列出自訂MCP使用者端,請連絡我們。
對於所有MCP伺服器相關要求,請隨時透過 aemcs-mcp-feedback@adobe.com 聯絡Adobe
MCP使用者端應用程式組態 mcp-client-application-configuration
每個使用者都會執行此步驟,或者MCP使用者端應用程式的管理員可以在支援時執行此步驟。 不同應用程式的設定詳細資料稍有不同。 MCP使用者端正在迅速成長,並且正在積極開發遠端MCP伺服器的支援。 您可能需要啟用「開發人員模式」才能存取新增遠端伺服器的功能,但一般程式為:
- 新增一或多個MCP伺服器URL。
- 設定一或多個MCP端點。 例如:
https://mcp.adobeaemcloud.com/adobe/mcp/aem
- 設定一或多個MCP端點。 例如:
- 觸發連線。
- 儲存或啟動設定,讓MCP使用者端應用程式嘗試連線到MCP伺服器
- 使用Adobe ID登入。
- 出現提示時,請完成Adobe登入流程,讓應用程式能夠取得與您的Adobe ID繫結的OAuth權杖
- 驗證探索到的工具。
- 驗證之後,應用程式就會從伺服器探索MCP工具。 然後,您可以開始提示LLM執行AEM作業。
請參閱支援的MCP應用程式,以取得支援的應用程式完整清單。
驗證 authentication
Adobe代管的MCP伺服器會實作OAuth,並與Adobe的身分識別系統整合。
- 當MCP使用者端應用程式連線到MCP伺服器時,使用者會看到Adobe登入對話方塊,並使用其 Adobe ID 進行驗證
- 成功登入後,系統會驗證貴組織是否允許MCP使用者端應用程式,以及是否允許請求的MCP伺服器。 如果任一檢查失敗,則會顯示錯誤訊息。
- 驗證後,MCP伺服器會發行應用程式用於後續工具呼叫的權杖。
- MCP工具會遵守使用者的AEM許可權。 例如,只有在AEM中有權修改內容片段的使用者才能透過MCP修改它。
此方法可確保AI協助的作業符合您現有的AEM安全性與治理模式。
使用MCP伺服器 using-mcp-with-aem
設定MCP使用者端應用程式後,您可以提示LLM執行AEM作業。 LLM知道已設定之MCP伺服器的功能,選擇呼叫哪些工具,並根據需要排序以符合您的要求。
範例使用案例 example-use-cases
某些代表性的案例包括:
-
環境探索
- 列出環境和授權以決定執行工作流程的位置。
-
網站管理
- 列出網站
- 建立、讀取、更新及刪除頁面和頁面內容。
-
內容片段管理
- 搜尋內容片段
- 建立新片段
- 當行銷活動訊息變更時,更新現有片段。
-
資產匯入
- 匯入具有狀態檢查的資產
-
資產搜尋
note NOTE 透過MCP端點存取 Assets搜尋 所需的最低AEM發行版本為 26309。
範例工作流程 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 聯絡以要求支援其他使用者端或允許列出自訂使用者端。