SMS8 - SMS GATEWAY using your phone

SMS8 MCP Sunucusu

SMS ağ geçidi → sms8.io  ·  Vibe kodlayıcılar ve geliştiriciler için SMS Gateway MCP → mcp.sms8.io

Claude Code, Cursor, Windsurf, OpenCode ve Model Context Protocol'ü konuşan diğer tüm AI kodlama araçlarından SMS gönderin, OTP'ler oluşturup doğrulayın, gelen kodları bekleyin ve webhook'ları yapılandırın. SMS, SMS8 platformu aracılığıyla eşleştirilmiş bir Android telefona yönlendirilir.

Canlı sunucu: https://mcp.sms8.io Kontrol Paneli: https://app.sms8.io Pazarlama sitesi: https://sms8.io

Neden kullanmalısınız

Bir uygulama geliştiriyor ve SMS bildirimleri, OTP'ler, iki yönlü mesajlaşma veya otonom ajan telefon doğrulaması mı istiyorsunuz? Çoğu seçenek sizi operatör programlarına kaydolmaya, telefon numaraları sağlamaya, mesaj başına ödeme yapmaya veya oturum başına tek kullanımlık SIM kiralamaya zorlar. SMS8, SMS'leri zaten sahip olduğunuz bir telefon üzerinden yönlendirir. MCP sunucusu, AI asistanınıza doğrudan çağırabileceği dokuz araç sunar, böylece bir projeye SMS eklemek bir saatlik entegrasyon çalışması yerine tek bir komut alır.

Elde edecekleriniz

Araç	Amacı
setup_sms8	API anahtarını doğrular, hesap bağlamı ve kod örnekleri döndürür
send_sms	Eşleştirilmiş bir Android cihaz üzerinden bir SMS gönderir
send_otp	Bir doğrulama kodu oluşturur ve gönderir
verify_otp	Yazılan bir kodu, verilen son OTP ile karşılaştırır
wait_for_otp	YENİ. Eşleştirilmiş Android'e bir OTP gelene kadar bekler; kodu çıkarır
get_messages	Son gelen kutusu veya gönderilen SMS'leri döndürür
list_devices	Eşleştirilmiş Android cihazlarını listeler
get_balance	YENİ. Hafif kredi ve yenileme kontrolü
create_webhook	Gelen SMS ve teslimat olayları için bir geri çağrı URL'si kaydeder

Tüm araçlar, SMS8 kontrol paneli ile aynı gönderim hattını paylaşır. Krediler, yeniden denemeler, çoklu cihaz yönlendirme ve webhook imzalama, doğrudan bir API çağrısıyla aynı şekilde çalışır.

SMS8 vs Twilio vs MessageBird

Yetenek	SMS8	Twilio	MessageBird
Dahili MCP sunucusu	Evet	Hayır	Hayır
Mesaj başına ücret	Yok	$0.0079+	$0.05+
A2P 10DLC gerekli	Hayır	Evet	Evet
Telefon numarası sağlama	Gerekmez	$1+/ay	$2+/ay
Kurulum süresi	60 saniye	Günler ila haftalar	Günler
Dahili OTP doğrulama	Evet	Ek hizmet	Ek hizmet
Açık kaynak MCP kodu	MIT	Hayır	Hayır

npm ile kurulum

Altı paket her akışı kapsar — projenize uygun olanı seçin.

Paket	Çalıştırma komutu	Kullanım durumu
sms8-mcp	npx -y sms8-mcp	Claude Code, Cursor, Windsurf, OpenCode için MCP başlatıcı
sms8-cli	npx sms8-cli send +1234 "hi"	Gönderme / OTP / gelen kutusu / cihazlar için terminal CLI
react-sms-otp	npm i react-sms-otp	React useSms8Otp() + <OtpForm /> + <OtpInput /> (ayırıcılar, RTL, maske, render prop'ları)
sms-otp-verify	npm i sms-otp-verify	Aynı kod, "sms otp verify" / "otp input" aramaları için SEO hedefli ad
capacitor-sms-otp-send-verify	npm i capacitor-sms-otp-send-verify	Ionic uygulamaları için Capacitor eklentisi — yerel iOS Swift + Android Kotlin + web yedeği
cordova-plugin-sms-otp-send	cordova plugin add cordova-plugin-sms-otp-send	Ionic uygulamaları için Cordova eklentisi — yerel iOS Swift + Android Kotlin
sms-otp-using-myphone	npx sms-otp-using-myphone send +1234	Aynı CLI'nin yalnızca OTP markası
phone-sms-gateway	npx phone-sms-gateway send +1234 "hi"	Aynı CLI'nin telefon ağ geçidi markası
send-sms-from-android	npx send-sms-from-android send +1234 "hi"	Aynı CLI'nin Android öncelikli markası

MCP örneği (Claude Code, Cursor, Windsurf — aynı yapılandırma şekli):

{
  "mcpServers": {
    "sms8": {
      "command": "npx",
      "args": ["-y", "sms8-mcp"],
      "env": { "SMS8_API_KEY": "sk_xxx" }
    }
  }
}

CLI örneği:

export SMS8_API_KEY=sk_xxx
npx sms8-cli send +14155550100 "Hello"
CODE=$(npx sms8-cli otp wait +Google --timeout=120)

React örneği:

import { OtpForm } from 'react-sms-otp';

<OtpForm
  apiKey={process.env.NEXT_PUBLIC_SMS8_API_KEY!}
  onVerified={(phone) => router.push('/dashboard')}
/>

Altı paketin tümünün kaynak kodu npm-packages/ adresinde bulunur.

iOS + Android SDK'ları

Yerel mobil uygulamalar için, sdks/ klasörü, gönderme / doğrulama API'si + SMS otomatik doldurma yardımcıları (Android'de Google SMS Retriever, iOS'ta oneTimeCode içerik türü) ile birlikte Kotlin (Android) ve Swift (iOS) SDK'larını sunar.

SDK	Kurulum	Otomatik doldurma
sms8-swift	Swift Package Manager — README dosyasına bakın	iOS OTPTextField SwiftUI görünümü
sms8-android	JitPack — README dosyasına bakın	SMSRetriever.start(activity) — SMS izni gerekmez

Her iki SDK da MIT lisanslıdır, aynı SMS8 API anahtarını paylaşır ve aynı Twilio-Verify alternatifi kullanım durumlarını hedefler.

Hızlı başlangıç

1. Bir SMS8 hesabı edinin

app.sms8.io adresinden kaydolun. 5 günlük ücretsiz deneme, kredi kartı gerekmez. Android telefonunuzu QR ile eşleştirin ve Profil ardından API bölümünden API anahtarınızı kopyalayın.

2. MCP sunucusunu aracınıza ekleyin

Barındırılan HTTP (Claude Code, Cursor, Windsurf, Codex, Devin)

{
  "mcpServers": {
    "sms8": {
      "url": "https://mcp.sms8.io",
      "transport": "http",
      "headers": {
        "Authorization": "Bearer YOUR_SMS8_API_KEY"
      }
    }
  }
}

Claude Code eklentisi (tek komut)

/plugin marketplace add 1fancy/sms8-sms-gateway
/plugin install sms8-sms-gateway

Ardından Claude Code'u başlatmadan önce kabuğunuzda export SMS8_API_KEY=sk_xxx komutunu çalıştırın.

stdio istemcileri için npx

{
  "mcpServers": {
    "sms8": {
      "command": "npx",
      "args": ["-y", "@sms8/mcp"],
      "env": { "SMS8_API_KEY": "sk_your_key" }
    }
  }
}

3. Kurulum sihirbazı

app.sms8.io/mcp-setup.php adresindeki kontrol paneli, her AI aracı için JSON'u önceden doldurur, gerekirse cihaz eşleştirme QR kodunuzu gösterir ve canlı bir SMS test formu içerir.

4. AI'ınıza sorun

Add SMS verification to my signup flow using the sms8 MCP.

AI, setup_sms8'i, ardından send_otp ve verify_otp'yi çağıracak ve ilk denemede çalışan üretim kodu yazacaktır.

Kullanım durumları

Bunlar, Claude Code, Cursor veya Windsurf'e yapıştırabileceğiniz gerçek tek satırlık komutlardır.

Kayıtta telefon doğrulaması

Wire phone-number verification into this app using the sms8 MCP. Use
send_otp on /signup, verify_otp on /verify-phone. Render the remaining
attempts on error.

Sipariş kargo bildirimleri

When an order ships, send the customer an SMS with their tracking link
via the sms8 MCP.

İki yönlü destek gelen kutusu

Register a webhook with the sms8 MCP at https://my-app.com/sms-inbox.
Scaffold the handler that verifies the HMAC signature and routes inbound
SMS to the support queue.

SMS ile şifresiz giriş

Replace the magic-link email login with SMS OTPs using the sms8 MCP.
6-digit code, 5-minute expiry, 5 attempts.

Yönetici sayfaları için SMS 2FA

Add SMS 2FA to /admin login via the sms8 MCP. Lock the account after
5 failed verify_otp attempts.

Hazır kod örnekleri

examples/ içindeki her dosya üretime hazır, sıfır bağımlılıklı ve kopyala-yapıştır yapılabilir. Bunlar, AI'ın bir setup_sms8 el sıkışmasından sonra ürettiği kodlardır.

• php-send.php: send, sendOtp, verifyOtp içeren minimal Sms8Sender sınıfı
• js-fetch.js: Node / tarayıcı / Cloudflare Worker istemcisi (ESM ve CommonJS)
• otp-flow.php: eksiksiz telefon doğrulama akışı (startSignup + verifySignup)
• webhook-handler.php: HMAC imza kontrolü ile gelen SMS işleyicisi

Sıkça sorulan sorular

SMS8 MCP sunucusu nedir?

mcp.sms8.io adresinde, Model Context Protocol'ü uygulayan bir HTTPS uç noktasıdır. AI kodlama araçları, SMS göndermek, OTP'ler oluşturmak ve webhook'ları yapılandırmak için JSON-RPC arayüzünü çağırır. SMS, SMS8 platformu aracılığıyla eşleştirilmiş bir Android telefona yönlendirilir.

Bunun Twilio'dan farkı nedir?

SMS8, mevcut SIM kartınızla kendi Android telefonunuzu ağ geçidi olarak kullanır. Mesaj başına operatör ücreti, A2P 10DLC kaydı veya sağlanması gereken bir telefon numarası yoktur. Sabit bir plan ödersiniz ve sınırsız SMS gönderirsiniz. MCP sunucusu, AI asistanınızın doğrudan çağırabileceği yedi araç sunar ki bu Twilio'nun sunmadığı bir özelliktir.

Bu Claude Code ile çalışır mı?

Evet. MCP sunucusunu, https://mcp.sms8.io'yi işaret eden HTTP aktarımı ve SMS8 API anahtarınızı Bearer token olarak kullanarak ~/.config/claude/mcp-servers.json dosyasına ekleyin. Veya /plugin marketplace add 1fancy/sms8-sms-gateway ve ardından /plugin install sms8-sms-gateway komutunu çalıştırın.

Bu Cursor ve Windsurf ile çalışır mı?

Evet. Her ikisi de HTTP MCP sunucularını destekler. API anahtarınızı Bearer başlığı olarak https://mcp.sms8.io ile ~/.cursor/mcp.json (Cursor) veya ~/.codeium/windsurf/mcp_config.json (Windsurf) dosyasına ekleyin. app.sms8.io/mcp-setup.php adresindeki kurulum sihirbazı, her araç için JSON'u önceden doldurur.

AI otomatik olarak OTP doğrulaması ekleyebilir mi?

Evet. Birlikte gelen Claude Code Skill (skills/send-sms/SKILL.md), asistana ne zaman send_otp ve verify_otp'i çağıracağını ve mevcut bir kayıt veya giriş rotasını doğrulama adımıyla nasıl saracağını öğretir. "/signup'a telefon doğrulaması ekle" gibi bir komut yeterlidir.

Kaynak kodu herkese açık mı?

Evet, MIT lisanslıdır. Sunucu, yedi araç uygulamasının tümü, npm başlatıcı (@sms8/mcp), Claude Code eklenti manifestosu ve örnek kod bu repoda bulunur.

API anahtarıma ne olur?

API anahtarınız, her MCP araç çağrısını bir Authorization: Bearer başlığı (veya X-Api-Key) aracılığıyla doğrular. Barındırılan sunucu, bunu SMS8 hesabınıza göre doğrular ve ardından çağrıyı mevcut SMS8 gönderim hattı üzerinden yönlendirir. setup_sms8 yanıtı, anahtarınızın yalnızca son dört karakterini döndürür, böylece AI sohbet geçmişine veya günlüklere asla sızmaz.

Bunu üretimde kullanmak güvenli midir?

Evet. Sunucu tarafı savunmaları şunları içerir:

• SMS8 API'sinden devralınan anahtar başına hız sınırlaması
• 24 saatte telefon numarası başına 5 OTP sabit sınırı, kullanıcı tarafından yapılandırılamaz
• 30 ila 600 saniye yeniden gönderme bekleme süresi (varsayılan 60 saniye)
• Yalnızca POST OTP uç noktaları; GET 405 döndürür; çerezler yok sayılır
• Satır kilitleriyle işlem sarılmış hız sınırı kontrolleri; eşzamanlı çağrılar limitleri aşamaz
• HMAC-SHA256 webhook imzaları
• RFC1918, CGNAT, bağlantı yerel, IPv4 eşlemeli IPv6 ve DNS çözümlü ana bilgisayarları kapsayan create_webhook üzerinde kapsamlı SSRF engelleme listesi
• CORS yalnızca keşif yöntemleri için duyurulur; tools/call, kötü amaçlı bir web sayfasının SMS gönderimlerini tetikleyememesi için CORS'u atlar

MCP sunucusunu kendim barındırabilir miyim?

Evet. Repoyu klonlayın, SMS8_APP_PATH değişkenini SMS8 kurulum dizininize ayarlayın ve çalıştırın:

git clone https://github.com/1fancy/sms8-sms-gateway.git
cd sms8-sms-gateway
export SMS8_APP_PATH=/path/to/your/sms8-install
php -S 127.0.0.1:8080 index.php

mcp.sms8.io adresindeki barındırılan sunucu ücretsizdir ve çoğu kullanıcı için daha kolaydır.

"Vibe coding" nedir?

Vibe coding, her satırı elle yazmak yerine, düz İngilizce ile ne istediğinizi AI asistanına tarif ederek çalışan yazılım ortaya çıkarmaktır. SMS8 MCP, en yaygın isteklerden birini ("SMS bildirimleri ekle") bir operatör portalına veya A2P evrak işlerine hiç dokunmadan mümkün kılar.

Güvenlik ve gizli bilgiler

Bu repo hiçbir gizli bilgi içermez. Tüm kimlik bilgileri ortam değişkenlerinde veya AI aracınızın MCP yapılandırmasında bulunur:

SMS8_API_KEY=sk_…        # from app.sms8.io → Profile → API
SMS8_WEBHOOK_SECRET=…    # from app.sms8.io → Webhook

Tam güvenlik ayrıntıları için yukarıdaki SSS bölümüne bakın. Talep üzerine ayrı bir güvenlik denetim özeti sunulur.

Repo düzeni

.
├── README.md                       this file
├── LICENSE                         MIT
├── index.php                       MCP server entry (JSON-RPC dispatcher)
├── landing.html                    marketing landing at mcp.sms8.io
├── .claude-plugin/plugin.json      Claude Code plugin manifest
├── .mcp.json                       MCP server config referenced by the plugin
├── skills/send-sms/SKILL.md        teaches Claude when to invoke SMS8 tools
├── npm-packages/                   five published npm packages
│   ├── sms8-mcp/                   MCP stdio bridge (sms8-mcp)
│   ├── sms8-cli/                   universal CLI (sms8)
│   ├── sms-otp-using-myphone/      OTP-only brand of the CLI
│   ├── phone-sms-gateway/          phone-as-gateway brand of the CLI
│   └── send-sms-from-android/      Android-first brand of the CLI
├── lib/                            Auth, JsonRpc, ToolRegistry
├── tools/                          7 tool implementations
└── examples/                       PHP and JS drop-in samples

Yol haritası

• HTTP MCP sunucusu mcp.sms8.io adresinde canlı
• Telefon başına kötüye kullanım sınırı olan OTP uç noktaları
• npm paketleri sms8-mcp, sms8-cli, sms-otp-using-myphone, phone-sms-gateway, send-sms-from-android
• Claude Code eklentisi ve Skill
• MMS desteği
• Yanıt oluşturma için AI'a otomatik yönlendirilen gelen SMS
• Kontrol panelinde yapılandırılabilir araç başına hız limitleri
• Python, Go ve Ruby'de kod örnekleri

Katkıda bulunma

Sorunlar ve çekme istekleri github.com/1fancy/sms8-sms-gateway adresinde memnuniyetle karşılanır. Daha büyük değişikliklerden önce bir tartışma başlatın.

Lisans

MIT. LICENSE dosyasına bakın.

Anahtar kelimeler

model context protocol, mcp server, mcp sms, claude code sms, claude code mcp, cursor mcp, windsurf mcp, sms api, otp api, sms gateway, android sms gateway, twilio alternative, vibe coding, ai sms integration, sms notifications, send sms from claude, send sms from cursor, phone verification api, sms otp, 2fa sms, webhook sms, inbound sms, two-way sms, unlimited sms, no per-message fees, no A2P 10DLC, ai coding tools, sms8