Wavix

Wavix MCP Server

Bir Model Context Protocol sunucusu; LLM'lere ve yapay zeka ajanlarına Wavix telekom platformuna doğrudan erişim sağlar — SMS/MMS, sesli aramalar, 2FA, SIP trunking, telefon numarası yönetimi, 10DLC kaydı, çağrı kayıtları, konuşma analitiği ve faturalandırma.

Wavix, tek bir API üzerinden SMS gönderme, sesli arama yapma ve 2FA akışları çalıştırma için küresel bir iletişim platformudur. Ücretsiz deneme mevcuttur; ücretli kullanım, hesabınıza bağlı Wavix fiyatlandırma planını izler.

Bu MCP sunucusunu kullanmanın en hızlı yolu, https://mcp.wavix.com/mcp adresindeki barındırılan uç noktadır — MCP uyumlu herhangi bir istemciyi buna yönlendirin ve Wavix API anahtarınızla kimlik doğrulayın. Kendi kendinize barındırmanız gerekiyorsa (özel Wavix dağıtımı, güvenlik duvarı arkası, özel örnek), bkz. Kendi sunucunuzu çalıştırın.

İçindekiler

• Uç nokta
• Kurulum — tek tıkla, Claude Code, Claude Desktop / Web, Cursor, VS Code, Codex CLI, Windsurf
• Kendi sunucunuzu çalıştırın (kendi kendine barındırma)
• Örnekler
• Araçlar → TOOLS.md içindeki tam katalog
• Kaynaklar
• Kimlik doğrulama (en iyi uygulamalar, bir belirteç ele geçirilirse)
• Sorun giderme
• Uyumluluk ve sınırlar
• Destek, Katkıda bulunma, Güvenlik, Lisans

Uç nokta

Alan	Değer
URL	https://mcp.wavix.com/mcp
Taşıma	Streamable HTTP
Kimlik doğrulama	Authorization: Bearer <api_key>
Araçlar	bkz. TOOLS.md
Kaynaklar	Wavix belgeleri + OpenAPI belirtimi (otomatik keşfedilir)

Wavix API anahtarını Wavix Console → Administration → API keys → Create new bölümünden alın.

Kurulum

Başlamadan önce: Wavix API anahtarınızı edinin.

1. https://wavix.com adresinde oturum açın.
2. Administration → API keys bölümünü açın.
3. Create new seçeneğine tıklayın (veya mevcut bir anahtarı kopyalayın). Elinizin altında bulundurun — aşağıda YOUR_API_KEY yerine yapıştıracaksınız.

Tek tıkla kurulum

⚠️ Aşağıdaki düğmeler, düzenleyicinizin MCP yapılandırmasına YOUR_API_KEY yer tutucu belirtecini ekler. Düzenleyici kurulumu bitirdikten sonra, oluşturulan yapılandırmayı açın ve herhangi bir istek göndermeden önce yer tutucuyu gerçek API anahtarınızla değiştirin — aksi takdirde her çağrı 401 Unauthorized döndürür.

Daha sonra kaldırmak için: aynı yapılandırma dosyasını (~/.cursor/mcp.json, .vscode/mcp.json veya düzenleyicinizin karşılığı) açın ve wavix girişini silin veya bağlayıcıyı düzenleyicinizin MCP / Connectors arayüzü üzerinden kaldırın.

Claude Code

claude mcp add --transport http wavix https://mcp.wavix.com/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Doğrulamak için claude mcp list ve oturum içinde durum için /mcp kullanın.

Claude Desktop / Claude Web

Ayarlar → Connectors → Add custom connector:

• Ad: Wavix
• URL: https://mcp.wavix.com/mcp
• Taşıma: Streamable HTTP
• Kimlik doğrulama başlığı: Authorization: Bearer <api_key>

Cursor (manuel)

~/.cursor/mcp.json (veya proje düzeyinde .cursor/mcp.json) dosyasına ekleyin:

{
  "mcpServers": {
    "wavix": {
      "url": "https://mcp.wavix.com/mcp",
      "headers": {
        "Authorization": "Bearer <api_key>"
      }
    }
  }
}

Cursor 2.4+ tam kataloğu gösterir; önceki sürümler 40 ile sınırlıdır.

VS Code (manuel, GitHub Copilot Chat)

Çalışma alanınızda .vscode/mcp.json oluşturun (veya kullanıcı settings.json içindeki "mcp" anahtarı altına aynı servers nesnesini ekleyin):

{
  "servers": {
    "wavix": {
      "type": "http",
      "url": "https://mcp.wavix.com/mcp",
      "headers": {
        "Authorization": "Bearer <api_key>"
      }
    }
  }
}

Güncel şema için VS Code MCP sunucuları kılavuzuna bakın.

Codex CLI

Codex CLI, stdio üzerinden MCP'yi destekler. mcp-remote aracılığıyla barındırılan sunucuya köprü kurun. ~/.codex/config.toml dosyasını düzenleyin:

[mcp_servers.wavix]
command = "npx"
args = [
  "-y",
  "mcp-remote",
  "https://mcp.wavix.com/mcp",
  "--header",
  "Authorization:Bearer ${WAVIX_API_KEY}"
]

[mcp_servers.wavix.env]
WAVIX_API_KEY = "YOUR_API_KEY"

Windsurf / diğer istemciler

Özel başlıklarla Streamable HTTP taşımasını destekleyen herhangi bir MCP istemcisi çalışır. Şunları kullanın:

• URL: https://mcp.wavix.com/mcp
• Başlık: Authorization: Bearer <api_key>

Bir yapay zeka ajanı aracılığıyla mı kuruyorsunuz? Ajanınızı llms-install.md adresine yönlendirin — bu, modele URL'yi, başlığı ve istemci başına yapılandırmayı belirleyici bir biçimde veren, makine tarafından okunabilir bir kurulum kılavuzudur; böylece uç nokta değerlerini doğaçlama yapmaz.

Kendi sunucunuzu çalıştırın

Barındırılan sunucu çoğu kullanıcı için kutudan çıktığı gibi çalışır. Genel olmayan bir Wavix dağıtımına yönlendirmeniz, güvenlik duvarı arkasında çalıştırmanız veya kendi altyapınızda işletmeniz gerekiyorsa kendi kendinize barındırın.

Docker

docker build -t wavix-mcp-server .
docker run --rm -p 8000:8000 wavix-mcp-server

Sunucu 8000 portunda dinler ve MCP uç noktasını /mcp adresinde sunar. İstemcinizi http://<host>:8000/mcp adresine yönlendirin.

Kaynak koddan

git clone https://github.com/Wavix/wavix-mcp-server.git
cd wavix-mcp-server
pip install -e .
wavix-mcp

Python 3.10+ gerektirir.

Yapılandırma

Ortam değişkeni	Varsayılan	Amaç
WAVIX_API_BASE_URL	https://api.wavix.com	Yukarı akış Wavix API uç noktasını geçersiz kıl (iç dağıtımlar veya hazırlık ortamları için)

Sunucuyu çalıştırmak için Wavix kimlik bilgileri gerekmez — bunlar, MCP istemcisinin Authorization: Bearer <api_key> başlığından istek başına iletilir. Kendi kendine barındıranlar, sunucuyu genel olarak açmadan önce önünde TLS'yi sonlandırmaktan sorumludur (nginx, Caddy, bulut yük dengeleyici).

Örnekler

Bağlı herhangi bir istemciye doğrudan yapıştırabileceğiniz somut istemler.

Aşağıdaki telefon numaraları (+1 310 555 0100, +44 7700 900123) ayrılmış test aralıklarındadır (NANP 555 ve Ofcom 070 09xx) — aynen kopyalamak güvenlidir, bunlar aracılığıyla gerçek abonelere ulaşılamaz.

İşlemsel SMS gönderme

İstem: "+13105550100 numarasından +447700900123 numarasına 'Doğrulama kodunuz 4821' yazan bir SMS gönder."

Ajan, sms_and_mms_messages_send işlevini from, to ve text ile çağırır. Mesaj kimliğini ve teslimat durumunu döndürür.

2FA doğrulaması çalıştırma

İstem: "+13105550100 numarasına SMS ile bir 2FA doğrulama kodu gönder. Aldığım kodu size verdiğimde doğru olup olmadığını kontrol et."

Ajan two_fa_verification_create işlevini çağırır, SMS ile gelen kodu paylaşmanızı bekler, ardından two_fa_verification_check işlevini çağırır. Entegrasyon kodu yazmadan şifresiz akışların prototipini yapmak için kullanışlıdır.

Telefon numarası bulma ve satın alma

İstem: "SMS özellikli müsait bir ABD ücretsiz numarası bul, sepetime ekle ve ödemeyi tamamla."

Ajan buy_numbers_list (ülkeye ve özelliğe göre filtreleme), cart_add ve cart_checkout işlevlerini zincirler. Ödeme öncesinde kullanıcıyla onaylayın — hesaptan ücret keser.

Çağrı transkriptlerinde arama

İstem: "Dün gelen, iki dakikadan uzun süren ve arayanın 'iade' dediği tüm çağrıları göster."

Ajan, transkripsiyonlarda cdrs_search işlevini kullanır, ardından tam çağrı meta verileri için her sonucu cdrs_get ile zenginleştirir.

Kayıt çekme ve transkript etme

İstem: "abc-123 çağrısının kaydını al, Wavix'ten transkript etmesini iste ve transkripti döndür."

Ajan call_recording_get (önceden imzalanmış indirme URL'si döndürür), cdrs_retranscribe işlevlerini çağırır, ardından cdrs_transcription_get işlevini yoklar.

Faturalandırmayı denetleme

İstem: "Geçen ay SMS'e ne kadar harcadık? En son fatura PDF'i için bana bir indirme bağlantısı ver."

Ajan, türe ve tarihe göre filtrelenmiş billing_transactions_list işlevini, ardından billing_invoices_list + billing_invoices_download işlevlerini çağırır. İndirme aracı, dosyanın kendisini değil PDF'e önceden imzalanmış bir URL döndürür — URL'yi bir tarayıcıda açın veya gerçek belgeyi almak için istemcinize iletin.

Araçlar

Wavix OpenAPI belirtiminden üretilen 122 araç. Bağımsız değişkenler, istek parametrelerini ve gövde alanlarını yansıtır.

Grup	#	Kapsam
SMS ve MMS	10	Gönderme, listeleme, mesaj alma; gönderen kimlikleri; opt-out'lar
Çağrı kontrolü	9	Çağrı başlatma / yanıtlama / sonlandırma; ses çalma; DTMF toplama
Çağrı kaydı	4	Listeleme, indirme (önceden imzalanmış URL), silme
Çağrı akışı	2	Medya akışını başlatma / durdurma
Çağrı webhook'ları	3	Listeleme, oluşturma, silme
CDR'ler	7	Listeleme, dışa aktarma, alma; transkripsiyon arama ve yeniden transkript etme
Konuşma Analitiği	4	Yükleme, transkript etme, orijinal dosyayı alma
2FA	6	Doğrulama oluşturma / kontrol etme / iptal etme / yeniden gönderme; olaylar
Numaralarım	6	Listeleme, güncelleme, serbest bırakma; SMS / ses yönlendirme; belge yükleme
Satın alma	5	Ülkeler, bölgeler, şehirler; müsait numara arama
Sepet	4	Ekleme, kaldırma, alma, ödeme
Numara doğrulayıcı	3	Tekli ve toplu doğrulama
SIP trunk'ları	5	Tam CRUD
10DLC	30	Markalar, kampanyalar, inceleme, kanıt, olay abonelikleri
Profil	3	Profil alma / güncelleme; hesap yapılandırması
API Anahtarları	4	Listeleme, oluşturma, etkinleştirme / devre dışı bırakma, silme
Alt hesaplar	5	Listeleme, oluşturma, alma, güncelleme; işlemler
Faturalandırma	3	İşlemler, faturalar, hesap özeti indirme
Ses kampanyaları	2	Tetikleme ve alma
Wavix Embeddable (WebRTC)	5	Widget belirteçleri CRUD
Bağlantı kısaltıcı	2	Kısa bağlantı oluşturma; metrikler

Tam araç listesi ve tek satırlık açıklamalar için TOOLS.md dosyasına bakın. Yetkili kaynak Wavix OpenAPI belirtimidir — istemciniz her zaman güncel canlı kataloğu görür.

Kaynaklar

Araçlara ek olarak sunucu, Wavix belgelerini MCP Kaynakları olarak sunar; böylece model, önceki bilgilerden tahmin yürütmek yerine talep üzerine yetkili bağlam çekebilir.

URI şeması	İçerik
wavix://docs/<path>	docs.wavix.com adresindeki belgeleme sayfaları (llms.txt aracılığıyla otomatik keşfedilir).
wavix://api/openapi.yaml	Tam Wavix OpenAPI 3.0 belirtimi.

Her iki kaynak — docs.wavix.com ve Wavix OpenAPI belirtimi — herkese açıktır ve kimlik doğrulama olmadan doğrudan incelenebilir.

Kaynaklar, resources/read üzerinde tembel olarak getirilir ve sunucu tarafında 1 saatlik TTL ile önbelleğe alınır. Yukarı akış Bearer belirteci, belgeleme ana bilgisayarlarına asla iletilmez — yalnızca api.wavix.com adresine iletilir.

Kimlik doğrulama

İstemciden gelen her istek şunları içermelidir:

Authorization: Bearer <api_key>

Sunucu bu başlığı istek başına api.wavix.com adresine iletir. Belirteç:

• asla günlüğe kaydedilmez,
• çapraz ana bilgisayar yönlendirmelerinde (ör. önceden imzalanmış S3 indirme URL'leri) asla iletilmez,
• belgeleme ana bilgisayarlarına asla gönderilmez.

İstemciniz call_recording_get, billing_invoices_download, speech_analytics_file_get veya ten_dlc_brand_evidence_get tarafından döndürülen önceden imzalanmış bir indirme URL'sini takip ediyorsa, Authorization başlığı olmadan doğrudan getirin.

En iyi uygulamalar

• MCP için özel bir API anahtarı kullanın. https://wavix.com adresinde → Administration → API keys bölümünde (veya başka bir oturumdan api_keys_create aracının kendisi aracılığıyla) ayrı bir API anahtarı oluşturun. Bu, diğer entegrasyonları kesintiye uğratmadan MCP erişimini iptal etmenizi sağlar.

• Periyodik olarak döndürün. API anahtarını herhangi bir üretim sırrı gibi ele alın: planlı olarak ve herhangi bir sızıntı şüphesinde döndürün.

• API anahtarlarını git'ten uzak tutun. MCP istemci yapılandırmaları kazara işlenmeye müsaittir ve belirteci geçmişe ve CI günlüklerine taşır. Çoğu istemci, başlık değerinde ${env:VAR} ikamesini destekler — API anahtarını bir ortam değişkeninde veya işletim sistemi anahtar zincirinizde saklayın ve yapılandırmadan referans verin. Güvenlik ağı olarak, yaygın istemci yapılandırma yollarını projenizin .gitignore dosyasına ekleyin:

  .cursor/mcp.json
  .vscode/mcp.json
  claude_desktop_config.json
  .claude/mcp.json
  .codex/config.toml
  

Bir belirteç ele geçirilirse

1. Wavix Konsolu'nda anahtarı hemen devre dışı bırakın (veya api_keys_deactivate çağrısını yapın).
2. api_keys_create veya Konsol üzerinden bir yedek oluşturun.
3. İstemcinin yapılandırmasını güncelleyin ve yeniden bağlanın.
4. Beklenmeyen etkinlikler için billing_transactions_list ve cdrs_list inceleyin.

Sorun Giderme

Belirti	Olası neden / çözüm
Herhangi bir araçtan 401 Unauthorized	Eksik veya geçersiz Authorization: Bearer … başlığı. API anahtarının Wavix Konsolu'nda etkin olduğunu doğrulayın.
Araç bir download_url döndürür, dosyanın kendisini değil	Beklenen davranış. Kayıt, fatura, konuşma analitiği ve 10DLC kanıt uç noktaları önceden imzalanmış URL'ler döndürür (bkz. Kimlik Doğrulama). URL'yi Authorization başlığı olmadan doğrudan getirin.
İstemci yalnızca ~40 araç gösteriyor, tam kataloğu değil	Eski istemciler sunucu başına araç sınırı uygular. Yükseltin (Cursor 2.4+, en son VS Code, en son Claude).
Bu README'de listelenen bir araç için Tool not found	Yerel istemci eski bir araç listesini önbelleğe alıyor olabilir. İstemciyi yeniden başlatın veya sunucuyu kaldırıp yeniden ekleyin.
errors dizisiyle 4xx	Wavix API'sinden doğrulama hatası. errors inceleyin; ilgili wavix://docs/* sayfasına veya OpenAPI spesifikasyonuna başvurun.
Sunucuya ulaşılamıyor	mcp.wavix.com:443 için DNS ve giden HTTPS'i doğrulayın.
Aracı beklenmedik şekilde yıkıcı bir araç çağırıyor	Çoğu istemci araç çağrılarından önce onay isteyebilir — bu ayarı etkinleştirin ve özel bir MCP API anahtarına geçin (bkz. En iyi uygulamalar).

Uyumluluk ve sınırlar

• Streamable HTTP taşımasını destekleyen herhangi bir MCP istemcisiyle uyumludur (Claude Desktop / Web / Code, Cursor 2.4+, VS Code, Windsurf, özel MCP SDK'ları) ve MCP istemci bağdaştırıcısı olan herhangi bir aracı çerçevesiyle.
• Eski istemciler sunucu başına araç sınırı uygulayabilir; tam kataloğa erişmek için güncel bir sürüme yükseltin.
• Hız sınırları ve kullanım ücretleri Wavix hesap planınıza göre belirlenir. Bkz. Wavix fiyatlandırması.

Değişiklik günlüğü

Barındırılan sunucu, Wavix OpenAPI spesifikasyonu geliştikçe sürekli güncellenir; yeni araçlar otomatik olarak görünür ve mevcut araç argümanları isteğe bağlı alanlar kazanabilir. Bu depo için dokümantasyon değişiklikleri Sürümler altında izlenir. Araç girdilerini veya kimlik doğrulamayı etkileyen önemli davranış değişiklikleri için hem orada hem de Wavix sürüm notları bölümünde bir bildirim yayınlayacağız.

Destek

• Ürün dokümanları: https://docs.wavix.com
• API referansı: https://docs.wavix.com/api-reference
• Sorular / geri bildirim: support@wavix.com

Katkıda bulunma

Bu depo kaynak olarak erişilebilir ancak harici katkılara açık değildir. Pull request'ler otomatik olarak kapatılır ve Issues / Discussions devre dışıdır. Hata raporlarını, özellik isteklerini ve geri bildirimleri support@wavix.com adresine gönderin. Ayrıntılar için CONTRIBUTING.md bölümüne bakın.

Altta yatan FastMCP çerçevesinde bir hata bulursanız, lütfen bunu orada yukarı akışta bildirin.

Güvenlik

Bir güvenlik açığı bildirmek için, genel bir sorun açmak yerine lütfen support@wavix.com adresine Security: <short summary> konusuyla e-posta gönderin. Ayrıntılar için SECURITY.md bölümüne bakın.

Lisans

MIT © Wavix