MCP
engagelab-sms-mcp は、AIアシスタントがEngageLabプラットフォームを介してSMSを送信できるようにするMCP（Model Context Protocol）サーバーです。このサーバーをMCP対応クライアント（Cursor、Claude Desktopなど）に追加することで、AIがあなたに代わってテンプレートベースのSMS送信操作を実行できます。
前提条件
- Node.js 18+
- EngageLabアカウントを持ち、SMS APIの認証情報（
dev_keyとdev_secret）を取得していること - 承認済みのSMSテンプレートが少なくとも1つあること
ヒント： API認証情報は、EngageLabコンソールのAPI Keyページで作成および管理できます。
設定方法
Cursor
Settings > MCP に移動し、Add new MCP server をクリックして、以下の設定を貼り付けます。
{
"mcpServers": {
"engagelab-sms": {
"command": "npx",
"args": ["-y", "engagelab-sms-mcp"],
"env": {
"ENGAGELAB_DEV_KEY": "<your_dev_key>",
"ENGAGELAB_DEV_SECRET": "<your_dev_secret>"
}
}
}
}
{
"mcpServers": {
"engagelab-sms": {
"command": "npx",
"args": ["-y", "engagelab-sms-mcp"],
"env": {
"ENGAGELAB_DEV_KEY": "<your_dev_key>",
"ENGAGELAB_DEV_SECRET": "<your_dev_secret>"
}
}
}
}
このコードブロックはフローティングウィンドウ内に表示されます
<your_dev_key> と <your_dev_secret> を、EngageLabコンソールで取得した実際の認証情報に置き換えてください。
Claude Desktop
Settings > Developer > Edit Config を開き、mcpServers に追加します。
{
"mcpServers": {
"engagelab-sms": {
"command": "npx",
"args": ["-y", "engagelab-sms-mcp"],
"env": {
"ENGAGELAB_DEV_KEY": "<your_dev_key>",
"ENGAGELAB_DEV_SECRET": "<your_dev_secret>"
}
}
}
}
{
"mcpServers": {
"engagelab-sms": {
"command": "npx",
"args": ["-y", "engagelab-sms-mcp"],
"env": {
"ENGAGELAB_DEV_KEY": "<your_dev_key>",
"ENGAGELAB_DEV_SECRET": "<your_dev_secret>"
}
}
}
}
このコードブロックはフローティングウィンドウ内に表示されます
その他のMCPクライアント
stdio トランスポートに対応するMCPクライアントであれば、このサーバーを使用できます。起動コマンドを npx -y engagelab-sms-mcp に設定し、必要な環境変数を渡してください。
利用可能なツール
send_sms
EngageLabを介して、承認済みテンプレートを使用してSMSを送信します。
リクエストパラメータ：
| フィールド | 型 | 必須 | 説明 |
|---|---|---|---|
| to | string[] | はい | 対象電話番号のリスト。国際形式を推奨（例：+6581234567） |
| template.id | string | はい | 承認済みのEngageLab SMSテンプレートID |
| template.params | object | はい | テンプレート変数の値。例：{"code": "123456"} |
リクエスト例：
{
"to": ["+6581234567"],
"template": {
"id": "your-template-id",
"params": {
"code": "123456"
}
}
}
{
"to": ["+6581234567"],
"template": {
"id": "your-template-id",
"params": {
"code": "123456"
}
}
}
このコードブロックはフローティングウィンドウ内に表示されます
レスポンスパラメータ：
| フィールド | 型 | 説明 |
|---|---|---|
| success | boolean | リクエストが受理されたかどうか |
| plan_id | string | EngageLabのプランID。トラッキングに使用 |
| total_count | number | 送信した受信者の総数 |
| accepted_count | number | 配信が受理された受信者の数 |
| message_id | string | メッセージ識別子（利用可能な場合） |
| message | string | ステータスまたはエラーの説明 |
| code | number | EngageLabのレスポンスコード（0は成功を意味する） |
環境変数
| 変数 | 必須 | デフォルト | 説明 |
|---|---|---|---|
| ENGAGELAB_DEV_KEY | はい | — | EngageLab dev key |
| ENGAGELAB_DEV_SECRET | はい | — | EngageLab dev secret |
| ENGAGELAB_BASE_URL | いいえ | https://smsapi.engagelab.com |
ベースAPI URL |
| ENGAGELAB_REQUEST_TIMEOUT_MS | いいえ | 10000 |
リクエストタイムアウト（ms） |
| ENGAGELAB_MAX_RETRIES | いいえ | 1 |
失敗時の最大リトライ回数 |
よくある質問
サーバーが起動せず、「Missing required environment variable」と表示される
- MCPクライアントの
env設定で、ENGAGELAB_DEV_KEYとENGAGELAB_DEV_SECRETが正しく入力されていることを確認してください。
send_sms がエラーコード 3002（「invalid template id format」）を返す
- テンプレートIDが、EngageLabコンソールの承認済みテンプレートIDと完全に一致していることを確認してください。
send_sms がテンプレートパラメータ関連のエラーを返す
template.params内のキー名が、EngageLabテンプレートで定義された変数名と厳密に一致していることを確認してください。
SMSが受信されない
- 国際電話番号形式（例：
+6581234567）を使用していることを確認してください。 - テンプレートが承認済みで、無効化されていないことを確認してください。
