Telerivet MCP

公式

150か国以上でSMS、WhatsApp、Viber、IVR、USSDメッセージを送信・自動化できます。

telerivet.com で表示

Telerivet MCPで何ができますか？

  • メッセージの送信または予約 — アシスタントに、連絡先やグループへのテキストメッセージの送信または予約を依頼できます。デフォルトでは承認が必要です。
  • プロジェクトデータの検索 — 読み取り専用の API メソッドを通じて、連絡先、メッセージ、統計情報などのプロジェクトデータを取得します。
  • 確認用メッセージの下書き作成 — draft_message を使って、受信者を含む編集可能な下書きを表示し、送信前にメッセージの内容を確認して承認できます。
  • 一括スクリプトの実行 — 多数の個別 API 呼び出しの代わりに、run_script を使って Telerivet の Cloud Script サンドボックスで一括操作を実行します。
  • 承認を得てデータを削除 — 組織の承認設定に従い、delete_api を通じて連絡先、メッセージ、その他のプロジェクトデータを削除します。
  • ルートとドキュメントの検索 — メッセージングルートの選択肢、ソリューションのパターン、Telerivet のドキュメントを調べ、セットアップを計画します。

ホスト型 MCP サーバー

npx add-mcp 'https://api.telerivet.com/mcp'

Claude Code、Codex、Cursor などにインストールできます

ドキュメント

Telerivet は、Model Context Protocol (MCP) サーバーを提供しています。このサーバーを使うと、Claude や ChatGPT などの AI エージェントや LLM ベースのツールが、標準の MCP インターフェースを通じて Telerivet REST API を操作できます。

Telerivet の MCP サーバーを使うと、AI エージェントは Telerivet 内でさまざまな操作を実行できます。メッセージの送信や予約、データや利用統計の取得、連絡先のインポート、プロジェクト、ルート、自動サービスの設定などが可能です。

MCP エンドポイントは次のとおりです。

https://api.telerivet.com/mcp

MCP クライアントは、HTTP POST リクエストを介して JSON-RPC 2.0 メッセージを送信する Streamable HTTP トランスポートで接続します。

クライアントの設定

MCP エンドポイントへの接続には OAuth 2.0 認証が必要です。

OAuth Client ID Metadata Documents (CIMD) に対応する MCP クライアントは、手動設定なしで接続できます。ユーザーが初めて認可すると、Telerivet が自動的に登録します。Telerivet は Dynamic Client Registration に対応していません。

次の MCP クライアントの設定手順を参照してください。

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 クライアントが組織内で実行できる操作を制御できます。アプリケーションをクリックすると、設定を表示または変更できます。これらの設定は、ユーザーが接続時に付与した権限にかかわらず、組織内のすべてのユーザーによるそのアプリケーションへのアクセスに適用されます。

必須の権限 – 組織内でアプリケーションを認可できるユーザー（全ユーザー、組織管理者のみ、または組織管理者とプロジェクト管理者のみ）。

許可される操作 – 操作カテゴリごとに、アプリケーション単独で実行できるか、ユーザーによる各操作の承認が必要か、または一切許可されないかを設定します。

操作説明選択肢デフォルト
データの読み取り連絡先、メッセージ、統計情報、その他のプロジェクトデータの検索。許可、許可しない許可
データの作成と更新連絡先、グループ、サービス、下書きキャンペーン、ルート、その他のプロジェクトデータの作成と編集。許可、承認を必須にする、許可しない許可
メッセージの送信とサービスの実行連絡先へのメッセージや通話の送信または予約、自動サービスの実行、スクリプトの実行。許可、承認を必須にする、許可しない承認を必須にする
データの削除連絡先、メッセージ、サービス、その他のプロジェクトデータの削除。許可、承認を必須にする、許可しない承認を必須にする
外部 Web リクエストの実行このアプリケーションが実行するスクリプトから、外部 Web サイトやサードパーティ API にリクエストを送信すること。許可、許可しない許可

カテゴリが許可しないに設定されている場合、対応する MCP ツール（send_api や delete_api など）は MCP クライアントから非表示になり、そのカテゴリに属する API リクエストは拒否されます。run_script ツールには、メッセージの送信、データの作成・更新、データの削除のうち、最も厳しい設定が適用されます。

アプリケーションによっては、独自のデフォルト設定が指定されています。たとえば、ユーザーがその場にいなくてもメッセージを送信する必要がある自律型エージェントなどです。アプリケーションのデフォルトが標準のデフォルトと異なる場合、接続済みアプリケーションページに、設定の横にアプリケーションのデフォルトが表示されます。常に組織の設定が優先されます。

許可される権限 – アプリケーションがこの組織でアクセスできるデータや実行できる操作の種類。権限のチェックを外すと、ユーザーが接続時にその権限を付与していても、組織内のすべてのアプリケーションユーザーについて、対応する API 操作がブロックされます。

アクセスの取り消し – アプリケーションを組織の承認済みアプリケーションから削除し、組織内でそのアプリケーションに発行済みのすべてのアクセストークンを取り消します。

自組織が所有するアプリケーション（OAuth Client の追加から追加したもの）は承認不要です。許可される操作は、アプリケーション固有の設定ページで設定します。

Human-in-the-Loop による確認

接続済みアプリケーションページで操作カテゴリが承認を必須にするに設定されている場合、ユーザーが各操作を明示的に承認するまで、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 Web アプリの操作の承認ページへのリンクが渡されるため、ページを開くよう求められます。このページには、アプリケーション、プロジェクト、操作の説明、リクエストの詳細がすべて表示されます。承認をクリックした後、MCP クライアントに戻り、再試行するよう指示してください。

操作を承認するには、その操作自体に必要な権限（例：プロジェクトでメッセージを送信する権限）が必要です。操作を承認しても、アプリケーションに追加の権限が付与されることはありません。

承認の仕組み

  • 承認は、同じ API メソッドと同じパラメーターを使う特定のリクエスト 1 件にのみ適用され、1 回だけ使用できます。AI モデルがリクエストの内容を少しでも変更した場合は、再度承認が必要です。
  • 承認の有効期限は 1 時間です。
  • run_script を介して承認したスクリプトが行う API リクエストには、個別の承認は必要ありません。
  • アプリケーションが MCP を介さず、アクセストークンを使って REST API を直接呼び出した場合、承認が必要なリクエストはエラーコード confirmation_required で失敗し、エラーメッセージに承認リンクが含まれます。ユーザーがその場にいない状態でこれらの操作を実行する必要があるアプリケーション（サーバーサイドの連携や自律型エージェントなど）では、組織管理者が該当カテゴリを許可に設定する必要があります。

メッセージのレビュー。 上記とは別に、プロジェクトのメッセージ設定でメッセージのレビューが有効になっている場合、設定済みの上限を超える API 経由（MCP 経由を含む）の送信メッセージは、レビュー担当者が承認するまで保留中のメッセージとして扱われます。これは Web アプリから送信されたメッセージと同じ動作です。

ツール

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 – Web アプリの機能と URL パターンに関する情報を返します。AI エージェントが API から直接利用できない機能へのリンクを生成できるようにします。クエリを指定しない場合は、すべてのページの簡潔なインデックスを返します。キーワードまたは URL パスで検索すると、一致するページの詳細を返します。
  • draft_message – 1 つ以上の電話番号（または連絡先グループ）宛ての簡単なテキストメッセージを下書きし、送信前にユーザーの承認を求めます（メッセージの下書きを参照）。MCP クライアントが MCP Apps 拡張機能に対応している場合にのみ利用できます。
  • get_route_options – 利用可能なメッセージングのルート／チャネルオプションに関する情報を返します。国、チャネルタイプ、用途による絞り込み（または特定のルートタイプの検索）を行うと、地域ごとの利用可否、コンプライアンス要件、登録手順、課金方式（内部／Telerivet 管理または外部／BYOC）、設定にかかる期間、料金などの詳細を返します。
  • skillbook_search / skillbook_get – 意図または用途に一致する、一般的なソリューションパターン、サービス、キャンペーンタイプ、プラットフォーム機能、メッセージテンプレートに関する情報を返します。
  • search_documentation / get_documentation – ユーザーガイドのヘルプ記事、法務／ポリシーページ、開発者向け API ドキュメント、www.telerivet.com のマーケティング／会社情報など、Telerivet のドキュメントコーパスから項目を検索して取得します。

MCP サーバーが公開するツールと API メソッドは、時間の経過とともに変更される場合があります。

以下のリンクには MCP サーバーが返す JSON が表示されており、利用可能なツールと API メソッドを把握するのに役立ちます。

OAuth トークンに付与されたスコープと、アプリケーションに対する組織の制御によって、利用可能なツールと API メソッドが決まります。トークンにないスコープを必要とするメソッドや、組織がアプリケーションに対して許可していないメソッドは、一覧から除外されます。