30-sekundiline vastus
Muuseumid lahendasid selle probleemi kord varem, pool sajandit tagasi, kaardikataloogiga: standardne viis, kuidas ükskõsi külastaja saab suurelt kogumikult täpset küsimust esitada ja saada täpset vastust. Model Context Protocol — MCP — on kaardikatalog tehisintellekti assistentide jaoks. See on avatud standard, mis võimaldab assistendil nagu Claude astuda välja oma vestlusest ja küsida infot reaalsetest, struktureeritudest allikatest, statt et tugeneda sellele, mida ta treeningprotsessist poolikud mäludest meeldib. Mus3ums avaldab nüüd täpselt sellist kataloogi: MCP-server aadressil https://direct.Mus3ums.com/mcp/, mis sisaldab seitsemõist tööriista. Viis neist otsivad kogumist — teoseid, kunstnereid, muuseumeid, artikleid või kõiki nelja korraga. Üks annab täpse, reaalsete summade hinnapakkumise kataloogis oleva mis tahes teose reproduktsiooni jaoks, kas see on kunstitrükk või käsitsi maalitud õli, soovitud suuruses ja nimeatud valuutas. Ja üks — ainus tööriist, mis küsib, kes me oleme — võimaldab meil kontrollida oma tellimusi. Ühegi avaliku tööriista kasutamiseks ei vaja võtit, registreerimist ega maket. Me ühendame assistendi üks kord ning sellest hetkest peale muutub küsimus "leia mulle Caillebotte'i vihmane Pariisi tänav ja ütle mulle, kui palju maksaks üks meetri lai käsitsi maalitud koopia eurodes" küsimuseks koos täpse vastusega.
1. Mis on MCP, ilma tehnilise jargonita
Tehisintellekti assistent on omaette jäetuna nagu teadlane, kes on lukustatud raamatukogu, kus uusi raamatuid ei ole ostetud alates päevast, mil selle treening lõppes. Küsi temalt Caravaggio eluloo kohta ja ta vastab hästi; küsi temalt, kui palju maksab täna kanadade dollarites 70 × 90 cm suurune käsitsi maaldud reproduktsioon teosest Püha Matteuse kutse, ja ta suudab vaid oletada — viisakalt, sujuvalt ning tõendamatult.
MCP on avatud standard, mille lõi Anthropic 2024. aasta lõpus ja mis on sellest ajast alates võetud üle kogu tööstuses. See lahendab selle probleemi võimalikult lihtsal viisil: see annab assistendile telefoni. Veebileht, millel on küsimist väärt asja — katalog, andmebaas või hinnalist — avaldab väikese kogum nimeatud tööriistu, millest igaüks sisaldab kirjeldust selle kohta, mida tööriist teeb ja millist infot selleks vajatakse. Assistent loeb seda nimekirja nagu me loeme menüüd ja kui meie küsimus seda nõuab, ta numbrid pöörab: üks struktureeritud päring välja, üks struktureeritud vastus tagasi, meile esitatuna koos tervete numbritega. Assistent ei lähemagi läbi veebilehe servereid; ta saab esitada ainult neid küsimusi, millele leht on valmis vastata. See piirang ongi selle eesmärk. Kataloogkaart ei too külastajatele arhiivi võtmega kätte — see annab vastuse kaardi tekstis olevale päringule.
2. Seit tööriista ja seda, mida igaüks neist vastab
Server pakub seitse tööriista. Pane tähele komplekti olemust: viis on viisid asjade leidmisel, üks muudab leidingu hinnaks ning üks — ainus privaatne — puudutab meid pigem kui kogumust.
| Tööriist | Mida see vastab | Kas token on vajalik? |
|---|---|---|
search_artworks |
Tegemist on teoste kataloogi täistekstiga otsinguga pealkirja, kunstniku ja kirjelduse põhjal — "nukupind kypressidega", "Bruegel talvejahipid". Iga vastavus tagastab kunstniku, pealkirja, lingi teose lehele ja asjakohasusindeksi. | Ei |
search_artists |
Kunstnikud nime või biograafia põhjal, piiratud vastavalt soovile sünnilinn, sünnimaa või aasta järgi, mil kunstnik elas — vaikne supervõim küsimustele nagu "1660. aastal Delftis tegevad maalijad". | Ei |
search_museums |
Muuseumid nime järgi, valikuliselt linna ja riigi põhjal, kus iga tulemus on kaardil asendatud: nimi, linn, riik, link. | Ei |
search_articles |
Saiti kuuluvad esseed, juhendid ja korduma kippuvad küsimused (FAQ), valikuliselt kategooria põhjal filtreeritud (blogi, ostja juhend, tugiteenus jne). | Ei |
search_fts |
Kõik neli kataloogi korraga — kuni kümme tulemust igast, ühendatud ühte nimekirja, mis on järjestatud asjakohasuse järgi. Õige esimene samm siis, kui ei tea veel, kas "Vermeer Delft" peaks viima maali, biograafia või muuseumi juurde. | Ei |
get_a_quotation |
Täpne hind konkreetse teose reproduktsiooni jaoks — teosena trükk või käsitsi maalitud õliteos — määratud laiuses ja kõrguses (25–250 cm per pool, cm või tollides) ning määratud väärtuses. Teose võib nimetada kataloogi numbri või lihtsalt pealkirja ja kunstniku järgi. | Ei |
get_my_orders_details |
Meie enda tellimused — ja ainult meie enda: kuupäevad, summad, ridad koos valikutega, praegune staatus, tarne aadress. Küsimus "Kust on see Monet, mille tellisin märtsis?" muutub küsimuseks, millele meie assistent vastata saab. | Jah — isiklik token leitavast /profile/mcp/ |
Iga otsingutulemis on asjakohasusindeks ning tööriistad tagastavad ainult usaldusväärsed vastamised, mitte täidavad nimekirja asjatute tulemustega — assistent, kes tulemusi loeb, saab kindla tuvastuse eristada ebakindlast vastust. Tulemused tulevad selles keeles, mis on küsimuses: language parameeter võtab vastu kõik veebisaidi liidese keeled ning lingid viivad lehtedele selles keeles.
3. Hinnapakkumise tööriist väärib lähemmat vaatamist
Hind on koht, kus enamik "tehisintellekti ja ostlemise" integratsioonid vaikselt ebaõnnestuvad, seega on väärt mõista täpselt, mida see tööriist teeb. Hinnapakkumist arvutatakse sama koodiga, mis määrab hinnad ostulehel, ja ümardatakse samamoodi — number, mida assistent ette loeb, on see number, mida me näeksime veebilehel, mitte selle hoolitletud hinnang. Kolm muud tööriista harjumust väärivad tähelepanu:
- See keeldubub rahas kohta oletamast. Kui me küsime valuuta kohta, mille vahet kursist ei ole saadaval, ütleb tööriist selle selgelt välja ja lõpetab. See ei asendagi kunagi vaikselt USA dollareid, lootes, et me seda ei märka.
- See teatab meile, mis on müügil ja mis mitte. Mitte kõik teosed ei ole pakutavad igas vormis. Kui küsida käsipintlit õliõldust teosest, mis on saadaval ainult trükkina, siis vastus märgib probleemi — ja mainib trükki, kui see võimalus on avatud.
- See hoiab mõdad ausad. Iga mõõt peab olema vahemikus 25 kuni 250 cm (umbes 10 kuni 98 tolli) — ulemikus, mida tööbaas tegelikult võiks valmistada — ja tööriist teisendab tollid meie jaoks, selle asemel et usaldada kedagi vaimset aritmist.
Nii muutub selline vestlus rutiinseks: "Leida Gustave Caillebotte'i Pariisi tänavakoht vihmas, siis pakkuda mulle käsipintlit õliõldust suuruses 100 × 70 cm eurodes ning sama suurusega trükki, ja öelda mulle nende vahe." Assistent teeb ühe otsingu ja kaks hinnapakkumise päringut ning võrdlus, mille ta tagastab, on aritmika reaalsetel hindadel — sama võrdlus, mida meie juhend giclée-trükkide ja käsipintlite õliõldiste meistriteostade vahel käsitleb käsitsi.
4. Assistentide ühendamine praktikas
Server räägib olekuvaba (stateless) MCP-d tavalise HTTPS protokooli kaudu — JSON-RPC POST-päihs, mitte midagi eksootilisemat — mis tähendab, et seda saavad kasutada kaks erinevat sihtrühma.
MCP kliendiga
Iga MCP-võimega klient ühendub vaid lõpppunkti (endpoint) URL-i abil. Claude puhul tähendab see kohandatud konnektori lisamist, mis on suunatud aadressile https://direct.Mus3ums.com/mcp/. Claude Code puhul piisab ühe käsu:**
claude mcp add --transport http Mus3ums https://direct.Mus3ums.com/mcp/Alates sellest hetkest ilmuvad assistendi repertuaari seitse tööriista ning ta otsustab küsimus küsimuselt, millal neid kasutada — täiendavat konfigureerimist ei vaja ning avalike tööriistade puhul ei nõudeta ka autentimisteabe andmist.
Nagu tavaline API
Arendajad, kes soovivad kataloogi ilma MCP-kliendita, saavad sama lõpppunkti otse kutsuda. Üks curl-käsk teeb otsingu kollektsioonis:
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"}
}
}'Vastus on struktureeritud JSON — katalooginumbrid, pealkirjad, kunstnikud, täielikud URL-id, hulgad — valmis igaks meie poolt loovitud lahenduseks.
Isiklik token, ainult tellimuste jaoks
Et võimaldada assistendil näha meie tellimusi, logime veebilehele sisse, avame Profile → MCP / API (/profile/mendas/) ja kopeerime seal näidatud isikliku tokeni, saades selle edasi Authorization päisena. Disain on teadlikult piiratud: token tuvastab ühe konto, tellimuste tööriist vastab ainult selle konto kohta ning otsingu- ja hinnapakkumiste tööriistad ignoreerivad tokenit täielikult, kuna neil puudub vajadus midagi privaatset kaitsta. Kui küsid tellimusnumbrist, mis ei kuulu meile, annab server sama vastuse, mida ta annaks olematu tellimuse puhul — ta keeldub kinnitamast isegi seda minimaalset infot teiste inimeste ostude kohta.
5. Miks kataloogisaidil üldse API on olemas
Sellepärast, et küsimused on juba liigunud. Üha suurem osa ostuplanevates inimestest ei alusta enam otsingumootoriga, vaid abistajaga — vestlusakenasse trükitakse "mis maksaks mulle Mona Lisa muuseumikvaliteediga koopia?" ja abistaja vastab kõikide leitavaks tõendatavate allikatena. Saite, mis avaldab oma kataloogi ja hinnakirja vormis, mida abistajad saavad päringutele vastata, teeb lihtsalt seda, mida muuseumid tegid, kui trükkisid oma esimesed avalikud kataloogid: kohtub külastajaga seal, kus külastaja juba on, eelistades täpseid vastuseid folkloori asemel. Alternatiiv — abistajad, kes arvavad hintoja ja kättesaadavust vanunenud treeningandmete põhjal — ei aita kedagi, eriti mitte inimest, kes on valmis vastuse eest päris raha maksma. Oleme mujal kirjutanud sellest, kuidas reproduktsiooni materjalid ja hinnastamine tegelikult toimivad ja mida tähendavad kvaliteet ja väärtus reproduktsioonis; MCP server on need samad vastused, muudet masinaga loetavaks.
Kolm küsimust, milleks on väärt enne ühendumist küsida
Kas Mus3ums MCP serverist kasutamiseks vajame kontot või API võtit?
Enamikud funktsioonid selleks ei vaja. Viis otsingutööriistut ja hinnapakkumise tööriist on avalikud ega vaja tokenit, kuna need näitavad ainult seda, mida veebilehed juba kõikide külastajatele avaldavad. Isikuline token on vajalik vaid ühe tööriista puhul — selle jaoks, mis tagastab meie oma tellimused koos nime, telefoninumberi ja tarneaadressiga. See token on kättesaadav lehelt /profile/mcp/ pärast sisselogimist ning see saab avada ainult selle konto tellimusi, kellele see kuulub.
Kas assistendi esitした hind on tegelik hind?
Jah. Hinnapakkumine on loodud sama hinnakoodiga nagu ostulehe oma ja ümardatud identсelt, nii et number, mida assistent ette loeb, vastab veebilehel olevale numbrile. See katab trükised ja käsitsi maalitud õliõliteosed suuruses 25 kuni 250 cm külgedelt, ükskõsi toetatud valuutas — ning kui mingi valuuta vahet kurs on kättesaamatu, ütleb tööriist selle selgelt välja, statt et lakkuks vaikselt dollaritesse.
Millised assistendid saavad ühenduda?
Iga klient, mis toetab MCP-d HTTP kaudu: Claude läbi kohandatud konnektorite, Claude Code ühe claude mcp add käsu abil ning üha suurenev MCP-võimega töölauaprogrammid ja arendajatööriistad. Kuna edastus on tavaline JSON-RPC üle HTTPS POSTi, ei ole MCP klient strictly vajalik — curl käsk või mõned read üksikus programmeerimisköögis jõuavad samadele seitsmele tööriistale.
Seotud Mus3ums.com-is
- Mida hinnakiri kajastab: giclée-prandid võrreldes käsitsi maalitud õliteostega, ausalt võrrelduna.
- Kuidas reproduktsioonide hinnad tegelikult muodustuvad materjali ja tellimuse valikute põhjal: kunstireproduktsioonide dekodeerimine — materjalid, hinnastamine ja tellimine.
- Otsingutööriistud inimlikummas vormis: sirgi kunstnike kataloogi samamoodi nagu seda teeb API.
- Olete juba sisse logitud? Token ja reaalajas tööriistade nimekiri on Teie profiili MCP / API lehel.
