TrueDialog MCP

resmi

AI Agent’ınıza entegre TrueDialog. Ödüllü TrueDialog platformu üzerinden çok kanallı mesajlar gönderin ve kişileri yönetin. Mevcut TrueDialog hesabınızı kullanarak işletme SMS’leri ve RCS mesajları göndermek, kişileri yönetmek için AI Agent’ınızı TrueDialog’a bağlayın. Kişileri arayın ve alın, kişi kayıtları oluşturun veya güncelleyin, hesap ayrıntılarını ve yapılandırılmış 10DLC/uzun kod ve kısa kod kanallarını görüntüleyin, bir veya birden fazla alıcıya giden metin mesajları gönderin. SMS ve RCS pazarlama iletişimi, uyarılar ve bildirimler, randevu ve etkinlik hatırlatmaları, satış takibi, müşteri hizmetleri güncellemeleri ve çalışan iletişimi için TrueDialog’ı kullanın. Mesajlar, güvenilir ve mevzuata uygun SMS iş akışlarını desteklemek için TrueDialog’ın doğrudan operatör bağlantılarını ve yerleşik abonelikten çıkma yönetimini kullanır.

tdmcp.com üzerinde görüntüle

TrueDialog MCP ile neler yapabilirsiniz?

Check your session — Ask which TrueDialog user and account your authorized connection is acting as, as a quick auth check.
Browse accounts and channels — List every account your login can see, fetch one account's details, or list its SMS, RCS, email, and voice channels.
Look up contacts — Fetch a contact by id or search across phone numbers and email addresses by substring.
Create or update contacts — Add a contact from a phone number or email, or update only the fields you pass without overwriting the rest.
Send SMS — Text one or more numbers, with a dry run available, and let the connector pick a sending channel if you don't name one.

Dokümantasyon

MCP, Model Context Protocol, bir yapay zekâ istemcisinin gerçekten bir şeyler yapabilmek için ihtiyaç duyduğu araçlara ve verilere nasıl eriştiğini tanımlar. tdmcp, MCP konuşan herhangi bir istemci ile TrueDialog SMS API arasındaki altyapıdır: otuz yıllık operatör altyapısı, abonelikten çıkma işlemleri, iki yönlü konuşmalar, RCS, MMS ve kısa kod trafiği; iyi adlandırılmış küçük bir araç kümesi olarak sunulur.

Kimlik doğrulama, yapıştırılmış kimlik bilgileriyle değil OAuth 2.1 ile yapılır. Tarayıcınızda auth.tdmcp.com üzerinden bir kez yetki verirsiniz; portala giriş yapmak için kullandığınız TrueDialog hesabıyla oturum açarsınız. Yapay zekâ istemciniz yalnızca kısa ömürlü bir bearer token tutar, parolanızı asla tutmaz ve token'ı her çağrıda gönderir. Bağlayıcı token'ı doğrular ve özel bir arka kanal üzerinden TrueDialog erişiminizi sunucu tarafında çözümler. İstemci yapılandırmanıza uzun ömürlü hiçbir bilgi kaydedilmez.

Çalışma zamanı özellikle sıradandır: yönetilen bir ön kapının arkasında Azure Container Apps, AMD64 kapsayıcıları, Streamable HTTP sunan FastMCP, yapışkan oturum yok. Tüm altyapı Terraform ile yönetilir. Şaşırtıcı hiçbir şey yok; sıcak yolda sizin eklemediğiniz hiçbir şey yok.

Uç nokta: https://connect.tdmcp.com. Streamable HTTP, durumsuz. Aynı aktarım https://connect.tdmcp.com/mcp adresinde de yanıt verir — /mcp yol kuralını varsayan istemciler için bir uyumluluk takma adı; iki URL de çalışır. Kimlik doğrulama OAuth 2.1 ile yapılır — istemciniz bunu otomatik olarak keşfeder ve tarayıcıda oturum açma sürecinde size yol gösterir. Yapıştırmanız gereken anahtar veya üstbilgi yoktur.

Yetkilendirme nasıl çalışır?

Aşağıdaki her istemci aynı dört adımı izler ve bunların çoğu sizin için gerçekleşir:

İstemcinize connect.tdmcp.com adresini eklersiniz.
İstemci, OAuth sunucusunu auth.tdmcp.com adresinde bulur ve kendini otomatik olarak kaydeder (dinamik istemci kaydı, PKCE).
Bir tarayıcı penceresi açılır. TrueDialog kimlik bilgilerinizle oturum açarsınız.
İstemciniz bir token alır ve bağlantınız kurulur. Token'ı kendi kendine yeniler — oturum süresi dolana kadar yeniden oturum açmanız gerekmez.

Claude'da (Desktop uygulaması veya claude.ai), Customize → Connectors bölümünü açın ve + → Add custom connector seçeneğine tıklayın. Bir ad ve uç nokta URL'si girin:

özel bağlayıcı ekle

Name:   TrueDialog
URL:    https://connect.tdmcp.com/

Add'e, ardından Connect'e tıklayın. TrueDialog'da oturum açmanız için bir tarayıcı penceresi açılır; onayladığınızda dokuz araç görünür — Claude, OAuth sunucusuna kendini otomatik olarak kaydeder; yapıştırmanız gereken hiçbir şey yoktur. Team/Enterprise sürümünde, önce bir Owner'ın kuruluş için bu özelliği etkinleştirmesi gerekir (Organization settings → Connectors → Add → Custom → Web); ardından her üye bunu Customize → Connectors bölümünden ekler.

Her MCP aracı, belirli bir TrueDialog API yüzeyine karşılık gelir. Araçlar bilerek küçük ve anlaşılır tutulmuştur; aracının akıl yürütmesi araç listesinde değil, istemde yer alır. Toplam dokuz araç vardır — altısı salt okunur, üçü yazma işlemi yapar.

whoami Yetkilendirilmiş oturumunuzun arkasındaki kullanıcıyı ve hesabı döndürür. Tek seferlik bir kimlik doğrulama kontrolü için kullanışlıdır. Salt okunur.
list_accounts Girişinizin erişebildiği tüm hesapları listeler. Çok kiracılı ortamlardaki operatörler için önemlidir; tek hesaplı kullanıcılar için değil. Salt okunur.
get_account_info Tek bir hesap kaydını getirir. Varsayılan olarak kimliği doğrulanmış hesabı kullanır. Salt okunur.
list_channels Bir hesaptaki kanalları — long code, short code, RCS, email, voice — listeler. send_sms çağrısından önce kanal kimliğini bulmak için kullanın. Salt okunur.
get_contact Bir kişiyi kimliğine göre arar. Salt okunur.
search_contacts Telefon numaraları ve e-posta adreslerinde alt dize eşleşmesi yapar. Salt okunur.
create_contact Bir telefon numarası veya e-posta adresiyle kişi oluşturur (en az biri gereklidir). Bu numara veya e-posta zaten bir kişide kayıtlıysa TrueDialog oluşturma işlemini reddeder ve sizi update_contact aracına yönlendirir — sessizce yinelenen kayıt oluşturmaz.
update_contact Bir kişinin telefonunu, e-postasını veya adını günceller. Önce kaydı okur ve yalnızca ilettiğiniz alanları yeniden yazar; böylece TrueDialog'un her şeyi üzerine yazan güncelleme işlemi diğer alanları silmez — bu bir oku-değiştir-yaz işlemidir, dolayısıyla manage iznine ek olarak contact-read izni gerektirir ve eşzamanlı bir düzenlemeye karşı atomik değildir. Yazma işlemi.
send_sms Bir veya daha fazla numaraya giden SMS gönderir. Gerçek bir gönderimdir: varsayılan olarak canlı telefonlara ulaşır (deneme çalıştırması için execute=false iletin). Gönderim kanalı belirtmezseniz otomatik olarak çözümler. Tek yönlüdür — yanıtları okumaz.

Onunla konuşun.

Bu araçları adlarıyla çağırmazsınız — yalnızca istekte bulunursunuz, doğru araçları da aracı seçer. Bağlandıktan sonra deneyebileceğiniz birkaç örnek:

“Kimin hesabıyla bağlıyım?” kimlik doğrulamayı onaylar
“Hesabımda hangi kanallar ayarlanmış?” kanalları listeler
“+1 512 555 0142 numarasına mesaj gönder: Dört kişilik masanız saat 19.00 için onaylandı.” tek gönderim, tek alıcı
“512 555 0142 numaralı kişinin iletişim bilgilerini bul ve siparişinin gönderildiğini bildir.” arar ve gönderir

Dosyalar e-posta araçları üzerinden iletilir. inbox_send_message ve inbox_reply_to_message araçlarının her biri bir attachments listesi alır; inbox_forward_message ise özgün dosyaları kendisi taşır (include_attachments varsayılan olarak açıktır). attachments listesindeki her girdi tam olarak bir bayt kaynağı belirtir ve seçtiğiniz kaynak, dosyanın ulaşıp ulaşmamasını belirler.

Bu araçlar, dağıtım başına etkinleştirilen Inbox paketine aittir. connect.tdmcp.com adresindeki bağlayıcı şu anda yukarıdaki dokuz TrueDialog aracını sunar; Inbox paketi etkinleştirilen her yerde e-posta araçlarıyla birlikte ekler de kullanılabilir.

attachment_id Bu gelen kutusundaki bir iletide platformun zaten tuttuğu bir eki belirtir — kimlikler inbox_get_thread aracından gelir. Sunucu, saklanan baytları kendisi yeniden ekler; dolayısıyla base64 verisi modelden geçmez. Çok küçük olmayan her şey için ve yanıtladığınız ileti dizisinde baytlar zaten varsa doğal olarak tercih edilmesi gereken yöntem budur. filename ve content_type, saklanan baytlardan devralınır ve geçersiz kılınabilir. Bu yöntem, boyut sınırını değil, metne dönüştürme sınırını ortadan kaldırır. (İletileri yönlendirmek için buna bile gerek yoktur: inbox_forward_message özgün ekleri varsayılan olarak taşır.)
upload_id Depolama alanında önceden hazırlanan baytları belirtir — gerçekten yeni ve büyük bir dosya için kullanılan yöntemdir. Dosyanın adı, MIME türü ve tam bayt uzunluğuyla /v1/inboxes/{inbox_id}/attachments/uploads adresine POST; döndürülen önceden imzalanmış upload_url adresine ham baytları PUT; ardından gönderinizde upload_id değerini belirtin. Inbox paketinin etkin olduğu her yerde inbox_create_attachment_upload ilk adımı gerçekleştirir ve upload_id ile upload_url değerlerini döndürür. Hiçbir araç PUT işlemini yapmaz, dolayısıyla erişimi yalnızca bu bağlayıcıyla sınırlı olan bir aracı yine de yeni baytları hazırlayamaz; yükleme, istemci veya uygulama tarafından PUT dışarıdan yapılmalıdır.
content filename ve content_type ile birlikte sağlanan satır içi base64 verisi. Yalnızca çok küçük dosyalar için güvenilirdir — yaklaşık 2 KB, yani yaklaşık 2.700 base64 karakteri — çünkü dizenin tamamı araç çağrısında karakter karakter üretilmelidir ve tek bir yanlış karakter, anlaşılması güç bir base64 padding hatasıyla gönderimin başarısız olmasına yol açar. Bu, doğrulanmış bir sınır değil, güvenilirlik eşiğidir: 2 KB'de sizi durduran bir şey yoktur. Gönderim kabul edilir ve daha sonra, kod çözme sırasında başarısız olur.

Sunucunun uyguladığı sınırlar

Sunucu tarafında denetlenen üç sınır vardır:

İleti başına 10 MB; biçimi ne olursa olsun tüm girdilerin toplamı — başvurulan baytlar da satır içi baytlarla aynı şekilde, tam boyutlarıyla hesaba katılır. Başvuru kullanmak dosyayı metne dönüştürme gereğini ortadan kaldırır; dosyanın boyutunu küçültmez.
Dosya başına 10 MB; yükleme yuvası oluşturulurken bildirilen size_bytes değerine uygulanır — böylece hiçbir zaman sınırı aşan bir nesneyi depolayabilecek URL verilmez.
Tek bir attachments listesinde 100 girdi.

Toplam, herhangi bir bayt alınmadan önce saklanan meta verilerden denetlenir; her şey çözümlendikten sonra da yeniden denetlenir. Böylece sınırı aşan bir gönderim kısmen iletilmek yerine 422 ile reddedilir. Bu sınırlardan herhangi birini aşan bir grubu birkaç gönderime bölün.

Üç biçim tek bir listede serbestçe karıştırılabilir. Önceden imzalanmış yükleme URL'leri kısa ömürlüdür — varsayılan olarak 15 dakika — ve PUT, imza her ikisini de kapsadığı için size verilen Content-Type ve Content-Length değerlerini aynen göndermelidir. Yükleme tek kullanımlıktır: ona başvuran ilk gönderim yüklemeyi tüketir. GET …/attachments/uploads/{upload_id}, yuvanın hâlâ beklemede olup olmadığını, ne zaman sona ereceğini ve hangi iletinin onu kullandığını bildirir; PUT verisinin ulaşıp ulaşmadığını denetlemez. Baytlar ulaşmadan yapılan gönderim 422 ile reddedilir ve yükleme hakkını tüketmez; böylece PUT tamamlandıktan sonra yeniden deneyebilirsiniz. Ters yönde okumak için inbox_get_attachment, bir ekin baytlarını base64 kodlamalı olarak döndürür.

MCP sunucusu başlangıç noktasıdır. Asıl ürün çalışması onun üzerine kurulur: SMS konuşmalarını sonuçlara dönüştüren bir aracı çalışma zamanı.

Bir SMS yanıtı geldiğinde, doğru aracıyı konuşmanın tüm bağlamıyla uyandırın: yanıtı tetikleyen giden ileti, müşterinin geçmişi ve ileti dizisinin amacı. Aracılar için web kancaları.

Dakika değil, hedef satın. Çok turlu randevu onayı ve yeniden planlama, düşük puanlarda NPS'yi derinleştirme, B2B potansiyel müşteri nitelendirme, destek taleplerini önceliklendirme. Aracı, konuşmayı baştan sona yürütür.

TrueDialog'un uyumluluk konusundaki fikrî mülkiyetini yanıt katmanına uygulayın. “Gece bana mesaj atmayın” ifadesi, abonelikten tamamen çıkma yerine sessiz saatler önerisine dönüşür. TCPA'ya uygun denetim izi ücretsiz olarak sunulur.

Destek temsilcilerinizin yerini almayın. Onlara yardımcı olun. Taslak yanıtlar, ileti dizisi özetleri ve önerilen sonraki en iyi eylemler; tümü, zaten kullandıkları aracı konsolunda sunulur.

Teknoloji yığını

FastMCP / httpx / Python 3.14
Azure Container Apps / ACR / Static Web Apps / Azure DNS
Terraform / Docker

Lisans

MIT.

Yazı tipleri

Lato, JetBrains Mono.