Het 30-seconden antwoord
Musea hebben dit probleem een eeuw geleden al eens opgelost met de kaartcatalogus: een standaardmethode waarmee elke bezoeker een zeer specifieke vraag kan stellen aan een enorme collectie en een precies antwoord krijgt. Het Model Context Protocol — MCP — is de kaartcatalogus voor AI-assistenten. Het is een open standaard die een assistent zoals Claude in staat stelt om buiten het gesprek te treden en een live, gestructureerde bron van waarheid te raadplegen, in plaats van te vertrouwen op wat hij zich nog half herinnert uit de training. Mus3ums publiceert nu precies zo'n catalogus: een MCP-server op https://direct.Mus3ums.com/mcp/ met zeven tools. Vijf daarvan doorzoeken de collectie — kunstwerken, kunstenaars, musea, artikelen, of alle vier tegelijk. Eén tool geeft een exacte, reële prijsopgave voor een reproductie van elk kunstwerk in de catalogus, als kunstprint of handgeschilderd olieverfschilderij, in de gewenste afmeting en valuta. En één — de enige tool die vraagt wie we zijn — stelt ons in staat om onze eigen bestellingen te controleren. Voor geen enkele van de openbare tools is een sleutel, registratie of betaling nodig. We koppelen de assistent eenmalig, en vanaf dat moment wordt "zoek voor mij Caillebotte's regenachtige Parijse straat en vertel me wat een handgeschilderde kopie van een meter breed in euro's zou kosten" een vraag met een exact antwoord.
1. Wat MCP is, zonder het jargon
Een AI-assistent is, wanneer hij aan zichzelf wordt overgelaten, een geleerde opgesloten in een bibliotheek die stopte met het verwerven van boeken op de dag dat zijn training eindigde. Vraag hem naar de biografie van Caravaggio en hij presteert goed; vraag hem wat een handgeschilderde reproductie van 70 × 90 cm van De Roeping van de Heilige Matteüs vandaag de dag kost, in Canadese dollars, en hij kan alleen maar gokken — beleefd, vloeiend en oncontroleerbaar.
MCP, een open standaard die eind 2024 door Anthropic is geïntroduceerd en sindsdien door de hele sector is overgenomen, lost dit op de eenvoudigst mogelijke manier op: het geeft de assistent een telefoon. Een website die iets heeft dat het vragen waard is — een catalogus, een database, een prijslijst — publiceert een kleine set benoemde tools, elk met een beschrijving van wat het doet en wat er verteld moet worden. De assistent leest die lijst zoals wij een menukaart lezen, en wanneer onze vraag daarom vraagt, belt hij: één gestructureerd verzoek eruit, één gestructureerd antwoord terug, aan ons geciteerd met de cijfers intact. De assistent zoekt nooit zelf door de servers van de site; hij kan alleen de vragen stellen die de site heeft gekozen om te beantwoorden. Die beperking is juist het doel. Een catalogus geeft bezoekers niet de sleutels van het archief — hij beantwoordt de vraag op de kaart.
2. De zeven tools, en wat elk ervan beantwoordt
De server biedt zeven tools aan. Let op de structuur van het geheel: vijf zijn manieren om dingen te vinden, één zet een vondst om in een prijs, en één — de enige privé-tool — heeft betrekking op ons in plaats van op de collectie.
| Tool | Wat het beantwoordt | Token nodig? |
|---|---|---|
search_artworks |
Volledige tekstzoekopdracht in de kunstcatalogus op titel, kunstenaar en beschrijving — "tarweveld met cipressen", "Bruegel winterjagers". Elke overeenkomst geeft de kunstenaar, de titel, een link naar de pagina van het werk en een relevantiescore terug. | Nee |
search_artists |
Kunstenaars op naam of biografie, indien gewenst verfijnd op geboorteplaats, geboorteland of een jaar waarin de kunstenaar leefde — een stille superkracht voor vragen zoals "schilders actief in Delft in 1660". | Nee |
search_museums |
Musea op naam, optioneel op stad en land, waarbij elk resultaat op de kaart wordt geplaatst: naam, stad, land, link. | Nee |
search_articles |
De eigen essays, gidsen en FAQ's van de site, optioneel gefilterd op categorie (blog, kopergids, ondersteuning, enzovoort). | Nee |
search_fts |
Alle vier de catalogi tegelijk — tot tien resultaten uit elk, samengevoegd in een enkele lijst gesorteerd op relevantie. De juiste eerste stap wanneer we nog niet weten of "Vermeer Delft" moet leiden naar een schilderij, een biografie of een museum. | Nee |
get_a_quotation |
Een exacte prijs voor een reproductie van een specifiek kunstwerk — als een kunstprint of een met de hand geschilderd olieverfschilderij — met een opgegeven breedte en hoogte (25–250 cm per zijde, in cm of inches) en in een opgegeven valuta. Het kunstwerk kan worden benoemd via het catalogusnummer of simpelweg via titel en kunstenaar. | Nee |
get_my_orders_details |
Onze eigen bestellingen — en alleen de onze: datums, bedragen, regelitems met hun opties, huidige status, verzendadres. "Waar is de Monet die ik in maart heb besteld?" wordt een vraag die onze assistent kan beantwoorden. | Ja — persoonlijke token van /profile/mcp/ |
Elk zoekresultaat bevat een relevantiescore, en de tools leveren alleen matches met een hoge betrouwbaarheid in plaats van de lijst op te vullen — een assistent die de resultaten leest, kan een duidelijke identificatie onderscheiden van onzekerheid. Resultaten worden teruggegeven in de taal waarin we vragen: de language parameter accepteert alle talen van de interface van de site, en links verwijzen naar pagina's in die taal.
3. De offerte-tool verdient een nadere blik
De prijs is het punt waar de meeste "AI ontmoet winkelen"-integraties stilletjes de fout in gaan, dus het is de moeite waard om precies te zeggen wat deze wel doet. De offerte wordt berekend door dezelfde code die de prijzen op de koop-pagina zelf bepaalt, en op dezelfde manier afgerond — het bedrag dat de assistent voorleest, is het bedrag dat we op de website zouden zien, niet een schatting ervan. Drie verdere eigenschappen van de tool verdienen aandacht:
- Het weigert te gokken met geld. Als we vragen naar een valuta waarvan de wisselkoers niet beschikbaar is, geeft de tool dit aan en stopt het proces. Het vervangt nooit stilletjes Amerikaanse dollars in de hoop dat we het niet merken.
- Het vertelt ons wat wel en niet te koop is. Niet elk werk wordt in elke vorm aangeboden. Vraag om een handgeschilderd olieverfwerk van een werk dat alleen als print beschikbaar is, en het antwoord benoemt het probleem — en vermeldt de print, indien die optie openstaat.
- Het houdt de afmetingen eerlijk. Elke dimensie moet tussen de 25 en 250 cm liggen (ongeveer 10 tot 98 inch) — het bereik dat een atelier daadwerkelijk kan produceren — en de tool zet inches voor ons om in plaats van te vertrouwen op iemands mentale rekenkracht.
Zo wordt een gesprek als dit routine: "Zoek Gustave Caillebotte's Parijse straatscène in de regen, geef me vervolgens een offerte voor een handgeschilderd olieverfwerk van 100 × 70 cm in euro's, en hetzelfde formaat als een print, en vertel me het verschil." De assistent voert één zoekopdracht uit en twee offerte-aanvragen, en de vergelijking die wordt teruggegeven is een berekening op basis van echte prijzen — dezelfde vergelijking die onze gids over giclée prints versus handgeschilderde olieverfmeesterwerken handmatig doorloopt.
4. Een assistent verbinden, in de praktijk
De server spreekt stateless MCP over gewone HTTPS — JSON-RPC in een POST-body, niets exotischers — wat betekent dat twee doelgroepen het kunnen gebruiken.
Met een MCP-client
Elke MCP-geschikte client maakt verbinding met enkel de endpoint URL. In Claude betekent dit het toevoegen van een custom connector die wijst naar https://direct.Mus3ums.com/mcp/. In Claude Code, één commando:
claude mcp add --transport http Mus3ums https://direct.Mus3ums.com/mcp/Vanaf dat moment verschijnen de zeven tools in het repertoire van de assistent en bepaalt deze, vraag voor vraag, wanneer deze gebruikt moeten worden — geen verdere configuratie nodig, en voor de publieke tools zijn er geen inloggegevens vereist.
Als een gewone API
Ontwikkelaars die de catalogus willen gebruiken zonder een MCP-client, kunnen hetzelfde endpoint rechtstreeks aanroepen. Eén curl-commando doorzoekt de collectie:
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"}
}
}'Het antwoord is gestructureerde JSON — catalogusnummers, titels, kunstenaars, absolute URL's, scores — klaar voor wat we ook aan het bouwen zijn.
De persoonlijke token, uitsluitend voor bestellingen
Om een assistent onze bestellingen te laten inzien, loggen we in op de website, gaan naar Profiel → MCP / API (/profile/mcp/), en kopiëren de getoonde persoonlijke token om deze als een Authorization header te verzenden. Het ontwerp is doelbewust beperkt: de token identificeert één account, de orders-tool antwoordt alleen voor dat specifieke account, en de zoek- en offerte-tools negeren de token volledig omdat er niets privégegevens beschermd hoeven te worden. Wanneer er wordt gevraagd naar een ordernummer dat niet van ons is, geeft de server hetzelfde antwoord als bij een order die niet bestaat — de server weigert zelfs dat kleine beetje informatie over de aankopen van anderen te bevestigen.
5. Waarom een cataloguswebsite überhaupt een API publiceert
Omdat de vragen al verplaatst zijn. Een groeiend deel van de mensen die een aankoop plannen, begint tegenwoordig niet met een zoekmachine maar met een assistent — "wat zou een kopie van de Mona Lisa van museumkwaliteit me kosten?" wordt in een chatvenster getypt, en de assistent antwoordt op basis van de bronnen die hij daadwerkelijk kan verifiëren. Een site die zijn catalogus en prijzen publiceert in een vorm die assistenten kunnen opvragen, doet simpelweg wat musea deden toen ze hun eerste openbare catalogi drukten: de bezoeker ontmoeten waar de bezoeker zich al bevindt, en de voorkeur geven aan exacte antwoorden boven folklore. Het alternatief — assistenten die prijzen en beschikbaarheid gokken op basis van verouderde trainingsgegevens — dient niemand, en al helemaal niet de persoon die bereid is echt geld uit te geven aan het antwoord. We hebben elders geschreven over hoe reproductiemediums en prijsstelling werkelijk werken en wat kwaliteit en waarde betekenen in een reproductie; de MCP-server biedt precies diezelfde antwoorden, maar dan machineleesbaar gemaakt.
Drie vragen die het waard zijn om te stellen voordat u verbinding maakt
Hebben we een account of een API-sleutel nodig om de Mus3ums MCP-server te gebruiken?
Voor het grootste deel niet. De vijf zoektools en de quotation-tool zijn openbaar en hebben geen token nodig, omdat ze alleen datgene tonen wat de websites al aan elke bezoeker publiceren. Een persoonlijk token is vereist voor precies één tool — diegene die onze eigen bestellingen retourneert, met een naam, telefoonnummer en verzendadres in het antwoord. Dat token is verkrijgbaar via de /profile/mcp/ pagina na het inloggen, en kan uitsluitend de bestellingen van het account ontgrendelen waar het bij hoort.
Is de prijs die de assistent noemt de werkelijke prijs?
Ja. De offerte wordt gegenereerd door dezelfde prijsberekeningscode als de kooppagina en op identieke wijze afgerond, zodat het getal dat de assistent uitspreekt overeenkomt met het getal op de website. Het omvat prints en handgeschilderde olieverfschilderijen van 25 tot 250 cm per zijde, in elke ondersteunde valuta — en wanneer de wisselkoers van een valuta niet beschikbaar is, geeft de tool dit aan in plaats van stilletjes terug te vallen op dollars.
Welke assistenten kunnen verbinding maken?
Elke client die MCP over HTTP ondersteunt: Claude via aangepaste connectoren, Claude Code met een enkel claude mcp add commando, en het groeiende veld van MCP-geschikte desktop- en developer-tools. En omdat de transmissie gewone JSON-RPC over HTTPS POST is, is er strikt genomen geen MCP-client vereist — een curl-commando of enkele regels in een willekeurige programmeertaal bereiken dezelfde zeven tools.
Gerelateerd op Mus3ums.com
- Wat de offerte-tool prijst: giclée prints versus handgeschilderde oliemeesterwerken, een eerlijke vergelijking.
- Hoe reproductieprijzen feitelijk worden opgebouwd uit medium en keuzes voor opdrachten: het ontcijferen van kunstreproductie — media, prijsstelling en opdrachten.
- De zoektools in menselijke vorm: blader door de kunstenaarscatalogus op dezelfde manier als de API dat doet.
- Al ingelogd? De token- en live tool-lijst vindt u op de MCP / API-pagina van uw profiel.
