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许可证-请参阅许可证文件
______________________________________________________________________
链接
______________________________________________________________________