Ortto MCP Server

官方

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

造訪 ortto.com

文件

前往 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 速率限制。