[有限可用性]{class="badge informative" title="此功能目前在有限測試版中提供"}

Marketo Engage MCP伺服器

AVAILABILITY
此功能限時提供。 若要要求存取權,請填寫此表單。 請確定您已準備好訂閱的Munchkin ID。

模型上下文通訊協定(MCP)是一種開放標準,可讓AI工具與外部服務通訊。 Marketo MCP伺服器可作為您的AI助理與Marketo之間的橋樑。 它會公開超過100項操作,涵蓋表單、方案、智慧行銷活動、銷售機會、電子郵件、代碼片段、清單和資料夾。

當您的AI工具呼叫MCP伺服器時,伺服器會使用您在每個請求中提供的認證,代表您執行相對應的REST API呼叫。 您不需要安裝、部署或執行任何伺服器端軟體。

IMPORTANT
模型內容通訊協定(MCP)是一種新興的開放原始碼標準,可能會帶來安全性或可靠性風險。Adobe MCP伺服器整合和相關檔案係依「現況」提供,不提供任何形式的保證。
將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和使用者端密碼

  1. 前往​Admin > LaunchPoint
  2. 選取您的API服務。 如果您沒有這類服務,請選取​New > New Service,選擇​ Custom ​做為服務型別,並指派專用的API使用者。
  3. 選取​ View Details ​並複製​ Client ID ​和​ Client Secret ​值。

Munchkin帳戶ID

  1. 前往​Admin > Munchkin
  2. 複製​Munchkin Account ID。 格式為XXX-XXX-XXX,且符合執行個體URL的前置詞。

設定您的AI工具

每個AI工具的設定稍有不同。 提供常用工具的連線範例。

TIP
若要連線到多個Marketo執行個體,請在您的MCP設定中新增具有唯一名稱的個別專案: marketo-prodmarketo-staging,每個專案都有對應的認證。

克勞德案頭 claude-desktop

若要連線到Claude Desktop,請下載marketo-mcp-bridge.zip並將其解壓縮。 將marketo-mcp-bridge.mjs放入已知位置,以便在下一個步驟中參照。

您還需要:

  • Node.js v18+
  • npm
  1. 開啟Claude Desktop
  2. 移至​設定>開發人員>編輯設定
  3. 將下列專案新增至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>"
      }
    }
  }
}
  1. 重新啟動Claude Desktop

游標 cursor

如果您的游標MCP組態已經包含其他伺服器,請在mcpServers下新增marketo專案。
下列範例顯示專案目錄中​Settings > MCP​或.cursor/mcp.json中的完整mcpServers區塊:

IMS權杖
code language-json
{
  "mcpServers": {
    "marketo": {
      "type": "http",
      "url": "https://marketo-mcp.adobe.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR-IMS-TOKEN",
        "x-gw-ims-org-id": "YOUR-IMS-ORG-ID"
      }
    }
  }
}
Marketo使用者端認證
code language-json
{
  "mcpServers": {
    "marketo": {
      "type": "http",
      "url": "https://marketo-mcp.adobe.io/mcp",
      "headers": {
        "X-Marketo-Client-Id": "YOUR-CLIENT-ID",
        "X-Marketo-Client-Secret": "YOUR-CLIENT-SECRET",
        "X-Marketo-Munchkin-Id": "YOUR-MUNCHKIN-ID"
      }
    }
  }
}

重新啟動游標。

克勞德程式碼(CLI) claude-code

在終端機中執行以下命令,取代您的認證:

IMS權杖
code language-bash
claude mcp add --transport http marketo \
  https://marketo-mcp.adobe.io/mcp \
  --header "Authorization: Bearer YOUR-IMS-TOKEN" \
  --header "x-gw-ims-org-id: YOUR-IMS-ORG-ID"
Marketo使用者端認證
code language-bash
claude mcp add --transport http marketo \
  https://marketo-mcp.adobe.io/mcp \
  --header "X-Marketo-Client-Id: YOUR-CLIENT-ID" \
  --header "X-Marketo-Client-Secret: YOUR-CLIENT-SECRET" \
  --header "X-Marketo-Munchkin-Id: YOUR-MUNCHKIN-ID"

OpenAI程式碼 codex

  1. 前往「設定> MCP伺服器>新增伺服器」
  2. 新增伺服器URL: https://marketo-mcp.adobe.io/mcp
  3. 新增驗證方法的標頭:
IMS權杖
  • 授權:「持有人YOUR-IMS-TOKEN」
  • x-gw-ims-org-id: “YOUR-IMS-ORG-ID”
Marketo使用者端認證
  • X-Marketo-Client-Id: “YOUR-CLIENT-ID”
  • X-Marketo-Client-Secret: “YOUR-CLIENT-SECRET”
  • X-Marketo-Munchkin-Id: “YOUR-MUNCHKIN-ID”
  1. 按一下儲存,即可完成此程式。

VS程式碼與GitHub Copilot vscode

按​Ctrl+Shift+P (或macOS上的​Cmd+Shift+P),輸入​MCP: Open User Configuration,然後按Enter。 這會開啟mcp.json。 在servers物件中新增marketo專案:

IMS權杖
code language-json
{
  "servers": {
    "marketo": {
      "type": "http",
      "url": "https://marketo-mcp.adobe.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR-IMS-TOKEN",
        "x-gw-ims-org-id": "YOUR-IMS-ORG-ID"
      }
    }
  }
}
Marketo使用者端認證
code language-json
{
  "servers": {
    "marketo": {
      "type": "http",
      "url": "https://marketo-mcp.adobe.io/mcp",
      "headers": {
        "X-Marketo-Client-Id": "YOUR-CLIENT-ID",
        "X-Marketo-Client-Secret": "YOUR-CLIENT-SECRET",
        "X-Marketo-Munchkin-Id": "YOUR-MUNCHKIN-ID"
      }
    }
  }
}
NOTE
為安全起見,請在設定檔案中使用環境變數內插,而非直接貼上認證。 您可以使用如${MARKETO_CLIENT_SECRET}的語法參考變數,並在您的環境中設定它們。 這可防止憑證以純文字形式儲存在版本控制的檔案中。

其他工具 other-tools

Marketo MCP伺服器由Adobe代管,並在公用URL上公開。任何透過可串流的HTTP傳輸支援遠端伺服器的MCP使用者端都可以連線到它。
您不需要工具專用的橋接器或任何本機安裝的軟體。如果您的工具未在上方列出,請使用下方的連線詳細資料來手動設定。

連線詳細資料:

設定
傳輸
HTTP (可串流HTTP)
伺服器URL
https://marketo-mcp.adobe.io/mcp

驗證標頭:

針對每個請求的下列驗證方法之一,傳送標頭。 您在其中輸入伺服器URL和標題取決於您的工具,因此請參閱其MCP檔案。

IMS權杖
table 0-row-2 1-row-2 2-row-2
標頭
Authorization Bearer YOUR-IMS-TOKEN
x-gw-ims-org-id 您的IMS組織ID
Marketo使用者端認證
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設定,請從CursorVS Code範例開始,並調整金鑰(mcpServersservers)以符合您工具的結構描述。

可用的作業

連線之後,您可以要求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的狀態」

疑難排解

錯誤
原因
修正
「未提供Marketo認證」
遺失一或多個X-Marketo-Client-IdX-Marketo-Client-SecretX-Marketo-Munchkin-Id
確認您的設定中存在所有Marketo使用者端認證標頭。
「401未獲授權」
您的認證遺失、無效或過期。 若使用Marketo使用者端憑證,使用者端ID或使用者端密碼不正確。 若使用IMS權杖,該權杖無效或過期。
驗證驗證方法的認證。 若要取得使用者端認證,請在​Admin > LaunchPoint​中重新檢查​ Client ID ​和​Client Secret。 針對IMS權杖,產生新權杖並更新Authorization標頭。
「403禁止存取」
您的認證有效,但您的Marketo執行個體未啟用MCP存取。
請連絡您的Marketo MCP管理員,為您的Munchkin帳戶ID啟用MCP存取權。
「請求太多」(速率限制)
您在短時間內傳送過多請求,或同時傳送過多請求,且已達您的Marketo執行個體的API限制。
減少您一次傳送的頻率與要求數,並在重試之前等候一小段時間。 使用專用的API使用者來追蹤及管理您的配額。
連線逾時或已拒絕
無法從您的網路連線MCP伺服器。
確認您可以從您的環境連線到伺服器URL。 檢查VPN需求(如果適用)。
工具呼叫傳回空白結果
API使用者缺少請求資產型別的許可權。
請要求您的Marketo管理員檢閱API使用者角色和許可權。

安全性考量

IMPORTANT
在Marketo中使用只有您工作所需許可權的專用API使用者。 請勿重複使用管理員認證來存取API。
  • 每個要求的認證。 使用者端ID、使用者端密碼、Munchkin ID和REST API端點會隨每個請求以HTTP標頭傳輸。 伺服器不會儲存或快取它們。
  • 多租使用者隔離。 每個請求都使用自己的認證集。 您的資料不會與任何其他使用者的工作階段相交。
  • Munchkin ID允許清單。 伺服器只接受已核准Marketo執行個體的要求。 使用未經授權的Munchkin ID的請求會以403錯誤遭到拒絕。
  • API速率限制。 MCP伺服器繼承Marketo執行個體的API速率限制。 使用專用的API使用者來追蹤及管理配額消耗。
  • 讓認證不受版本控制。 如果您的AI工具支援,請使用環境變數內插(${MARKETO_CLIENT_SECRET}),因此認證不會以純文字儲存在存放庫檔案中。
recommendation-more-help
marketo-developer-help