WhatsApp Business Tools MCP

npx add-mcp 'https://mcp.facebook.com/whatsapp_business_tools'

WhatsApp Business Tools MCP

WhatsApp Business Platform (Cloud API) üzerinde geliştirme yapan geliştiriciler için — WhatsApp Business Tools MCP sunucusu, yapay zeka ajanınızın ve IDE asistanınızın WhatsApp Business entegrasyonunuzu tek bir yerden yönetmesini ve hata ayıklamasını sağlar. Ajanın, yönettiğiniz işletmeleri ve WhatsApp hesaplarını keşfetmesine, telefon numaralarını kaydetmesine ve kayıt etmesine, mesaj şablonları oluşturup yönetmesine, webhook'ları yapılandırmasına ve mesaj göndermesine olanak tanır — sizin adınıza, yönettiğiniz uygulamalar ve işletmeler üzerinde.

Not: WhatsApp Business Tools MCP sunucusu kademeli olarak kullanıma sunulmaktadır ve henüz herkese açık olmayabilir. Arayüz ve araç seti beta aşamasındadır ve değişebilir.

Genel Bakış

Aşağıdaki tablo sunucu ayrıntılarını özetlemektedir:

Özellik	Değer
Sunucu adı	WhatsApp Business Tools
Taşıma	Streamable HTTP
Uç nokta	https://mcp.facebook.com/whatsapp_business_tools
Kimlik doğrulama	Meta geliştirici hesabı oturum açma (OAuth)
Durum	Beta - arayüz ve araç seti değişebilir

Ön Koşullar

Sunucu, kendi varlıklarınız üzerinde çalışır; bu nedenle bir ajanın çoğu aracı kullanabilmesi için şunlara ihtiyacınız vardır:

• Yönetmek istediğiniz bir işletmeye yönetici erişimi (MANAGE rolü).
• Yöneticisi olduğunuz, WhatsApp özellikli bir uygulama — bu işletmeye bağlı, WhatsApp Business Messaging kullanım senaryosuna sahip (veya eski bir uygulamada WhatsApp ürünü) bir uygulama. Uygulama üzerinde yönetici erişiminiz olmalıdır, yalnızca işletme üzerinde değil.
• Bu işletme için WhatsApp Business Cloud API Hizmet Şartları'nın kabul edilmesi. Mesajlaşma ve telefon numarası kaydı, bir yönetici bunları kabul edene kadar engellenir.

Ön koşullardan herhangi biri eksikse, araç neyi düzeltmeniz gerektiğini söyleyen ve düzeltebileceğiniz sayfaya bağlantı veren, uygulanabilir bir hata döndürür.

IDE'nizi veya ajan istemcinizi ayarlayın

WhatsApp Business Tools MCP sunucusu uzak bir sunucudur. Uzak MCP sunucularını destekleyen istemciler, uç noktaya doğrudan bağlanabilir. Yalnızca yerel (stdio) sunucuları destekleyen istemciler için, uzak sunucuyu stdio üzerinden proxy'leyen mcp-remote köprüsünü kullanın.

İstemcinizi aşağıdaki bölümlerden birini kullanarak yapılandırın, ardından kimlik doğrulamak için OAuth oturum açmayı tamamlayın.

Claude Code ve Desktop

Claude Code — sunucuyu eklemek için aşağıdaki komutu çalıştırın:

claude mcp add --transport http whatsapp_business_tools https://mcp.facebook.com/whatsapp_business_tools

Ardından bir oturumda /mcp çalıştırın ve kimlik doğrulamak için whatsapp_business_tools seçeneğini belirleyin.

Claude Desktop — Ayarlar > Bağlayıcılar > Özel bağlayıcı ekle seçeneğini açın, ardından şunları ayarlayın:

• Ad: WhatsApp Business Tools
• URL: https://mcp.facebook.com/whatsapp_business_tools

OpenAI Codex App ve ChatGPT

Codex App — Ayarlar (sol alttaki dişli simgesi) > MCP Sunucuları > Sunucu ekle seçeneğini açın, Streamable HTTP seçin, ardından şunları ayarlayın:

• Ad: WhatsApp Business Tools
• URL: https://mcp.facebook.com/whatsapp_business_tools
• Kimlik doğrulama: OAuth

Kimlik Doğrula seçeneğine tıklayın ve OAuth oturum açmayı tamamlayın.

ChatGPT — Ayarlar > Eklentiler > Eklentilere göz at seçeneğini açın, yeni bir eklenti eklemek için sağ üstteki + simgesine tıklayın, ardından şunları ayarlayın:

• Ad: WhatsApp Business Tools
• URL: https://mcp.facebook.com/whatsapp_business_tools
• Kimlik doğrulama: OAuth

Eklentiyi kaydedin ve OAuth oturum açmayı tamamlayın.

OAuth oturum açma

WhatsApp Business Tools MCP sunucusu, Meta geliştirici hesabınızla OAuth üzerinden kimlik doğrular; bu nedenle aynı oturum açma akışı her istemciyle çalışır.

Oturum açma akışı

Sunucuyu istemcinize ekledikten sonra (bkz. IDE'nizi veya ajan istemcinizi ayarlayın):

1. Bağlantıyı başlatın. Birçok istemci, sunucu eklendiğinde OAuth akışını otomatik olarak başlatır. Diğerleri önce Bağlan veya Kimlik Doğrula seçeneğine tıklamanızı gerektirir.
2. Oturum açın. Tarayıcınız Meta hesabınızla oturum açmak için açılır. Otomatik açılmazsa, istemcinizin yazdırdığı bağlantıyı kopyalayıp manuel olarak açın.
3. Erişim izni verin. Onay ekranında, sunucunun erişmesini istediğiniz işletmeleri ve WhatsApp özellikli uygulamaları seçin.
4. Onaylayın. İstemcinize dönün ve bağlantınızı doğrulayın.

İstemciyi yeniden başlattığınızda oturum açma akışını tekrar tamamlamanız gerekir.

Kapsamlar

Sunucu, onay sırasında aşağıdaki izinleri ister:

Kapsam	Erişim
business_management	Onay sırasında seçtiğiniz, yönettiğiniz işletmeleri keşfedin ve bunlar üzerinde işlem yapın.
whatsapp_business_management	WhatsApp Business hesaplarını, telefon numaralarını, mesaj şablonlarını ve webhook'ları yönetin.
whatsapp_business_messaging	Kayıtlı telefon numaralarınızdan mesaj gönderin.

Erişimi istediğiniz zaman facebook.com > Ayarlar > İşletme Entegrasyonları bölümünden inceleyebilir veya iptal edebilirsiniz.

Bağlantınızı doğrulayın

Sunucuyu ekledikten sonra ajanınızın araçları görebildiğini doğrulayın:

1. IDE'yi veya ajan istemcisini yeniden başlatın.
2. Ajandan, whatsapp_business_tools sunucusundan sahip olduğu araçları listelemesini isteyin.
3. Düşük riskli bir okuma aracı çalıştırın. Örneğin, whatsapp_biz_businesses ile yönettiğiniz işletmeleri listelemesini isteyin.

Ajan araç bulamazsa veya kimlik doğrulama hatası bildirirse, uç nokta URL'sini yeniden kontrol edin ve oturum açma akışını tamamladığınızı doğrulayın.

Araçlar

WhatsApp Business Tools MCP, whatsapp_biz_ önekiyle adlandırılmış araçları kullanıma sunar. Çoğu araç, yönettiğiniz bir işletmeye göre kapsamlandırılmıştır; bu nedenle tipik bir oturum, işletmelerinizi listeleyip birini seçerek başlar. Araç seti beta sırasında gelişmektedir.

Keşif

• whatsapp_biz_businesses — Yönettiğiniz ve onay sırasında izin verdiğiniz işletmeleri listeleyin. Bir işletme seçmek için önce bunu kullanın. Örnek: "WhatsApp'ta yönetebileceğim işletmeleri listele."
• whatsapp_biz_accounts — Bir işletme altındaki WhatsApp hesaplarını (ve mesajlaşma hesaplarını) listeleyin. Örnek: "1234567890 işletmesi için WhatsApp hesaplarını göster."
• whatsapp_biz_phone_numbers — Bir işletme veya WhatsApp hesabındaki telefon numaralarını, durum ve kayıt durumuyla birlikte listeleyin. Örnek: "Bu işletme için telefon numaralarını ve durumlarını listele."

Telefon numarası kaydı

• whatsapp_biz_add_phone_number — Bir WhatsApp hesabına telefon numarası ekleyin. Örnek: "+1 555 010 1234 telefon numarasını WhatsApp hesabıma ekle."
• whatsapp_biz_send_verification_code — Bir telefon numarasına doğrulama kodu gönderin. Örnek: "Bu numaraya SMS ile doğrulama kodu gönder."
• whatsapp_biz_verify_phone_number — Alınan kodla bir telefon numarasını doğrulayın. Örnek: "Bu numarayı 123456 koduyla doğrula."
• whatsapp_biz_register_phone_number — Mesaj gönderip alabilmesi için doğrulanmış bir numarayı kaydedin. Örnek: "Bu numarayı mesajlaşma için kaydet."

Mesaj şablonları

• whatsapp_biz_list_templates / whatsapp_biz_get_template — Bir hesaptaki mesaj şablonlarını listeleyin ve inceleyin. Örnek: "Bu hesap için onaylanmış şablonları listele."
• whatsapp_biz_create_template / whatsapp_biz_update_template / whatsapp_biz_delete_template — Mesaj şablonları oluşturun, güncelleyin ve silin. Örnek: "en_US dilinde order_update adında bir pazarlama şablonu oluştur."

Mesajlaşma

• whatsapp_biz_send_message — Kayıtlı bir numaradan serbest biçimli metin (yalnızca 24 saatlik müşteri hizmetleri penceresi içinde teslim edilir) veya onaylanmış bir şablon mesajı gönderin. Göndermeden önce hedefi sizinle onaylar. Örnek: "order_update şablonunu bu numaradan +1 555 010 9999'a gönder."

Webhook'lar

• whatsapp_biz_configure_webhooks — WhatsApp konusu için geri çağırma URL'sini ve doğrulama belirtecini ayarlayın ve izin verilen alanlara abone olun. Örnek: "Bu işletme için webhook'ları https://example.com/webhook." geri çağırma ile yapılandır
• whatsapp_biz_subscribe_webhook — Bir WhatsApp hesabını uygulamanızın webhook'larına abone edin, böylece olayları teslim edilir. Örnek: "Bu WhatsApp hesabını webhook'lara abone et."

Hesap kurulumu

• whatsapp_biz_configure_payments — Hesabın faturalandırılabilir mesajlar gönderebilmesi için bir ödeme yöntemi yapılandırın. Örnek: "Bu hesap için ödemeleri ayarlamama yardım et."
• whatsapp_biz_verify_business — İşletme doğrulamasını kontrol edin ve başlatın. Örnek: "İşletme doğrulama durumu nedir ve nasıl başlatırım?"
• whatsapp_biz_system_user_token — İşletmeniz için bir sistem kullanıcısı erişim belirteci oluşturmak üzere bir bağlantı alın; böylece WhatsApp Cloud API'yi doğrudan çağıran özel bir mesajlaşma çözümü oluşturabilirsiniz. Belirteç oluşturma, İşletme Ayarları'nda güvenli bir şekilde gerçekleşir — araç, bir sistem kullanıcısı seçip belirteci oluşturduğunuz Sistem Kullanıcıları sayfasına derin bir bağlantı döndürür. Daha fazla bilgi için bkz. Sistem kullanıcısı oluşturma ve kalıcı erişim belirteci oluşturma. Örnek: "Bu işletme için bir sistem kullanıcısı erişim belirteci oluşturmak üzere bana bir bağlantı ver."

Hız sınırları

Platformu korumak için istekler, kullanıcı başına araç başına hız sınırına tabidir. Sınırı aşarsanız, araç bir hız sınırı hatası döndürür; kısa bir süre bekledikten sonra tekrar deneyin.

Geri bildirim

Geri bildiriminiz varsa veya daha fazla araç görmek istiyorsanız, geri bildiriminizi paylaşın.

İlgili

• MCP genel bakış
• WhatsApp Business Platform belgeleri

---

Bu ürün için tam belge dizini: https://developers.facebook.com/documentation/mcp/llms.txt