Adobe目标MCP
一非官方)Adobe Target的模型上下文协议代理框架,使您最喜欢的MCP客户端能够通过自然语言创建和管理Adobe Target活动、HTML和JSON报价、受众、响应令牌和活动报告
MCP标准合规性: 此项目遵循开放的模型上下文协议标准,可与任何兼容MCP的客户端(Claude Desktop、Cursor或其他MCP客户端)配合使用。下面的配置示例使用Claude Desktop/Code,但相同 mcpServers 格式适用于所有MCP客户端。
Adobe Target API文档:https://developer.adobe.com/target/administer/admin-api/
______________________________________________________________________
目录
______________________________________________________________________
核心能力
- Adobe目标管理API集成:用于管理A/B测试、体验定向、报价创建(HTML/JSON)、受众、mbox、属性、活动绩效报告和响应令牌的33个工具的完整套件
- 活动报告:实时和过去活动的查询结果
- 响应令牌管理:创建新的resposne代币并清点现有代币
- 智能报价创建:使用结构化数据模板为无头/SPA实现生成HTML报价或JSON报价
- 受众管理和创建:列出AT属性中现有的受众,或用自然语言创建新的受众
- 数据层事件生成:HTML中的自动转换提供了对GTM、Adobe Launch、Tealium、Segment的跟踪
-
______________________________________________________________________
快速开始
先决条件
安装前,请确保:
- Node.js 20+ -ES模块支持所需(下载)
- Chrome浏览器 -代理需要查看您的网页、分析DOM元素并实时预览更改
- Adobe目标帐户 -具有管理员API访问权限
- MCP客户端 -Claude Desktop、Claude Code、Cursor、Windsurf或任何兼容MCP的客户端
1.克隆存储库
git clone https://github.com/scottehastings16/adobe-target-mcp.git
cd adobe-target-mcp2.安装依赖项
npm install已安装的依赖项:
@modelcontextprotocol/sdk@^1.0.4-MCP协议实现dotenv@^17.2.3-环境变量管理
3.安装所需的MCP服务器
此代理需要 两台MCP服务器 共同努力:
a) Adobe目标MCP代理(本项目)
- 已安装
npm install
b) Chrome DevTools MCP服务器(必需)
- 提供实时浏览器DOM访问和页面分析
- 通过自动安装
npx配置adobe目标mcp时 - 需要Chrome或Chromium浏览器
4.配置环境
复制 .env.example 到 .env 并配置:
# Required - Adobe Target API credentials
TARGET_TENANT_ID=your-tenant-id
TARGET_API_KEY=your-api-key
TARGET_ACCESS_TOKEN=your-access-token
TARGET_WORKSPACE_ID=your-workspace-id
# Optional - Default values for activities
TARGET_DEFAULT_MBOXES=target-global-mbox
TARGET_DEFAULT_PRIORITY=5
# Optional - Success metrics defaults
TARGET_DEFAULT_METRIC_TYPE=engagement
TARGET_DEFAULT_ENGAGEMENT_METRIC=page_count5.配置MCP客户端
复制 .claude.json.example 访问MCP客户端的配置文件,并更新路径和凭据。
克劳德桌面/代码:
窗户: %APPDATA%\Claude\claude_desktop_config.json 雨衣: ~/Library/Application Support/Claude/claude_desktop_config.json Linux: ~/.config/Claude/claude_desktop_config.json
对于其他MCP客户端: 有关MCP服务器配置文件的位置,请参阅客户的文档。
{
"mcpServers": {
"adobe-target": {
"command": "node",
"args": ["C:\\Users\\YourUsername\\adobe-target-mcp\\src\\index.js"],
"env": {}
},
"chrome-devtools": {
"command": "npx",
"args": ["-y", "chrome-devtools-mcp"],
"env": {
"CHROME_PATH": "C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe"
}
}
}
}特定于平台的Chrome路径:
- 窗户:
"C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe" - 雨衣:
"/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" - Linux:
"/usr/bin/google-chrome"或"/usr/bin/chromium"
特定于平台的路径格式:
- 窗户: 使用带有转义符的反斜杠:
"C:\\Users\\YourUsername\\adobe-target-mcp\\..." - Mac/Linux: 使用正斜杠:
"/Users/yourname/adobe-target-mcp/..."
6.开始使用
配置后,您可以要求您的AI助手:
- “显示付费媒体个性化活动的结果”
- “在我的网站www.example.com上的英雄形象下创建一个旋转木马”
- “显示我的targt属性中可用的响应令牌”
- “为我的页面www.example.com生成一个弹出模块,添加一个CTA和此图像:example.com/image.png…添加一个链接到此链接example.com/products的产品页面的CTA”
- “为功能标志创建JSON报价”
- “列出所有活动的目标活动”
- “在我的房产中列出可飞行的mbox”
- “为立即购买CTA测试生成转换报告”
- “帮助我创建新的响应令牌”
- 使用配置的品牌颜色更新“立即购买”优惠
该代理将使用其33个工具代表您与Adobe Target进行交互。
______________________________________________________________________
外部MCP服务器
- chrome开发工具mcp (通过npx自动安装)
- 用途:实时浏览器控制、DOM分析、截图 - 安装:首次运行时自动通过 npx -y chrome-devtools-mcp - 要求:Chrome/Chromium浏览器
系统要求
- Node.js:20+(需要ES模块支持)
- Adobe目标:具有管理员API访问权限的帐户
- Chrome浏览器:Chrome DevTools MCP集成所需
- MCP客户端:Claude Desktop、Claude Code或任何兼容MCP的客户端
______________________________________________________________________
项目结构
adobe-target-mcp/
├── src/
│ ├── index.js # Main MCP server entry point
│ ├── .env.example # Environment variable template
│ │
│ ├── config/
│ │ ├── tag-managers.json # Tag manager configurations (GTM, Adobe Launch, Tealium, Segment)
│ │ └── firing-conditions.json # Event firing logic (session, throttle, debounce, etc.)
│ │
│ ├── helpers/
│ │ ├── makeTargetRequest.js # Adobe Target API client wrapper
│ │ └── applyDefaults.js # Auto-fill default configuration values
│ │
│ ├── templates/
│ │ ├── README.md # Template system documentation
│ │ ├── html/ # HTML offer templates (10 templates)
│ │ │ ├── carousel.json
│ │ │ ├── hero-banner.json
│ │ │ ├── cta-button.json
│ │ │ ├── modal.json
│ │ │ ├── sticky-header.json
│ │ │ ├── countdown-timer.json
│ │ │ ├── form-field.json
│ │ │ ├── tabs.json
│ │ │ ├── accordion.json
│ │ │ └── notification-banner.json
│ │ └── json/ # JSON offer templates (9 templates)
│ │ ├── product-recommendations.json
│ │ ├── feature-flags.json
│ │ ├── hero-config.json
│ │ ├── pricing-data.json
│ │ ├── personalization-content.json
│ │ ├── navigation-menu.json
│ │ ├── form-config.json
│ │ ├── testimonials.json
│ │ └── ab-test-variant.json
│ │
│ └── tools/
│ ├── index.js # Tool registration
│ ├── activities/ # Activity management (5 tools)
│ │ ├── listActivities.js
│ │ ├── createABActivity.js
│ │ ├── getABActivity.js
│ │ ├── updateABActivity.js
│ │ └── updateActivityState.js
│ ├── offers/ # Offer management (5 tools)
│ │ ├── listOffers.js
│ │ ├── createOffer.js # PRIMARY TOOL - HTML offers
│ │ ├── createJsonOffer.js # JSON offers (SPAs, server-side, mobile)
│ │ ├── getOffer.js
│ │ └── updateOffer.js
│ ├── audiences/ # Audience management (2 tools)
│ │ ├── listAudiences.js
│ │ └── createAudience.js
│ ├── mboxes/ # Mbox resources (3 tools)
│ │ ├── listMboxes.js
│ │ ├── getMbox.js
│ │ └── listMboxProfileAttributes.js
│ ├── properties/ # Properties (1 tool)
│ │ └── listProperties.js
│ ├── reports/ # Reporting (6 tools)
│ │ ├── getABPerformanceReport.js
│ │ ├── getABOrdersReport.js
│ │ ├── getXTPerformanceReport.js
│ │ ├── getXTOrdersReport.js
│ │ ├── getAPTPerformanceReport.js
│ │ └── getActivityInsights.js
│ ├── response-tokens/ # Response tokens (2 tools)
│ │ ├── listResponseTokens.js
│ │ └── createResponseToken.js
│ ├── atjs/ # at.js settings (2 tools)
│ │ ├── getAtjsSettings.js
│ │ └── getAtjsVersions.js
│ ├── revisions/ # Activity revisions (2 tools)
│ │ ├── getRevisions.js
│ │ └── getEntityRevisions.js
│ ├── templates/ # Template management (1 tool)
│ │ └── listTemplates.js # Browse available templates
│ └── custom/ # DataLayer & preview tools (4 tools)
│ ├── generateDataLayerEvent.js
│ ├── createActivityFromModifications.js
│ ├── generatePreviewScript.js
│ └── getMockupAnalysisInstructions.js
│
├── package.json # Node.js dependencies
├── .env # Environment variables (create from .env.example)
└── README.md # This file______________________________________________________________________
______________________________________________________________________
可用工具
活动(5个工具)
listActivities-列出所有具有筛选功能的目标活动createABActivity-创建A/B测试(仅限API,高级使用)getABActivity-按ID获取活动详细信息updateABActivity-更新活动配置updateActivityState-激活、暂停或停用活动
优惠(5个工具)
listOffers-列出所有带有筛选功能的优惠createOffer- 主要工具 -创建HTML报价(95%的情况下使用)createJsonOffer-为SPA、服务器端、移动应用程序、无头应用程序创建JSON服务getOffer-按ID获取优惠详情updateOffer-更新优惠内容
观众(2个工具)
listAudiences-列出所有受众createAudience-用规则创建新受众
Mbox(3个工具)
listMboxes-列出所有mboxgetMbox-获取mbox详细信息listMboxProfileAttributes-列出mbox的配置文件属性
属性(1个工具)
listProperties-列出目标属性
报告(6个工具)
getABPerformanceReport-A/B测试性能指标getABOrdersReport-A/B测试订单/收入数据getXTPerformanceReport-体验目标绩效getXTOrdersReport-体验定向订单getAPTPerformanceReport-自动化个性化性能getActivityInsights-活动见解和建议
响应令牌(2个工具)
listResponseTokens-列出所有响应令牌createResponseToken-创建自定义响应令牌
at.js配置(2个工具)
getAtjsSettings-获取at.js设置getAtjsVersions-列出可用的at.js版本
修订(2个工具)
getRevisions-列出所有活动修订getEntityRevisions-获取特定实体的修订
模板(1个工具)
listTemplates- 浏览所有可用的HTML和JSON模板
自定义工具(4个工具)
generateDataLayerEvent- 生成转换跟踪代码 支持标签管理器createActivityFromModifications-通过JavaScript修改创建目标活动(高级使用,适用API限制)generatePreviewScript-为Chrome DevTools MCP注入生成预览脚本getMockupAnalysisInstructions-获取模型分析和经验生成工作流程的说明
______________________________________________________________________
许可证
MIT许可证-请参阅许可证文件
______________________________________________________________________
链接
______________________________________________________________________
