Platfone - Receive SMS & Virtual Numbers MCP

공식

AI 에이전트를 위한 가상 전화번호 플랫

GitHub
3

Platfone Receive SMS & Virtual Numbers MCP(으)로 무엇을 할 수 있나요?

  • 계정 잔액 확인 — AI에게 get_balance를 사용하여 총 잔액, 예약 잔액, 사용 가능 잔액을 조회하도록 요청하세요.
  • 비용 및 가용성 확인 — 주문 전에 check_price를 사용하여 국가 및 서비스 쌍의 가격과 번호 가용성을 확인하세요.
  • 가상 번호 주문 — order_number를 통해 국가 및 서비스 이름으로 임시 전화번호를 대여하여 활성화 ID와 전화번호를 받으세요.
  • 수신 SMS 확인 — check_sms를 사용하여 활성화에 대한 SMS 코드가 도착했는지 확인하고, 상태 및 폴링 안내를 반환받으세요.
  • 새 SMS 요청 — retry_activation을 사용하여 동일한 번호로 다른 SMS를 받기 위해 무료 재시도를 트리거하세요.
  • 취소 및 환불 — SMS를 받기 전에 cancel_activation을 사용하여 활성 활성화를 해제하고 예약된 자금을 회수하세요.

문서

Platfone MCP 서버

npm version npm downloads License: MIT Smithery

Platfone은 계정 인증, 테스트, 자동화 워크플로우를 위한 가상 전화번호를 제공합니다. Platfone MCP 서버는 AI 에이전트가 Claude, VS Code Copilot, Codex 등 MCP 호환 클라이언트에서 임시 번호를 얻고 SMS 메시지를 수신할 수 있도록 합니다.

📖 문서 · 🔧 설정 가이드 · 🔑 API 키 받기 · 📦 npm

MCP를 사용하는 이유

API를 수동으로 통합하는 대신, AI 에이전트는 다음을 수행할 수 있습니다:

  • 국가 및 서비스 이름으로 자율적으로 번호 주문
  • SMS 코드 대기
  • 활성화 재시도 또는 취소

모두 구조화된 도구 호출을 통해 이루어지며, 별도의 커스텀 백엔드가 필요하지 않습니다.

기능

  • 전체 활성화 수명 주기 — 번호 주문부터 SMS 수신까지
  • ETag 캐시 카탈로그 — 국가 및 서비스가 5분 TTL과 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") 또는 ID("il") 허용. activation_id + phone 반환.
check_sms활성화 상태 폴링. SMS 코드 수신 시 반환하거나 폴링 지침과 함께 현재 상태 반환.
retry_activation동일 번호로 다른 SMS 요청. 무료.
cancel_activationSMS 수신 전 활성 활성화 취소. 예약 금액 환불.

참고: 국가 및 서비스 카탈로그는 서버 측에 캐시되며 사람이 읽을 수 있는 이름에서 자동 해석됩니다. 에이전트는 전체 카탈로그를 받지 않으며, 해석된 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 도착 전 취소 (잔액 환불)

개발

설정 지침 및 테스트 팁은 전체 개발 가이드를 읽어보세요.

문제 해결

오류해결책
UnauthorizedExceptionPLATFONE_API_KEY이 유효한지 확인하세요
PaymentRequiredExceptionPlatfone 잔액을 충전하세요
NoNumbersAvailableException다른 국가 또는 서비스를 시도하세요
TooManyRequestsException속도 제한 — 기다렸다가 재시도하세요
MaxPriceExceededException제안된 max_price 및 반환된 order_id로 order_number 재시도
TooManyActivationsException최대 동시 활성 활성화 도달 — 취소하거나 만료될 때까지 기다리세요

라이선스

LICENSE.md를 참조하세요. MIT 라이선스에 따라 라이선스가 부여됩니다.

Platfone API 사용은 서비스 약관 및 개인정보 처리방침의 적용을 받습니다.