Telinfy MCP server
公式DLT準拠でSMS、WhatsApp、RCSメッセージをプログラムから送信できます。連絡先の管理、キャンペーンのスケジュール設定、配信レポートの追跡が可能です。
Telinfy MCPで何ができますか?
-
安全に認証する — アシスタントに
login_to_telinfyを使用してTelinfyのユーザー名とパスワードでログインさせ、セッションを確立します。 -
DLT準拠のSMSを送信する —
send_smsを使用して、送信者名とテンプレートIDを指定したトランザクショナルメッセージやプロモーショナルメッセージを送信します(例:「+919876543210にOTPを送信」)。 -
動的キャンペーンをスケジュールする —
scheduleDynamicCampaignを活用して、変数置換(例:名前、注文ID)を含むExcelファイルを使用したパーソナライズされた一括SMSを送信します。 -
連絡先グループを管理する —
create_phonebookで電話帳を作成し、get_phonebook_groupsでグループを一覧表示し、get_group_contactsとedit_contactで連絡先を表示または編集します。 -
WhatsAppキャンペーンを送信する — 事前作成済みのテンプレートを使用して
send_whatsapp_campaignで顧客にメッセージを送信し、fetch_whatsapp_smart_reportでパフォーマンスを追跡します。 -
配信レポートを取得する —
fetch_sms_campaign_report、fetch_rcs_report、またはgetMessageReportを使用して、日付フィルタリング付きでSMS、WhatsApp、RCSキャンペーンのレポートを取得します。
ドキュメント
Telinfy MCP 統合ガイド
AIアシスタントでTelinfy MCPサーバーに接続して使用する方法
Telinfy MCPサーバーは、TelinfyのSMS、WhatsApp、RCSメッセージング機能へのプログラムによるアクセスを提供し、AIアシスタントがあなたに代わってメッセージの送信、連絡先の管理、キャンペーンのスケジュール設定、レポートの取得を行うことを可能にします。
MCPとは?
Model Context Protocol(MCP)は、AIアプリケーションがMCP互換のデータソースやツールに安全に接続できるようにするオープン標準です。MCPはAIアプリケーションにとってのUSB-Cポートのようなものと考えてください。AIアプリをさまざまなサービスに接続するための標準化された方法です。
Telinfy MCPサーバー
Telinfy MCPサーバーは、Telinfyメッセージングプラットフォームへのアクセスを提供する、安全で認証付きのサービスです。
ベースサーバーURL: https://mcp.telinfy.com/sse
認証が必要です
Telinfy MCPサーバーを使用するには、以下が必要です:
- Telinfyユーザー名
- Telinfyパスワード
- API認証情報(ログイン後に自動的に取得されます)
利用可能なツール
Telinfy MCPサーバーは、包括的なメッセージングおよびキャンペーン管理ツールを提供します:
SMS操作
send_sms- DLT準拠のSMSメッセージを送信schedule_sms- 将来の配信のためにSMSキャンペーンをスケジュールscheduleDynamicCampaign- Excelファイルとテンプレート変数を使用して動的SMSキャンペーンをスケジュールget_sms_schedule- スケジュールされたすべてのSMSキャンペーンを表示fetch_sms_campaign_report- SMSキャンペーンの詳細レポートを取得
WhatsApp操作
send_whatsapp_campaign- 事前に作成されたテンプレートを使用してWhatsAppメッセージを送信whatsapp_campaign- すべてのWhatsAppキャンペーンを一覧表示fetch_whatsapp_smart_report- 日付フィルタリング付きでWhatsAppキャンペーンレポートを取得
RCS操作
fetch_rcs_report- 日付フィルタリング付きでRCSメッセージレポートを取得
連絡先管理
create_phonebook- 連絡先を含む新しい電話帳グループを作成get_phonebook_groups- すべての電話帳グループを一覧表示get_group_contacts- 特定のグループ内の連絡先を表示edit_contact- 連絡先情報を更新toggle_contact_status- グループ内の連絡先を有効/無効にするdelete_contact_group- 電話帳グループを削除
メッセージレポート
getMessageReport- 送信済みメッセージの配信レポートとステータスを取得
認証
login_to_telinfy- Telinfyプラットフォームで認証し、セッションを確立
ワイヤープロトコル
Telinfy MCPサーバーはSSE(Server-Sent Events)プロトコルを使用します:
SSE(Server-Sent Events)- /sse
- URL:
https://mcp.telinfy.com/sse - 公式MCP仕様バージョン
- Claude、Windsurf、Cursor、その他のMCPクライアントでサポート
- すべての統合に推奨
セットアップ手順
Claude Desktop/Webの場合:
- Claudeの設定に移動
- 「Integrations」または「Connections」に移動
- 以下の詳細で新しいMCPサーバーを追加:
- 名前: Telinfy
- サーバーURL:
https://mcp.telinfy.com/sse
- サーバーURL:
- 名前: Telinfy
- 設定を保存
Claude Code(コマンドライン)の場合:
claude mcp add -s user -t http telinfy https://mcp.telinfy.com/sse
Windsurf、Cursor、その他のMCPクライアントの場合:
この設定をMCP設定ファイルに追加します:
{
"mcpServers": {
"telinfy": {
"serverUrl": "https://mcp.telinfy.com/sse"
}
}
}
Telinfy MCPの使用
初期セットアップ
MCPサーバーに接続した後、Telinfyの認証情報で認証する必要があります:
Claude, please log me into Telinfy using my username and password.
AIアシスタントはlogin_to_telinfyツールを使用して安全なセッションを確立します。
使用例
SMSキャンペーンを送信
Send an SMS to +919876543210 with the message "Your OTP is 123456"
using sender name "NOTIFY" and template ID "1234567890"
マーケティングキャンペーンをスケジュール
Schedule an SMS campaign named "Weekend Sale" to be sent tomorrow at 10 AM
to these numbers: +919876543210, +919876543211 with the message
"Flash Sale this weekend! 50% off. Visit now."
連絡先グループを作成
Create a new phonebook group called "VIP Customers" with these contacts:
- John Doe, +919876543210
- Jane Smith, +919876543211
WhatsAppメッセージを送信
Send a WhatsApp campaign using my "order_confirmation" template
to +919876543210 with customer name "John" and order number "ORD123"
キャンペーンレポートを取得
Show me the SMS campaign report for campaign ID "12345"
メッセージ配信ステータスを取得
Get the delivery status for all messages sent today
主な機能
DLT準拠
すべてのSMSキャンペーンは、テンプレートIDと送信者名によるDLT(Distributed Ledger Technology)準拠をサポートし、インドでの規制遵守を保証します。
動的キャンペーン
変数置換を使用したExcelファイルでパーソナライズされたSMSキャンペーンをスケジュールできます。大量のパーソナライズメッセージに最適です。
マルチチャネルメッセージング
- SMS - プロモーション用およびトランザクション用ルート
- WhatsApp - テンプレートベースのビジネスメッセージング
- RCS - リッチコミュニケーションサービス
包括的なレポート
メッセージ配信、キャンペーンパフォーマンスを追跡し、日付フィルタリング付きの詳細レポートを生成します。
連絡先管理
連絡先をグループに整理し、連絡先を有効/無効にし、クリーンな電話帳リストを維持します。
セキュリティと認証
- すべてのAPI呼び出しはTelinfyの認証情報を使用して認証されます
- 初回ログイン後の安全なトークンベース認証
- セッションは会話の間維持されます
- AIアシスタントは認証情報を保存しません
サポートとリソース
- Telinfyダッシュボード: https://telinfy.com
- APIドキュメント: 詳細なAPIドキュメントについてはTelinfyサポートにお問い合わせください
- MCPプロトコル: https://modelcontextprotocol.io
- サポート: Telinfyのアカウントマネージャーにお問い合わせください
トラブルシューティング
認証の問題
ログインの問題が発生した場合:
- ユーザー名とパスワードが正しいことを確認
- アカウントでAPIアクセスが有効になっているか確認
- アカウントにMCPアクセスがあることを確認するためTelinfyサポートに連絡
接続の問題
MCPサーバーが接続しない場合:
- サーバーURLが正確に次の通りであることを確認:
https://mcp.telinfy.com/sse - インターネット接続を確認
- AIクライアント設定でMCPサーバーの再接続を試す
メッセージ配信の問題
メッセージが送信されない場合:
- Telinfyアカウントに十分なクレジットがあることを確認
- DLTテンプレートIDが正しく登録されていることを確認
- Telinfyアカウントで送信者名が承認されていることを確認
- 電話番号が正しい形式であることを確認
ベストプラクティス
- 常に最初にログイン - 各セッションの開始時に認証
- 正しいテンプレートIDを使用 - DLTテンプレートがメッセージ内容と一致することを確認
- 電話番号形式を確認 - 10桁のインド番号または国番号付きの国際形式を使用
- キャンペーンレポートを確認 - 配信ステータスを定期的に監視
- 連絡先を効率的に管理 - 電話帳グループを整理
- 一括送信前にテスト - 大規模キャンペーンの前にテストメッセージを送信
ワークフロー例
キャンペーン送信の完全なワークフローは次のとおりです:
- 認証
Log me into Telinfy with username "myuser" and password "mypass" - 連絡先グループを作成
Create a phonebook group "Spring Sale 2024" with my customer list - キャンペーンをスケジュール
Schedule an SMS campaign "Spring Sale Announcement" to the "Spring Sale 2024" group for tomorrow at 9 AM with message "Exclusive Spring Sale! 40% off all items. Shop now at example.com" using sender "RETAIL" and template "1234567890" - 結果を監視
Show me the delivery report for the Spring Sale campaign
高度な機能
動的変数置換
Excelファイルを使用して大規模にパーソナライズされたメッセージを送信:
- 列(Mobile、Name、OrderID、Amount)を含むExcelをアップロード
- 変数をマッピング:{{1}} = Name、{{2}} = OrderID、{{3}} = Amount
- テンプレート:「Hi {{1}}, your order {{2}} of Rs.{{3}} is confirmed」
マルチルートSMS
- ルート0: プロモーションメッセージ
- ルート1: トランザクションメッセージ(OTP、アラート)
Unicodeサポート
Unicodeモードを有効にすることで、地域言語でメッセージを送信できます。
開始チェックリスト
- Telinfy MCPサーバーをAIアシスタントに接続
- Telinfyの認証情報で認証
- アクティブな送信者名とDLTテンプレートがあることを確認
- アカウント残高とクレジットを確認
- 一括キャンペーンの前に単一のSMSでテスト
- 整理された電話帳グループを作成
- 最適なタイミングでスケジュールキャンペーンを設定
- レポートを定期的に監視
詳細なAPI仕様とパラメータリファレンスについては、Telinfy APIドキュメントを参照するか、アカウントマネージャーにお問い合わせください。