İçeriğe geç
OmniChannels.ai

Yapay zekâ asistanları ve ajanları

Cursor + OmniChannels.ai: geliştirirken mesaj gönderin ve izleyin

MCP ile bağlanınAPI ve webhook'larla bağlanınGüncelleme

Kısaca

Cursor, OmniChannels.ai'ye https://mcp.broadnet.me/mcp adresindeki uzak MCP sunucumuz üzerinden bağlanır. Sunucuyu, jetonunuz bir ortam değişkeninden okunan Authorization başlığıyla .cursor/mcp.json dosyasına ekleyin. Cursor ajanı artık WhatsApp, SMS ve RCS gönderebilir, onaylı şablonları listeleyebilir ve iletim raporlarını okuyabilir; her araç çağrısından önce onay ister. Eklenti gerekmez.

Neler yapabilirsiniz?

  • Kod yazarken test mesajı gönderin

    Düzenleyiciden ayrılmadan bir mesaj akışını uçtan uca kontrol edin; gönderim yalnızca doğrulanmış numaralarınıza gider.

    Şunu sormayı deneyin

    “971500000000 numarasına siparişin kargoya verildiğini bildiren bir WhatsApp mesajı gönder.”

  • Şablon adlarını ve değişkenlerini öğrenin

    Ajan onaylı WhatsApp şablonlarını listeler; böylece yazdığınız kod tam adları ve parametreleri kullanır.

    Şunu sormayı deneyin

    “Onaylı Arapça WhatsApp şablonlarımı listele ve her birinin beklediği değişkenleri göster.”

  • İletim sorunlarını ayıklayın

    Kodunuzun az önce gönderdiği bir mesajın iletim raporunu okuyun ve neden başarısız olduğunu görün.

    Şunu sormayı deneyin

    “Son gönderdiğim mesajın iletim raporunu kontrol et ve varsa hatayı açıkla.”

  • Şemadan entegrasyon kodu yazın

    Ajana OpenAPI şemamızı verin; yazdığı REST çağrıları, multipart gönderimler dahil, tam alanları kullanır.

    Şunu sormayı deneyin

    “OpenAPI şemasını kullanarak toplu SMS kampanyası gönderen bir TypeScript fonksiyonu yaz.”

Nasıl bağlanır?

MCP ile bağlanınAPI ve webhook'larla bağlanın

OmniChannels.ai, Streamable HTTP üzerinden çalışan uzak bir MCP sunucusu işletir. Cursor, MCP sunucularını bir projedeki .cursor/mcp.json dosyasından ya da tüm projeler için ~/.cursor/mcp.json dosyasından okur ve url ile headers alanlarındaki ${env:NAME} değerlerini çözer; böylece jeton dosyada değil, bir ortam değişkeninde kalabilir.

Bağlandıktan sonra Cursor, sunucunun araçlarını MCP ayarlarında listeler ve her birini açıp kapatabilirsiniz. Cursor varsayılan olarak bir MCP aracını çalıştırmadan önce onay ister ve önce bağımsız değişkenleri gösterir. Her gönderim gerçek ve ücretlendirilen bir mesaj olduğundan, gönderim yapan her araçta onayı açık tutun.

  • Uç nokta: https://mcp.broadnet.me/mcp (Streamable HTTP)
  • Başlık: Authorization: Bearer ${env:BROADNET_TOKEN}
  • Yapılandırma: .cursor/mcp.json (proje) veya ~/.cursor/mcp.json (genel)
  • Sorun giderme: Output panelinde MCP Logs altında

Kurulum

  1. 1

    API erişimi talep edin

    Test erişimi talep edin ve bir API jetonu alın. Test gönderimleri yalnızca doğrulanmış kendi numaralarınıza gider.

  2. 2

    MCP anahtarı alın

    Yönetim portalında Integrations, ardından MCP Integration bölümünü açın ve Get temporary key'i seçin.

    Rehber: MCP server for AI agents
  3. 3

    Sunucuyu mcp.json'a ekleyin

    mcpServers altına, URL'mizi ve ${env:BROADNET_TOKEN} değerini okuyan bir Authorization başlığını içeren bir omnichannels girdisi ekleyin.

    Rehber: Use the MCP server with Cursor
  4. 4

    Değişkeni tanımlayıp yeniden başlatın

    BROADNET_TOKEN değişkenini, Cursor'un başlatıldığı ortamda (örneğin kabuk profilinizde) tanımlayın, ardından Cursor'u yeniden başlatın.

  5. 5

    Araçları gözden geçirin

    Cursor'un MCP ayarlarında ajanın ihtiyaç duymadığı her aracı kapatın ve gönderim araçlarında onayı açık tutun.

  6. 6

    İlk mesajı gönderin

    Ajandan doğrulanmış numaranıza test mesajı göndermesini isteyin, çağrıyı onaylayın, ardından iletim raporunu kontrol edin.

Üretici belgeleri

Cursor, sahibinin ticari markasıdır. OmniChannels.ai, Cursor ile bağlantılı değildir ve Cursor tarafından onaylanmamıştır; bu sayfa, Cursor'in kendi MCP, HTTP veya webhook özellikleriyle kurulan bir bağlantıyı açıklar.

Örnek iş akışı

Tipik bir isteğin Cursor üzerinden müşterinize ve geri nasıl ilerlediği.

  1. 01

    Cursor ajanı

    Ajan sohbetindeki bir istek

  2. 02

    OmniChannels.ai MCP sunucusu

    Araç, çağrıyı onayladıktan sonra çalışır

  3. 03

    Test telefonunuz

    WhatsApp, SMS veya RCS mesajı iletildi

  4. 04

    İletim raporu

    Ajan durumu bir okuma aracıyla geri okur

1. Cursor ajanı: Ajan sohbetindeki bir istek 2. OmniChannels.ai MCP sunucusu: Araç, çağrıyı onayladıktan sonra çalışır 3. Test telefonunuz: WhatsApp, SMS veya RCS mesajı iletildi 4. İletim raporu: Ajan durumu bir okuma aracıyla geri okur

Sorular

Cursor için resmi bir OmniChannels.ai eklentisi var mı?

Hayır. Cursor, standart MCP desteği üzerinden herkese açık MCP uç noktamız ve .cursor/mcp.json içindeki API jetonunuzla bağlanır. Kurulması gereken bir şey yoktur.

.cursor/mcp.json dosyasını deponuma commit edebilir miyim?

Evet; jeton ${env:BROADNET_TOKEN} ile bir ortam değişkeninden okunuyorsa. Portaldaki hazır yapılandırma anahtarın kendisini içerir, bu sürümü sürüm kontrolünün dışında tutun.

Sunucu hata veriyor veya araç görünmüyor. Neleri kontrol etmeliyim?

Output panelini açın ve MCP Logs'u seçin. Yetkilendirme hatası, başlığın eksik olduğu ya da anahtarın yanlış veya süresi dolmuş olduğu anlamına gelir. Boş bir değişken, Cursor'un BROADNET_TOKEN tanımlı olmadan başlatıldığını gösterir.

Ajan hangi kanallardan gönderim yapabilir?

Araçlar, hesabınızda etkin olan her kanalda gönderimi kapsar; örneğin SMS, WhatsApp, RCS, Telegram, Messenger, Instagram ve push. Tam araç listesi sunucu sürümüne ve hesabınıza bağlıdır.

API ve MCP erişimi alın

Kanallarınızı, ülkelerinizi ve kullanım senaryonuzu bize söyleyin. Bir mühendis test kimlik bilgilerini verir ve test numaralarınızı doğrular.