エディタからアシスタントができること
各ツールはSMS8ダッシュボードと同じ送信パイプラインを使用します。クレジット、リトライ、複数端末ルーティング、Webhook署名、すべてが直接APIを呼び出したときと同じように動作します。
setup_sms8
初回ハンドシェイク。キーを検証し、端末、プラン、連携コンテキストを返します。
send_sms
ペアリング済みAndroid経由でSMSを送信します。端末別、SIM別のルーティングに対応しています。
send_otp
コードを生成して送信します。長さ、有効期間、試行回数を指定できます。
verify_otp
最後に発行したコードと定数時間で比較します。一致しない場合は残り試行回数を返します。
wait_for_otp 新機能
OTP形式のSMSがAndroidに届くまでエージェントをブロックし、コードを自動的に抽出します。自律エージェントに欠かせない機能です。
get_messages
受信または送信した最近のSMSを取得します。方向や番号でフィルタできます。
list_devices
ペアリングされたAndroid端末を一覧表示します。複数SIMで負荷分散する際に送信元を選択できます。
get_balance 新機能
残高を素早く確認できます。残SMS数、更新までの日数、一行サマリーを返します。
create_webhook
受信SMS用のコールバックURLを登録します。HTTPSのみ、SSRF対策済み、HMAC署名付きです。
3通りのインストール方法から選択
SMS8は、ホスト型HTTP MCPサーバー、Skill組み込み済みのClaude Codeプラグイン、そしてstdioクライアント用のnpxランチャーとして提供しています。
- ホスト型HTTPはBearerトークンを使ってClaude Code、Cursor、Windsurfで動作します
- Claudeプラグインは
/plugin marketplace add 1fancy/sms8-sms-gatewayで導入します - npxはstdioブリッジを起動します:
npx -y @sms8/mcp
{
"mcpServers": {
"sms8": {
"url": "https://mcp.sms8.io",
"transport": "http",
"headers": {
"Authorization":
"Bearer YOUR_SMS8_API_KEY"
}
}
}
}
npmでインストール
9つのnpmパッケージがすべてのフローをカバーします。MCP経由のAIエージェント、ターミナルスクリプト、OTPフロー、Reactフック + IonicアプリのCapacitor・Cordovaプラグイン。1つのAPIキー、1台のペアリング済みAndroid端末です。
Claude Code、Cursor、Windsurf、OpenCode向けのMCPランチャーです。MCP設定に貼り付ければ、AIアシスタントが9つのSMSツールを利用できます。
$ npx -y sms8-mcp
ターミナルCLIです。SMS送信、OTPの送信 / 検証 / 待機、受信ボックスの閲覧、デバイス一覧に対応します。スクリプト、cron、CIに最適です。
$ npx sms8-cli send +14155550100 "Hi"
ReactuseSms8Otp()フック + セパレータ、RTL、マスク、render propsに対応した<OtpInput />コンポーネントです。
$ npm i react-sms-otp
react-sms-otpと同じコードで、«sms otp verify»および«otp input»検索向けにSEO最適化されています。
$ npm i sms-otp-verify
IonicアプリのためのCapacitorプラグイン:ネイティブiOS Swift + Android Kotlinブリッジ + Webフォールバック。
$ npm i capacitor-sms-otp-send-verify
IonicアプリのためのCordovaプラグイン:OTP送信・検証用のネイティブiOS Swift + Android Kotlinブリッジ。
$ cordova plugin add cordova-plugin-sms-otp-send
OTPに特化したCLIブランドです。Twilio不要、OTPごとの料金なしで、ご自身の電話からSMS OTPコードを送信・検証できます。
$ npx sms-otp-using-myphone send +1234
電話をゲートウェイとして使うCLIブランドです。バックエンドは同じで、電話SMSゲートウェイを探すチーム向けに検索最適化されています。
$ npx phone-sms-gateway send +1234 "Hi"
Androidファーストブランドです。同じコードで、«AndroidからSMS送信»を検索する開発者向けに最適化されています。
$ npx send-sms-from-android send +1234 "Hi"
そのままコピペで使えるユースケース
電話番号認証
「sms8 MCPを使ってこのアプリにSMS認証を組み込んでください。/signupでsend_otpを呼び、/verify-phoneでverify_otpを呼び、エラー時には残り試行回数を表示してください。」
注文通知
「注文が発送されたら、sms8 MCP経由で顧客に追跡リンク付きのSMSを送信してください。」
双方向サポート受信箱
「sms8 MCPでhttps://app.com/sms-inへのWebhookを登録してください。HMACを検証し、受信SMSをサポートキューに転送するハンドラを生成してください。」
パスワードレスログイン
「マジックリンクログインをsms8 MCP経由のOTPに置き換えてください。6桁のコード、5分間有効です。」
予約リマインダー
「明日の予約をDBから読み取り、各予約の24時間前にsend_smsでリマインダーSMSを送信してください。」
管理画面の2FA
「sms8 MCPを使って/adminにSMSによる2FAを追加してください。verify_otpが5回失敗したらアカウントをロックしてください。」
SMS8 MCP vs Twilio vs MessageBird
| 機能 | SMS8 MCP | Twilio | MessageBird |
|---|---|---|---|
| MCPサーバー内蔵 | あり | なし | なし |
| メッセージあたりの費用 | ゼロ | $0.0079〜 | $0.05〜 |
| A2P 10DLC必須 | 不要 | 必要 | 必要 |
| 番号レンタル | 不要 | $1〜/月 | $2〜/月 |
| 導入までの時間 | 60秒 | 数日から数週間 | 数日 |
| OTP認証 | 無料で同梱 | 別サービス | 別サービス |
| MCPコードのオープンソース | MIT | なし | なし |
デフォルトでセキュア、落とし穴なし
番号ごとの上限
1つの番号につき24時間で最大5回のOTPまで。この上限はアカウント設定からは変更できません。
競合防止
クールダウンと上限は行ロック付きSQLトランザクションで検証します。並列で枠を増やすことはできません。
OTPはPOSTのみ
GETは405を返します。Cookieは無視されます。
APIキーのマスキング
setup_sms8はキーの末尾4文字のみを表示します。
Webhook SSRF対策
ループバック、RFC1918、CGNAT、リンクローカル、IPv6にマップされたIPv4をブロックします。
HMAC署名
受信SMSと配信イベントはHMAC-SHA256で署名されて届くため、なりすましができません。
よくあるご質問
SMS8 MCPサーバーとは何ですか?
mcp.sms8.ioでホストされているModel Context Protocolサーバーで、AIコーディングツール(Claude Code、Cursor、Windsurf、Codex、Devin)がSMSを送信したり、OTPを発行したり、Webhookを設定したりできるようにします。すべてのメッセージは、Twilioではなくペアリング済みのAndroidから送信されます。
A2P 10DLCは必要ですか?
いいえ。SMS8はご自身のAndroidとSIMを使用します。A2P 10DLC登録、メッセージごとの料金、番号レンタルはいずれも不要です。
Claude CodeプロジェクトにSMSをどう組み込みますか?
~/.config/claude/mcp-servers.jsonにMCPサーバーを追加し、HTTPトランスポートでhttps://mcp.sms8.ioを指定し、SMS8キーをBearerトークンとして設定してください。または、/plugin marketplace add 1fancy/sms8-sms-gatewayを実行し、続いて/plugin install sms8-sms-gatewayを実行してください。
CursorやWindsurfで動きますか?
はい。どちらもHTTPベースのMCPサーバーを扱えます。~/.cursor/mcp.jsonまたは~/.codeium/windsurf/mcp_config.jsonにBearerとしてSMS8キーを設定してhttps://mcp.sms8.ioを追加してください。
Twilioの代替になりますか?
はい。SMS8はすでにお持ちのSIMが入ったご自身のAndroidを経由します。メッセージごとの料金もA2P 10DLCも番号プロビジョニングもありません。プランは月額$29からで、SMSは無制限です。
コードは公開されていますか?
はい、MITライセンスでgithub.com/1fancy/sms8-sms-gatewayに公開されています。