[有限可用性]{class="badge informative" title="此功能目前在有限測試版中提供"}
Marketo Engage MCP伺服器
模型上下文通訊協定(MCP)是一種開放標準,可讓AI工具與外部服務通訊。 Marketo MCP伺服器可作為您的AI助理與Marketo之間的橋樑。 它會公開超過100項操作,涵蓋表單、方案、智慧行銷活動、銷售機會、電子郵件、代碼片段、清單和資料夾。
當您的AI工具呼叫MCP伺服器時,伺服器會使用您在每個請求中提供的認證,代表您執行相對應的REST API呼叫。 您不需要安裝、部署或執行任何伺服器端軟體。
將MCP使用者端或伺服器連線至Adobe產品是客戶選擇的組態,客戶必須負責評估任何MCP整合的安全性和適用性。Adobe對於因設定錯誤、誤用MCP、協力廠商實作中的漏洞,或透過啟用MCP的工作流程執行的意外動作所引起的問題,概不負責。
為了降低風險,Adobe鼓勵您在有效使用之前在沙箱環境中測試整合,並在確認或依賴之前,仔細檢閱及驗證所有MCP啟動的動作和回應。
MCP基本需知
將MCP想成是AI應用程式的USB-C連線埠。 正如USB-C提供標準化方式將裝置連線到各種周邊裝置和配件,MCP也提供標準化方式將AI模型連線到資料來源和工具。 — 模型內容通訊協定
MCP可讓AI工具同時連線至多個外部服務。 例如,AI助理可以:
- 連線至文書處理器,以產生AI輔助檔案
- 連線至動畫工具(例如Blender),以建立視覺效果
- 連線至Adobe After Effects以進行視訊編輯
MCP是通訊協定:任何應用程式都可以實作的開放標準,以向AI工具公開其資料和動作。
Marketo Engage MCP的功用和不功用
在連線AI工具之前,瞭解MCP的範圍有助於設定期望。
MCP可以:
- 透過標準REST API提供對Marketo資料和功能的存取
- 使用您在每個請求中提供的認證,代表您執行API呼叫
- 支援多個同時使用者,每個使用者都透過自己的憑證連線
- 自動處理OAuth權杖重新整理。 您不需要管理權杖有效期
- 在租使用者隔離的環境中操作,因此您的資料絕不會與另一個使用者的工作階段相交
MCP不是:
- 使用、託管或執行任何AI或機器學習模型。 所有AI處理作業都會在AI工具中進行,而非MCP
- 訓練任何資料或從中學習,包括您的客戶資料
- 產生預測、建議或決定。 決策是下遊人工智慧工具或使用者的責任
- 儲存或保留要求之間的認證、要求資料或工作階段狀態
- 需要您安裝、部署或管理任何伺服器端軟體
MCP可能會傳輸資料,包括可能的敏感欄位,視API使用方式而定,但B2B資料涉及客戶業務資料,不涉及PII資料。
先決條件
- 已啟用REST API存取的Marketo執行個體
- 在Marketo LaunchPoint中建立API認證的管理員存取權
- 下列AI工具之一: Claude Desktop、Cursor、Codex、Claude Code (CLI)或具有GitHub Copilot的VS Code
- 網路存取MCP伺服器URL:
https://marketo-mcp.adobe.io/mcp
取得Marketo認證
您需要Marketo執行個體的下列值:
- 使用者端識別碼
- 使用者端密碼
- Munchkin帳戶ID
如果您已經擁有這些工具,請跳到設定您的AI工具。
使用者端ID和使用者端密碼
- 前往Admin > LaunchPoint。
- 選取您的API服務。 如果您沒有這類服務,請選取New > New Service,選擇 Custom 做為服務型別,並指派專用的API使用者。
- 選取 View Details 並複製 Client ID 和 Client Secret 值。
Munchkin帳戶ID
- 前往Admin > Munchkin。
- 複製Munchkin Account ID。 格式為
XXX-XXX-XXX,且符合執行個體URL的前置詞。
設定您的AI工具
每個AI工具的設定稍有不同。 提供常用工具的連線範例。
marketo-prod和marketo-staging,每個專案都有對應的認證。克勞德案頭 claude-desktop
若要連線到Claude Desktop,請下載marketo-mcp-bridge.zip並將其解壓縮。 將marketo-mcp-bridge.mjs放入已知位置,以便在下一個步驟中參照。
您還需要:
- Node.js v18+
- npm
- 開啟Claude Desktop
- 移至設定>開發人員>編輯設定
- 將下列專案新增至
claude_desktop_config.json:
{
"preferences": {
...
},
"mcpServers": {
"marketo-mcp": {
"command": "node",
"args": ["/path/to/marketo-bridge/bridge.mjs"],
"env": {
"MARKETO_MCP_PROD_CLIENT_ID": "<your-client-id>",
"MARKETO_MCP_PROD_CLIENT_SECRET": "<your-client-secret>",
"MARKETO_MCP_PROD_MUNCHKIN_ID": "<your-munchkin-id>"
}
}
}
}
- 重新啟動Claude Desktop
游標 cursor
如果您的游標MCP組態已經包含其他伺服器,請在mcpServers下新增marketo專案。
下列範例顯示專案目錄中Settings > MCP或.cursor/mcp.json中的完整mcpServers區塊:
| code language-json |
|---|
|
| code language-json |
|---|
|
重新啟動游標。
克勞德程式碼(CLI) claude-code
在終端機中執行以下命令,取代您的認證:
| code language-bash |
|---|
|
| code language-bash |
|---|
|
OpenAI程式碼 codex
- 前往「設定> MCP伺服器>新增伺服器」
- 新增伺服器URL:
https://marketo-mcp.adobe.io/mcp - 新增驗證方法的標頭:
- 授權:「持有人YOUR-IMS-TOKEN」
- x-gw-ims-org-id: “YOUR-IMS-ORG-ID”
- X-Marketo-Client-Id: “YOUR-CLIENT-ID”
- X-Marketo-Client-Secret: “YOUR-CLIENT-SECRET”
- X-Marketo-Munchkin-Id: “YOUR-MUNCHKIN-ID”
- 按一下儲存,即可完成此程式。
VS程式碼與GitHub Copilot vscode
按Ctrl+Shift+P (或macOS上的Cmd+Shift+P),輸入MCP: Open User Configuration,然後按Enter。 這會開啟mcp.json。 在servers物件中新增marketo專案:
| code language-json |
|---|
|
| code language-json |
|---|
|
${MARKETO_CLIENT_SECRET}的語法參考變數,並在您的環境中設定它們。 這可防止憑證以純文字形式儲存在版本控制的檔案中。其他工具 other-tools
Marketo MCP伺服器由Adobe代管,並在公用URL上公開。任何透過可串流的HTTP傳輸支援遠端伺服器的MCP使用者端都可以連線到它。
您不需要工具專用的橋接器或任何本機安裝的軟體。如果您的工具未在上方列出,請使用下方的連線詳細資料來手動設定。
連線詳細資料:
https://marketo-mcp.adobe.io/mcp驗證標頭:
針對每個請求的下列驗證方法之一,傳送標頭。 您在其中輸入伺服器URL和標題取決於您的工具,因此請參閱其MCP檔案。
| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| 標頭 | 值 |
Authorization |
Bearer YOUR-IMS-TOKEN |
x-gw-ims-org-id |
您的IMS組織ID |
| table 0-row-2 1-row-2 2-row-2 3-row-2 | |
|---|---|
| 標頭 | 值 |
X-Marketo-Client-Id |
您的使用者端ID |
X-Marketo-Client-Secret |
您的使用者端密碼 |
X-Marketo-Munchkin-Id |
您的Munchkin帳戶ID |
如果您的工具接受JSON設定,請從Cursor或VS Code範例開始,並調整金鑰(mcpServers、servers)以符合您工具的結構描述。
可用的作業
連線之後,您可以要求AI助理執行下列類別的作業。 如需支援API參考的完整作業清單,請參閱支援的MCP作業。
表單
瀏覽、建立、複製和核准表單。 新增或移除欄位、設定欄位可見性規則,並識別表單的內嵌位置。
提示範例:
- “顯示所有已核准的表單”
- 「將「聯絡我們」表單原地複製至Q2 Campaign資料夾」
- 「將公司欄位新增至示範申請表單」
智慧行銷活動
建立智慧行銷活動、設定智慧清單篩選器、新增流程步驟,以及啟用或停用行銷活動。
提示範例:
- 「哪些智慧型行銷活動目前有效?」
- 「在Operations資料夾中建立名為Lead Scoring Update的新智慧行銷活動」
- 「在歡迎電子郵件行銷活動中顯示流程步驟」
潛在客戶與清單
依電子郵件地址尋找銷售機會、建立或更新銷售機會記錄,以及管理靜態清單成員資格。
提示範例:
- 「透過電子郵件jane@example.com尋找銷售機會」
- 「將銷售機會ID 12345新增至第2季MQL清單」
- 「建立稱為夏季活動出席者的新靜態清單」
方案
建立、複製和標籤程式。 依型別、管道或日期範圍瀏覽計畫。
提示範例:
- 「將Q4網路研討會程式原地複製至2026年事件資料夾」
- 「在Campaigns資料夾中建立名為Summer Sale的新電子郵件程式」
- 「顯示所有標籤為網路研討會的計畫」
電子郵件和代碼片段
瀏覽電子郵件、從範本建立電子郵件、更新內容區段及管理可重複使用的程式碼片段。
提示範例:
- 「顯示所有草稿電子郵件」
- 「更新歡迎電子郵件的標題區段」
- 「哪些資產使用假日促銷活動代碼片段?」
例項結構
若要瞭解您的Marketo設定,請瀏覽資料夾、頻道、標籤型別和活動型別。
提示範例:
- 「列出Marketo中的所有資料夾」
- 「顯示所有可用的頻道」
- 「已設定哪些標籤型別?」
大量作業
大量匯出潛在客戶資料,並檢查匯入或匯出工作狀態。
提示範例:
- 「針對過去30天內建立的潛在客戶建立大量匯出」
- 「檢查匯出作業xx的狀態」
疑難排解
X-Marketo-Client-Id、X-Marketo-Client-Secret或X-Marketo-Munchkin-Id。Authorization標頭。安全性考量
- 每個要求的認證。 使用者端ID、使用者端密碼、Munchkin ID和REST API端點會隨每個請求以HTTP標頭傳輸。 伺服器不會儲存或快取它們。
- 多租使用者隔離。 每個請求都使用自己的認證集。 您的資料不會與任何其他使用者的工作階段相交。
- Munchkin ID允許清單。 伺服器只接受已核准Marketo執行個體的要求。 使用未經授權的Munchkin ID的請求會以403錯誤遭到拒絕。
- API速率限制。 MCP伺服器繼承Marketo執行個體的API速率限制。 使用專用的API使用者來追蹤及管理配額消耗。
- 讓認證不受版本控制。 如果您的AI工具支援,請使用環境變數內插(
${MARKETO_CLIENT_SECRET}),因此認證不會以純文字儲存在存放庫檔案中。