Co je MCP
Model Context Protocol (MCP) je otevřená norma, která AI asistentovi umožňuje používat vnější služby jednotným způsobem. Služba publikuje seznam nástrojů. Každý nástroj má název, popis, vstupy, které bere, a tvar toho, co vrací. Asistent seznam přečte, vybere nástroj, když o něj konverzace žádá, a dostane strukturovanou odpověď zpět.
Výkres ukazuje tvar našeho serveru MCP.
- Asistent čte seznam nástrojů a vybere jeden, když o něj konverzace žádá.
- Nástroje jen pro čtení: výrobní možnosti, návrh, zpráva o kontrole, nabídky, objednávky a zprávy.
- Nástroje, které zapisují: nahrání, nabídky a zprávy.
- Nástroj, který vede k objednávce, může jen jednu připravit. Schválíte ji na webu.
- Web odpovídá ve strukturovaném tvaru, s přesnými čísly.
Pro Vás je účinek jednoduchý. Místo aby asistent hádal, jak web funguje, web asistentovi přesně řekne, co může dělat. Asistent pak může dělat věci jako „zkontroluj tento soubor desky“ nebo „ukaž mi cenu“ způsobem, který je přesný a opakovatelný.
Proč továrna nabízí nástroje místo webového formuláře
Webový formulář je vytvořen pro lidské oči. Asistent, který jej používá, se musí dívat na snímky obrazovky nebo web stírat, a rozbije se, když se stránka změní.
Seznam nástrojů je vytvořen pro software. Říká, co každý krok potřebuje a co se vrací. Pro objednávku desky na tom záleží, protože kroky jsou přesné: nahrát soubory, přečíst zprávu o kontrole, změnit možnost, přečíst cenu, potvrdit. Každý krok má čísla, která musí být přesná, například velikost otvoru v mikrometrech nebo cenu v měně. Strukturované odpovědi je udržují přesné.
Nástroje také usnadňují bezpečnost. Nástroj může prostě říct, že utrácí peníze, a asistent může být postaven tak, aby se Vás zeptal, než takový nástroj použije. Webový formulář žádný takový signál nedává.
Co existuje dnes
Server MCP. Jeho adresa je https://uliketechnology.com/api/mcp. Bez přihlášení může asistent číst, co vyrábíme, otevřít hostovskou relaci, poslat desku ke kontrole souborů a získat ceny, v rámci denního přídělu. Aby asistent mohl pracovat s Vaším účtem, připojte https://uliketechnology.com/api/mcp/account: požádá asistenta, aby se přihlásil jako Vy. Asistent pak může také číst Vaše objednávky, připravit objednávku k Vašemu schválení a číst a psát Vaše zprávy s továrnou.
Dva způsoby připojení. Asistent se přihlásí jako Vy: otevře stránku tohoto webu ve Vašem prohlížeči, která ukazuje jeho název, jeho adresu a to, o co žádá, a nic není dovoleno, dokud nestisknete Povolit. Nebo vytvoříte klíč API ve svém účtu, vyberete, co smí dělat, a klíč dáte svému vlastnímu programu. Oba jednají jako Vy, v rámci oprávnění, která jste vybrali, a přístup můžete kdykoli ukončit. Pro vývojáře a asistenty obsahuje adresy a kroky.
REST API. Je to táž služba bez MCP: nahrání, kontrola souborů, nabídka a objednávka. Rychlý start API ukazuje volání.
Bezpečnostní model
Spočívá na čtyřech pravidlech.
- Agent vždy pracuje pro přihlášenou osobu. Agenti nemají vlastní účty. Přihlásíte se svým vlastním účtem a dovolíte agentovi jednat za Vás s pojmenovanými oprávněními. Oprávnění můžete vzít zpět.
- Agent může připravit objednávku. Nemůže ji zadat a nemůže platit. Když asistent, který se za Vás přihlásil, požádá o zadání objednávky, odpovědí je „je nutné schválení“ a odkaz na náš web. Zatím není nic objednáno. Odkaz otevřete, přihlásíte se, uvidíte přesnou objednávku a celkovou částku a schválíte nebo odmítnete. Odkaz funguje jednou, je vázán na Váš účet, vyprší po 24 hodinách a přestane fungovat, pokud se nabídka nebo celková částka změní. Platba je bankovním převodem, který provedete sami.
- Inženýr potvrdí každou objednávku. Ať ji zadal kdokoli, inženýr zkontroluje soubory a objednávku před zahájením výroby.
- Každý nástroj říká, jakého je druhu. Nástroj je označen jako jen pro čtení, jako ten, který zapisuje záznam, nebo jako ten, který závazně provádí. Dva závazné, zadání a zrušení objednávky, používají klíč, který zajistí, že opakované volání proběhne jen jednou.
- Vy se přihlásíte svým vlastním účtem a dovolíte agentovi jednat za Vás.
- Agent připraví objednávku. Nemůže ji zadat ani platit.
- Web ukáže přesnou objednávku a celkovou částku za odkazem.
- Inženýr potvrdí každou objednávku před výrobou.
- Jantarová cesta je schvalovací odkaz. Agent Vám jej předá a funguje jen pro Vás, když jste přihlášeni.
Záměrně neexistuje nástroj, který platí, který přidává nebo mění adresu, nebo který vytváří klíč API. Ty se provádějí jen v prohlížeči, kde jste Vy.
Klíč API funguje stejným způsobem. Je to Váš vlastní program jednající jako Vy a objednávka, kterou odešle, je připravena, nikoli zadána: odpovědí je schvalovací odkaz a objednávka je zadána poté, co ji na webu schválíte.
Text z Vašich souborů také bereme jako data. Názvy souborů, text uvnitř návrhových souborů a popisy v kusovnících se vracejí v polích omezené délky, nikdy jako pokyny. Popis každého nástroje jmenuje pole, která takový text nesou, a říká asistentovi, aby nic z toho, co je tam napsáno, nenásledoval. Text v souboru nemůže změnit, co agent smí dělat.
Nástroje
Toto jsou nástroje, které server nabízí. Asistent vidí jen ty, které smí použít: bez přihlášení prvních pět skupin a poté, co připojíte svůj účet, ty, které Vaše oprávnění pokrývají.
| Skupina | Nástroje |
|---|---|
| Čtení, co dokážeme vyrobit | get_capabilities |
| Práce bez účtu | start_guest_session |
| Nahrání a čtení desky | create_upload_session, complete_upload, list_designs, get_design, set_layer_mapping |
| Kontrola | validate_design, get_validation_report |
| Nabídka | preview_quote, create_pcb_quote, list_quotes, get_quote, update_quote_options |
| Adresy | list_addresses |
| Objednávka | place_order, list_orders, get_order, cancel_order, answer_engineering_query |
| Zprávy s továrnou | list_threads, get_thread, create_thread, post_thread_message, mark_thread_read, close_thread |
place_order vrací schvalovací odkaz popsaný výše. cancel_order funguje jen předtím, než je objednávka uvolněna do výroby. Otázku, kterou továrna označila jako osobní, nelze přes asistenta zodpovědět: nástroj odmítne a řekne asistentovi, aby Vám otázku ukázal.
Server také nese naši příručku návrhu pro asistenty jako zdroj, ulike://guide/pcb-design, a prompt, check-and-quote-a-board, který asistenta provede nahráním, kontrolou a nabídkou.
Jak vypadá objednávka přes asistenta
Řekněme, že požádáte asistenta, aby objednal dvacet desek. Přečte výrobní možnosti, pošle Váš zip archiv na adresu pro nahrání, přečte zprávu o kontrole a řekne Vám, co našel. Vytvoří nabídku a ukáže Vám cenu. Kde cena potřebuje inženýra, lze nabídku objednat poté, co ji inženýr potvrdil. Asistent poté připraví objednávku a dá Vám odkaz. Vy jej otevřete, přihlásíte se, zkontrolujete celkovou částku a adresu a schválíte. Stránka objednávky ukáže bankovní údaje a referenci pro Váš převod. Inženýr objednávku potvrdí a výroba začne, když Vaše platba dorazí.
V žádném bodě asistent nedrží Vaše platební údaje. V žádném bodě nemůže asistent, který se za Vás přihlásil, zadat objednávku bez Vašeho schválení. Pokud jeho odpověď vypadá špatně, uvidíte to na schvalovací stránce, než je cokoli objednáno.
Co MCP nemění
MCP je způsob, jak dosáhnout téže služby. Nepřidává nové pravomoci. Agent používající server MCP potká tutéž kontrolu souborů, tytéž limity, tytéž ceny a tutéž technickou kontrolu jako osoba používající web. Oprávnění, která agentovi dáte, nejsou nikdy širší než Vaše vlastní. Nástroj může dělat jen to, co jeho oprávnění dovoluje, a oprávnění můžete kdykoli odebrat.
Co můžete dělat nyní
Přidejte adresu serveru MCP k asistentovi, který MCP podporuje, nebo vytvořte klíč API pro svůj vlastní program. Pro vývojáře a asistenty ukazuje obojí. Pokud pracujete s asistentem, dejte mu naši Příručku návrhu DPS pro AI asistenty. Pokud chcete vědět, jak s asistentem pracovat obecně, čtěte Objednávání desek s AI asistentem.