[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 Admin 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`	string	否	排序依據的欄位。遞減順序以`-`為前置詞（例如，`-modifiedAt`）。選項： `id`、`name`、`state`、`priority`、`startsAt`、`endsAt`、`lifetimeStart`、`lifetimeEnd`、`createdAt`、`createdBy`、`modifiedAt`、`modifiedBy`、`type`、`thirdPartyId`
`state`	string	否	依活動狀態篩選： `approved` （即時/作用中）、`deactivated` （非作用中）、`paused`、`saved` （草稿）
`activity_type`	string	否	依型別篩選： `ab` （A/B測試）、`xt` （體驗鎖定目標）、`abt` (Automated Personalization)
`name_contains`	string	否	篩選名稱包含此字串（不區分大小寫）的活動
`starts_after`	string	否	ISO 8601日期 — 在此日期之後開始的活動
`starts_before`	string	否	ISO 8601日期 — 在此日期之前開始的活動
`modified_after`	string	否	ISO 8601日期 — 在此日期之後修改的活動
`ends_after`	string	否	ISO 8601日期 — 在此日期之後結束的活動
`ends_before`	string	否	ISO 8601日期 — 在此日期之前結束的活動
`workspace`	string	否	依工作區ID篩選
`segment_id`	string	否	依對象區段ID篩選
`profile_attribute_id`	string	否	依設定檔屬性ID篩選
`priority`	整數	無	依確切的優先順序值篩選(0-999)
`mbox`	string	否	依mbox/位置名稱篩選
`offer_id`	string	否	依優惠ID篩選
`view_id`	string	否	依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`	string	否	依選件型別篩選： `content` (HTML)、`json`或`redirect`
`name`	string	否	依選件名稱篩選（部分符合）

傳回：具有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`	string	否	依mbox名稱篩選（部分符合）
`status`	string	否	依狀態篩選

傳回：具有mboxes的JSON物件（物件清單，包括name、status、lastRequestTime）和total。

範例提示：「列出所有包含’homepage’的mbox」。

取得mbox

工具： get_target_mbox

取得特定mbox的詳細資訊。

table 0-row-4 1-row-4
參數	類型	必要	說明
`mbox_name`	string	是	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`	string	否	報告的時段（例如`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`	string	否	報告的時段

傳回：訂單計數、收入，以及體驗的平均訂單值。

範例提示：「取得活動12345的訂單報表」。

取得體驗鎖定目標效能報表

工具： get_xt_performance_report

取得體驗鎖定目標活動的效能報表。

table 0-row-4 1-row-4 2-row-4
參數	類型	必要	說明
`activity_id`	整數	是	XT活動的唯一識別碼
`report_interval`	string	否	報告的時段

傳回：體驗層級的效能測量結果。

範例提示：「顯示我的體驗鎖定目標活動54321的效能」。

取得體驗鎖定目標訂單報表

工具： get_xt_orders_report

取得體驗鎖定目標活動的訂單/收入報表。

table 0-row-4 1-row-4 2-row-4
參數	類型	必要	說明
`activity_id`	整數	是	XT活動的唯一識別碼
`report_interval`	string	否	報告的時段

傳回：依據體驗的排序量度。

範例提示：「取得XT活動54321的訂單資料」。

依活動名稱取得效能報表

工具： get_activity_report_by_name

依名稱搜尋活動並取得其效能報表。

當您知道活動名稱但不知道其ID時，這很有用。

table 0-row-4 1-row-4 2-row-4
參數	類型	必要	說明
`activity_name`	string	是	要搜尋的活動名稱
`report_interval`	string	否	報告的時段

傳回：活動詳細資料和績效測量結果。

範例提示： 「取得我的『首頁主圖測試』活動的效能報告」。

取得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`	string	否	報告的時段（例如`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`	string	否	預覽的頁面URL。表單式活動的必要專案。針對VEC活動，會覆寫編寫的位置（如果提供）

傳回：活動資訊（名稱、型別、狀態）、每個體驗的預覽URL，以及體驗名稱和索引。

範例提示： 「產生活動12345動的預覽URL，以便我測試瀏覽器中的每一個體驗。」

回應Token工具 tools-response-tokens

列出回應Token

工具： list_target_response_tokens

列出您Target租使用者中的所有回應Token。

擷取所有已設定的回應Token，包括內建和自訂。

不需要引數。

傳回：回應權杖物件的JSON陣列，狀態為name、type和enabled。

範例提示：「列出所有回應Token」。

修訂工具 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`	string	是	資源型別： `activity`、`offer`或`audience`
`modified_by`	string	否	依進行變更的使用者篩選
`limit`	整數	無	要傳回的修訂數量上限
`offset`	整數	無	分頁要略過的修訂數量

傳回：包含時間戳記、使用者和變更說明的修訂歷程記錄。

範例提示： 「顯示活動變更的稽核記錄」。

取得特定實體的修訂版本

工具： get_target_entity_revisions

依照ID取得特定實體的所有修訂版本。

table 0-row-4 1-row-4 2-row-4
參數	類型	必要	說明
`revision_resource_type`	string	是	資源型別： `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

回應Token

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

回應Token工具 tools-response-tokens

修訂工具 tools-revisions

範本工具 tools-templates

工具摘要 tools-summary

相關資源 tools-related