AEM Sites Personalization MCP Use-case Overview

A web page shows some promotional content. By default, it renders a default author-selected content.

At runtime, Adobe Target swaps it for a personalized Content Fragment based on the visitor audience, e.g.:

• Magazine Lovers → magazine-themed offer
• Adventure Lovers → adventure-themed offer
• Everyone else → the default Content Fragment

Audience can be defined as per the business use-case.

Some simple examples: You can use previously visited page URL containing certain keyword 'magazine' or 'adventure', current page url params have some campaign id like “?campaign=NewYear”, etc.

Prerequisites

• AEM as a Cloud Service (Author + Publish) with the EDS site connected.
• Adobe Target access in any Adobe IMS organization.
• AEM ⇄ Target IMS integration configured
• “Promotion” block in AEM Sites (available in release v2.8.0 or higher)
• MCP Server Installation in Co-worker

Setup

Let’s set up the flow in your own environment. We need three things:

Step 1 — Connect AEM and Adobe Target

1. Establish the AEM ⇄ Target IMS based integration so AEM can export Content Fragments to Target (IMS based integration instructions here).
2. Next, Go to your Adobe Target instance.
3. Click on Administration tab.

4. Go to Implementation section.

5. Look for latest at.js and download it.

6. Go to your EDS project’s github repository and replace the content of following file with your “at.js”:
   /scripts/at-lsig.js

Step 2 — Setup MCP servers in Co-worker

There are a certain pre-requisite MCP servers that need to be installed before we can start using co-worker to execute this usecase

1. Target MCP Server
   1. Source - https://targetmcp.adobe.io/mcp
   2. Connection Type – Http
   3. Authentication – Passthrough
2. AEM Content MCP Server
   1. Source - https://mcp.adobeaemcloud.com/adobe/mcp/content
   2. Connection Type – Http
   3. Authentication – Passthrough
3. AEM MCP Server
   1. Source - https://mcp.adobeaemcloud.com/adobe/mcp/aem
   2. Connection Type – Http
   3. Authentication – Passthrough
4. Reference Demo MCP
   1. Source - https://3635370-rdmcp-stage.adobeioruntime.net/api/v1/web/rd-mcp/mcp-server
   2. Connection Type – Http
   3. Authentication – Passthrough

Step 3 — Install Reference Demo Plugin from Marketplace

1. Go to Marketplace

2. Click on Add Marketplace at the top right

3. Enter the following values in the popup:
   1. GitHub Repository - https://github.com/AEMXSC/ref-demo-mcp
   2. Branch, Tag, or Commit SHA – keep empty
   3. Subdirectory - ref-demo-plugin

4. Installing rd-usecase-setup:
   1. Select Install on the rd-usecase-setup and wait for the installation to complete

Step 4 — Prompting Co-worker

You are all set and now you can start prompting co-worker to create demos.

Please find some happy scenario prompts below:

1. Setup Personalization demo using AEM and Adobe Target for audience who are magazine lovers by running the personalized offer on the promotions block on the home page of site WKND-universal.
2. Setup Personalization demo using AEM and Adobe Target for audience who are interested in adventure by running the personalized offer on the promotions block on the home page of site WKND-universal.

Some questions that co-worker might ask you:

The Demo

1. Default: open the page with no qualifying audience; confirm the default CF renders.
2. Magazine Lovers: navigate to a 'magazine' section page and return to the home page (by clicking the brand logo)
3. Adventure Lovers: repeat with 'adventure' to view the personalized experience.