30-секундна відповідь
Музеї вже вирішували цю проблему раніше, півтора століття тому, за допомогою картотеки: стандартизованого способу, що дозволяє будь-якому відвідувачу поставити величезній колекції точне запитання та отримати точну відповідь. Model Context Protocol — MCP — це картотека для ШІ-асистентів. Це відкритий стандарт, який дозволяє такому асистенту, як Claude, виходити за межі поточної розмови та звертатися до живого, структурованого джерела істини замість того, щоб покладатися на те, що він напівпам'ятає з етапу навчання. Mus3ums тепер публікує саме таку каталожку: MCP-сервер за адресою https://direct.Mus3ums.com/mcp/ із сімома інструментами. П'ять із них здійснюють пошук по колекції — твори мистецтва, художники, музеї, статті або всі чотири одночасно. Один повертає точну, реальну цінову пропозицію на репродукцію будь-якого твору з каталогу, як у вигляді арт-принта, так і в вигляді олійного письма ручної роботи, у зазначеному нами розмірі та валюті. А один — єдиний інструмент, що ставить запитання про те, хто ми такі — дозволяє нам перевіряти наші власні замовлення. Для жодного з публічних інструментів не потрібні ключі, реєстрація чи оплата. Ми підключаємо асистента лише один раз, і відтоді фраза «знайди мені дощову паризьку вулицю Кайботта і скажи, скільки коштуватиме копія ручної роботи шириною в метр у євро» стає запитанням з точною відповіддю.
1. Що таке MCP, без професійного жаргону
Штучний інтелект, залишений напризволяще, — це вчений, замкнений у бібліотеці, яка припинила отримувати нові книги в той самий день, коли завершилося його навчання. Запитайте його про біографію Караваджо, і він відповість добре; запитайте його, скільки сьогодні в канадських доларах коштує написана вручну репродукція «Поклику святого Матвія» розміром 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. Інструмент розрахунку вартості заслуговує на прискіпливий погляд
Ціна — це те місце, де більшість інтеграцій формату «ШІ зустрічає шопінг» непомітно дають збій, тому варто чітко сказати, що саме робить цей інструмент. Розрахунок вартості виконується тим самим кодом, який встановлює ціни на самій сторінці покупки, і округлюється так само — цифра, яку озвучує асистент, є тією самою цифрою, яку ми побачили б на сайті, а не її приблизним значенням. Ще три особливості інструменту заслуговують на увагу:
- Він відмовляється робити припущення щодо грошей. Якщо ми запитаємо про валюту, курс якої недоступний, інструмент прямо про це повідомить і зупиниться. Він ніколи не замінює тихо долари США в надії, що ми цього не помітимо.
- Він повідомляє нам, що є у продажу, а що — ні. Не кожна робота пропонується в усіх варіантах виконання. Якщо попросити написану маслом картину, яка доступна лише як принт, відповідь вкаже на проблему — і згадає про принт, якщо такий варіант можливий.
- Він дотримується чесності щодо розмірів. Кожен розмір має бути в межах від 25 до 250 см (приблизно від 10 до 98 дюймів) — діапазон, який майстерня дійсно може виготовити — і інструмент конвертує дюйми за нас, замість того щоб покладатися на чиюсь устну арифметику.
Таким чином, подібна розмова стає рутинною: «Знайди сцену дощової паризької вулиці Гюстава Кайботта, потім розрахуй мені вартість написаної маслом картини розміром 100 × 70 см у євро, та таку ж за розміром принт, і скажи мені різницю». Асистент робить один пошуковий запит і два запити на розрахунок вартості, а порівняння, яке він видає, є арифметичним розрахунком реальних цін — саме таке порівняння, яке ми вручну розбираємо у нашому посібнику з відмінностей між принтами джикле та шедеврами, написаними маслом.
4. Підключення асистента на практиці
Сервер використовує stateless MCP через звичайний HTTPS — JSON-RPC у тілі POST-запиту, нічого екзотичного — що дозволяє використовувати його двом різним аудиторіям.
З MCP-клієнтом
Будь-який клієнт із підтримкою MCP підключається лише за URL-адресою кінцевої точки. У 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/ після входу в систему, і він може розблокувати замовлення лише того облікового запису, якому він належить.
Чи є ціна, яку називає асистент, реальною ціною?
Так. Розрахунок ціни виконується тим самим кодом, що й на сторінці покупки, і округлюється ідентично, тому число, яке зачитує асистент, збігається з числом на вебсайті. Це стосується принтів та написаних вручну олійних картин розміром від 25 до 250 см за сторону, у будь-якій підтримуваній валюті — і якщо курс обміну валюти недоступний, інструмент повідомить про це, а не перейде мовчки на долари.
Які асистенти можуть підключитися?
Будь-який клієнт, що підтримує MCP через HTTP: Claude через кастомні конектори, Claude Code за допомогою однієї команди claude mcp add, а також десктопні та розробницькі інструменти з підтримкою MCP, сфера застосування яких постійно зростає. Оскільки транспорт використовує звичайний JSON-RPC через HTTPS POST, спеціальний MCP-клієнт не є суворо обов'язковим — команда curl або кілька рядків на будь-якій мові програмування дозволяють отримати доступ до тих самих семи інструментів.
Пов'язане на Mus3ums.com
- Що саме оцінює інструмент розрахунку вартості: принти джикле проти написаних вручну олійних шедеврів, чесне порівняння.
- Як ціни на репродукції насправді формуються залежно від техніки та вибору замовлення: розшифровка репродукції творів мистецтва — техніки, ціноутворення та замовлення.
- Інструменти пошуку в людській формі: переглянути каталог художників так само, як це робить API.
- Вже увійшли в систему? Список токенів та інструментів у реальному часі доступний на сторінці MCP / API вашого профілю.
