MCP
Claude, Cursor veya herhangi bir MCP istemcisini uzak WASync sunucusuna bağlayın. Altı araç, sizin tarafınızda tek satır kod yok.
WASync, Streamable HTTP üzerinden çalışan uzak bir MCP sunucusu sunar. Bunu bir MCP istemcisine eklediğinizde ajan, sizin tarafınızda hiç kod olmadan WhatsApp araçlarına kavuşur.
https://cloudapi.wasync.app/api/mcpBu alan adı bilinçli olarak seçildi. REST temel URL'si ve kullanıcıya dönük tüm
bağlantılar developers.wasync.app adresini kullanır. Ancak MCP sunucusunun
URL'si, OAuth uç noktaları ve /.well-known/… belgeleri, istemcilerin zaten
kaydettiği protokol tanımlayıcılarıdır; cloudapi.wasync.app üzerinde kalırlar
ve bayt bayt eşleşmelidir. Bunları "düzeltmeyin".
İstemci bağlama
Yapılandırma dosyası okuyan istemciler için (Claude Desktop, Cursor, …):
{
"mcpServers": {
"wasync": {
"url": "https://cloudapi.wasync.app/api/mcp"
}
}
}Kimlik doğrulama, istemci tarafından yürütülen PKCE'li OAuth 2.0 ile yapılır: ilk çağrıda bir tarayıcı açılır, onay verirsiniz ve istemci belirteçleri saklar. Yapıştırmanız gereken bir anahtar yoktur.
Yerel uzak MCP desteği olmayan bir istemci, stdio üzerinden köprü kurabilir:
npx mcp-remote https://cloudapi.wasync.app/api/mcpKayıt defterinde bulun
WASync, resmî MCP Registry'de şu adla listelenir:
app.wasync/whatsappKayıt defterini okuyan istemciler ve dizinler, URL'yi yapıştırmak yerine sunucuyu adıyla bulabilir.
Araçlar
| Tool | What it does | Needs |
|---|---|---|
list_whatsapp_connections | İznin kullanabileceği bağlantıları durumları ve lisans bilgileriyle listeler. Diğer tüm araçlar, buradan alınan bir bağlantı kimliğini kullanır. | read |
get_whatsapp_connection | Tek bir bağlantının güncel durumu: çevrimiçi olup olmadığı, lisans durumu ve bitiş tarihi. Salt okunurdur. | read |
read_whatsapp_messages | Kayıtlı mesajlar, en yeniden başlayarak; paylaşılan tüm bağlantılarda veya yalnızca birinde; nextCursor ile sayfalanır. Hiçbir şey gönderilmez ve okundu bilgisi gösterilmez. | read |
send_whatsapp_message | Bir bağlantıdan tek bir alıcıya metin mesajı gönderir. Aracın açıklaması, modele önce alıcıyı ve metni onaylatmasını söyler: WhatsApp mesajı geri alınamaz. | send |
send_whatsapp_file | İsteğe bağlı bir açıklamayla dosya gönderir (belge, görsel, ses veya video; en fazla 5 MB). url alanına doğrudan bir https bağlantısı (tercih edilen) ya da data alanına base64 verin. Aynı önce onayla kuralı geçerlidir: geri alınamaz. | send |
mark_whatsapp_messages_read | Bir müşterinin gelen mesajlarını telefon numarasına veya bir mesaj kimliğine göre okundu olarak işaretler (mavi tikler). | send |
Bu araçlar GET /connections, GET /connections/{id}, GET /messages,
POST /messages (metin ve medya) ve POST /messages/read uç noktalarına
karşılık gelir ve aynı kapsamlara tabidir; bir ajan
yalnızca iznin izin verdiği işlemleri yapabilir.
Dosya gönderme
send_whatsapp_file, url veya data alanlarından tam olarak birini alır:
{
"connectionId": "conn_123",
"to": "40700000000",
"url": "https://files.example.com/offers/offer-2026.pdf",
"filename": "offer-2026.pdf",
"caption": "Here is the offer we discussed."
}url, internetteki herkesin oturum açmadan açabileceği bir dosyaya giden doğrudanhttps://bağlantısı olmalıdır. WASync dosyayı indirir (en fazla 5 MB, 20 saniye) ve siz bir tane vermezsenizmimetypedeğerini dosya sunucusunun yanıtından alır. Özel ağlara, WASync'in kendisine veya dosya yerine bir web sayfasına işaret eden bağlantılar reddedilir.data, düz base64 biçiminde dosyadır (data:öneki olmadan); çözüldüğünde en fazla 5 MB olmalıdır ve bu durumdamimetypezorunludur.urlkullanmayı tercih edin: dosya baytlarını bir modelin konuşması içinde taşımak yavaş ve pahalıdır.filename, alıcının gördüğü addır (eğik çizgi içermez);captionisteğe bağlıdır ve en fazla 1024 karakter olabilir.
Hatalar, mesajın başında sabit bir kodla araç hatası olarak döner:
invalid_url, url_not_allowed, download_failed, file_too_large,
invalid_media veya WASync gönderimi reddettiğinde send_failed: <reason>.
MCP mi, REST API mi?
WhatsApp'a erişmesi gereken bir insan gözetimindeki ajan için MCP'yi kullanın: bir sohbet istemcisinden yanıt vermek, yanıt taslağı hazırlamak, bilgi aramak gibi. Davranışın sahibi kendi yazılımınızsa ve webhook'lara, idempotency anahtarlarına, 5 MB'tan büyük dosyalara veya provizyonlamaya ihtiyaç duyuyorsanız REST API'yi kullanın; bunların hiçbirini MCP sunmaz.
OAuth izni yalnızca zaten var olan bağlantılar üzerinde verilir; bu nedenle MCP, bir çalışma alanının ilk bağlantısını oluşturamaz. Önce bir API key ile oluşturun: Hızlı başlangıç.