30 sekunnin vastaus
Museot ratkaisivat tämän ongelman kerran aiemmin, vuosisata puolikymmen sitten, kortistolla: vakiintuneella tavalla, jonka avulla mikä tahansa vierailija voi esittää valtavalle kokoelmalle tarkan kysymyksen ja saada tarkan vastauksen. Model Context Protocol — MCP — on tekoälyassistenttien kortisto. Se on avoin standardi, joka antaa esimerkiksi Clauden kaltaisen assistentin laajentaa keskusteluaan ja kyselyä reaaliahteesta, rakenteellisesta totuuden lähteestä sen sijaan, että se luottaisi siihen, mitä se puolittain muistaa koulutuksestaan. Mus3ums julkaisee nyt juuri tällaisen luettelon: MCP-palvelimen osoitteessa https://direct.Mus3ums.com/mcp/, joka sisältää seitsemän työkalua. Viisi niistä hakee kokoelmasta — teoksia, taiteilijoita, museoita, artikkeleita tai kaikkia neljää kerralla. Yksi palauttaa tarkan, todelliseen rahaan perustuvan hintatarjouksen mistä tahansa luettelon teoksesta valmistetulle reproduktiolle, joko taideprinttinä tai käsinmaalattuna öljyvärinä, valitsemallamme koolla ja valuutalla. Ja yksi — ainoa työkalu, joka kysyy kuka olemme — antaa meidän tarkistaa omat tilauksemme. Mitään avainta, rekisteröitymistä tai maksua ei tarvita yhtäkään julkisista työkaluista. Yhdistämme assistentin kerran, ja siitä lähtien "etsi minulle Caillebotten sateinen Pariisin katu ja kerro, mitä metri leveä käsinmaalattu kopio maksaisi euroina" muuttuu kysymykseksi, johon on tarkka vastaus.
1. Mitä MCP on, ilman ammattijargonia
Tekoälyavustaja on itsenäisesti toimittanaan tutkija, joka on lukittu kirjastoon, johon kirjojen hankinta päättyi sinä päivänä, kun sen koulutus loppui. Kysy siltä Caravaggion elämäkerrasta, ja se suoriutuu tehtävästä hyvin; kysy siltä, mitä 70 × 90 cm kokoinen käsinmaalattu Pyhän Matteuksen kutsumisen jäljennös maksaa tänään Kanadan dollareissa, ja se voi vain arvata — kohteliaasti, sujuvasti ja varmistamattomasti.
MCP, avoin standardi, jonka Anthropic esitteli vuoden 2024 lopulla ja joka on sittemmin otettu käyttöön koko toimialalla, korjaa tämän mahdollisimman yksinkertaisella tavalla: se antaa avustajalle puhelimen. Verkkosivusto, jolla on kysyttävää arvokasta sisältöä — kuten luettelo, tietokanta tai hintalista — julkaisee pienen joukon nimettyjä työkaluja, joista jokaisella on kuvaus siitä, mitä se tekee ja mitä sille on kerrottava. Avustaja lukee listan samalla tavalla kuin me luemme ruokalistaa, ja kun kysymyksemme sitä vaatii, se soittaa: yksi jäsennelty pyyntö ulos, yksi jäsennelty vastaus takaisin, meille lainattuna luvut säilyneinä. Avustaja ei koskaan selata sivuston palvelimia; se voi esittää vain ne kysymykset, joihin sivusto on valinnut vastata. Tämä rajoite on juuri se tarkoitus. Kirjakatalogi ei anna vierailijoille avaimia arkistoon — se vastaa kortissa olevaan kyselyyn.
2. Seitsemän työkalua ja mitä kukin niistä vastaa
Palvelin tarjoaa seitsemän työkalua. Huomaa joukon rakenne: viisi on tapa löytää asioita, yksi muuttaa löydöksen hinnaksi, ja yksi — ainoa yksityinen työkalu — koskee meitä pikemminkin kuin kokoelmaa.
| Työkalu | Mihin se vastaa | Tarvitaanko tokenia? |
|---|---|---|
search_artworks |
Täystekstihaku teosluettelosta otsikon, taiteilijan ja kuvauksen perusteella — "veitsikenttä sypresseineen", "Bruegelin talven metsästäjät". Jokainen osuma palauttaa taiteilijan, otsikon, linkin teoksen sivulle ja osuvuuspisteet. | Ei |
search_artists |
Taiteilijat nimen tai elämäkerran perusteella, rajattuna tarvittaessa syntymäkaupungin, syntymämaan tai taiteilijan elinvuoden mukaan — hiljainen supervoima kysymyksiin kuten "Delftissä toimineet maalari vuodesta 1660". | Ei |
search_museums |
Museet nimen perusteella, valinnaisesti kaupungin ja maan mukaan, jokainen tulos sijoitettuna kartalle: nimi, kaupunki, maa, linkki. | Ei |
search_articles |
Sivuston omat esseet, oppaat ja UKK, valinnaisesti kategorioittain suodatettuna (blogi, ostajan opas, tuki jne.). | Ei |
search_fts |
Kaikki neljä luetteloa kerralla — enintään kymmenen tulosta jokaisesta, yhdistettynä yhdeksi listaksi osuvuuden mukaan järjestettynä. Oikea ensimmäinen siirto, kun emme vielä tiedä, pitäisikö haun "Vermeer Delft" johtaa maalaukseen, elämäkertaan vai museoon. | Ei |
get_a_quotation |
Tarkka hinta tietyn teoksen reproduktiolle — painatuksena tai käsinmaalattuna öljyvärimaalauksena — annetulla leveydellä ja korkeudella (25–250 cm per sivu, senttimetreinä tai tuumina) ja tietyssä valuutassa. Teos voidaan ilmoittaa luettelon numerolla tai yksinkertaisesti otsikolla ja taiteilijalla. | Ei |
get_my_orders_details |
Omat tilauksemme — ja vain omat: päivämäärät, summat, erät valintoineen, nykyinen tila, toimitusosoite. "Missä on maaliskuussa tilaamani Monet?" muuttuu kysymykseksi, johon avustajamme voi vastata. | Kyllä — henkilökohtainen token osoitteesta /profile/mcp/ |
Jokainen hakutulos sisältää osuvuuspisteet, ja työkalut palauttavat vain luotettavat osumat listan täyttämisen sijaan — tuloksia lukeva avustaja erottaa varman tunnistuksen epävarmuudesta. Tulokset palautetaan pyydetyllä kielellä: language-parametri hyväksyy minkä tahansa sivuston käyttöliittymän kielistä, ja linkit johtavat kyseisellä kielellä oleville sivuille.
3. Tarjoustyökalu ansaitsee tarkemman tarkastelun
Hinta on se kohta, jossa useimmat "tekoäly kohtaa ostamisen" -integraatiot epäonnistuvat hiljaisesti, joten on syytä sanoa tarkasti, mitä tämä työkalu tekee. Tarjous lasketaan samalla koodilla, joka määrittää hinnat itse ostosivulla, ja se pyöristetään samalla tavalla — luku, jonka assistentti lukee ääneen, on sama luku, jonka näkisimme verkkosivustolla, eikä vain sen arvio. Työkalun kolme muuta ominaisuutta ansaitsevat huomiota:
- Se kieltäytyy arvaamasta rahamääriä. Jos pyydämme valuuttaa, jonka vaihtokurssia ei ole saatavilla, työkalu ilmoittaa siitä ja lopettaa. Se ei koskaan hiljaisesti korvaa niitä Yhdysvaltain dollareilla ja toivo, ettemme huomaisi sitä.
- Se kertoo meille, mikä on ja mikä ei ole myynnissä. Kaikkia teoksia ei ole tarjolla kaikissa muodoissa. Jos pyydät käsinmaalattua öljyversiota teoksesta, joka on saatavilla vain painoksena, vastaus nimeää ongelman — ja mainitsee painoksen, jos se on mahdollista.
- Se pitää koot rehellisinä. Jokaisen mitan on oltava välillä 25–250 cm (noin 10–98 tuumaa) — alue, jonka verstas voi todellisuudessa valmistaa — ja työkalu muuntaa tuumit meille sen sijaan, että luottaisi kenenkään päässälaskuun.
Näin keskustelu tästä tulee rutiinia: "Etsi Gustave Caillebotten Pariisin katunäkymä sateessa, anna sitten tarjous käsinmaalatusta öljyversiosta koossa 100 × 70 cm euroina, ja sama koko painoksena, ja kerro minulle ero." Assistentti tekee yhden hakukutsun ja kaksi tarjouskutsua, ja vertailu, jonka se palauttaa, on laskutoimitus todellisilla hinnoilla — sama vertailu, jonka oppaamme giclée-painosten ja käsinmaalattujen öljyteosten välillä käy läpi manuaalisesti.
4. Assistentin yhdistäminen käytännössä
Palvelin käyttää tilatonta MCP-protokollaa tavallisen HTTPS:n välityksellä — JSON-RPC POST-rungossa, ei mitään eksoottisempaa — mikä tarkoittaa, että sitä voivat käyttää kaksi eri kohderyhmää.
MCP-asiakasohjelman kanssa
Mikä tahansa MCP-yhteensopiva asiakasohjelma yhdistyy pelkän päätepisteen URL-osoitteen avulla. Claudessa tämä tarkoittaa mukautetun liittimen lisäämistä, joka on osoitettu osoitteeseen https://direct.Mus3ums.com/mcp/. Claude Codessa se vaatii vain yhden komennon:
claude mcp add --transport http Mus3ums https://direct.Mus3ums.com/mcp/Siitä hetkestä lähtien seitsemän työkalua ilmestyvät assistentin valikoimaan, ja se päättää kysymys kerrallaan, milloin niitä käytetään — ei lisäkonfiguraatioita, eikä julkisille työkaluille tarvita tunnuksia.
Tavallisena API:na
Kehittäjät, jotka haluavat katalogin ilman MCP-asiakasohjelmaa, voivat kutsua samaa päätepistettä suoraan. Yksi curl-komento hakee kokoelman:
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"}
}
}'Vastaus on jäsenneltyä JSONia — kataloginumerot, otsikot, taiteilijat, absoluuttiset URL-osoitteet, pisteytykset — valmiina mitä tahansa rakentamaamme sovellusta varten.
Henkilökohtainen token, vain tilauksia varten
Saattaaksemme assistentin näkemään tilauksemme, kirjaudumme verkkosivustolle, avaamme Profiili → MCP / API (/profile/mcp/) ja kopioimme siellä näkyvän henkilökohtaisen tokenin, lähettäen sen Authorization-otsikkona. Suunnittelu on tietoisesti rajattu: token tunnistaa yhden tilin, tilaustyökalu vastaa vain kyseiselle tilille, ja haku- sekä tarjoustyökalut jättävät tokenin kokonaan huomiotta, koska niillä ei ole mitään yksityistä suojattavaa. Jos kysytään tilausnumeroa, joka ei kuulu meille, palvelin antaa saman vastauksen kuin jos kyseessä olisi tilaus, jota ei ole olemassa — se kieltäytyy vahvistamasta edes sellaista tietoa muiden ostoksista.
5. Miksi katalogisivusto julkaisee API:n lainkaan
Koska kysymykset ovat jo siirtyneet. Yhä suurempi osa ostoksia suunnittelevista ihmisistä ei aloita hakukoneella, vaan assistentilla — chatti-ikkunaan kirjoitetaan "paljonko museolaatuisen Mona Lisa -kopion hinta olisi?", ja assistentti vastaa niistä lähteistä, jotka se pystyy todellisuudessa varmistamaan. Sivusto, joka julkaisee kataloginsa ja hintansa muodossa, jota assistentit voivat kysellä, tekee yksinkertaisesti samaa kuin museot tekivät painaessaan ensimmäiset julkiset kataloginsa: se kohtaa vierailijan siellä, missä vierailija jo on, ja suosii tarkkoja vastauksia kansanperinteiden sijaan. Vaihtoehto — assistenttien arvailevat hinnat ja saatavuus vanhentuneen koulutusdatan perusteella — ei palvele ketään, etenkään henkilöä, joka on aikeissa käyttää oikeaa rahaa vastaukseen. Olemme kirjoittaneen muualla siitä, miten reproduktioiden materiaalit ja hinnoittelu todellisuudessa toimivat sekä siitä, mitä laatu ja arvo tarkoittavat reproduktiossa; MCP-palvelin on juuri nuo samat vastaukset, tehty koneellisesti luettavaan muotoon.
Kolme kysymystä, jotka kannattaa kysyä ennen yhdistämistä
Tarvitsemmeko tilin tai API-avaimen Mus3ums MCP -palvelimen käyttöön?
Suurimpaan osaan ei. Viisi hakutyökalua ja lainaustyökalu ovat julkisia eivätkä vaadi tokenia, koska ne näyttävät vain sitä, mitä verkkosivustot jo julkaisevat jokaiselle vierailijalle. Henkilökohtainen token vaaditaan vain yhteen työkaluun — siihen, joka palauttaa omat tilauksemme sisältäen nimen, puhelinnumeron ja toimitusosoitteen vastauksessa. Tämä token saadaan /profile/mcp/ -sivulta sisäänkirjautumisen jälkeen, ja se voi avata vain siihen kuuluvan tilin tilaukset.
Onko assistentin ilmoittama hinta todellinen hinta?
Kyllä. Lainaus tuotetaan samalla hinnoittelukoodilla kuin ostosivu ja pyöristetään identtisesti, joten luku, jonka assistentti lukee ääneen, vastaa verkkosivustolla olevaa lukua. Se kattaa vedokset ja käsin maalatut öljyt 25–250 cm sivun pituudelta, millä tahansa tuetulla valuutalla — ja jos valuutan vaihtokurssi ei ole saatavilla, työkalu ilmoittaa siitä sen sijaan, että se vaihtuisi hiljaisesti dollareihin.
Mitkä assistentit voivat yhdistää?
Mikä tahansa asiakasohjelma, joka tukee MCP:tä HTTP:n välityksellä: Claude mukautettujen liittimien kautta, Claude Code yhdellä claude mcp add -komennolla sekä laajeneva joukko MCP-yhteensopivia työpöytä- ja kehittäjätyökaluja. Ja koska siirto on tavallista JSON-RPC:tä HTTPS POST -pyynnön kautta, mitään erillistä MCP-asiakasohjelmaa ei ole ehdottomasti tarpeen — curl-komento tai muutaman rivin koodi missä tahansa ohjelmointikielessä pääsee samoihin seitsemään työkaluun.
Aiheeseen liittyvää Mus3ums.com-sivustolla
- Mitä tarjoustyökalu hinnoittelee: giclée-vedokset vs. käsin maalatut öljymestariteokset, rehellinen vertailu.
- Miten jäljennösten hinnat todellisuudessa muodostuvat tekniikan ja tilausvalintojen perusteella: taiteen jäljentämisen purku — tekniikat, hinnoittelu ja tilaaminen.
- Hakutyökalut ihmismuodossa: selaa taiteilijaluetteloa samalla tavalla kuin API tekee.
- Oletko jo kirjautunut sisään? Token- ja live-työkalulista löytyvät profiilisi MCP / API-sivulta.
