Wat MCP is
Het Model Context Protocol (MCP) is een open norm die een AI-assistent externe diensten op uniforme wijze laat gebruiken. Een dienst publiceert een lijst van tools. Elke tool heeft een naam, een beschrijving, de invoer die hij neemt en de vorm van wat hij teruggeeft. De assistent leest de lijst, kiest een tool als het gesprek erom vraagt en krijgt een gestructureerd antwoord terug.
De tekening toont de vorm van onze MCP-server.
- De assistent leest de lijst tools en kiest er een als het gesprek erom vraagt.
- Alleen-lezen tools: productiemogelijkheden, het ontwerp, het controlerapport, offertes, bestellingen en berichten.
- Tools die schrijven: uploads, offertes en berichten.
- De tool die naar een bestelling leidt, kan er alleen een voorbereiden. U keurt deze op de site goed.
- De site antwoordt in een gestructureerde vorm, met exacte getallen.
Voor u is het effect eenvoudig. In plaats van dat de assistent raadt hoe een website werkt, vertelt de website de assistent precies wat hij kan doen. De assistent kan daarna dingen doen zoals „controleer dit printbestand“ of „toon mij een prijs“ op een exacte en herhaalbare manier.
Waarom een fabriek tools aanbiedt in plaats van een webformulier
Een webformulier is gemaakt voor menselijke ogen. Een assistent die er een gebruikt, moet naar screenshots kijken of de pagina schrapen en het breekt als de pagina verandert.
Een toollijst is gemaakt voor software. Deze zegt wat elke stap nodig heeft en wat terugkomt. Voor een printbestelling telt dat, omdat de stappen precies zijn: bestanden uploaden, controlerapport lezen, een optie wijzigen, de prijs lezen, bevestigen. Elke stap heeft getallen die exact moeten zijn, bijvoorbeeld een gatgrootte in micrometers of een prijs in een valuta. Gestructureerde antwoorden houden ze exact.
Tools maken veiligheid ook gemakkelijker. Een tool kan ronduit zeggen dat hij geld uitgeeft en een assistent kan worden gebouwd om u te vragen voordat hij zo'n tool gebruikt. Een webformulier geeft geen dergelijk signaal.
Wat vandaag bestaat
De MCP-server. Het adres is https://uliketechnology.com/api/mcp. Zonder inloggen kan een assistent lezen wat wij maken, een gastsessie openen, een print naar de bestandscontrole sturen en prijzen krijgen, binnen een dagbudget. Om een assistent met uw account te laten werken, verbindt u https://uliketechnology.com/api/mcp/account: dit vraagt de assistent om als u in te loggen. De assistent kan daarna ook uw bestellingen lezen, een bestelling voorbereiden voor uw goedkeuring en uw berichten met de fabriek lezen en schrijven.
Twee manieren om verbinding te maken. Een assistent logt als u in: hij opent een pagina van deze site in uw browser die zijn naam en zijn adres toont en aangeeft wat hij vraagt te doen, en niets wordt toegestaan totdat u op Toestaan drukt. Of u maakt een API-sleutel in uw account, kiest wat deze mag doen en geeft de sleutel aan uw eigen programma. Beide handelen als u, binnen de machtigingen die u koos, en u kunt de toegang op elk moment beëindigen. Voor ontwikkelaars en assistenten bevat de adressen en de stappen.
De REST-API. Dit is dezelfde dienst zonder MCP: uploaden, bestandscontrole, offerte en bestelling. De API-snelstart toont de aanroepen.
Het veiligheidsmodel
Het rust op vier regels.
- Een agent werkt altijd voor een ingelogde persoon. Agenten hebben geen eigen accounts. U logt in met uw eigen account en u staat de agent toe voor u te handelen met benoemde machtigingen. U kunt de machtiging intrekken.
- De agent kan een bestelling voorbereiden. Hij kan deze niet plaatsen en hij kan niet betalen. Als een assistent die voor u inlogde vraagt een bestelling te plaatsen, is het antwoord „goedkeuring nodig“ en een link naar onze site. Er is nog niets besteld. U opent de link, logt in, ziet de exacte bestelling en het totaalbedrag en keurt goed of wijst af. De link werkt eenmaal, is aan uw account gebonden, verloopt na 24 uur en stopt met werken als de offerte of het totaalbedrag verandert. Betaling gebeurt per bankoverschrijving, die u zelf doet.
- Een ingenieur bevestigt elke bestelling. Wie deze ook plaatste, een ingenieur controleert de bestanden en de bestelling voordat de productie begint.
- Elke tool zegt wat voor soort hij is. Een tool is gemarkeerd als alleen-lezen, als een die een record schrijft, of als een die bindend is. De twee bindende, het plaatsen en het annuleren van een bestelling, nemen een sleutel die een herhaalde aanroep maar eenmaal laat gebeuren.
- U logt in met uw eigen account en staat de agent toe voor u te handelen.
- De agent bereidt een bestelling voor. Hij kan deze niet plaatsen of betalen.
- De site toont de exacte bestelling en het totaalbedrag achter een link.
- Een ingenieur bevestigt elke bestelling voor productie.
- Het amberkleurige pad is de goedkeuringslink. De agent geeft deze aan u door en deze werkt alleen voor u, ingelogd.
Er is opzettelijk geen tool die betaalt, die een adres toevoegt of wijzigt, of die een API-sleutel maakt. Deze worden alleen in de browser gedaan, waar u bent.
Een API-sleutel werkt op dezelfde manier. Het is uw eigen programma dat als u handelt, en een bestelling die hij stuurt wordt voorbereid, niet geplaatst: het antwoord is de goedkeuringslink, en de bestelling wordt geplaatst nadat u deze op de site goedkeurt.
Wij behandelen tekst uit uw bestanden ook als data. Bestandsnamen, tekst in ontwerpbestanden en beschrijvingen in stuklijsten komen terug in velden van beperkte lengte, nooit als instructies. De beschrijving van elke tool noemt de velden die zulke tekst dragen en vertelt de assistent niets te volgen wat daar geschreven staat. Tekst in een bestand kan niet veranderen wat de agent mag doen.
De tools
Dit zijn de tools die de server aanbiedt. Een assistent ziet alleen die welke hij mag gebruiken: zonder inloggen de eerste vijf groepen en, nadat u uw account verbond, die welke uw machtigingen dekken.
| Groep | Tools |
|---|---|
| Lezen wat wij kunnen maken | get_capabilities |
| Zonder account werken | start_guest_session |
| Een print uploaden en lezen | create_upload_session, complete_upload, list_designs, get_design, set_layer_mapping |
| Controleren | validate_design, get_validation_report |
| Offerte | preview_quote, create_pcb_quote, list_quotes, get_quote, update_quote_options |
| Adressen | list_addresses |
| Bestelling | place_order, list_orders, get_order, cancel_order, answer_engineering_query |
| Berichten met de fabriek | list_threads, get_thread, create_thread, post_thread_message, mark_thread_read, close_thread |
place_order geeft de hierboven beschreven goedkeuringslink terug. cancel_order werkt alleen voordat een bestelling voor productie wordt vrijgegeven. Een vraag die de fabriek als persoonlijk markeerde, kan niet via een assistent worden beantwoord: de tool weigert en vertelt de assistent u de vraag te tonen.
De server draagt ook onze ontwerpgids voor assistenten als resource, ulike://guide/pcb-design, en een prompt, check-and-quote-a-board, die een assistent door uploaden, controleren en offerte leidt.
Hoe een bestelling via een assistent eruitziet
Stel dat u een assistent vraagt twintig printen te bestellen. Hij leest de productiemogelijkheden, stuurt uw zip-archief naar het uploadadres, leest het controlerapport en vertelt u wat hij vond. Hij maakt een offerte en toont u de prijs. Waar een prijs een ingenieur nodig heeft, kan de offerte worden besteld nadat de ingenieur deze bevestigde. De assistent bereidt daarna de bestelling voor en geeft u een link. U opent deze, logt in, controleert het totaalbedrag en het adres en keurt goed. De bestelpagina toont de bankgegevens en de referentie voor uw overschrijving. Een ingenieur bevestigt de bestelling en de productie begint wanneer uw betaling is aangekomen.
Op geen moment houdt de assistent uw betaalgegevens vast. Op geen moment kan een assistent die voor u inlogde een bestelling plaatsen zonder uw goedkeuring. Als zijn antwoord verkeerd lijkt, ziet u het op de goedkeuringspagina voordat er iets wordt besteld.
Wat MCP niet verandert
MCP is een manier om dezelfde dienst te bereiken. Het voegt geen nieuwe bevoegdheden toe. Een agent die de MCP-server gebruikt, ontmoet dezelfde bestandscontrole, dezelfde grenswaarden, dezelfde prijzen en dezelfde technische controle als een persoon die de website gebruikt. De machtigingen die u een agent geeft, zijn nooit breder dan uw eigen. Een tool kan alleen doen wat zijn machtiging toelaat en u kunt de machtiging op elk moment verwijderen.
Wat u nu kunt doen
Voeg het adres van de MCP-server toe aan een assistent die MCP ondersteunt, of maak een API-sleutel voor uw eigen programma. Voor ontwikkelaars en assistenten toont beide. Als u met een assistent werkt, geef hem onze PCB-ontwerpgids voor AI-assistenten. Als u wilt weten hoe u in het algemeen met een assistent werkt, lees Printen bestellen met een AI-assistent.