30-წამიანი პასუხი
მუზეუმებმა ეს პრობლემა ერთხელ უკვე გადაჭრეს, საუკუნე და ნახევარი წინ, ბარათების კატალოგით: სტანდარტული გზით, რომლის საშუალებითაც ნებისმიერ სტუმარს შეუძლია ვრცელ კოლექციას დასვას ზუსტი კადგმული და მიიღოს ზუსტი პასუხი. Model Context Protocol — MCP — არის ბარათების კატატალოგი AI ასისტენტებისთვის. ეს არის ღია სტანდარტი, რომელიც საშუალებას აძლევს ისეთ ასისტენტს, როგორიცაა 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 |
ერთდროულად ოთხივე კატალოგი — თითოეულიდან ათამდე შედეგი, გაერთიანებული ერთ სიაში რელევანტობის მიხედვით დალაგებული. სწორი პირველი ნაბიჯი მაშინ, როდესაც ჯერ არ ვიცით, უნდა მიგვიყვანოს "Vermeer Delft" ნახატამდე, ბიოგრაფიამდე თუ მუზეუმამდე. | არა |
get_a_quotation |
ზუსტი ფასი კონკრეტული ნამუშევრის რეპროდუქციისთვის — როგორც ხელოვნების რეპროდუქცია (print) ან ხელით ნათესლი ოსწარები — მოცემული სიგანისა და სიმაღლისთვის (25–250 სმ თითოეულ მხარაზე, სმ-ში ან ინჩებში) და მოცემულ ვალუტაში. ნამუშევრის მითითება შესაძლებელია მისი კატალოგის ნომრით ან უბრალოდ სათაურითა და ხელოვანის სახელით. | არა |
get_my_orders_details |
ჩვენი საკუთარი შეკვეთები — და მხოლოდ ჩვენი საკუთარი: თარიღები, თანხები, პოზიციები თავისი პარამეტრებით, მიმდინარე სტატუსი, առალიფის მისამართი. კითხვა "სად არის მონეტი, რომელიც მარტში შევუკვეთე?" ხდება ისეთი კითხვა, რომელზეც ჩვენს ასისტენტს შეუძლია პასუხის გაცემა. | დიახ — პირადი ტოკენიდან /profile/mcp/ |
თითოეული ძიების შედეგი შეიცავს რელევანტობის ქულას და ინსტრუმენტები აბრუნებენ მხოლოდ მაღალი სანდოობის დამთხვევებს და არა უბრალოდ სიაში გადატენილ ინფორმაციას — ასისტენტს, რომელიც კითხულობს შედეგებს, შეუძლია ზუსტი იდენტიფიკაცია გაარჩიოს ბუნდოვანებისგან. შედეგები ბრუნდება იმ ენაზე, რომელზეც მოვითხოვთ: language პარამეტრი იღებს საიტის ინტერფეისის ნებისმიერ ენას და ბმულები მიუთითებს ამავე ენაზე არსებულ გვერდებზე.
3. ციტატის ხელსაწყო უფრო დეტალური განხილვის ღირს
ფასი არის ის ადგილი, სადაც „AI და შოპინგის“ ინტეგრაციის უმეტესობა ჩუმად ტრიალებს, ამიტომ ღირს ზუსტად ვთქვათ, რას აკეთებს ეს კონკრეტული ხელსაწყო. ფასი გამოითვლება იმავე კოდით, რომელიც აწესებს ფასებს თავად საყიდელ გვერდზე და ამავეგვარად ამრგვალებს — ციფრი, რომელსაც ასისტენტი წარმოთქვამს, არის ის ზუსტი ციფრი, რომელსაც ვნახავდით ვებგვერდზე და არა მისი სავარაუდო შეფასება. ხელსაწყოს კიდევ სამი თვისება იმსახურებს ყურადღებას:
- ის უარს ამბობს ფულის შესახებ გამოცნილზე. თუ ჩვენ მოვითხოვთ ვალუტას, რომლის გაცვლითი კურსი ხელმისაწვდომი არ არის, ხელსაწყო ამას გვეუბნება და ჩერდება. ის არასოდეს ანაცვლებს ჩუმად აშშ დოლარით იმ იმედით, რომ ვერ შევამჩნევთ.
- ის გვატყობინებს, რა არის გასაყიდი და რა — არა. ყველა ნამუშევარი არ არის ხელმისაწვდომი ყველა ფორმით. თუ მოვითხოვთ ხელით ნათესილ ზეთს იმ ნამუშევრისთვის, რომელიც მხოლოდ პრინტად არის ხელმისაწვდომი, პასუხი მიგვითითებს პრობლემაზე — და ახსენებს პრინტს, თუ ეს ვარიანტი შესაძლებელია.
- ის ინარჩუნებს ზომების სიზუსტეს. თითოეული განზომილება უნდა იყოს 25-დან 250 სმ-მდე (დაახლოებით 10-დან 98 ინჩამდე) — ეს არის დიაპაზონი, რომლის წარმოებაც სახელოსნოს რეალურად შეუძლია — და ხელსაწყო თავად გადაჰყავს ინჩები ჩვენთვის, ნაცვლად იმისა, რომ ვენდოთ ვინმეს გონებრივ არითმეტიკას.
ამგვარად, მსგავსი დიალოგი რუტინულ პროცესად იქცევა: „იპოვე გუსტავ კაიბოტეს პარიზის ქუჩის სცენა წელში, შემდეგ გამომიწერე ხელით ნათესილი ზეთი 100 × 70 სმ ზომაში ევროში, იგივე ზომის პრინტი და მითხარი განსხვავება.“ ასისტენტი ახორციელებს ერთ ძებნის მოთხოვნას და ორ ფასის გამოთვლის მოთხოვნას, ხოლო შედარება, რომელსაც ის გვაწვდის, არის რეალურ ფასებზე დაფუძნებული არითმეტიკა — იგივე შედარება, რომელსაც ჩვენი გიდი ジкле (giclée) პრინტებისა და ხელით ნათესილი ზეთის შედევრების შესახებ ხელით გადის.
4. ასისტენტის დაკავშირება პრაქტიკაში
სერვერი იყენებს stateless MCP-ს სტანდარტული HTTPS-ის მეშვეობით — JSON-RPC POST ბოდით, არაფერი უფრო ეგზოტიკური — რაც ნიშნედ იმას, რომ მისი გამოყენება ორ სხვადასხვა აუდიტორიას შეუძლია.
MCP კლიენტთან ერთად
ნებისმიერი MCP-ს მხარდამჭერი კლიენტი უკავშირდება მხოლოდ endpoint URL-ის მეშვეობით. Claude-ში ეს ნიშნავს მორგებული კონექტორის დამატებას, რომელიც მიმართულია https://direct.Mus3ums.com/mcp/ მისამართზე. Claude Code-ში საჭიროა მხოლოდ ერთი ბრძანება:
claude mcp add --transport http Mus3ums https://direct.Mus3ums.com/mcp/ამ მომენტიდან ასისტენტის რეპერტუარში ჩნდება შვიდი ხელსაწყო და ის თავად წყვეტს, კითხვა კითხვაზე, როდის გამოიყენოს ისინი — დამატებითი კონფიგურაციის გარეშე, ხოლო საჯარო ხელსაწყოებისთვის ავტორიზაციის მონაცემები არ არის საჭირო.
როგორც ჩვეულებრივი API
დეველოპერებს, რომლებსაც სურთ კატალოგის გამოყენება MCP კლიენტის გარეშე, შეუძლიათ პირდაპირ მიმართონ იმავე endpoint-ს. ერთი 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-ები, ქულები — მზად არის ნებისმიერი პროექტისთვის, რასაც ჩვენ ვქმნით.
პერსონალური ტოკენი, მხოლოდ შეკვეთებისთვის
იმისათვის, რომ ასისტენტმა დაინახოს ჩვენი შეკვეთები, ჩვენ ვავტორიზდებით ვებგვერდზე, გადავდივართ Profile → MCP / API ()-ში და ვაკოპირებთ იქ ნაჩვენებ პერსონალურ ტოკენს, რომელსაც ვაგზავნით როგორც 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 აკეთებს.
- უკვე ავტორიზებული ხართ? ტოკენი და live ინსტრუმენტების სია მოცემულია თქვენი პროფილის MCP / API გვერდზე.
