Açıklama
AI Building Blocks for WordPress girişiminin bir parçasıdır.
MCP Adapter, WordPress’in Yetenekler API’si ile Model Context Protocol (MCP) belirtimi arasında köprü kurarak yapay zekâ aracılarının WordPress işlevleriyle etkileşime girmesi için standartlaştırılmış bir yol sağlar. HTTP ve STDIO aktarım desteği, kapsamlı hata yönetimi ve özel entegrasyonlar için genişletilebilir bir mimari içerir.
Özellikler:
- Yetenekten MCP’ye dönüştürme – WordPress yeteneklerini otomatik olarak MCP araçlarına, kaynaklarına ve komut istemlerine dönüştürür.
- Çoklu sunucu yönetimi – Benzersiz yapılandırmalara sahip birden fazla MCP sunucusu oluşturun ve yönetin.
- Genişletilebilir aktarım katmanı – Yerleşik HTTP ve STDIO aktarımlarının yanı sıra özel aktarım protokolleri için destek.
- Esnek hata yönetimi – Özel, sunucuya özgü işleyici desteğiyle varsayılan WordPress uyumlu hata günlük kaydı.
- Gözlemlenebilirlik – Yapılandırılabilir işleyicilerle sıfır ek yüklü metrik takibi.
- İzin denetimi – Dışa aktarılan tüm işlevler için ayrıntılı, yapılandırılabilir izin denetimi.
Yükleme
- WordPress yönetim panelinizde Eklentiler > Yeni Ekle bölümüne gidin, “MCP Adapter” araması yapın ve Şimdi Kur düğmesine tıklayın.
- Eklentiyi WordPress’teki ‘Eklentiler’ ekranından etkinleştirin.
- Sunmak istediğiniz yetenekleri kaydedin veya bunları sizin yerinize kaydeden bir eklenti yükleyin.
Eklenti ZIP dosyasını Eklentiler > Yeni Ekle > Eklenti Yükle yoluyla da yükleyebilir veya WP-CLI ile kurabilirsiniz:
wp plugin install mcp-adapter --activate
SSS
-
MCP nedir?
-
Model Context Protocol (Model Bağlam Protokolü), yapay zekâ aracılarını harici sistemlere bağlamaya yönelik açık bir standarttır. Her yapay zekâ istemcisinin kendi özel entegrasyonuna ihtiyaç duyması yerine, bir sistem yapabildiklerini MCP araçları, kaynakları ve istemleri olarak sunar ve MCP uyumlu herhangi bir istemci bunları kullanabilir. Belirtim için bkz. modelcontextprotocol.io.
-
MCP Adapter nedir?
-
MCP Adapter, sunucu ve aktarım katmanıdır. Kendi başına herhangi bir yapay zekâ özelliği sağlamaz.
Sunduğu şeyler WordPress Yetenekler API’sinden gelir. Yetenek, yazıları okumak veya bir ayarı güncellemek gibi WordPress çekirdeği ya da başka bir eklenti tarafından kaydedilen tek bir kabiliyettir. MCP Adapter, sitenizde kayıtlı yetenekleri alır, bunları MCP istemcilerinin kullanımına sunar ve protokol anlaşmasını, izinleri ve hata yönetimini üstlenir.
Bu, bunun yararlı olması için çekirdekten veya kendi yeteneklerini kaydeden bir eklentiden gelen yeteneklerin de sitede bulunması gerektiği anlamına gelir.
-
Yapay zekâ aracıları siteme nasıl bağlanır?
-
Bağdaştırıcı, yerleşik HTTP aktarımı üzerinden MCP uç noktalarını kaydeder. MCP uyumlu bir istemciyi uç noktaya yönlendirin ve bir WordPress kullanıcısı olarak kimlik doğrulaması yapın. Bağdaştırıcı, tam olarak
2025-11-25ve2026-07-28MCP sürümlerini destekler. Uç nokta ayrıntıları için başlangıç kılavuzuna bakın. -
Kayıtlı her yetenek otomatik olarak sunulur mu?
-
Hayır, dışa aktarma isteğe bağlıdır. Bir yeteneğe yalnızca herkese açık olarak işaretlenmişse MCP üzerinden erişilebilir ve herhangi bir şey yürütülmeden önce geçerli kullanıcı için izin denetimleri çalışmaya devam eder. Yetenekleri nasıl etkinleştireceğinizi ve devre dışı bırakacağınızı öğrenmek için belgelere bakın.
-
Hataları nereden bildirebilirim veya özellikleri nereden talep edebilirim?
-
GitHub deposu üzerinden. Güvenlik sorunları herkese açık olarak bildirilmek yerine SECURITY.md dosyasındaki süreci izlemelidir.
Eklenti geliştiricileri, eklenti üstbilgilerine
Requires Plugins: mcp-adapterekleyerek MCP Adapter’a bağımlılık tanımlamalıdır. WP-CLI ve wp-env seçenekleri için BENİOKU dosyasına bakın.
Katkıda Bulunanlar ve Geliştiriciler
“MCP Adapter” açık kaynaklı yazılımdır. Aşağıdaki kişiler bu eklentiye katkıda bulunmuşlardır.
Katkıda bulunanlar“MCP Adapter” 6 dile çevrildi. Katkıda bulundukları için çevirmenlere teşekkürler.
“MCP Adapter” eklentisini dilinize çevirin.
Geliştirmeyle ilgilenir misiniz?
Kodu görüntüleyin, SVN deposuna göz atın ya da RSS ile geliştirme günlüğüne abone olun.
Değişiklik Kaydı
0.7.1 – 2026-10-15
Düzeltildi
- Depolanan oturum başlatma parametrelerini 4 KiB ile sınırlayın ve aşırı büyük oturum verilerini otomatik olarak kurtararak tekrarlanan veritabanı hatalarını ve aşırı günlük kaydını önleyin. Etkilenen istemcilerin bir kez yeniden bağlanması gerekir. Büyük satır içi simgelerin bağlantıları engellememesi için istemci simgeleri depolamadan hariç tutulur.
- Daha eski bir paketlenmiş sınıf yüklenmeden önce sürüm seçimine izin vererek, paketlenmiş kopyaları denetlemeden önce kurulu eklentinin otomatik yükleyicisini kaydedin.
- MCP istemcilerinden gelen bilinmeyen yetenek adları artık WordPress geliştirici bildirimleri oluşturmaz.
Değiştirildi
- Kullanılamayan yetenekler, ilgili mevcut yetenek adlarını veya keşfetmeye yönelik bir ipucunu içeren daha net hatalar döndürür. MCP üzerinden sunulmayan yetenekler, bilinmeyen adlarla aynı
ability_not_foundhatasını döndürür.
Eklendi
- Bir site sahibi rehberi bir yapay zekâ istemcisi bağlamayı, uygulama parolalarını ve sorun gidermeyi kapsar.
0.7.0 – 2026-10-02
Önemli değişiklikler
- Bağdaştırıcı tam olarak iki MCP şema revizyonuna hizmet verir:
2025-11-25ve2026-07-28.2025-06-18veya2024-11-05öneren istemciler bağlanmaya devam eder ve2025-11-25şeması üzerinden hizmet alır. - Oluşturulan DTO sınıfları,
McpToolValidator,McpResourceValidatorveMcpPromptValidatorsınıfları vemcp_adapter_validation_enabledfiltresi kaldırıldı. Ağ doğrulaması her zaman seçilen şema üzerinden çalışır. - Geçersiz protokol alanları artık sessizce yok sayılmıyor veya onarılmıyor. Desteklenen hiçbir revizyonun temsil edemediği bileşenler reddedilir.
- Özel aktarımlar
HttpRequestHandlerveyaMcpWireOrchestratorbileşenlerine devredilmelidir. JSON-RPC toplu istekleri reddedilir. WP\\MCP\\Clisınıflarıfinalolarak işaretlendi.
Eklendi
- Oturumsuz
server/discoveryaşam döngüsü ve yeni HTTP başlıkları dahil MCP2026-07-28desteği. - Doğrudan çağrılabilir araçlar,
McpInputRequireddöndürerek2026-07-28kapsamında açımlama girdisi isteyebilir. - Seçilen şema, aktarım ve oturum verilerini içeren, istek başına değişmez bir bağlam olan
McpRequestContext.
Değiştirildi
- MCP Adapter’ı paketlenmiş bir kütüphane olarak kullanımdan kaldırıldı. Bunun yerine MCP Adapter eklentisini kurun.
Düzeltildi
mcp-adapter/get-ability-infoboş birinput_schemadeğerini[]yerine{}olarak serileştirir.- Başka bir eklenti, MCP sunucusu başlatılmadan önce Abilities API’yi başlattığında varsayılan yetenekler kaydedilir.
Değişikliklerin tam listesi için 0.7.0 geçiş kılavuzuna ve CHANGELOG.md dosyasına bakın.
0.6.1 – 2026-08-13
Düzeltildi
- Sürüm ZIP dosyası artık ZIP’in dışarıda bıraktığı dosyalara işaret eden bir Jetpack Autoloader sınıf haritası içermiyor. 0.6.0 sürümünde sınıf haritası,
WP_CLIveWP_CLI_Commanddahil olmak üzere yalnızca test amaçlı genel sınıfları listeliyor ve bunları sürüm yapıtının hariç tuttuğutests/phpunit/altındaki dosyalarla eşleştiriyordu. Bu nedenle normal bir web isteğindeclass_exists( 'WP_CLI' )çağrısı yapan herhangi bir eklenti, yakalanmayan bir ölümcül hatayı tetikleyebiliyordu.class_exists( 'WP_CLI' )artık WP-CLI kullanılamadığındafalsedöndürüyor (#283).
Hiçbir API, kanca veya protokol davranışı değişmedi. 0.6.0 sürümünden yükseltme yapmak herhangi bir geçiş gerektirmez. Kaynaktan derlenen veya Composer aracılığıyla dahil edilen kurulumlar etkilenmedi.
0.6.0 – 2026-08-12
Önemli değişiklikler
- Artık WordPress 6.9 veya daha yenisi gerekiyor. Bağımsız Abilities API eklentisi artık desteklenen bir yükleme yolu değildir.
meta.public: truedeğerine sahip yetenekler,meta.mcp.publicaçıkça devre dışı bırakmadığı sürece artık varsayılan MCP sunucusu üzerinden sunulur. Mevcut izin geri çağrıları ve yetenek denetimleri geçerliliğini korur.- Yalnızca çoklu sitede, oturum depolaması ağ genelindeki bir anahtardan ayrı site başına anahtarlara taşındığı için etkin Akış yapılabilir (Streamable) HTTP oturumlarının yükseltmeden sonra bir kez yeniden bağlanması gerekir. Tek siteli kurulumlar bundan etkilenmez.
- Daha önce
McpValidatortarafından sunulan MIME doğrulama yardımcıları kaldırıldı. Bunları doğrudan çağıran entegrasyonlar kendi uygulamaya özel MIME doğrulamalarını uygulamalıdır.
Eklendi
- Kullanılabilir şablon olmadığında boş bir şablon listesi döndüren
resources/templates/listdesteği. - Eklenti PHP dosyalarının doğrudan çalıştırılması engellendi.
- Genişletilmiş otomatik uyumluluk, bağımlılık ve Plugin Check kapsamı.
Değiştirildi
- Bağımsız adaptör ile başka bir eklenti farklı sürümleri paketlediğinde mevcut en yeni
WP\\MCPsınıflarının geçerli olması için artık Jetpack Autoloader kullanılıyor. - WordPress çoklu sitede oturum depolama alanı site (blog) bazında sınırlandırıldı.
- Eşzamanlı oturum değişiklikleri sınırlı yeniden denemelerle korunarak bir isteğin başka bir oturumun üzerine yazma riski azaltılıyor.
- Belgeler, Yetenekler API’sinin (Abilities API) WordPress 6.9 ve daha yeni sürümlerde yer aldığını açıklığa kavuşturuyor, zorunlu yetenek
categoryalanını belgeliyor ve baştan sona örnekleri geliştiriyor.
Düzeltildi
_meta; kaynak içeriklerinde, gömülü kaynaklarda, içerik bloklarında ve istem mesajlarında korunur.- Bozuk biçimlendirilmiş
_meta, birlikte bulunduğu veri yükü atılmadan yok sayılır. mimeType,text/html;profile=mcp-appgibi parametreli değerler de dahil olmak üzere tam olarak bildirildiği gibi iletilir.- Yalnızca blob içeren kaynak içerikleri doğru şekilde işlenir.
- Kaynak URI şemaları büyük/küçük harfe duyarsız olarak eşleştirilir; böylece istemciler şemayı küçük harfe normalleştirseler bile kaynakları okuyabilir.
- Şema tanımlayan yetenekler için boş bağımsız değişkenler normalleştirilerek geçerli sıfır bağımsız değişkenli araç çağrılarının yürütülmesine izin verilir.
wp mcp-adapter serve, varsayılan sunucu seçilirken JSON-RPC stdout çıkışını temiz tutar.- Çakışan bir yerel seçenek kaydetmek yerine WP-CLI’ın genel
--userbağımsız değişkeni kullanılır.
Daha eski sürümler için CHANGELOG.md dosyasına bakın.
