Wavix

Wavix MCP Sunucusu

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

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

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

İçindekiler

• Uç Nokta
• Kurulum — tek tıklamayla, Claude Code, Claude Desktop / Web, Cursor, VS Code, Codex CLI, Windsurf
• Kendiniz ç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 token ele geçirilirse)
• Sorun Giderme
• Uyumluluk ve sınırlamalar
• Destek, Katkıda Bulunma, Güvenlik, Lisans

Uç Nokta

Alan	Değer
URL	https://mcp.wavix.com/mcp
Aktarım	Streamable HTTP
Kimlik Doğrulama	Authorization: Bearer <api_key>
Araçlar	TOOLS.md dosyasına bakın
Kaynaklar	Wavix dokümanları + OpenAPI spesifikasyonu (otomatik keşfedilir)

Wavix Konsolu → Yönetim → API anahtarları → Yeni oluştur üzerinden bir Wavix API anahtarı edinin.

Kurulum

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

1. https://wavix.com adresinde oturum açın.
2. Yönetim → API anahtarları bölümünü açın.
3. Yeni oluştur 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ıklamayla kurulum

⚠️ Aşağıdaki düğmeler, düzenleyicinizin MCP yapılandırmasına YOUR_API_KEY yer tutucu token'ını ekler. Düzenleyici kurulumu tamamladıktan 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ürecektir.

Daha sonra kaldırmak için: aynı yapılandırma dosyasını (~/.cursor/mcp.json, .vscode/mcp.json veya düzenleyiciniz için eşdeğeri) açın ve wavix girişini silin ya da düzenleyicinizin MCP / Bağlayıcılar kullanıcı arayüzü aracılığıyla bağlayıcıyı 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 bir oturum içinde durum için /mcp kullanın.

Claude Desktop / Claude Web

Ayarlar → Bağlayıcılar → Özel bağlayıcı ekle:

• Ad: Wavix
• URL: https://mcp.wavix.com/mcp
• Aktarım: 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 altındaki "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. Barındırılan sunucuya mcp-remote aracılığıyla 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 aktarımını destekleyen herhangi bir MCP istemcisi çalışacaktı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ı kurulum yapıyorsunuz? Ajanınızı llms-install.md adresine yönlendirin — bu, modele URL'yi, başlığı ve istemci başına yapılandırmayı deterministik bir formatta veren, böylece uç nokta değerlerini doğaçlama yapmasını engelleyen makine tarafından okunabilir bir kurulum kılavuzudur.

Kendiniz çalıştırın

Barındırılan sunucu çoğu kullanıcı için kutudan çıktığı gibi çalışır. Herkese açık olmayan bir Wavix dağıtımına yönlendirmeniz, güvenlik duvarı arkasında çalıştırmanız veya kendi altyapınız içinde işletmeniz gerekiyorsa kendi kendine 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.

Kaynaktan

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 (dahili dağıtımlar veya hazırlık 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 herkese açık olarak sunmadan önce sunucunun önünde TLS sonlandırmasından (nginx, Caddy, bulut yük dengeleyici) sorumludur.

Örnekler

Bağlı herhangi bir istemciye bırakabileceğ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 bir SMS gönderin

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

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

Bir 2FA doğrulaması çalıştırın

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

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

Bir telefon numarası bulun ve satın alın

İstem: "SMS özellikli, kullanılabilir bir ABD ücretsiz numarası bul, sepete ekle ve ödemeyi tamamla."

Ajan, buy_numbers_list (ülke ve özelliğe göre filtreleme), cart_add ve cart_checkout'i zincirler. Ödeme yapmadan önce kullanıcıyla onaylayın — hesaba ücret yansıtır.

Arama transkriptlerini arayın

İstem: "Dün gelen, iki dakikadan uzun süren ve arayanın 'iade' kelimesini geçirdiği tüm aramaları göster."

Ajan, transkripsiyonlara karşı cdrs_search'i kullanır, ardından tam arama meta verileri için her sonucu cdrs_get aracılığıyla zenginleştirir.

Bir kaydı alın ve transkribe edin

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

Ajan call_recording_get'i (ön imzalı bir indirme URL'si döndürür), cdrs_retranscribe'i çağırır, ardından cdrs_transcription_get'i yoklar.

Faturalandırmayı denetleyin

İ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, ardından billing_invoices_list + billing_invoices_download'i çağırır. İndirme aracı, dosyanın kendisini değil, PDF'e yönelik ön imzalı 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 spesifikasyonundan oluşturulan 122 araç. Argümanlar, istek parametrelerini ve gövde alanlarını yansıtır.

Grup	#	Kapsam
SMS ve MMS	10	Mesaj gönderme, listeleme, alma; gönderici kimlikleri; çıkışlar
Arama kontrolü	9	Aramaları başlatma / cevaplama / sonlandırma; ses çalma; DTMF toplama
Arama kaydı	3	Listeleme, indirme (ön imzalı URL), silme
Arama akışı	2	Medya akışını başlatma / durdurma
Arama web kancaları	3	Listeleme, oluşturma, silme
CDR'ler	6	Listeleme, dışa aktarma, alma; transkripsiyon arama ve yeniden transkribe etme
Konuşma Analitiği	4	Yükleme, transkribe etme, orijinal dosyayı alma
2FA	6	Doğrulama oluşturma / kontrol etme / iptal etme / yeniden gönderme; olaylar
Numaralarım	7	Listeleme, güncelleme, serbest bırakma; SMS / ses yönlendirme; belge yükleme
Satın Al	5	Ülkeler, bölgeler, şehirler; kullanılabilir numara arama
Sepet	4	Ekleme, çıkarma, 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	Profili alma / güncelleme; hesap yapılandırması
API Anahtarları	5	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 Gömülebilir (WebRTC)	5	Widget token'ları CRUD
Bağlantı kısaltıcı	2	Kısa bağlantı oluşturma; metrikler

Tek satırlık açıklamalarla birlikte tam araç listesi için TOOLS.md dosyasına bakın. Yetkili kaynak Wavix OpenAPI spesifikasyonudur — istemciniz her zaman güncel canlı kataloğu görür.

Kaynaklar

Araçlara ek olarak, sunucu Wavix dokümantasyonunu MCP Kaynakları olarak sunar, böylece model ön bilgiden tahmin yürütmek yerine talep üzerine yetkili bağlamı çekebilir.

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

Her iki kaynak da — docs.wavix.com ve Wavix OpenAPI spesifikasyonu — herkese açıktır ve kimlik doğrulaması olmadan doğrudan göz atılabilir.

Kaynaklar, resources/read üzerinde tembelce getirilir ve sunucu tarafında 1 saatlik TTL ile önbelleğe alınır. Yukarı akış Bearer token'ı, dokümantasyon 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. Token:

• asla günlüğe kaydedilmez,
• asla çapraz ana bilgisayar yönlendirmelerinde (ör. ön imzalı S3 indirme URL'leri) iletilmez,
• asla dokümantasyon ana bilgisayarlarına 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 ön imzalı 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 → Yönetim → API anahtarları adresinde (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ı bozmadan MCP erişimini iptal etmenizi sağlar.

• Periyodik olarak döndürün. API anahtarına herhangi bir üretim sırrı gibi davranın: programa uygun olarak ve herhangi bir sızıntı şüphesinde döndürün.

• API anahtarlarını git dışında tutun. MCP istemci yapılandırmaları, token'ı geçmişe ve CI günlüklerine taşıyarak kazara commit edilmesi kolaydı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 ona başvurun. Bir 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 token ele geçirilirse

1. Wavix Konsolu'nda anahtarı hemen devre dışı bırakın (veya api_keys_deactivate çağrısı yapın).
2. api_keys_create veya Konsol üzerinden yeni bir anahtar 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 kayıtlarını inceleyin.

Sorun Giderme

Belirti	Olası neden / çözüm
Herhangi bir araçtan 401 Unauthorized hatası	Eksik veya geçersiz Authorization: Bearer … başlığı. Wavix Konsolu'nda API anahtarının etkin olduğunu doğrulayın.
Araç, dosyanın kendisi yerine download_url döndürüyor	Beklenen bir durumdur. Kayıt, fatura, konuşma analizi ve 10DLC kanıt uç noktaları ön imzalı URL'ler döndürür (bkz. Kimlik Doğrulama). URL'yi Authorization başlığı olmadan doğrudan getirin.
İstemci tam katalog yerine yalnızca ~40 araç gösteriyor	Eski istemciler sunucu başına bir araç sınırı uygular. Güncelleyin (Cursor 2.4+, en son VS Code, en son Claude).
Bu README'de listelenen bir araç için Tool not found hatası	Yerel istemci eski bir araç listesini önbelleğe almış olabilir. İstemciyi yeniden başlatın veya sunucuyu kaldırıp yeniden ekleyin.
errors dizisi içeren 4xx hatası	Wavix API'den doğrulama hatası. errors ayrıntılarını inceleyin; ilgili wavix://docs/* sayfasına veya OpenAPI şartnamesine başvurun.
Sunucuya erişilemiyor	DNS ve mcp.wavix.com:443 adresine giden HTTPS bağlantısını kontrol edin.
Ajan beklenmedik şekilde yıkıcı bir araç çağırıyor	Çoğu istemci, araç çağrılarından önce onay isteyecek şekilde ayarlanabilir — bu ayarı etkinleştirin ve özel bir MCP API anahtarına geçin (bkz. En İyi Uygulamalar).

Uyumluluk ve Sınırlamalar

• Streamable HTTP aktarımını destekleyen tüm MCP istemcileri (Claude Desktop / Web / Code, Cursor 2.4+, VS Code, Windsurf, özel MCP SDK'ları) ve MCP istemci adaptörüne sahip tüm ajan çerçeveleriyle uyumludur.
• Eski istemciler sunucu başına bir araç sınırı uygulayabilir; tam kataloğa erişmek için güncel bir sürüme yükseltin.
• Hız limitleri ve kullanım ücretleri Wavix hesap planınıza tabidir. Bkz. Wavix fiyatlandırması.

Değişiklik Günlüğü

Barındırılan sunucu, Wavix OpenAPI şartnamesi geliştikçe sürekli olarak 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ı sayfasında bir duyuru 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 kaynağı açık ancak dış katkılara kapalıdır. Çekme istekleri otomatik olarak kapatılır ve Sorunlar / Tartışmalar 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 sayfasına bakın.

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

Güvenlik

Bir güvenlik açığını bildirmek için, lütfen herkese açık bir sorun açmak yerine Security: <short summary> konu başlığıyla support@wavix.com adresine e-posta gönderin. Ayrıntılar için SECURITY.md sayfasına bakın.

Lisans

MIT © Wavix