platfone

Platfone MCP サーバー

Platfone は、アカウント認証、テスト、自動化ワークフロー向けの仮想電話番号を提供します。Platfone MCP サーバーを使うと、AI エージェントは Claude、VS Code Copilot、Codex などの MCP 対応クライアントから、一時的な電話番号を取得して SMS メッセージを受信できます。

📖 ドキュメント · 🔧 セットアップガイド · 🔑 API キーを取得 · 📦 npm

なぜ MCP なのか？

API を手動で統合する代わりに、AI エージェントは次のことができます。

• 国とサービス名を指定して、自律的に電話番号を注文する
• SMS コードを待つ
• アクティベーションを再試行またはキャンセルする

これらはすべて、構造化されたツール呼び出しで実行でき、カスタムバックエンドは必要ありません。

特長

• アクティベーションライフサイクル全体に対応 — 電話番号の注文から SMS の受信まで
• ETag キャッシュ対応カタログ — 国とサービスは TTL 5 分でメモリ内にキャッシュされ、ETag に基づいて条件付きで更新されます。エージェントに送信されることはありません
• 人間にわかりやすい入力 — ID の代わりに「Israel」や「Telegram」を使用できます。名前はサーバー側で自動解決されます
• デュアルトランスポート — 単一のコードベースから stdio と http を利用できます
• API キー認証 — 既存の Platfone API キーを使用できます

インストール

詳しい手順については、インストールガイドをご覧ください。

クイックスタート

NPM：

PLATFONE_API_KEY=your_key npx @platfone/mcp

エージェントのガイドライン

• 最初に必ず check_price を呼び出して、料金と利用可能状況を確認します
• 次に order_number を呼び出して、電話番号をレンタルします
• SMS を受信するか、有効期限が切れるまで check_sms を呼び出します
• SMS が届かない場合は retry_activation を使用します
• 不要になった場合は cancel_activation を使用して、資金を解放します

ツール

ツール	説明
get_balance	アカウント残高を確認します：合計、予約済み、利用可能な資金。
check_price	注文前に、国とサービスの組み合わせの料金と利用可能状況を確認します。
order_number	仮想電話番号を注文します。「Israel」などの名前、または「il」などの ID を受け付けます。activation_id と phone を返します。
check_sms	アクティベーションの状態をポーリングします。SMS を受信すると SMS コードを返し、受信前は現在の状態とポーリング手順を返します。
retry_activation	同じ電話番号で SMS を再度リクエストします。無料です。
cancel_activation	SMS を受信する前に、アクティブなアクティベーションをキャンセルします。予約額が返金されます。

注： 国とサービスのカタログはサーバー側にキャッシュされ、人間が読める名前から自動的に解決されます。 エージェントにカタログ全体が渡されることはありません。解決済み ID または曖昧さを解消するためのヒントのみが渡されます。

一般的な AI エージェントのフロー

1. check_price         (country: "Israel", service: "Telegram")  → verify cost & availability
2. order_number        (country: "Israel", service: "Telegram")  → returns activation_id + phone
3. check_sms           (activation_id)                            → poll or check once for SMS

任意の手順：

• retry_activation — 同じ電話番号で SMS を再度リクエストします（無料）
• cancel_activation — SMS が届く前にキャンセルします（残高が返金されます）

開発

セットアップ手順とテストのヒントについては、開発ガイドをご覧ください。

トラブルシューティング

エラー	解決方法
UnauthorizedException	PLATFONE_API_KEY が有効であることを確認してください
PaymentRequiredException	Platfone の残高をチャージしてください
NoNumbersAvailableException	別の国またはサービスをお試しください
TooManyRequestsException	レート制限に達しました。しばらく待ってから再試行してください
MaxPriceExceededException	提案された max_price と返された order_id を指定して order_number を再試行してください
TooManyActivationsException	同時に有効化できる上限に達しました。キャンセルするか、有効期限が切れるまでお待ちください

ライセンス

LICENSE.md を参照してください。MIT License のもとでライセンスされています。

Platfone API の使用には、利用規約とプライバシーポリシーが適用されます。