30 saniyelik cevap
Müzeler bu sorunu bir asır önce kart kataloğu ile çözmüştü: Her ziyaretçinin geniş bir koleksiyona kesin bir soru sorması ve kesin bir yanıt alması için standart bir yöntem. Model Bağlam Protokolü — MCP — yapay zeka asistanları için kart kataloğudur. Claude gibi bir asistanın, konuşmasının dışına çıkmasına ve eğitimden yarım yamalak hatırladığı bilgilere güvenmek yerine canlı, yapılandırılmış bir doğruluk kaynağını sorgulamasına olanak tanıyan açık bir standarttır. Mus3ums şimdi tam olarak böyle bir katalog yayınlıyor: https://direct.Mus3ums.com/mcp/ adresinde yedi araç içeren bir MCP sunucusu. Bunlardan beşi koleksiyonu —eserleri, sanatçıları, müzeleri, makaleleri veya dördünü birden— arar. Biri, katalogdaki herhangi bir eserin sanat baskısı veya el yapımı yağlı boya olarak, belirttiğimiz boyutta ve para biriminde, bir reprodüksiyonu için kesin, gerçek parayla hesaplanmış bir fiyat teklifi sunar. Ve biri —kim olduğumuzu soran tek araç— kendi siparişlerimizi kontrol etmemize olanak tanır. Herhangi bir halka açık araç için anahtar, kayıt veya ödeme gerekmez. Asistanı bir kez bağlıyoruz ve o andan itibaren "bana Caillebotte'nin yağmurlu Paris sokağını bul ve bir metre genişliğinde el yapımı bir kopyasının euro cinsinden ne kadara mal olacağını söyle" ifadesi, kesin yanıtı olan bir soruya dönüşüyor.
1. Teknik terimlere boğulmadan MCP nedir?
Kendi başına bırakılmış bir yapay zeka asistanı, eğitiminin sona erdiği gün kitap alımı durmuş bir kütüphaneye hapsedilmiş bir akademisyen gibidir. Ona Caravaggio'nun biyografisini sorarsanız başarılı bir sonuç verir; ancak ona Az Aziz Matta'nın Çağrılışı eserinin 70 × 90 cm boyutlarında, el boyaması bir reprodüksiyonunun bugün Kanada doları cinsinden ne kadara mal olacağını sorarsanız, sadece tahmin yürütebilir — bunu nazikçe, akıcı bir şekilde ama doğruluğu kanıtlanamaz biçimde yapar.
Anthropic tarafından 2024 sonlarında tanıtılan ve o zamandan beri sektör genelinde benimsenen açık bir standart olan MCP, bu sorunu mümkün olan en basit yolla çözer: asistana bir telefon verir. Sorulmaya değer bir içeriğe sahip olan —bir katalog, bir veri tabanı veya bir fiyat listesi— bir web sitesi, her biri ne işe yaradığını ve ne söylenmesi gerektiğini içeren açıklamalarla birlikte, isimlendirilmiş küçük bir araç seti yayınlar. Asistan bu listeyi tıpkı bizim bir menüyü okuduğumuz gibi okur ve sorumuz gerektirdiğinde numarayı çevirir: dışarıya tek bir yapılandırılmış istek, içeriye ise rakamları bozulmadan aktarılan tek bir yapılandırılmış yanıt gelir. Asistan sitenin sunucularını asla karıştırmaz; yalnızca sitenin yanıtlamayı seçtiği soruları sorabilir. Buradaki asıl amaç da budur. Bir kart kataloğu, ziyaretçilere arşivin anahtarlarını teslim etmez; sadece karttaki sorguya yanıt verir.
2. Yedi araç ve her birinin yanıtladığı sorular
Sunucu yedi araç sunar. Setin yapısına dikkat edin: beşi bir şeyleri bulma yöntemidir, biri bir bulguyu bir fiyata dönüştürür ve biri — tek özel olanı — koleksiyondan ziyade bizimle ilgilidir.
| Araç | Neyi yanıtlar | Token gerekli mi? |
|---|---|---|
search_artworks |
Eser kataloğunda başlık, sanatçı ve açıklamaya göre tam metin araması — "selvi ağaçlı buğday tarlası", "Bruegal kış avcıları". Her eşleşme; sanatçıyı, başlığı, eserin sayfasına bir bağlantıyı ve bir alaka düzeyini döndürür. | Hayır |
search_artists |
İsme veya biyografiye göre sanatçılar; istenirse doğum şehri, doğum ülkesi veya sanatçının yaşadığı yıla göre daraltılabilir — "1660'ta Delft'te aktif olan ressamlar" gibi sorular için sessiz bir süper güç. | Hayır |
search_museums |
İsme göre, isteğe bağlı olarak şehir ve ülkeye göre müzeler; her sonuç harita üzerinde konumlandırılır: isim, şehir, ülke, bağlantı. | Hayır |
search_articles |
Sitenin kendi makaleleri, rehberleri ve SSS bölümleri; isteğe bağlı olarak kategoriye (blog, alıcı rehberi, destek vb.) göre filtrelenebilir. | Hayır |
search_fts |
Dört kataloğun tamamı aynı anda — her birinden on taneye kadar sonuç, alaka düzeyine göre sıralanmış tek bir listede birleştirilir. "Vermeer Delft" ifadesinin bir tabloya mı, biyografiye mi yoksa bir müzeye mi yönlendirmesi gerektiğini henüz bilmediğimizde atılacak en doğru ilk adımdır. | Hayır |
get_a_quotation |
Belirli bir genişlik ve yükseklikte (kenar başına 25–250 cm, cm veya inç cinsinden) ve belirli bir para biriminde, adı geçen bir eserin reprodüksiyonu için kesin fiyat — bir sanat baskısı veya el yapımı yağlı boya tablo olarak — Belirli bir katalog numarasıyla veya sadece başlık ve sanatçı ismiyle belirtilebilir. | Hayır |
get_my_orders_details |
Kendi siparişlerimiz — ve sadece bizimkiler: tarihler, tutarlar, seçenekleriyle birlikte kalem öğeleri, güncel durum, gönderim adresi. "Mart ayında sipariş ettiğim Monet nerede?" sorusu, asistanımızın yanıtlayabileceği bir soru haline gelir. | Evet — /profile/mcp/ adresinden alınan kişisel token |
Her arama sonucu bir alaka düzeyi puanı taşır ve araçlar listeyi doldurmak yerine yalnızca yüksek güvenilirliğe sahip eşleşmeleri döndürür — sonuçları okuyan bir asistan, kesin bir tanımlama ile belirsiz bir yanıt arasındaki farkı anlayabilir. Sonuçlar talep ettiğimiz dilde geri döner: language parametresi sitenin arayüz dillerinden herhangi birini kabul eder ve bağlantılar o dildeki sayfalara yönlendirir.
3. Teklif aracına daha yakından bakmak gerekir
Fiyat, çoğu "yapay zekanın alışverişle buluştuğu" entegrasyonun sessizce hata verdiği noktadır; bu nedenle bu aracın tam olarak ne yaptığını belirtmeye değer. Teklif, satın alma sayfasının kendisini fiyatlandıran kodla aynı şekilde hesaplanır ve aynı şekilde yuvarlanır — asistanın sesli olarak okuduğu rakam, web sitesinde göreceğimiz rakamın ta kendisidir, bir tahmini değildir. Aracın dikkat edilmesi gereken üç özelliği daha vardır:
- Para konusunda tahmin yürütmeyi reddeder. Eğer döviz kuru mevcut olmayan bir para birimi istersek, araç bunu belirtir ve durur. ABD dolarını sessizce yerine koyup fark etmeyeceğimizi ummaz.
- Neyin satışta olup olmadığını bize söyler. Her eser her formda sunulmaz. Sadece baskı olarak mevcut olan bir eserin el yapımı yağlı boyasını isterseniz, yanıt sorunu belirtir — ve eğer bu seçenek mümkünse baskıdan bahseder.
- Boyutları dürüst tutar. Her boyut, bir atölyenin fiilen üretebileceği aralık olan 25 ile 250 cm (yaklaşık 10 ila 98 inç) arasında olmalıdır — araç, kimsenin zihinsel aritmetiğine güvenmek yerine inç değerlerini bizim için dönüştürür.
Böylece şu tarz bir konuşma rutin hale gelir: "Gustave Caillebotte'un yağmur altındaki Paris sokak manzarasını bul, ardından bana 100 × 70 cm boyutlarında el yapımı bir yağlı boya için euro cinsinden fiyat ver, aynı boyuttaki baskı için de fiyat ver ve aradaki farkı söyle." Asistan bir arama çağrısı ve iki teklif çağrısı yapar; sunduğu karşılaştırma ise gerçek fiyatlar üzerinden yapılan aritmetik bir işlemdir — tıpkı giclée baskılar ile el yapımı yağlı boyalar rehberimizde elle incelediğimiz karşılaştırmanın aynısıdır.
4. Bir asistanı uygulamada bağlamak
Sunucu, düz HTTPS üzerinden durum bilgisi tutmayan (stateless) MCP konuşur — POST gövdesinde JSON-RPC, daha egzotik bir şey değil — bu da iki farklı kitlenin bunu kullanabileceği anlamına gelir.
Bir MCP istemcisi ile
MCP yeteneğine sahip herhangi bir istemci, yalnızca uç nokta (endpoint) URL'si ile bağlanır. Claude'da bu, https://direct.Mus3ums.com/mcp/ adresine yönlendirilmiş özel bir konektör eklemek anlamına gelir. Claude Code'da ise tek bir komut yeterlidir:
claude mcp add --transport http Mus3ums https://direct.Mus3ums.com/mcp/O andan itibaren yedi araç asistanın repertuarında görünür ve asistan, soru soru bunları ne zaman kullanacağına kendisi karar verir — başka bir yapılandırmaya gerek yoktur ve halka açık araçlar için herhangi bir kimlik bilgisi gerekmez.
Düz bir API olarak
Bir MCP istemcisi olmadan kataloğa erişmek isteyen geliştiriciler, aynı uç noktayı doğrudan çağırabilirler. Tek bir curl komutu koleksiyon içinde arama yapar:
curl -s https://direct.Mus3ums.com/mcp/ \
-H 'Content-Type: application/json' \
-d '{
"jsonrpc": "2.0", "id": 1, "method": "tools/call",
"params": {
"name": "search_artworks",
"arguments": {"query": "Caillebotte Paris street rainy day"}
}
}'Yanıt; katalog numaraları, başlıklar, sanatçılar, mutlak URL'ler ve puanlar içeren yapılandırılmış bir JSON formatındadır — inşa ettiğimiz her türlü yapıya hazırdır.
Sadece siparişler için kişisel jeton (token)
Bir asistanın siparişlerimizi görmesini sağlamak için web sitesinde oturum açar, Profil → MCP / API (/profile/mcp/) kısmını açar ve orada gösterilen kişisel jetonu kopyalayıp bir Authorization başlığı olarak göndeririz. Tasarım kasıtlı olarak dar tutulmuştur: jeton tek bir hesabı tanımlar, sipariş aracı yalnızca o hesap için yanıt verir; arama ve teklif araçları ise koruyacak özel bir verileri olmadığı için jetonu tamamen görmezden gelir. Bize ait olmayan bir sipariş numarası sorulduğunda sunucu, var olmayan bir sipariş için vereceği yanıtın aynısını verir — başkasının satın alımları hakkında bu kadar küçük bir bilgiyi bile onaylamayı reddeder.
5. Bir katalog sitesi neden bir API yayınlar?
Çünkü sorular artık yer değiştirdi. Satın alma planlayan insanların artan bir oranı, işe bir arama motoruyla değil, bir asistanla başlıyor — "Mona Lisa'nın müze kalitesinde bir kopyası bana ne maliyete gelir?" ifadesi bir sohbet penceresine yazılıyor ve asistan, doğrulayabildiği kaynaklardan yanıt veriyor. Kataloglarını ve fiyatlarını asistanların sorgulayabileceği bir biçimde yayınlayan bir site, aslında müzelerin ilk halka açık kataloglarını bastıklarında yaptıkları şeyi yapıyor: Ziyaretçiyi halihazırda bulunduğu yerde karşılamak ve kulaktan dolma bilgiler yerine kesin cevapları tercih etmek. Alternatifi ise —asistanların güncelliğini yitirmiş eğitim verilerinden fiyatları ve uygunluk durumunu tahmin etmesi— hiç kimseye, özellikle de yanıt için gerçek para harcamak üzere olan kişiye hizmet etmez. Başka bir yerde reprodüksiyon tekniklerinin ve fiyatlandırmanın gerçekte nasıl işlediği ve bir reprodüksiyonda kalite ve değerin ne anlama geldiği hakkında yazdık; MCP sunucusu, bu yanıtların makine tarafından okunabilir hale getirilmiş halidir.
Bağlantı kurmadan önce sorulmaya değer üç soru
Mus3ums MCP sunucusunu kullanmak için bir hesaba veya API anahtarına ihtiyacımız var mı?
Çoğu özellik için gerekmiyor. Beş arama aracı ve alıntı aracı halka açıktır ve herhangi bir jeton (token) gerektirmez; çünkü bunlar yalnızca web sitelerinin halihazırda her ziyaretçiye sunduğu bilgileri gösterir. Yalnızca tek bir araç için kişisel bir jeton gereklidir — bu da yanıt olarak kendi siparişlerimizi, isim, telefon ve teslimat adresiyle birlikte döndüren araçtır. Bu jeton, giriş yaptıktan sonra /profile/mcp/ sayfasından alınır ve yalnızca ait olduğu hesabın siparişlerinin kilidini açabilir.
Asistanın verdiği fiyat gerçek fiyat mı?
Evet. Fiyat teklifi, satın alma sayfasıyla aynı fiyatlandırma kodu tarafından üretilir ve aynı şekilde yuvarlanır; böylece asistanın okuduğu sayı web sitesindeki sayıyla eşleşir. Desteklenen herhangi bir para biriminde, her kenarı 25 ila 250 cm olan baskıları ve el boyaması yağlı tabloları kapsar — ve bir para biriminin döviz kuru mevcut olmadığında, araç sessizce dolara dönmek yerine bunu belirtir.
Hangi asistanlar bağlanabilir?
HTTP üzerinden MCP konuşabilen tüm istemciler: Özel konektörler aracılığıyla Claude, tek bir claude mcp add komutu ile Claude Code ve genişleyen MCP yetenekli masaüstü ve geliştirici araçları. Ve taşıma işlemi HTTPS POST üzerinden sıradan JSON-RPC olduğu için, kesin olarak bir MCP istemcisine ihtiyaç duyulmaz — bir curl komutu veya herhangi bir programlama dilindeki birkaç satır kod aynı yedi araca ulaşabilir.
Mus3ums.com ile İlgili
- Teklif aracının fiyatlandırdığı şey: giclée baskılar ve el yapımı yağlı boya şaheserlerinin dürüst bir karşılaştırması.
- Reproduksiyon fiyatlarının teknik ve sipariş tercihlerine göre gerçekte nasıl oluşturulduğu: sanat reprodüksiyonunu çözmek — teknikler, fiyatlandırma ve sipariş verme.
- İnsan formundaki arama araçları: API'nin yaptığı şekilde sanatçı kataloğuna göz atın.
- Zaten giriş yaptınız mı? Token ve canlı araç listesi profilinizin MCP / API sayfasında yer almaktadır.
