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 вашего профиля.
