Ortto MCP Server

官方

Ortto 的全新 MCP 伺服器可讓您將喜愛的 AI 助手連接到 Ortto。連接後，您的助手就能安全地存取 Ortto 客戶資料平台與行銷自動化平台中的客戶資料、受眾群體及行銷活動洞察。

造訪 ortto.com

你可以用 Ortto MCP 做什麼？

  • 擷取與篩選行銷活動 — 使用 get_campaigns 依類型、狀態或名稱查詢行銷活動。
  • 搜尋聯絡人與受眾 — 透過名稱或欄位尋找聯絡人，並使用 get_contacts 和 get_audiences 列出受眾。
  • 提取行銷活動成效報告 — 透過 get_email_report、get_journey_report、get_sms_report 及 get_push_report 取得電子郵件、旅程、簡訊或推播通知的分析資料。
  • 存取自訂報告 — 使用 list_reports 和 get_report 列出使用者建立的報告並擷取其資料。
  • 管理知識庫內容 — 透過 create_category、create_article_from_html 及 modify_index 建立分類、發布 HTML 文章並重新編排索引。
  • 檢視帳戶結構與品牌手冊 — 使用 get_schema 和 get_brand_book 擷取自訂欄位與品牌設定。

文件

前往 ortto.com

首頁 Ortto MCP Ortto MCP

Ortto MCP

什麼是 MCP？

模型上下文協定 (Model Context Protocol, MCP) 是一項開放標準，允許 AI 代理（如 Claude 或 ChatGPT）安全地與外部工具和資料來源互動。

您可以將 AI 代理（MCP 客戶端） 直接連接到 Ortto 的 MCP 伺服器。這讓您的代理能夠理解並處理您的 Ortto 資料。

接著，您的代理就能使用 自然語言提示 協助處理各種任務。例如：

  • 「顯示我過去 30 天電子郵件行銷活動的成效。」
  • 「哪些旅程在轉換方面表現最佳？」
  • 「給我一份本月參與度最高的聯絡人名單。」

設定 MCP 資料來源

要開始使用我們的 MCP 功能，您需要在 Ortto 帳戶中建立 MCP 作為資料來源。請按照以下步驟設定：

  1. 在您的 Ortto 帳戶中，導航至 CDP > 資料來源。
  2. 點擊 新增資料來源 並搜尋 MCP。
  3. 輸入您的 MCP 資料來源名稱，然後點擊 連接。

4. 資料來源建立後，您將獲得一個 限定範圍的金鑰 (Scoped key)。您需要使用此金鑰將 Ortto 連接到您選擇的 AI 代理（Claude、ChatGPT 等）。

現在您已準備好將 Ortto 連接到您的 AI 代理。根據您使用的 AI 代理，請查閱下方相應的文章：

  • 搭配 Claude 使用 Ortto MCP
  • 搭配 ChatGPT 使用 Ortto MCP

提示：您可以將 Ortto MCP 與任何支援自訂連接器的應用程式連接。如果您使用的應用程式未列於上方，只需根據您的 Ortto 帳戶託管位置，使用相應的 遠端 MCP 伺服器 URL。

  • 美國： https://mcp-api-us.ortto.app/mcp?jwt=your-scoped-key
  • 歐洲： https://mcp-api-eu.ortto.app/mcp?jwt=your-scoped-key
  • 澳洲： https://mcp-api-au.ortto.app/mcp?jwt=your-scoped-key

如果您不確定帳戶託管於何處，可以在應用程式內導航至 設定 > 隱私、安全與 GDPR > 資料託管 找到此資訊。

支援的工具/動作

Ortto MCP 伺服器允許 AI 代理透過特定的工具/動作與您的 Ortto 資料互動。以下表格按資料類別整理，詳細說明了支援的工具/動作及其定義。

提示：下方表格中列出的工具/動作僅是我們 MCP 功能使用的命名慣例。您無需在 AI 代理工具中明確使用這些名稱。您的代理將根據您的自然語言請求，自動選擇並使用適當的工具/動作。

行銷活動管理

工具/動作描述
get_campaigns擷取您的行銷活動列表，並提供篩選和分頁選項。支援按行銷活動類型、狀態和搜尋查詢進行篩選。

範例：

  • 「顯示我上個月所有的電子郵件行銷活動」
  • 「取得目前正在執行的行銷活動」
  • 「尋找名稱中包含 'summer' 的行銷活動」

聯絡人與受眾

工具/動作描述
get_contacts擷取聯絡人，提供全面的篩選選項，包括受眾 ID、欄位選擇和搜尋功能。
get_audiences列出您帳戶中的所有受眾，並支援搜尋和分頁功能。

範例：

  • 「擷取名稱中包含 'smith' 的任何聯絡人」
  • 「尋找成員少於 1,000 人的受眾」
  • 「顯示最後 10 位註冊聯絡人的電子郵件地址和姓名」

行銷活動報告

工具/動作描述
get_email_report產生詳細的電子郵件行銷活動成效報告，包括開啟率、點擊率和參與度指標。
get_journey_report取得全面的旅程成效分析，並提供可自訂的時間範圍。
get_journey_shape_report分析特定的旅程形狀及其指標。
get_sms_report擷取簡訊行銷活動成效資料和參與度統計數據。
get_push_report存取推播通知行銷活動分析和傳遞指標。

範例：

  • 「為 'Holiday Sale' 行銷活動產生電子郵件報告」
  • 「'Abandoned Cart' 旅程的整體成效如何？」

自訂報告

工具/動作描述
list_reports存取您 Ortto 帳戶中使用者建立的報告，並可按圖表類型和搜尋功能進行篩選。
get_report擷取特定的報告資料，並提供可自訂的時間範圍和重新整理選項。

範例：

  • 「列出我帳戶中所有的圓餅圖報告」
  • 「擷取 'Q3 Revenue' 報告的資料」

帳戶與設定

工具/動作描述
get_schema擷取您 Ortto 執行個體的完整資料結構描述，包括自訂欄位和資料結構。
get_brand_book存取您的品牌手冊設定，包括顏色、字型和品牌元素。

範例：

  • 「我們品牌手冊中定義的主要和次要品牌顏色是什麼？」
  • 「擷取我帳戶中名稱包含 'example' 的所有自訂欄位」

素材管理

工具/動作描述
create_asset建立新素材，主要是 HTML 電子郵件，並提供可自訂的內容和中繼資料。
get_asset_html擷取現有素材的 HTML 內容以供審查或修改。
update_asset_meta更新素材中繼資料，包括名稱、主旨行和寄件者資訊。

範例：

  • 「建立一個名為 'Can't Miss Savings' 的新促銷電子郵件素材，內容說明使用者為何不應錯過即將到來的促銷活動」
  • 「擷取名為 'Welcome Email v2' 的素材的 HTML 內容」

知識庫

工具/動作描述
get_index擷取知識庫結構，包括類別和文章階層。
create_category建立新的知識庫類別，並可選擇設定父子關係。
create_article_from_html從 HTML 內容建立知識庫文章並進行分類。
move_article在知識庫的類別之間移動文章。
modify_index更新知識庫索引結構和組織方式。

範例：

  • 「從此 HTML 產生一篇知識庫文章，並將其標題設為 'MCP Overview'」
  • 「建立一個名為 'Troubleshooting' 的新類別」
  • 「顯示目前的知識庫結構」

請求限制

當您透過 Ortto MCP 功能使用 AI 代理時，會遇到兩組不同的限制。雖然 AI 代理（如 Claude 或 ChatGPT）會強制執行其自身關於請求長度和回應大小的限制，但所有透過 Ortto MCP 伺服器路由的 API 呼叫都受到我們標準 Ortto API 速率限制的約束。這些速率限制根據您的訂閱方案適用，旨在確保系統穩定性和公平使用。

深入了解我們的 API 速率限制。