Отговорът за 30 секунди
Музеите вече са решавали този проблем веднъж преди век и половина с картотеката: стандартен начин, чрез който всеки посетител може да зададе прецизен въпрос на огромна колекция и да получи прецизен отговор. Model Context Protocol — MCP — е картотеката за AI асистентите. Това е отворен стандарт, който позволява на асистент като Claude да излезе извък извън рамките на своя разговор и да направи заявка към жив, структуриран източник на истина, вместо да разчита на това, което частично помни от обучението си. Mus3ums сега публикува точно такъв каталог: MCP сървър на https://direct.Mus3ums.com/mcp/ с седем инструмента. Пет от тях търсят в колекцията — произведения на изкуството, артисти, музеи, статии или всички четири едновременно. Един връща точна, реална ценова оферта за репродукция на всяко произведение от каталога, като арт принт или ръчно рисувана маслена картина, в посочения от нас размер и валута. А един — единственият инструмент, който пита кой сме ние — ни позволява да проверим собствените си поръчки. За нито един от публичните инструменти не е необходим ключ, регистрация или плащане. Свързваме асистента веднъж и оттогава нататък „намери ми дъждовната улица на Кайбот в Париж и ми кажи колко би струвало ръчно рисувано копие с един метър ширина в евро“ се превръща във въпрос с точен отговор.
1. Какво е MCP, без жаргон
Един AI асистент, оставен сам на себе си, е учен, заключен в библиотека, която е престанала да придобива книги в деня, в който е приключило неговото обучение. Попитайте го за биографията на Караваджо и той ще се справи добре; попитайте го колко струва днес, в канадски долари, ръчно рисувано репродукция с размери 70 × 90 см на Призоваването на свети Матей, и той може само да гадае — учтиво, гладко и непроверяемо.
MCP, отворен стандарт, въведен от Anthropic в края на 2024 г. и оттогава приет в цялата индустрия, решава това по най-простия възможен начин: той дава на асистента телефон. Един уебсайт, който притежава нещо, достойно за въпрос — каталог, база данни, ценоразпис — публикува малък набор от наречени инструменти, всеки с описание на това какво прави и какво трябва да му бъде казано. Асистентът чете този списък по начина, по който ние четем меню, и когато въпросът ни го изисква, той набира: един структуриран заявка навън, един структуриран отговор обратно, цитиран до нас с непокътнатите цифри. Асистентът никога не рови в сървърите на сайта; той може само да задава въпросите, които сайтът е избрал да отговори. Това ограничение е същината. Картотеката не дава на посетителите ключовете към архива — тя отговаря на запитването, записано на картата.
2. Седемте инструмента и какво отговаря всеки един от тях
Сървърът предоставя седем инструмента. Забележете структурата на този набор: пет са методи за намиране на неща, един превръща находката в цена, а един — единственият частен инструмент — се отнася за нас, а не за колекцията.
| Инструмент | Какво отговаря | Нужен е токен? |
|---|---|---|
search_artworks |
Пълнотекстово търсене в каталога с произведения на изкуството по заглавие, автор и описание — „пшенично поле с кипариси“, „Зимните ловци на Брейгел“. Всеки съвпадащ резултат връща автора, заглавието, линк към страницата на произведението и оценка за релевантност. | Не |
search_artists |
Автори по име или биография, при желание филтрирани по град на раждане, държава на раждане или година, в която е живял художникът — „тиха суперсила“ за въпроси като „бояджии, активни в Делфт през 1660 г.“. | Не |
search_museums |
Музеи по име, по избор и по град и държава, като всеки резултат е поставен на карта: име, град, държава, линк. | Не |
search_articles |
Собствените есета, ръководства и често задавани въпроси (FAQ) на сайта, по избор филтрирани по категория (блог, ръководство за купувачи, поддръжка и т.н.). | Не |
search_fts |
Всички четири каталога едновременно — до десет резултата от всеки, обединени в един списък, подредени по релевантност. Правият първи ход, когато още не знаем дали „Вермеер Делфт“ трябва да ни доведе до картина, биография или музей. | Не |
get_a_quotation |
Точна цена за репродукция на конкретно произведение — като художествен принт или ръчно рисувана маслена картина — при зададена ширина и височина (25–250 см на страна, в см или инча) и в зададена валута. Произведението може да бъде посочено по неговия каталожен номер или просто по заглавие и автор. | Не |
get_my_orders_details |
Нашите собствени поръчки — и само нашите: дати, суми, отделни позиции с техните опции, текущ статус, адрес за доставка. „Къде е Моне, който поръчах през март?“ се превръща във въпрос, на който нашият асистент може да отговори. | Да — личен токен от /profile/mcp/ |
Всеки резултат от търсенето носи оценка за релевантност и инструментите връщат само със сигурни съвпадения, вместо да раздуват списъка — асистентът, който чете резултатите, може да различи твърдата идентификация от несигурното предположение. Резултатите се връщат на езика, на който сме поискали: параметърът language приема всеки от езиците на интерфейса на сайта, а линковете сочат към страници на съответния език.
3. Инструментът за оферти заслужава по-внимателно разглеждане
Цената е моментът, в който повечето интеграции „AI срещу пазаруване“ тихо се провалят, затова си струва да кажем точно какво прави този инструмент. Офертата се изчислява от същия код, който определя цените на самата страница за покупка, и се закръгля по същия начин — цифрата, която асистентът произнася, е цифрата, която бихме видели на уебсайта, а не нейно приблизително значение. Три допълнителни характеристики на инструмента заслужават внимание:
- Той отказва да гадае за пари. Ако поискаме валута, чийто обменен курс не е на разположение, инструментът го посочва и спира. Той никога не замества тихо щатските долари с надеждата, че няма да забележим.
- Той ни казва какво е и какво не е за продажба. Не всяко произведение се предлага във всяка форма. Поискайте ръчно рисувана маслена картина на произведение, което е налично само като принт, и отговорът ще посочи проблема — и ще спомене принта, ако този вариант е възможен.
- Той поддържа размерите честни. Всеки размер трябва да бъде между 2му 25 и 250 см (около 10 до 98 инча) — диапазонът, който една работилница действително може да произведе — и инструментът превръща инчовете вместо да се доверява на чийто и да било умен аритметичен процес.
Така разговор като този става рутинна дейност: "Намери сцената с парижка улица под дъжда на Гюстав Кайбот, след това ми предложи оферта за ръчно рисувана маслена картина с размери 100 × 70 см в евро, и същия размер като принт, и ми кажи разликата." Асистентът прави един заявка за търсене и две заявки за оферта, а сравнението, което предоставя, е аритметика върху реални цени — същото сравнение, което нашето ръководство за джикле принти срещу ръчно рисувани маслени картини разглежда ръчно.
4. Свързване на асистент, на практика
Сървърът използва безсъстояниев (stateless) MCP чрез стандартен HTTPS — JSON-RPC в POST тяло, нищо по-екзотично — което означава, че две различни аудитории могат да го използват.
С MCP клиент
Всеки клиент с възможност за MCP се свързва само чрез URL адреса на крайния пункт (endpoint). При Claude това означава добавяне на персонализиран конектор, насочен към https://direct.Mus3ums.com/mcp/. В Claude Code е нужна само една команда:
claude mcp add --transport http Mus3ums https://direct.Mus3ums.com/mcp/От този момент седемте инструмента се появяват в репертуара на асистента и той решава, въпрос по въпрос, кога да ги използва — без допълнителна конфигурация, а за публичните инструменти — без никакви данни за автентикация.
Като стандартно API
Разработчици, които искат достъп до каталога без MCP клиент, могат да извикат директно същия краен пункт. Една curl команда извършва търсене в колекцията:
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"}
}
}'Отговорът е структуриран JSON — номера на каталога, заглавия, автори, абсолютни URL адреси, оценки — готов за всичко, което изграждаме.
Личният токен, само за поръчки
За да позволим на асистент да вижда нашите поръчки, влизаме в сайта, отваряме Профил → MCP / API (/profile/mcp/) и копираме показания там личен токен, изпращайки го като заглавие Authorization. Дизайнът е умишлено ограничен: токенът идентифицира един акаунт, инструментът за поръчки отговаря само за този акаунт, а инструментите за търсене и ценообразуване напълно игнорират токена, тъй като няма нищо поверително, което да защитават. При запитване за номер на поръчка, която не е наша, сървърът дава същия отговор, какъвто би дал за поръчка, която не съществува — той отказва да потвърди дори толкова информация за покупки на други лица.
5. Защо един каталог изобщо публикува API
Защото въпросите вече са се преместили. Голяма част от хората, планиращи покупка, сега не започват с търсачка, а с асистент — „колко ще ми струва копие на Мона Лиза с музейно качество?“ се изписва в чат прозорец, а асистентът отговаря въз основа на всеки източник, който може да провери. Сайт, който публикува своя каталог и своите цени във форма, която асистентите могат да заявят, просто прави това, което музеите правеха, когато печатаха първите си публични каталози: среща се с посетителя там, където посетителят вече е, и предпочита точните отговори пред фолклора. Алтернативата — асистентите да гадаят цени и наличност от остарели тренировъчни данни — не служи на никого, а още по-малко на човека, който е на път да похарчи реални пари за отговора. Писахме другаде за как всъщност работят материалите за репродукция и ценообразуването и какво означават качеството и стойността при една репродукция; MCP сървърът представлява същите тези отговори, превърнати в машинно четим формат.
Три въпроса, които си струва да зададете преди свързване
Нуждаем ли се от акаунт или API ключ, за да използваме Mus3ums MCP сървъра?
Не за повечето от него. Петте инструмента за търсене и инструментът за ценообразуване са публични и не изискват токен, тъй като те показват само това, което уебсайтовете вече публикуват за всеки посетител. Личен токен е необходим само за един инструмент — този, който връща нашите собствени поръчки, с име, телефон и адрес за доставка в отговора. Този токен се взема от страницата /profile/mcp/ след влизане в профила и той може да отключи само поръчките на акаунта, към който принадлежи.
Реална ли е цената, която посочва асистентът?
Да. Ценообразуването се генерира от същия код за цени като на страницата за покупка и е закръглено идентично, така че числото, което асистентът произнася, съвпада с числото в уебсайта. То обхваща принти и ръчно рисувани маслени картини от 2ма до 250 см на страна, във всяка поддържана валута — а когато обменният курс на дадена валута не е наличен, инструментът го посочва, вместо мълчаливо да премине към долари.
Кои асистенти могат да се свържат?
Всеки клиент, който поддържа MCP чрез HTTP: Claude чрез персонализирани конектори, Claude Code с една единствена команда claude mcp add и разширяващата се област от настолни и разработчески инструменти с MCP възможности. И тъй като транспортът е стандартен JSON-RPC чрез HTTPS POST, не е строго необходим конкретен MCP клиент — команда curl или няколко реда на всеки програмен език могат да достигнат до същите седем инструмента.
Свързано във Mus3ums.com
- Какво включва ценообразуването в инструмента за оферти: джикле принти (giclée) срещу ръчно рисувани маслени шедьоври, честно сравнение.
- Как реално се формират цените на репродукциите въз основа на техниката и избора на поръчка: разшифроване на художествената репродукция — техники, ценообразуване и поръчване.
- Инструменти за търсене в човешка форма: прегледайте каталога с артисти по същия начин, по който го прави API-то.
- Вече сте влезли в профила си? Списъкът с токени и инструменти на живо се намира на вашата MCP / API страница в профила.
