[Beta]{class="badge informative"}

Adobe Target MCP服务器工具参考 target-mcp-tools-reference

最近更新： 2026年4月22日

主题：
Integrations

创建对象：

Intermediate
Experienced
Developer
User

AVAILABILITY

Adobe Target MCP服务器可用于 公共Beta 中的所有客户。当前在Claude Web、Claude Desktop、Claude Code、Cursor和 ChatGPT 中支持它。

此页面是Adobe Target MCP服务器公开的所有只读工具的完整参考。对于每个工具，您都可以找到描述、参数详细信息、返回值以及自然语言提示示例。有关设置说明和用例，请参阅入门和用例和演练。

IMPORTANT

模型上下文协议(MCP)是一种新兴的开源标准，可能会带来安全性或可靠性风险。 Adobe MCP服务器集成和相关文档按“原样”提供，不提供任何类型的担保。

将MCP客户端或服务器连接到Adobe产品是客户选择的配置，客户负责评估任何MCP集成的安全性和适用性。 Adobe对于因错误配置、滥用MCP、第三方实施中的漏洞或通过支持MCP的工作流执行的意外操作而产生的问题，概不负责。

为了降低风险，Adobe鼓励您在生产使用之前在沙盒环境中测试集成，并在确认或依赖集成之前，仔细审查和验证所有MCP启动的操作和响应。

先决条件 tools-prerequisites

您的Adobe Target角色决定了您可用的工具：

观察者角色或更高版本：访问所有23个只读工具

NOTE

在公共Beta中，写入工具（创建、更新、激活、停用）不通过公共MCP目录公开。此页面上列出的所有23种工具均为只读。写入权限将在未来版本中提供。

有关完整的设置说明，请参阅开始使用。

活动工具 tools-activities

列出活动

工具： list_target_activities

列出具有服务器端过滤和排序的Adobe Target活动。

检索分页的活动列表。所有筛选器都通过Target管理员API在服务器端应用。服务器每页最多返回200个活动。

table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 5-row-4 6-row-4 7-row-4 8-row-4 9-row-4 10-row-4 11-row-4 12-row-4 13-row-4 14-row-4 15-row-4 16-row-4 17-row-4 18-row-4
参数	类型	必需	描述
`limit`	整数	否	要返回的最大活动数（服务器最大数量：200）
`offset`	整数	否	为分页而跳过的活动数
`sort_by`	字符串	否	要作为排序依据的字段。前缀为`-`表示降序（例如，`-modifiedAt`）。选项： `id`、`name`、`state`、`priority`、`startsAt`、`endsAt`、`lifetimeStart`、`lifetimeEnd`、`createdAt`、`createdBy`、`modifiedAt`、`modifiedBy`、`type`、`thirdPartyId`
`state`	字符串	否	按活动状态筛选： `approved` （实时/活动）、`deactivated` （非活动）、`paused`、`saved` （草稿）
`activity_type`	字符串	否	按类型筛选： `ab` （A/B测试）、`xt` （体验定位）、`abt` (Automated Personalization)
`name_contains`	字符串	否	筛选名称包含此字符串（不区分大小写）的活动
`starts_after`	字符串	否	ISO 8601日期 — 在此日期之后开始的活动
`starts_before`	字符串	否	ISO 8601日期 — 在此日期之前开始的活动
`modified_after`	字符串	否	ISO 8601日期 — 在此日期之后修改的活动
`ends_after`	字符串	否	ISO 8601日期 — 在此日期之后结束的活动
`ends_before`	字符串	否	ISO 8601日期 — 在此日期之前结束的活动
`workspace`	字符串	否	按工作区ID筛选
`segment_id`	字符串	否	按受众区段ID过滤
`profile_attribute_id`	字符串	否	按配置文件属性ID筛选
`priority`	整数	否	按准确的优先级值筛选(0-999)
`mbox`	字符串	否	按mbox/位置名称筛选
`offer_id`	字符串	否	按优惠ID筛选
`view_id`	字符串	否	按SPA视图ID筛选

返回： JSON对象，带有activities （对象列表包括id、name、state、type、priority、modifiedAt、startsAt、endsAt）和total （总计数，可能会超过返回的页面大小）。

示例提示：“列出按最近修改排序的所有活动A/B测试。”

获取A/B活动

工具： get_ab_activity

获取有关A/B活动的详细信息。

检索特定A/B测试的完整配置，包括体验、位置、量度和定位规则。

table 0-row-4 1-row-4
参数	类型	必需	描述
`activity_id`	整数	是	A/B活动的唯一标识符

返回：完整的活动详细信息，包括元数据（名称、状态、优先级、日期）、体验、位置和选件、目标和量度，以及定位规则。

示例提示：“获取A/B活动12345的详细信息”。

获取体验定位活动

工具： get_xt_activity

获取有关体验定位(XT)活动的详细信息。

检索特定XT活动的完整配置，包括受众体验映射、位置和量度。

table 0-row-4 1-row-4
参数	类型	必需	描述
`activity_id`	整数	是	XT活动的唯一标识符

返回：完整的活动详细信息，包括元数据、具有受众映射的体验、位置和选件以及目标和量度。

示例提示：“获取体验定位活动12345的详细信息”。

获取Automated Personalization活动

工具： get_abt_activity

获取有关Automated Personalization (AP)活动的详细信息。

table 0-row-4 1-row-4
参数	类型	必需	描述
`activity_id`	整数	是	AP活动的唯一标识符

返回：完整的活动详细信息，包括元数据、体验、位置和算法设置。

示例提示：“获取自动Personalization活动12345的详细信息”。

优惠工具 tools-offers

列出优惠

工具： list_target_offers

列出Target租户中的所有优惠。

检索包含可选过滤功能的内容选件分页列表。

table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4
参数	类型	必需	描述
`limit`	整数	否	要返回的最大优惠数量
`offset`	整数	否	跳出进行分页的优惠数量
`type`	字符串	否	按选件类型筛选： `content` (HTML)、`json`或`redirect`
`name`	字符串	否	按选件名称筛选（部分匹配）

返回：包含offers的JSON对象（对象列表，包括id、name、type、content、modifiedAt）和total。

示例提示：“列出所有JSON选件”。

获取优惠

工具： get_target_offer

获取有关特定选件的详细信息。

table 0-row-4 1-row-4
参数	类型	必需	描述
`offer_id`	整数	是	优惠的唯一标识符

返回：完整的选件详细信息，包括id、name、type、content、workspace和modifiedAt。

示例提示：“获取选件67890的详细信息”。

受众工具 tools-audiences

列出受众

工具： list_target_audiences

列出Target租户中的所有受众。

table 0-row-4 1-row-4 2-row-4
参数	类型	必需	描述
`limit`	整数	否	要返回的最大受众数
`offset`	整数	否	为分页而跳过的受众数量

返回：包含audiences的JSON对象（对象列表，包括id、name、description、origin、modifiedAt）和total。

示例提示：“列出所有受众”。

获取受众

工具： get_target_audience

获取受众详细信息，包括定位规则。

检索特定受众的完整配置，包括其定位规则和条件。

table 0-row-4 1-row-4
参数	类型	必需	描述
`audience_id`	整数	是	受众的唯一标识符

返回：完整的受众详细信息，包括id、name、description、origin、定位规则和相关活动计数。

示例提示：“获取受众12345的详细信息并显示其定位规则。”

Mbox工具 tools-mboxes

列表mbox

工具： list_target_mboxes

列出您Target租户中的所有mbox。

table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4
参数	类型	必需	描述
`limit`	整数	否	要返回的最大mbox数
`offset`	整数	否	要跳过以进行分页的mbox数量
`name`	字符串	否	按mbox名称筛选（部分匹配）
`status`	字符串	否	按状态筛选

返回：包含mboxes的JSON对象（对象列表，包括name、status、lastRequestTime）和total。

示例提示：“列出所有包含’homepage’的mbox。”

获取mbox

工具： get_target_mbox

获取有关特定mbox的详细信息。

table 0-row-4 1-row-4
参数	类型	必需	描述
`mbox_name`	字符串	是	mbox的名称

返回： Mbox详细信息，包括name、status以及使用mbox的活动列表。

示例提示：“获取mbox 'homepage-hero’的详细信息。”

列出mbox配置文件属性

工具： list_target_mbox_profile_attributes

列出所有可用于定位的mbox配置文件属性。

无需参数。

返回：配置文件属性对象的JSON数组。

示例提示：“哪些配置文件属性可用于定位？”

资产工具 tools-properties

列表属性

工具： list_target_properties

列出Target租户中的所有属性。

属性可组织活动并控制访问权限。

无需参数。

返回：属性对象列表，包括id、name、description和channel。

示例提示：“列出所有Target属性”。

报告工具 tools-reporting

获取A/B性能报表

工具： get_ab_performance_report

获取A/B活动的性能报表。

检索转化率、提升度和置信度级别。

table 0-row-4 1-row-4 2-row-4
参数	类型	必需	描述
`activity_id`	整数	是	A/B活动的唯一标识符
`report_interval`	字符串	否	报告的时段（例如`last7days`、`last30days`或自定义日期范围）

返回：体验级别的量度（访客数、转化率、转化率）、提升度计算、统计置信水平和收入量度（如果已配置）。

示例提示：“显示过去30天的A/B测试12345性能报告。”

获取A/B订单报表

工具： get_ab_orders_report

获取A/B活动的订单/收入报表。

table 0-row-4 1-row-4 2-row-4
参数	类型	必需	描述
`activity_id`	整数	是	A/B活动的唯一标识符
`report_interval`	字符串	否	报告的时间段

返回：订单计数、收入和平均订单值（按体验）。

示例提示：“获取活动12345的订单报告”。

获取体验定位性能报表

工具： get_xt_performance_report

获取体验定位活动的性能报表。

table 0-row-4 1-row-4 2-row-4
参数	类型	必需	描述
`activity_id`	整数	是	XT活动的唯一标识符
`report_interval`	字符串	否	报告的时间段

返回：体验级别的绩效指标。

示例提示：“显示我的体验定位活动54321的性能”。

获取体验定位订单报表

工具： get_xt_orders_report

获取体验定位活动的订单/收入报表。

table 0-row-4 1-row-4 2-row-4
参数	类型	必需	描述
`activity_id`	整数	是	XT活动的唯一标识符
`report_interval`	字符串	否	报告的时间段

返回：按体验排序的量度。

示例提示：“获取XT活动54321的订单数据”。

按活动名称获取性能报表

工具： get_activity_report_by_name

按名称搜索活动并获取其性能报表。

当您知道活动名称但不知道其ID时，此变量将非常有用。

table 0-row-4 1-row-4 2-row-4
参数	类型	必需	描述
`activity_name`	字符串	是	要搜索的活动名称
`report_interval`	字符串	否	报告的时间段

返回：活动详细信息和性能度量。

示例提示：“获取我的‘主页主页主页主页测试’活动的性能报告。”

获取Analytics for Target (A4T)报表

工具： get_a4t_report

为Target活动获取Analytics for Target (A4T)报告。

验证活动的A4T配置，然后对Adobe Analytics执行GraphQL查询以检索Analytics端量度。仅适用于已配置A4T报表的活动。

table 0-row-4 1-row-4 2-row-4
参数	类型	必需	描述
`activity_id`	整数	是	Target活动的唯一标识符
`report_interval`	字符串	否	报告的时段（例如`last7days`、`last30days`或自定义日期范围）

返回：活动的分析端量度，包括直接源自Adobe Analytics的访客计数、转化、收入和体验提升。

示例提示：“提取A4T报告以进行我的签出优化测试并汇总Analytics端转化数据。”

预览工具 tools-preview

预览活动

工具： preview_activity

为Target活动生成浏览器QA预览URL。

创建可单击的预览链接，以强制显示特定体验，并绕过受众定位规则。适用于A/B、XT和Automated Personalization活动。

table 0-row-4 1-row-4 2-row-4 3-row-4
参数	类型	必需	描述
`activity_id`	整数	是	要预览的Target活动标识
`experience_index`	整数	否	基于0的体验索引。如果忽略，则返回所有体验的URL
`url`	字符串	否	用于预览的页面URL。对于基于表单的活动，此为必需字段。对于VEC活动，会覆盖创作位置（如果提供）

返回：活动信息（名称、类型、状态）、每个体验的预览URL以及体验名称和索引。

示例提示：“为活动12345生成预览URL，以便我可以在浏览器中测试每个体验。”

响应令牌工具 tools-response-tokens

列出响应令牌

工具： list_target_response_tokens

列出Target租户中的所有响应令牌。

检索所有已配置的响应令牌，包括内置和自定义响应令牌。

无需参数。

返回：响应令牌对象的JSON数组，状态为name、type和enabled。

示例提示：“列出所有响应令牌”。

修订版工具 tools-revisions

获取审核日志

工具： get_target_revisions

获取资源类型的审核日志。

通过作者可选的筛选，检索对Target资源所做的更改。

table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4
参数	类型	必需	描述
`revision_resource_type`	字符串	是	资源类型： `activity`、`offer`或`audience`
`modified_by`	字符串	否	按进行更改的用户筛选
`limit`	整数	否	要返回的最大修订数量
`offset`	整数	否	为分页而跳过的修订数量

返回：修订历史记录，包含时间戳、用户和更改描述。

示例提示：“显示活动更改的审核日志”。

获取特定实体的修订

工具： get_target_entity_revisions

按ID获取特定实体的所有修订。

table 0-row-4 1-row-4 2-row-4
参数	类型	必需	描述
`revision_resource_type`	字符串	是	资源类型： `activity`、`offer`或`audience`
`entity_id`	整数	是	实体的唯一标识符

返回指定实体的所有修订的 JSON数组。

示例提示：“向我显示对活动12345所做的所有更改。”

模板工具 tools-templates

列出可用模板

工具： list_target_templates

列出用于创建活动和选件的可用MCP资源和模板。

无需参数。

返回： JSON对象列出了可用的模板和资源。

示例提示：“哪些模板可用于创建活动？”

工具摘要 tools-summary

类别

计数

工具

活动

list_target_activities, get_ab_activity, get_xt_activity, get_abt_activity

产品建议

list_target_offers, get_target_offer

受众

list_target_audiences, get_target_audience

Mbox

list_target_mboxes, get_target_mbox, list_target_mbox_profile_attributes

属性

list_target_properties

报表

get_ab_performance_report, get_ab_orders_report, get_xt_performance_report, get_xt_orders_report, get_activity_report_by_name, get_a4t_report

预览

preview_activity

响应令牌

list_target_response_tokens

修订

get_target_revisions, get_target_entity_revisions

模板

list_target_templates

合计

recommendation-more-help

target-help-main

Adobe Target MCP服务器工具参考 target-mcp-tools-reference

先决条件 tools-prerequisites

活动工具 tools-activities

优惠工具 tools-offers

受众工具 tools-audiences

Mbox工具 tools-mboxes

资产工具 tools-properties

报告工具 tools-reporting

预览工具 tools-preview

响应令牌工具 tools-response-tokens

修订版工具 tools-revisions

模板工具 tools-templates

工具摘要 tools-summary

相关资源 tools-related