Bitrix CMS için En İyi Yapay Zeka Arkadaşı — MCP Kurulum Rehberi

Bitrix CMS için En İyi Yapay Zeka Arkadaşı: Mia’yı MCP Üzerinden Bağlayın

Bitrix Site Yöneticisi dünya genelinde milyonlarca kurumsal siteye güç veriyor — ve Model Context Protocol (MCP) sayesinde artık Mia’ya, kişisel yapay zeka sekreterinize, doğrudan konuşuyor. Bu rehberde, resmi MCP modülünü yüklemekten başlayarak Mia sohbetinizle eşleştirmeye kadar tüm kurulumu adım adım ele alacağız.

Bağlandıktan sonra, Mia’dan haberleri, iblock’ları, kullanıcıları, siparişleri ve daha fazlasını tek bir Telegram konuşmasından yönetmesini isteyebilirsiniz. Tarayıcı sekmeleri yok, yönetici panelleri yok, bağlam değiştirme yok.

MCP nedir ve neden önemsemelisiniz?

Model Context Protocol (MCP), yapay zeka ajanlarının dış servislerle yapılandırılmış ve güvenli bir arayüz üzerinden iletişim kurmasını sağlayan açık bir standarttır.

Bir MCP sunucusu, bir sistemin yeteneklerini ortaya koyar. Bir MCP istemcisi (Mia), bu sunucuya bağlanır ve yetenekleri sizin adınıza çağırır.

Bitrix site sahipleri için bu, şunlar gibi işler yapabileceğiniz anlamına gelir:

Mia’dan haber makalelerini yayımlamasını veya iblock girişlerini güncellemesini istemek
Kriterlere göre siparişleri, müşterileri veya ürünleri aramak
Satış, trafik veya içerik performansı hakkında raporlar oluşturmak
Kullanıcı oluşturmak, roller atamak veya izinleri yönetmek
Analitik sorgulamak veya performans metriklerini almak

Hepsi tek bir Telegram sohbetinden.

Önkoşullar

Başlamadan önce şunlardan emin olun:

Lisanslı bir 1C-Bitrix sitesi (modül yüklemeye izin verildi)
Modülleri kurmak ve ayarları yapılandırmak için yönetici erişimi
En az bir Standard planına sahip bir Mia Handles hesabı (MCP bağlantıları API erişimi gerektirir)
Bitrix sitenizde bir SSL sertifikası (MCP uç noktası için HTTPS gerekir)

1. Adım — hiweb.site_mcp modülünü yükleyin

Önerilen modül, Bitrix Marketplace’ten hiweb.site_mcp. Bu modül, Bitrix için resmi MCP sunucu uygulamasını sağlar.

Marketplace bağlantısı: https://marketplace.1c-bitrix.ru/hiweb.site_mcp

Not: Marketplace sayfası şu anda yapım aşamasındadır ancak yakında yayımlanacaktır. Modülü zaten kurduysanız 2. Adım’a geçin.

Bitrix yönetim panelinizden:

Ayarlar → Marketplace bölümüne gidin
hiweb.site_mcp için arama yapın veya yukarıdaki doğrudan bağlantıyı kullanın
Modülü yükleyin ve etkinleştirin
Etkinleştirdikten sonra Ayarlar → Site Ayarları → MCP Server bölümüne gidin

Burada şunları göreceksiniz:

Uç Nokta URL’si — MCP uç noktası için herkese açık URL (genellikle https://yoursite.com/api/mcp/)
Kimlik Doğrulama — bearer token yapılandırması
Dışa açılacak Araçlar — Mia’nın erişebileceği Bitrix yeteneklerini aç/kapat (iblock’lar, haberler, kullanıcılar, siparişler, analitik vb.)

2. Adım — Bearer Token oluşturun

Bitrix MCP modülü, güvenli API erişimi için Bearer token kimlik doğrulamayı kullanır.

Ayarlar → Site Ayarları → MCP Server bölümüne gidin
Generate Token (Token Oluştur) veya Create New Token (Yeni Token Oluştur) seçeneğine tıklayın
Bir ad verin; örneğin Mia MCP Integration
Token son kullanma süresini ayarlayın (önerilen: üretim kullanımı için son kullanma olmasın)
Oluşturulan token’ı kopyalayın — yalnızca bir kez görürsünüz

Bu token, Mia’nın Bitrix sitenize bağlanmak için kullandığı kimlik bilgisi haline gelir.

3. Adım — Uç noktayı güvenli şekilde dışa açın

MCP uç noktası yalnızca güvendiğiniz servisler tarafından erişilebilir olmalıdır. Tipik seçenekler:

Bearer token kimlik doğrulama — her istek, bearer token ile birlikte Authorization başlığını taşımalıdır
IP izin listesi — MCP yolunu Mia’nın arka plan IP aralığıyla sınırlayın
Özel ağ / VPC — kurumsal kurulumlar için

Bitrix siteniz Cloudflare veya başka bir WAF’ın arkasındaysa, POST yöntemleriyle MCP yolunun izinli olduğundan emin olun. Mia’yı bağlamadan önce uç noktayı önce curl ile test edin (bkz. 5. Adım).

4. Adım — Bitrix sunucusunu Mia Handles’a bağlayın

Şimdi eğlenceli kısım. Mia sohbetinizde:

Mia miniapp’i açın (profil fotoğrafınıza dokunun veya menüyü kullanın)
Ayarlar → Araçlar → MCP Servers → Add (veya mevcut bir sunucuyu düzenleyin)
Bağlantı formunu doldurun:

Server name:   My Bitrix Site
Endpoint URL:  https://example.com/hiweb-site-mcp/
Transport:     JSON POST (stateless)
Auth:          Bearer token
Token:         (oluşturulan bearer token’ı yapıştırın)

Önemli: Taşıma türü olarak JSON POST (stateless) seçin. Streamable HTTP veya SSE’yi KULLANMAYIN — Bitrix MCP modülü yalnızca POST JSON-RPC isteklerini kabul eder.

Connect’e dokunun. Mia uç noktayı doğrular, kullanılabilir araçları listeler ve sunucuyu sohbetinize ekler.

5. Adım — Bağlantıyı test edin

Bağlandıktan sonra Mia sohbetinizde basit bir komut deneyin:

"Bitrix sitemdeki son 5 haber öğesini listele"

Mia, sitenizden doğrudan çekilen bir özet döndürmeli. Hata alırsanız şu kontrolleri yapın:

Bearer token geçerliliği ve son kullanma süresi
MCP modülü aktif ve araçlar etkin
MCP uç nokta URL’si Mia’nın arka planından erişilebilir (güvenlik duvarı, SSL sertifikası)
Taşıma türü JSON POST (stateless) olarak ayarlı

Ayrıca curl ile manuel olarak da test edebilirsiniz:

curl -H "Authorization: Bearer YOUR_TOKEN" \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":1}' \
  "https://example.com/hiweb-site-mcp/"

JSON biçiminde bir araç listesi almanız gerekir — bu, sunucunun çalıştığı anlamına gelir.

6. Adım — Kurulumdan sonra neler yapabilirsiniz?

Bağlandıktan sonra Mia, Bitrix için yardımcı pilotunuz olur. Yapabileceğiniz en yaygın şeyler:

İçerik işlemleri — haber makaleleri ve iblock girişleri oluşturma, güncelleme veya yayımlama
Medya yönetimi — dosyalardaki görselleri listeleme, yükleme veya değiştirme
Kullanıcı yönetimi — hesap oluşturma, parolaları sıfırlama, roller atama
Siparişler & CRM — siparişleri, müşterileri, anlaşmaları veya potansiyel adayları sorgulama
Analitik — trafik raporlarını, dönüşüm metriklerini veya satış özetlerini çekme
Planlı yayımlama — Mia’nın takvimi üzerinden içerikleri gelecekteki tarihler için sıraya alma

Ve Mia zaten takviminizi, görevlerinizi ve dosyalarınızı bildiği için, gününüzün geri kalanıyla birlikte Bitrix işlerini de koordine edebilir — örneğin:

"Sana gönderdiğim ürün lansmanıyla ilgili bir haber yayımlayın, Çarşamba günü saat 14:00’te planlayın ve incelemesi için pazarlama ekibine bir görev ekleyin."

Mia bunların üçünü de tek seferde halleder.

Sorun Giderme

Belirti	Muhtemel neden	Çözüm
"Bağlantı başarısız"	Uç nokta engellenmiş ya da yanlış URL	Güvenlik duvarı kurallarını ve SSL sertifikasını kontrol edin
"Kullanılabilir araç yok"	Modül devre dışı veya araçlar açılmamış	Yeniden etkinleştirin ve en az bir aracı seçin
"Yetkisiz"	Geçersiz bearer token	MCP ayarlarında yeniden oluşturun ve Mia’da güncelleyin
"HTTP 404"	Yanlış uç nokta yolu	Modülün yapılandırılmış uç nokta URL’sini doğrulayın
"Taşıma hatası"	Yanlış taşıma türü	SSE veya Streamable değil, JSON POST (stateless) kullanın
Yavaş yanıtlar	Çok fazla araç etkin	Kullanılmayan araçları kapatın, sayfalama etkinleştirin

WordPress ve Drupal aynı şekilde çalışır

Ayrıca bir WordPress veya Drupal sitesi de çalıştırıyorsanız, aynı desen geçerlidir. Her CMS’in kendi MCP adaptörü vardır ancak Mia’daki bağlantı iş akışı aynıdır — modülü kurun, bir uç nokta dışa açın, kimlik bilgilerini Mia’ya yapıştırın. Hatta üç platformu da aynı Mia sohbetine bağlayabilirsiniz ve o, her birini isimleriyle ele alır.

Diğer rehberler için bakın:

Sonuç

Bitrix’i MCP üzerinden Mia’ya bağlamak, CMS’inizi tek başına bir kontrol panelinden günlük iş akışınızın konuşmalı bir uzantısına dönüştürür. Kurulduktan sonra sadece çalışır — ihtiyaç duyduğunuzda sessizce, arka planda.

Sorularınız varsa veya kurulum konusunda yardıma ihtiyacınız varsa, sohbet içinde Mia’ya doğrudan sorun. O zaten protokolü biliyor.