Telerivet MCP
官方在 150 多個國家傳送並自動化 SMS、WhatsApp、Viber、IVR 和 USSD 訊息。
你可以用 Telerivet MCP 做什麼？
- 傳送或排程訊息 — 要求助理向聯絡人或群組傳送或排程傳送文字訊息，預設需要取得核准。
- 查詢專案資料 — 透過唯讀 API 方法擷取聯絡人、訊息、統計資料及其他專案資料。
- 擬定訊息以供審閱 — 使用
draft_message顯示可編輯的草稿及收件者，讓您在傳送前核准確切的訊息內容。 - 執行大量作業指令碼 — 使用
run_script在 Telerivet 的 Cloud Script 沙箱中執行大量作業，而非逐一呼叫多個 API。 - 經核准後刪除資料 — 透過
delete_api移除聯絡人、訊息或其他專案資料，並遵循您組織的核准設定。 - 尋找路由與文件 — 查詢訊息路由選項、解決方案模式及 Telerivet 文件，以規劃設定方式。
託管 MCP 伺服器
npx add-mcp 'https://api.telerivet.com/mcp'可安裝到 Claude Code、Codex、Cursor 等客戶端
文件
Telerivet 提供一個 Model Context Protocol (MCP) 伺服器，讓 AI 代理程式和以 LLM 為基礎的工具（例如 Claude 和 ChatGPT）透過標準 MCP 介面與 Telerivet REST API 互動。
Telerivet 的 MCP 伺服器可讓 AI 代理程式在 Telerivet 中執行各種操作，包括傳送和排程訊息、擷取資料和使用統計資料、匯入聯絡人，以及設定專案、路由和自動化服務。
MCP 端點位於：
MCP 用戶端透過 Streamable HTTP 傳輸，使用 HTTP POST 要求傳送 JSON-RPC 2.0 訊息進行連線。
用戶端設定
MCP 端點需要透過 OAuth 2.0 進行驗證。
支援 OAuth Client ID Metadata Documents (CIMD) 的 MCP 用戶端無需任何手動設定即可連線：使用者首次授權時，Telerivet 會自動註冊用戶端。Telerivet 不支援 Dynamic Client Registration。
以下 MCP 用戶端提供設定說明：
- Claude（claude.ai 和 Claude Desktop）
- Claude Code
- ChatGPT
- Codex
- Antigravity CLI
- Hermes Agent
對於不支援 Client ID Metadata Documents 的 MCP 用戶端，必須手動設定 OAuth Client。若要使用其他不支援 CIMD 的 MCP 用戶端，您可以在 Telerivet 組織中新增 OAuth Client，並設定 MCP 用戶端所需的 OAuth 回呼 URL。（提供 MCP 用戶端的服務可能會在其文件中列出 OAuth 回呼 URL。）以此方式手動設定的 OAuth Client 只能由您自己的 Telerivet 組織中的使用者存取。
授權 MCP 用戶端
連線 MCP 用戶端時，系統會將您重新導向至 Telerivet，以授權存取。在此頁面中，您可以選擇：
- 權限 – 應用程式可存取的資料和執行的操作類型（例如，檢視訊息、傳送訊息或編輯自動化服務）。取消勾選您不希望授予應用程式的任何權限。應用程式能執行的操作不會超出您自己的使用者帳戶權限，而需要您未授予之權限的 API 方法會對 MCP 用戶端隱藏。
- 組織 – 應用程式可存取的組織。每次授權僅適用於一個組織；若要在另一個組織中使用該應用程式，請重新連線。
核准組織的應用程式。 每個 MCP 用戶端（例如 Claude 或 ChatGPT）都必須先由組織管理員核准，才能在組織中使用。如果您是組織管理員，授權頁面會讓您核准該應用程式供組織使用，並選擇誰可以使用此應用程式？：組織中的所有使用者、僅組織管理員，或組織管理員和專案管理員。其他使用者會看到訊息，請他們聯絡組織管理員以核准該應用程式。
撤銷存取權。 您可以隨時在帳戶安全性設定中的已授權的應用程式區段，撤銷應用程式對您帳戶的存取權。組織管理員可以在OAuth 存取權杖頁面檢視並撤銷所有使用者的存取權杖，或在已連線的應用程式頁面完全撤銷應用程式的存取權。
組織控制項
組織管理員可以在已連線的應用程式頁面（也可從組織的 Developer API 頁面前往）控制每個已核准的 MCP 用戶端在組織中可執行的操作。按一下應用程式即可檢視或變更其設定。這些設定適用於組織中所有使用者對該應用程式的存取，不受使用者連線時授予的權限影響。
必要權限 – 組織中哪些使用者可以授權該應用程式（所有使用者、僅組織管理員，或組織管理員和專案管理員）。
允許的操作 – 對於每個操作類別，設定應用程式是否可自行執行、是否必須由使用者核准每項操作，或完全不允許：
| 操作 | 說明 | 選項 | 預設值 |
|---|---|---|---|
| 讀取資料 | 查詢聯絡人、訊息、統計資料和其他專案資料。 | 允許、不允許 | 允許 |
| 建立和更新資料 | 建立和編輯聯絡人、群組、服務、草稿行銷活動、路由和其他專案資料。 | 允許、需要核准、不允許 | 允許 |
| 傳送訊息和觸發服務 | 傳送或排程傳送訊息和通話給聯絡人、觸發自動化服務，以及執行指令碼。 | 允許、需要核准、不允許 | 需要核准 |
| 刪除資料 | 刪除聯絡人、訊息、服務和其他專案資料。 | 允許、需要核准、不允許 | 需要核准 |
| 發出外部網頁要求 | 從此應用程式執行的指令碼向外部網站和第三方 API 發出要求。 | 允許、不允許 | 允許 |
當某個類別設為不允許時，對應的 MCP 工具（例如 send_api 或 delete_api）會對 MCP 用戶端隱藏，且該類別中的任何 API 要求都會遭到拒絕。run_script 工具會採用傳送、建立／更新和刪除資料這幾類設定中最嚴格的一項。
有些應用程式會指定自己的預設值，例如需要在沒有使用者在場時傳送訊息的自主代理程式。當應用程式的預設值與標準預設值不同時，「已連線的應用程式」頁面會在設定旁註明該應用程式的預設值。您組織的設定一律優先。
允許的權限 – 應用程式在此組織中可存取的資料和執行的操作類型。取消勾選某項權限會封鎖該應用程式在組織中所有使用者的對應 API 操作，即使使用者連線時已授予該權限也一樣。
撤銷存取權 – 將應用程式從組織的已核准應用程式中移除，並撤銷該應用程式在組織中的所有現有存取權杖。
由您自己的組織擁有的應用程式（透過新增 OAuth Client加入）不需要核准，其允許的操作則是在應用程式自己的設定頁面中設定。
人機協同確認
當已連線的應用程式頁面中的某個操作類別設為需要核准時，MCP 用戶端必須先取得使用者對每項操作的明確核准，才能執行該操作。預設情況下，這適用於傳送訊息和觸發服務，以及刪除資料。
傳送類別中的操作包括傳送或排程傳送訊息和通話、重新傳送訊息、觸發自動化服務、建立批次工作、模擬收到的訊息、編輯已排程的訊息或行銷活動、啟用自動化服務或變更啟用中服務的設定、建立 webhook 或變更 webhook URL、變更路由的電話號碼或供應商設定、變更專案的預設路由，以及使用 run_script 工具執行指令碼。刪除類別包括所有刪除方法，以及縮短專案的訊息保留期限。
視 MCP 用戶端而定，您可以透過以下其中一種方式核准操作：
MCP 用戶端中的核准提示
如果 MCP 用戶端支援 MCP elicitation（使用 MCP 通訊協定版本 2026-07-28 或更新版本），MCP 用戶端會直接提示您核准操作，並以淺白易懂的語言說明操作內容及其影響的專案。如果您核准，操作會立即執行。如果您拒絕，操作就不會執行，且 AI 模型會收到不得重試的指示。
訊息草稿
如果 MCP 用戶端支援 MCP Apps 擴充功能，AI 模型可以使用 draft_message 工具，向您顯示可編輯的文字訊息草稿，包括收件者。按一下傳送即可核准將該訊息原封不動地傳送給這些收件者。
核准連結
如果 MCP 用戶端不支援上述任一方式，或操作無法透過這些方式核准，AI 模型會收到 Telerivet 網頁應用程式中核准操作頁面的連結，並應請您開啟該頁面。此頁面會顯示應用程式、專案、操作說明和完整要求詳細資料。按一下核准後，返回 MCP 用戶端並要求其重試。
若要核准操作，您必須擁有該操作本身所需的權限（例如，在專案中傳送訊息的權限）。核准操作不會授予應用程式任何額外權限。
核准的運作方式
- 每次核准僅適用於一項完全相同的要求，也就是相同的 API 方法和參數，且只能使用一次。如果 AI 模型變更要求中的任何內容，就必須重新核准。
- 核准會在 1 小時後到期。
- 透過
run_script核准的指令碼所發出的 API 要求不需要另外核准。 - 如果應用程式使用其存取權杖直接呼叫 REST API（而非透過 MCP），需要核准的要求會以錯誤碼
confirmation_required失敗，且錯誤訊息會包含核准連結。若應用程式需要在沒有使用者在場時執行這些操作（例如伺服器端整合或自主代理程式），組織管理員必須將該類別設為允許。
訊息審核。 除上述設定外，如果專案在訊息設定中啟用了訊息審核，透過 API（包括 MCP）傳送且超出已設定限制的訊息會暫時保留為待審核訊息，直到審核者核准為止，與從網頁應用程式傳送的訊息相同。
工具
MCP 伺服器目前提供以下工具：
- list_api_methods – 列出可用的 API 方法，並提供名稱、說明和參數摘要。支援依類別篩選。
- get_method_schema – 傳回特定 API 方法的完整參數結構描述和回應欄位說明。
- read_api – 執行唯讀 API 方法以擷取資料。
- modify_api – 執行會建立或更新資料的 API 方法。
- delete_api – 執行會刪除資料的 API 方法。
- send_api – 執行會傳送、排程或接收訊息、呼叫自動化服務，或執行批次工作的 API 方法。
- run_analysis_script – 在 Telerivet 的 Cloud Script API 沙箱中執行唯讀 JavaScript，以分析專案資料；適用於彙總、跨實體類型聯結，或掃描大量記錄，而不必透過模型逐頁讀取。API 存取權為唯讀，且停用對外 HTTP。
- run_script – 執行可存取 Cloud Script API 的 JavaScript（讀取、寫入、傳送、HTTP 請求），適用於原本需要多次個別 API 呼叫的批次作業。指令碼發出的 API 請求會依據 OAuth 權杖的範圍進行檢查，因此指令碼的權限不會超過執行它的權杖。
- get_web_app_urls – 傳回網頁應用程式功能和 URL 模式的相關資訊。讓 AI 代理程式能夠產生連結，連至無法直接透過 API 使用的功能。未提供查詢時，會傳回所有頁面的精簡索引；依關鍵字或 URL 路徑搜尋時，則會傳回符合頁面的完整詳細資訊。
- draft_message – 為一或多個電話號碼（或一組聯絡人）草擬簡單的文字訊息，並在傳送前提示使用者核准（請參閱訊息草稿）。僅適用於支援 MCP Apps 擴充功能的 MCP 用戶端。
- get_route_options – 傳回可用訊息路由／通道選項的相關資訊。依國家、通道類型或用途篩選（或查詢特定路由類型）時，會傳回完整詳細資訊，包括地理區域可用性、合規要求、註冊流程、計費模式（內部／由 Telerivet 管理與外部／自帶供應商（BYOC））、設定時程和定價。
- skillbook_search / skillbook_get – 傳回符合意圖或用途的常見解決方案模式、服務、行銷活動類型、平台功能和訊息範本相關資訊。
- search_documentation / get_documentation – 搜尋並擷取 Telerivet 文件庫中的項目，包括使用者指南說明文章、法律／政策頁面、開發者 API 文件，以及 www.telerivet.com 上的行銷／公司內容。
MCP 伺服器公開的工具和 API 方法可能會隨時間變更。
以下連結會顯示 MCP 伺服器傳回的 JSON，有助於瞭解可用的工具和 API 方法：
- 工具定義
- list_api_methods 工具的輸出
- get_method_schema 工具對 Project_queryContacts 方法的輸出（替換 URL 的最後一個部分，即可查看其他 API 方法的結構描述）
- get_documentation 工具對 Cloud Script API 參考文件的輸出（替換 URL 的最後一個部分，即可查看其他文件項目）
授予 OAuth 權杖的範圍，以及貴組織針對此應用程式設定的控制項，會決定可使用哪些工具和 API 方法。若方法所需的範圍不在權杖的授權範圍內，或貴組織不允許此應用程式使用該方法，該方法就不會列入清單。