smsportal.app SMS

smsportal.app MCP サーバー

Claude、Cursor、その他のModel Context ProtocolクライアントなどのAIエージェントを通じて、ご自身のAndroidスマートフォンからSMSを送受信できます。

smsportal.appを使うと、AndroidスマートフォンをSMSゲートウェイとして利用できます。メッセージはご自身の電話番号とSIMから送信され、受信したSMSはAPI経由で利用できます。このサーバーは、そのアカウントをAIエージェントに公開します。南アフリカのSMSPortal (Pty) Ltdとは提携していません。

ホステッドサーバーを利用する（推奨）

1. smsportal.appでアカウントを作成し、Androidスマートフォンをペアリングして、ダッシュボードでAPIキーを作成します。
2. クライアントにサーバーを追加します。

Claude Code

claude mcp add --transport http smsportal https://smsportal.app/mcp \
  --header "Authorization: Bearer $SMSPORTAL_API_KEY"

カスタムヘッダーに対応していないClaude Desktopなどのクライアント（mcp-remote、Node.js 18+を使用）

{
  "mcpServers": {
    "smsportal": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://smsportal.app/mcp", "--header", "Authorization:${AUTH_HEADER}"],
      "env": { "AUTH_HEADER": "Bearer YOUR_SMSPORTAL_API_KEY" }
    }
  }
}

手順ガイド：smsportal.app/en/integrations/mcp。

ツール

ツール	機能
smsportal_list_devices	アカウントとペアリングされたスマートフォンと、最終ハートビートおよびSIMの状態
smsportal_get_stats	送信数、受信数、デバイス数
smsportal_list_messages	テキスト、番号、スマートフォン、ステータス、日時で送受信SMSを検索
smsportal_read_received_sms	スマートフォンがすでに同期した受信SMS
smsportal_get_send_status	smsportal_send_smsが返した一括送信の宛先ごとのステータス
smsportal_send_sms	スマートフォンから最大50件のE.164番号に、指定したメッセージを送信

APIで受け付けられたことは、配信された証拠にはなりません。送信後にステータスを確認してください。SMSPORTAL_READ_ONLY=trueを設定すると、送信ツールが非表示になります。

自分で実行する

git clone https://github.com/aleksanderem/smsportal-mcp && cd smsportal-mcp
npm ci && npm run build

ローカル（stdio）クライアントの設定：

{
  "mcpServers": {
    "smsportal": {
      "command": "node",
      "args": ["/path/to/smsportal-mcp/dist/index.js"],
      "env": { "SMSPORTAL_API_KEY": "YOUR_SMSPORTAL_API_KEY" }
    }
  }
}

変数	デフォルト	意味
SMSPORTAL_API_KEY	—	APIキー（stdioモード）
SMSPORTAL_API_URL	https://smsportal.app/api/v1	APIベースURL
SMSPORTAL_READ_ONLY	false	trueにすると送信ツールが非表示になります
SMSPORTAL_PUBLIC_ORIGIN	http://localhost:18080	HTTPモード：許可される唯一のブラウザーオリジン
SMSPORTAL_TRUST_PROXY	false	HTTPモード：呼び出し元アドレスについて、リバースプロキシを1ホップ信頼します
HOST, PORT	127.0.0.1, 3002	HTTPモードのリスナー

HTTPモード（node dist/index.js --httpまたはDockerfile）では、/mcpでストリーミング可能なHTTPを提供します。APIキーはAuthorization: Bearer（または、Bearerプレフィックスを追加できないホスト向けのx-api-keyヘッダー）から取得し、各リクエストの前に検証して、呼び出し元のネットワークごとにレート制限を適用します。

開発

npm ci && npm test

セキュリティに関する報告：SECURITY.mdを参照してください。ライセンス：MIT。