Sinch Engage / MessageMedia MCP server
公式Sinch Engage(オーストラリアではSinch MessageMedia)MCPサーバー。Sinch Engage APIをMCPツールとして提供します。
Sinch Engage MessageMedia MCPで何ができますか?
- Send SMS messages — アシスタントに、
sendMessageを使用してE.164形式の任意の携帯電話番号へSMSを送信するよう依頼します。 - Generate message reports —
getDetailedMessageReportまたはgetSummaryMessageReportを使用して、指定した日付範囲の送受信メッセージの詳細レポートまたは要約レポートを要求します。 - Manage contact groups —
createContactGroup、getContactGroups、またはdeleteContactGroupを使用して、連絡先グループ(リスト)を作成、表示、または削除します。 - Search and update contacts — グループ、電話番号、または名前で連絡先を検索し、
getContactWithSearchとupdateContactを使用して詳細を更新します。 - Track async report status — レポートIDを指定して
getAsyncReportStatusを使用し、非同期レポートリクエストの進行状況を確認します。
ドキュメント
Sinch Engage MCP サーバー
非推奨のお知らせ。 このMCPサーバーは非推奨となり、2026年11月30日にサポート終了となります。新規インテグレーションには使用しないでください。代替サーバーについては、Connect to the Sinch Engage MCP (AU) を参照してください。このパッケージとリポジトリは、既存のインストール向けにその日まで保持され、それ以上の機能開発は予定されていません。
このリポジトリには、Sinch Engage(オーストラリアではSinch MessageMedia)MCPサーバーのソースコードが含まれており、Sinch Engage APIをMCPツールとして提供します。
ツール概要
MCPサーバーで利用可能なツールの一覧は以下のとおりです(すべての電話番号はE.164形式で指定する必要があります。例:オーストラリアの場合は +61400000000)。
メッセージング
| ツール | 説明 | カテゴリ | モード |
|---|---|---|---|
| sendMessage | 携帯電話番号にSMSを送信します | messaging | write |
レポーティング
| ツール | 説明 | カテゴリ | モード |
|---|---|---|---|
| getDetailedMessageReport | 指定した日付範囲の送受信メッセージの詳細レポートを生成します。方向、アカウント、メタデータ、グループ化のオプションフィルターに対応しています。 | reporting | read |
| getSummaryMessageReport | 指定した日付範囲の送受信メッセージのサマリーレポートを生成します。方向、アカウント、グループ化のオプションフィルターに対応しています。 | reporting | read |
| getSummaryInsightMessageReport | 指定した日付範囲の送受信メッセージの事前コンパイル済みサマリーレポートを取得します。方向、アカウント、グループ化のオプションフィルターに対応しています。 | reporting | read |
| getAsyncReportStatus | report_id を使用して非同期レポートリクエストのステータスを取得します。 | reporting | read |
| getAsyncReportFields | 非同期詳細レポートのエクスポートで利用可能なフィールドの一覧を取得します。 | reporting | read |
| requestAsyncDetailedMessageReport | 指定した日付範囲の送受信メッセージの非同期詳細レポートをリクエストします。レポート形式と宛先の配信オプションに対応しています。 | reporting | read |
コンタクト
| ツール | 説明 | カテゴリ | モード |
|---|---|---|---|
| getContactGroups | アカウントに関連付けられたコンタクトグループ(リスト)のページングされた一覧を取得します。 | reporting | read |
| getContactGroupDetails | group_id で識別される特定のコンタクトグループ(リスト)の詳細を取得します。 | reporting | read |
| getContactWithSearch | グループ、電話番号、名前、チャネルタイプでフィルタリング可能なコンタクトの一覧を取得します。 | reporting | read |
| createContactGroup | 指定した名前とオプションのエイリアスで新しいコンタクトグループ(リスト)を作成します。 | reporting | write |
| createContact | 指定した詳細で新しいコンタクトを作成します。 | reporting | write |
| updateContact | contact_id で識別される既存のコンタクトを新しい詳細で更新します。 | reporting | write |
| deleteContactGroup | group_id で識別される特定のコンタクトグループ(リスト)を削除します。 | reporting | delete |
はじめに
前提条件
- Node.js >= 16.0
- プロビジョニング済みの Sinch Engage アカウント
- Claude Desktop(またはその他のMCPクライアント)。このREADMEは Claude Desktop に焦点を当てていますが、MCPサーバーは任意のMCPクライアントで使用できます。
API認証情報
MCPツールが使用するAPIを利用するには、以下の認証情報が必要です:
SINCH_ENGAGE_API_KEYとSINCH_ENGAGE_API_SECRETSinch Engage 認証情報
MCPサーバー設定
Sinch Engage MCPサーバーは、実行するNPMパッケージとして利用可能です。Claude Desktop の設定ファイル(claude_desktop_config.json)での設定方法は以下のとおりです。環境変数には、ご自身の認証情報とリージョン(現在サポートされているのは EU と AU)を入力することを忘れないでください:
{
"mcpServers": {
"Sinch Engage": {
"command": "npx",
"args": [
"-y",
"@sinch-engage/mcp-server"
],
"env": {
"SINCH_ENGAGE_API_KEY": "<your-key>",
"SINCH_ENGAGE_API_SECRET": "<your-secret>",
"SINCH_ENGAGE_REGION": "<region>",
"MCP_TOOL_CATEGORIES": "reporting, contacts, messaging",
"MCP_TOOL_MODES": "read, write, delete"
}
}
}
}
MCPサーバーをローカルで実行する
オプション1: Claude Desktopでstdioを使用してMCPサーバーを起動する
Claude DesktopでMCPサーバーをローカルで実行するには、リポジトリをクローンしてMCPサーバーをビルドする必要があります。このオプションは、ローカル開発とテストに便利です。
ステップ1: リポジトリをクローンする
git clone https://github.com/messagemedia/sinch-engage-mcp-server.git
ステップ2: 依存関係をインストールする
cd sinch-engage-mcp-server
npm install
ステップ3: Claude Desktop設定をセットアップする
Claude Desktop の設定ファイル(claude_desktop_config.json)でMCPサーバーを設定する方法の例を以下に示します。ここでSinch Engageの認証情報とリージョン(EU または AU)を指定できます:
{
"mcpServers": {
"Sinch Engage": {
"command": "node",
"args": ["/path/to/sinch-engage-mcp-server/src/index.js"],
"env": {
"SINCH_ENGAGE_API_KEY": "<your-key>",
"SINCH_ENGAGE_API_SECRET": "<your-secret>",
"SINCH_ENGAGE_REGION": "<region>",
"MCP_TOOL_CATEGORIES": "reporting, contacts, messaging",
"MCP_TOOL_MODES": "read, write, delete"
}
}
}
}
ステップ4:(オプション)MCPサーバーで利用可能なツールをフィルタリングする
ツールが多すぎると、コンテキストが大きくなり、トークン使用量が増加し、LLMが適切なツールを選択する際の混乱が生じます。
Claude Desktopの設定オプションで MCP_TOOL_CATEGORIES を指定することで、MCPサーバーで利用可能なツールをフィルタリングできます。
権限でツールをフィルタリングする場合は、MCP_TOOL_MODES を使用して、データの読み取り、書き込み、削除のいずれか、またはそれらの任意の組み合わせができるツールのみを選択できます。