iletiMerkezi Resmi MCP Server Yayında

iletiMerkezi MCP Server Yayında

@iletimerkezi/mcp-server, iletiMerkezi SMS API'sini Claude Code, Cursor, Codex CLI, Gemini CLI, VS Code (Cline) ve Claude Desktop gibi Model Context Protocol destekli LLM istemcilerine bağlayan resmi sunucudur. Açık kaynak (MIT), TypeScript ile yazıldı, npm üzerinde yayında.

Bu duyuru ile birlikte LLM ajanlarınız doğal dil isteklerinizi tek bir konuşma içinden SMS gönderimine, teslimat raporu sorgusuna, bakiye kontrolüne, kara liste yönetimine ve İYS izin işlemlerine çevirebilir.

Güncel sürüm: v1.0.0 (ilk stable major) — entegrasyon sözleşmesi (request/response zarfı, env değişkenleri, manifest auto-discovery protokolü) artık sabit; kırıcı değişiklikler semver kuralıyla majör sürüm artırır. Tool envanteri ise yeni API endpoint'leri eklendikçe manifest üzerinden otomatik genişleyebilir.

Neyi çözüyor?

Bir AI ajanına SMS gönderme yeteneği eklemek bugüne kadar üç adımdan geçiyordu: API dokümantasyonunu okumak, tool tanımlarını elle yazmak, hash hesaplamak ve hata yönetimini kendin kurmak.

MCP server bu üç adımı kaldırıyor. İstemci konfigürasyonuna npx -y @iletimerkezi/mcp-server satırını ekliyorsunuz, API anahtarı ve hash'i env'den geçiriyorsunuz, hepsi bu. 11 tool LLM'e otomatik açılıyor.

Sunduğu 11 tool

send_sms çağrısında İYS doğrulaması, sender ID seçimi ve mesaj zarfı LLM tarafında otomatik kuruluyor; siz sadece "905XX numarasına şu mesajı yaz" diyorsunuz.

Türkiye odağı

iletiMerkezi MCP Server, kamuya açık kaynaklar üzerinden görebildiğimiz kadarıyla, Türkiye'de BTK lisanslı SMS servis sağlayıcıları arasında resmi MCP sunucusu yayınlayan ilk markadır ve İYS izin yönetimini birinci sınıf MCP yüzeyi olarak sunan, dünya genelinde ilk SMS odaklı MCP sunucusudur. iys_register ile form yanıtlarını batch olarak ONAY/RET kaydına çevirebilir, iys_check ile bir alıcının güncel izin durumunu kaynak ve tarih bilgisiyle sorgulayabilirsiniz. KVKK ve İYS süreçlerini destekleyen izin kayıt ve sorgulama adımları konuşma içinden yönetilebilir hale gelir.

30 saniyelik kurulum

En hızlı yol — Claude Code (CLI) ile tek komut, user-scope (tüm projelerde geçerli):

claude mcp add iletimerkezi -s user \
  -e ILETIMERKEZI_API_KEY=API_ANAHTARINIZ \
  -e ILETIMERKEZI_API_HASH=HASH_DEGERINIZ \
  -- npx -y @iletimerkezi/mcp-server

Cursor, Gemini CLI, VS Code + Cline, Claude Desktop dört istemci aynı JSON şemasını paylaşır; ilgili config dosyasına şu bloğu ekleyin (boş dosyaya tam içerik; mevcut bir mcpServers objeniz varsa sadece iletimerkezi girdisini içine ekleyin):

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

Codex CLI TOML formatı kullanır (~/.codex/config.toml); codex mcp add komutu da aynı sonucu verir.

API anahtarı ve hash, panel.iletimerkezi.com → Ayarlar → Güvenlik → API Erişimi altından kopyalanır. Hash'i kendiniz hesaplamayın, panel hazır verir.

İstemci başına tam path listesi ve doğrulama: iim.to/mcp.

Ö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.

Tek kaynak prensibi

Sunucu kendi içinde tool şeması taşımıyor. Tool tanımları çalışma anında /api/manifest.json üzerinden çekiliyor. Bu, üç şey demek:

• API dokümantasyonundaki bir güncelleme MCP tarafına 24 saat içinde yansır, npm update gerekmez
• Yeni endpoint eklendiğinde kod değişmeden tool olarak görünür
• iletimerkezi.com erişilemese bile pakete gömülü build-time fallback ile sunucu çalışmaya devam eder

Güvenlik

• API Anahtarı + Hash, hesaba 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

Yol haritası ve geri bildirim

11 tool MVP değil; iletiMerkezi REST API'sinin AI tarafına açık tüm yüzeyini kapsıyor. Yeni endpoint'ler eklendikçe manifest üzerinden otomatik genişleyecek.

• Paket: iim.to/npm
• Dokümantasyon ve örnek konuşmalar: iim.to/mcp
• Tüm AI yüzeyleri: iletimerkezi.com/ai
• Sorun bildirimi: GitHub Issues

Deneyin, bize geri bildirim verin. Tool seti üzerine inşa edeceğiniz akışları görmek istiyoruz.