Drupal ile Mia Nasıl Çalışır — Kurulum Rehberi (MCP Sunucu)

Drupal ile Mia Nasıl Çalışır: Pratik Kurulum Rehberi

Drupal, web'deki en esnek CMS platformlarından biridir ve Model Context Protocol (MCP) sayesinde artık Mia, kişisel yapay zeka sekreterinizle el ele çalışabilir. Bu rehberde, Drupal MCP sunucusu modülünü yüklemekten Mia sohbetinize bağlamaya kadar tam kurulumu adım adım anlatacağız.

Sonunda Mia, panoya gerek kalmadan, bağlam değiştirmeden doğrudan Telegram sohbetinizden Drupal içeriğini okuyabilecek, oluşturabilecek, güncelleyebilecek ve yönetebilecek.

MCP Nedir ve Neden Umursamalısınız?

Model Context Protocol, yapay zeka ajanlarının yapılandırılmış, güvenli bir arayüz aracılığıyla harici hizmetlerle konuşmasını sağlayan açık bir standarttır (başlangıçta Anthropic tarafından tanıtıldı ve şimdi OpenAI ve Google tarafından desteklenmektedir).

Bir MCP sunucusu, bir sistemin (bu durumda Drupal) araçlarını ve verilerini ortaya çıkarır. Bir MCP istemcisi (Mia), o sunucuya bağlanır ve bu araçları sizin adınıza kullanır.

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

Mia'dan bir blog yazısı oluşturmasını veya güncellemesini istemek
Yayınlanmamış içerik taslaklarını aramak
Taksonomi terimlerini, kullanıcıları veya görünümleri listelemek
İş akışlarını tetiklemek (modere etme, yayınlama, zamanlama)
Site sağlığı ve durum raporlarını çekmek

Hepsi tek bir Telegram sohbetinden.

Ön Gereksinimler

Başlamadan önce şunlara sahip olduğunuzdan emin olun:

Bir Drupal 10.x veya 11 sitesi (PHP 8.1+, standart Composer kurulumu)
Modülleri yüklemek için yönetici erişimi
En az Standart plana sahip bir Mia Handles hesabı (MCP bağlantıları API erişimi gerektirir)
Resmi PHP MCP SDK'sının küresel olarak yüklenmiş olması veya Composer aracılığıyla kullanılabilir olması

Adım 1 — Drupal MCP Sunucu modülünü yükleyin

Önerilen modül, Drupal.org'dan mcp_server'dır — resmi modelcontextprotocol/php-sdk (PHP Foundation + Symfony işbirliği) üzerine kurulmuştur.

Site kök dizininizden şunu çalıştırın:

composer require drupal/mcp_server

Ardından Drush veya arayüz aracılığıyla etkinleştirin:

drush en mcp_server -y
drush cr

Alternatif olarak, Genişlet → Yeni modül yükle'ye gidin, arşivi yükleyin ve etkinleştirin.

Etkinleştirdikten sonra Yapılandırma → Web hizmetleri → MCP Sunucusu'na (/admin/config/services/mcp_server) gidin. Orada şunları bulacaksınız:

Uç Nokta URL'si — MCP uç noktasının genel URL'si (genellikle https://yoursite.com/mcp)
Kimlik Doğrulama — Temel kimlik doğrulama, belirteç veya OAuth (önerilen: belirteç)
Araçlar ve kaynaklar — hangi Drupal yeteneklerinin sunulacağını (düğümler, kullanıcılar, taksonomi, Görünümler vb.) değiştirin.

Güvenli bir API belirteci oluşturun ve kaydedin — Mia'da buna ihtiyacınız olacak.

Adım 2 — Uç noktayı güvenli bir şekilde sunun

MCP uç noktasına yalnızca güvendiğiniz hizmetler tarafından erişilebilmelidir. Tipik seçenekler:

IP izin listesi — erişimi Mia'nın arka uç IP'si ile sınırlayın
Belirteç tabanlı kimlik doğrulama — her istekte üstbilgiye belirteci göndermelisiniz
Özel ağ / VPC — kurumsal kurulumlar için

Drupal siteniz Cloudflare veya başka bir WAF'nin arkasındaysa, /mcp yolunun POST ve GET yöntemleriyle, akış kullanıyorsanız SSE ile birlikte izin verildiğinden emin olun.

Adım 3 — Mia Handles'da Drupal sunucusunu bağlayın

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

Mia miniapp'ini açın (profil resminize dokunun veya menüyü kullanın)
Ayarlar → Entegrasyonlar → MCP sunucusu ekle'ye gidin
Bağlantı formunu doldurun:

Sunucu adı:   Benim Drupal Sitem
Uç Nokta URL'si:  https://yoursite.com/mcp
Taşıma:     Akışlı HTTP
Kimlik Doğrulama: Taşıyıcı belirteci
Belirteç:         (Drupal MCP belirtecinizi yapıştırın)

Bağlan'a dokunun. Mia uç noktayı doğrulayacak, kullanılabilir araçları listeleyecek ve sunucuyu sohbetinize ekleyecektir.

Bir SSE veya JSON POST taşıma ile de bağlanabilirsiniz — Mia üçünü de destekler.

Adım 4 — Bağlantıyı test edin

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

"Drupal sitemdeki son 5 yayınlanmamış makaleyi listele"

Mia, doğrudan Drupal sitenizden çekilen bir özet döndürmelidir. Bir hata alırsanız şunu kontrol edin:

Drupal MCP ayarlarında belirteç geçerliliği
Uç nokta URL'si Mia'nın arka ucundan erişilebilir olmalı (güvenlik duvarı, SSL sertifikası)
Drupal tarafında gerekli araçlar etkinleştirilmiş olmalı

Kurulum Sonrası Yapabilecekleriniz

Bağlandıktan sonra Mia'nın sizin için halledebileceği bazı şeyler şunlardır:

İçerik işlemleri — taslak oluşturma, yayınlama/yayınlanmamış yapma, toplu alan düzenleme
Taksonomi ve referanslar — terim ekleme, kelimeleri yeniden düzenleme
Kullanıcı yönetimi — hesap oluşturma, şifre sıfırlama, roller atama
Görünüm sorguları — yapılandırılmış raporları Markdown veya JSON olarak alma
İş akışı tetikleyicileri — içeriği moderasyon durumlarına taşıma
Zamanlanmış yayınlama — Mia'nın yapılacakları veya takvimi aracılığıyla gelecekteki tarihler için makaleleri sıraya koyma

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

"Bu sabah kaydettiğim röportajı Drupal sitemde bir makale olarak yayınla ve editöre yarın saat 10:00'de gözden geçirmesini hatırlat."

Mia ikisini de tek seferde halledecektir.

Sorun Giderme

Belirti	Olası neden	Çözüm
"Bağlantı başarısız oldu"	Uç nokta engellendi veya yanlış URL	Güvenlik duvarı kurallarını ve SSL sertifikasını kontrol edin
"Araç yok"	MCP modülü devre dışı veya araç seçilmemiş	Yeniden etkinleştirin ve en az bir araç seçin
"Yetkisiz"	Geçersiz belirteç	Drupal yöneticisinden belirteci yeniden oluşturun ve Mia'da güncelleyin
Yavaş yanıtlar	Büyük varlık dışa aktarımları	Kullanılmayan araçları devre dışı bırakın, sayfalama özelliğini etkinleştirin

İlgili Okumalar

Aynı MCP deseni diğer CMS platformlarıyla da çalışır. Yardımcı rehberlerimize göz atın:

Drupal ile Mia Nasıl Çalışır: Pratik Kurulum Rehberi — mcp-adapter eklentisi, Uygulama Şifreleri ve WordPress'e özgü kullanım durumlarını (medya, yorumlar, eklenti eylemleri, REST API sorguları) kapsar.
Bitrix CMS için En İyi Yapay Zeka Arkadaşı: Mia'yı MCP Üzerinden Bağlayın — hiweb.site_mcp modülü, taşıyıcı belirteci kimlik doğrulaması, JSON POST taşıması ve Bitrix'e özgü kullanım durumlarını (iblocks, siparişler, CRM) kapsar.

Her üç platformu da aynı Mia sohbetine bağlayabilirsiniz ve Mia her birine adıyla hitap edecektir.

Sonuç

Drupal'ı MCP aracılığıyla Mia'ya bağlamak, CMS'nizi tek başına bir panodan günlük iş akışınızın konuşma temelli bir uzantısına dönüştürür. Kurulumdan sonra, ihtiyaç duyduğunuz her an sessizce, arka planda çalışır.

Sorularınız varsa veya kurulum konusunda yardım isterseniz, doğrudan Mia'ya sohbet üzerinden sorun. Protokolü zaten biliyor.