--- title: "Claude Code + OmniChannels.ai: mesajlaşmayı terminalinizden geliştirin ve test edin" description: "Claude Code'a OmniChannels.ai MCP sunucusunu ekleyerek test mesajı gönderin, iletim raporlarını okuyun; OpenAPI şemamızla WhatsApp ve SMS kodunuzu yazın." canonical: "https://omnichannels.ai/tr/integrations/claude-code/" language: "tr" updated: "2026-10-10" publisher: "BroadNet Technologies" brand: "OmniChannels.ai" --- # Claude Code + OmniChannels.ai: mesajlaşmayı terminalinizden geliştirin ve test edin Canonical: https://omnichannels.ai/tr/integrations/claude-code/ Language: tr Publisher: OmniChannels.ai by BroadNet Technologies **Kısaca:** Claude Code, OmniChannels.ai'ye tek komutla bağlanır: https://mcp.broadnet.me/mcp adresini gösteren ve Authorization: Bearer başlığı taşıyan claude mcp add --transport http. Ardından entegrasyon kodunuzu OpenAPI 3.1 şemamızdan yazarken test mesajı gönderebilir, WhatsApp şablonlarını listeleyebilir ve iletim raporlarını okuyabilir. Ekipler sunucuyu .mcp.json ile paylaşır; izin kuralları hangi araçların onaysız çalışacağını belirler. MCP ile bağlanın · API ve webhook'larla bağlanın ## Neler yapabilirsiniz? ### Gerçek şablonlardan kod yazın Claude Code, onaylı WhatsApp şablonlarınızı MCP ile okur ve her birinin tam olarak ihtiyaç duyduğu değişkenlerle bir fonksiyon yazar. > Şunu sormayı deneyin: "omnichannels araçlarını kullanarak onaylı WhatsApp şablonlarımı listele, ardından order_update şablonunu gereken alanlarla gönderen bir TypeScript fonksiyonu yaz." ### Webhook işleyicisi geliştirin Claude Code'u webhook rehberine yönlendirin; iletim durumlarını ve gelen mesajları kaydeden, kanallara göre değişen alanlara toleranslı bir uç nokta yazar. > Şunu sormayı deneyin: "SUBMITTED, SENT, DELIVERED, READ, FAILED ve REJECTED durumlarını mesaj kimliğine göre kaydeden, bilinmeyen alanları hata vermek yerine günlüğe yazan bir Express webhook işleyicisi yaz." ### Şemadan tipli istemci üretin OpenAPI şeması deponuzda kayıtlıysa Claude Code yolları ve alanları tahmin etmek yerine tam olarak onları kullanır. > Şunu sormayı deneyin: "docs/omnichannels-openapi.yaml dosyasını kullanarak POST /sms/sendSms ile SMS gönderen bir Python modülü yaz ve kullandığın her alanı şemadaki tipiyle listele." ### Kendi numaranızda uçtan uca test edin Claude Code, araç çağrısını onayladıktan sonra bir test mesajı gönderir, ardından kod yolunuzun çalıştığını iletim raporundan doğrular. > Şunu sormayı deneyin: "OmniDemo adından 447700900123 numaralı telefonuma bir test SMS'i gönder, ardından iletim raporunu kontrol et." ### Başarısız gönderimleri ayıklayın Okuma araçları, Claude Code'un iletim raporlarını günlüklerinizle karşılaştırmasına ve bir hatayı onu doğuran isteğe kadar izlemesine olanak tanır. > Şunu sormayı deneyin: "Dünkü kampanyanın iletim raporunu oku, hata nedenlerini özetle ve yeniden deneme kodumuzu hatalar rehberiyle karşılaştır." ## Nasıl bağlanır? Claude Code, uzak MCP sunucularını claude mcp add --transport http komutu ve bir Authorization başlığıyla ekler. Komutu çalıştırdığınızda kabuğunuz jetonu bir ortam değişkeninden açar; ekipler için proje kapsamlı bir .mcp.json, her geliştiricinin kendi jetonunu ${BROADNET_TOKEN} aracılığıyla vermesini sağlar ve Claude Code kullanmadan önce her kişiden sunucuyu onaylamasını ister. MCP, hesabınız üzerinde işlem yapmayı kapsar: test mesajı göndermek, şablonları ve iletim raporlarını okumak. Entegrasyon kodu yazmak için Claude Code'a uç noktalar ve alanlar konusunda tek doğru kaynak olarak OpenAPI 3.1 şemamızı, ayrıca webhook yükleri şemada olmadığı için webhook rehberini verin. mcp__omnichannels__get_* gibi izin kuralları okuma araçlarını onaysız çalıştırırken gönderim araçlarının yine sormasını sağlar. - Komut: claude mcp add --transport http omnichannels https://mcp.broadnet.me/mcp - Ekip kurulumu: anahtar değil, Bearer ${BROADNET_TOKEN} içeren .mcp.json'u commit edin - İzin kuralları araçları mcp__omnichannels__ olarak adlandırır - Tam istek alanları için /developers/openapi.json adresindeki OpenAPI 3.1 şeması - Tekil SMS JSON'dur; toplu ve diğer kanalların çoğu multipart/form-data kullanır ## Kurulum 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. **Geçici anahtar alın:** Yönetim portalında Integrations, ardından MCP Integration bölümünü açın, Get temporary key'i seçin ve BROADNET_TOKEN olarak dışa aktarın. (Rehber: https://omnichannels.ai/developers/mcp/) 3. **Sunucuyu ekleyin:** Authorization başlığıyla claude mcp add --transport http omnichannels https://mcp.broadnet.me/mcp komutunu çalıştırın veya ekibiniz için bir proje .mcp.json'u commit edin, ardından /mcp ile kontrol edin. (Rehber: https://omnichannels.ai/developers/mcp-claude-code/) 4. **İzin kurallarını belirleyin:** İsterseniz mcp__omnichannels__get_* gibi okuma araçlarına izin verin, her gönderim aracını soru modunda tutun ve projenin ihtiyaç duymadığı araçları reddedin. (Rehber: https://omnichannels.ai/developers/mcp-claude-code/) 5. **OpenAPI şemasını ekleyin:** openapi.yaml dosyasını deponuza indirin ve Claude Code'a uç nokta yolları, alanlar ve enum değerleri için onu kullanmasını söyleyin. (Rehber: https://omnichannels.ai/developers/openapi/) 6. **Kendi numaranızda test edin:** Claude Code'dan doğrulanmış numaranıza test mesajı göndermesini isteyin, ardından iletim raporunu okutun. ## Örnek iş akışı Claude Code (Entegrasyonunuzu yazar, istendiğinde araçları çağırır) → OmniChannels.ai MCP ve API (Testler için MCP araçları; kodunuz REST API'yi çağırır) → Test telefonunuz (Doğrulanmış numaranıza test SMS veya WhatsApp) → Webhook işleyiciniz (İletim durumlarını ve gelen mesajları alır) ## Sorular ### Claude Code için resmi bir OmniChannels.ai eklentisi var mı? Hayır. Claude Code, uzak MCP sunucuları için standart desteği üzerinden herkese açık uç noktamız ve API jetonunuzla bağlanır; herkese açık OpenAPI şemamızı da deponuzdaki başka bir dosya gibi okur. ### Anahtar paylaşmadan sunucuyu ekibimle nasıl paylaşırım? Authorization başlığı ${BROADNET_TOKEN} kullanan, proje kapsamlı bir .mcp.json commit edin. Her geliştirici bu değişkeni kendi kabuğunda tanımlar ve Claude Code, proje sunucusunu kullanmadan önce onlardan onay ister. ### Claude Code sormadan mesaj gönderebilir mi? Varsayılan olarak Claude Code bir MCP aracını kullanmadan önce sorar. Her gönderim gerçek ve ücretlendirilen bir mesaj olduğundan gönderim araçlarında bunu koruyun. İzin kurallarınızda yalnızca okuma araçlarına izin verin; araç adları sunucu sürümüne ve hesabınıza bağlı olduğundan önce /mcp altında kontrol edin. ### Ürünümde MCP mi yoksa REST API mi kullanmalıyım? Geliştirme sırasında Claude Code'un hesabınızı test edip incelemesi için MCP kullanın. Yayına verdiğiniz kod, gizli bilgi deponuzdan alınan bir jetonla doğrudan REST API'yi çağırmalı ve tam alanlar için OpenAPI şemasını kullanmalıdır. ## Geliştirici rehberleri - https://omnichannels.ai/developers/mcp-claude-code/ - https://omnichannels.ai/developers/openapi/ - https://omnichannels.ai/developers/webhooks/ - https://omnichannels.ai/developers/mcp/ ## Üretici belgeleri - [Connect Claude Code to tools via MCP](https://code.claude.com/docs/en/mcp) - [Claude Code permissions](https://code.claude.com/docs/en/permissions) ## İlgili entegrasyonlar - https://omnichannels.ai/tr/integrations/claude/ - https://omnichannels.ai/tr/integrations/cursor/ - https://omnichannels.ai/tr/integrations/vs-code/ - https://omnichannels.ai/tr/integrations/langchain/ Claude Code, sahibinin ticari markasıdır. OmniChannels.ai, Claude Code ile bağlantılı değildir ve Claude Code tarafından onaylanmamıştır; bu sayfa, Claude Code'in kendi MCP, HTTP veya webhook özellikleriyle kurulan bir bağlantıyı açıklar. Güncelleme: 2026-10-10