Ana içeriğe geç

iletiMerkezi MCP Server

@iletimerkezi/mcp-server, Claude Desktop / Cursor / Cline gibi Model Context Protocol istemcilerine iletiMerkezi SMS API'sini bağlayan resmi sunucudur. LLM, doğal dil isteğinizi alır, ilgili tool çağrısını üretir ve yanıtı yorumlar; SMS gönderimi, teslimat raporu, bakiye ve kara liste yönetimi tek bir konuşmadan yürütülebilir.

Sunucu tamamen TypeScript, MIT lisanslı, açık kaynaktır: iletimerkezi/iletimerkezi-mcp-server.

Sunduğu 7 tool

| Tool | API endpoint | Ne işe yarar | |---|---|---| | send_sms | POST /v1/send-sms/json | Tek veya çoklu numaraya SMS gönderir | | get_report | POST /v1/get-report/json | Sipariş teslimat raporu (özet + alıcı bazında) | | get_balance | POST /v1/get-balance/json | Hesap bakiyesi (TL + SMS kontörü) | | get_sender | POST /v1/get-sender/json | Onaylı sender ID listesi | | get_blacklist | POST /v1/get-blacklist/json | Engellenmiş numaralar (sayfalı) | | add_blacklist | POST /v1/add-blacklist/json | Numara engelle (idempotent) | | delete_blacklist | POST /v1/delete-blacklist/json | Engellemeyi kaldır |

Kurulum (Claude Desktop)

claude_desktop_config.json dosyasına mcpServers bloğunu ekleyin:

{
  "mcpServers": {
    "iletimerkezi": {
      "command": "npx",
      "args": ["-y", "@iletimerkezi/mcp-server"],
      "env": {
        "ILETIMERKEZI_API_KEY": "API_ANAHTARINIZ",
        "ILETIMERKEZI_API_HASH": "HASH_DEGERINIZ"
      }
    }
  }
}

İki değer de panel.iletimerkezi.com → Ayarlar → Güvenlik → API Erişimi altından kopyalanır. Hash'i kendiniz hesaplamayın; panel hazır verir. Detay: authentication.

Claude Desktop'ı tam quit ile kapatıp yeniden açtıktan sonra yeni bir konuşmada mesaj kutusunun altındaki tool ikonuna tıklayın; "iletimerkezi" sunucusu ve 7 tool görünmelidir.

Önemli ön koşul: Panel'de Ayarlar → Güvenlik → Erişim İzinleri → API kullanımına izin ver seçeneği açık olmalı. Kapalıysa her çağrı 401 döner. Sunucunun hata mesajı bu adımı doğrudan size hatırlatır.

Cursor, Cline ve diğer istemciler

Aynı mcpServers yapılandırması Cursor (~/.cursor/mcp.json), Cline ve diğer MCP destekli istemcilerde de geçerlidir. Sadece dosya yolu değişir; sunucu komutu ve env değişkenleri aynıdır.

Tek kaynak prensibi

@iletimerkezi/mcp-server kendi içinde tool şeması tanımlamaz. Tool tanımları çalışma anında /api/manifest.json üzerinden çekilir. Manifest, iletiMerkezi'nin resmi endpoint dokümantasyonundan üretilir; yani belgelerdeki bir güncelleme 24 saat içinde tüm MCP istemcilerinde görünür hale gelir, npm update gerekmez.

Bu yapı:

  • Canlı API ile MCP arasında drift = 0.
  • iletimerkezi.com erişilemese bile sunucu, npm publish anında pakete gömülen build-time fallback ile çalışmaya devam eder.
  • Yeni endpoint eklendiğinde, dokümantasyon yayınlanır yayınlanmaz LLM'ler tool olarak görür.

Örnek konuşmalar

LLM'e söyleyeceğiniz cümle, sunucunun arkasında tek bir tool çağrısına dönüşür:

  • "Bakiyemi göster." → get_balance
  • "905XXXXXXXXX numarasına 'Randevunuz yarın 14:00' yaz." → send_sms (sender, iys, tüm zarf otomatik)
  • "Şu sipariş numarasının teslimat raporunu çıkar: 312988299." → get_report
  • "0532'li numarayı kara listeye ekle." → add_blacklist
  • "Onaylı başlıklarımı listele." → get_sender

Güvenlik

  • API Anahtarı + Hash hesabınıza tam yetkiyle bağlıdır; sızdırılırsa tek çağrıyla bakiye harcanabilir.
  • Anahtarları kaynak kodunda veya çıktı dosyalarında bulundurmayın; MCP istemcisinin config dosyası lokal makinenizde kalır.
  • Sunucu, kimlik bilgilerini bellekte saklamaz; her çağrıda env'den okur.
  • Üretim entegrasyonlarında IP kısıtlaması ve aylık anahtar rotasyonu önerilir.

Yardım ve katkı

Son güncelleme: 2026-04-29 · English version