Ce este MCP
Model Context Protocol (MCP) este un standard deschis care permite unui asistent AI să folosească servicii externe într-un mod uniform. Un serviciu publică o listă de instrumente. Fiecare instrument are un nume, o descriere, intrările pe care le ia și forma a ceea ce returnează. Asistentul citește lista, alege un instrument când conversația o cere și primește înapoi un răspuns structurat.
Desenul arată forma serverului nostru MCP.
- Asistentul citește lista de instrumente și alege unul când conversația o cere.
- Instrumentele numai pentru citire: capacitățile de fabricație, proiectarea, raportul de verificare, ofertele, comenzile și mesajele.
- Instrumentele care scriu: încărcări, oferte și mesaje.
- Instrumentul care duce la o comandă poate numai să o pregătească. Dumneavoastră o aprobați pe site.
- Site-ul răspunde într-o formă structurată, cu numere exacte.
Pentru dumneavoastră efectul este simplu. În loc să ghicească cum funcționează un site, asistentul află de la site exact ce poate face. Apoi asistentul poate face lucruri ca „verifică acest fișier de placă” sau „arată-mi un preț” într-un mod exact și repetabil.
De ce o fabrică oferă instrumente în loc de un formular web
Un formular web este făcut pentru ochii omenești. Un asistent care îl folosește trebuie să se uite la capturi de ecran sau să răzuie pagina și se strică atunci când pagina se schimbă.
O listă de instrumente este făcută pentru software. Spune ce are nevoie fiecare pas și ce revine. Pentru o comandă de plăci acest lucru contează, pentru că pașii sunt preciși: încărcarea fișierelor, citirea raportului de verificare, schimbarea unei opțiuni, citirea prețului, confirmarea. Fiecare pas are numere care trebuie să fie exacte, de exemplu o dimensiune a găurii în micrometri sau un preț într-o monedă. Răspunsurile structurate le păstrează exacte.
Instrumentele fac și siguranța mai ușoară. Un instrument poate spune clar că cheltuiește bani, iar un asistent poate fi construit să vă întrebe înainte să-l folosească. Un formular web nu dă un astfel de semnal.
Ce există astăzi
Serverul MCP. Adresa lui este https://uliketechnology.com/api/mcp. Fără autentificare un asistent poate citi ce fabricăm, poate deschide o sesiune de vizitator, poate trimite o placă la verificarea fișierelor și poate obține prețuri, în cadrul unei alocații zilnice. Ca un asistent să lucreze cu contul dumneavoastră, conectați https://uliketechnology.com/api/mcp/account: acesta îi cere asistentului să se autentifice ca dumneavoastră. Asistentul poate apoi citi și comenzile dumneavoastră, poate pregăti o comandă pentru aprobarea dumneavoastră și poate citi și scrie în conversațiile dumneavoastră cu fabrica.
Două moduri de conectare. Un asistent se autentifică ca dumneavoastră: deschide o pagină a acestui site în browserul dumneavoastră, care arată numele lui, adresa lui și ce solicită să facă, iar nimic nu este permis până când nu apăsați Permiteți. Sau creați o cheie API în contul dumneavoastră, alegeți ce poate face și dați cheia programului dumneavoastră. Ambele acționează ca dumneavoastră, în limitele permisiunilor alese de dumneavoastră, iar dumneavoastră puteți încheia accesul oricând. Pagina Pentru dezvoltatori și asistenți are adresele și pașii.
API-ul REST. Este același serviciu fără MCP: încărcare, verificarea fișierelor, ofertă și comandă. Articolul Pornire rapidă API arată apelurile.
Modelul de siguranță
Se sprijină pe patru reguli.
- Un agent lucrează întotdeauna pentru o persoană autentificată. Agenții nu au conturi proprii. Dumneavoastră vă autentificați cu contul propriu și îi permiteți agentului să acționeze pentru dumneavoastră cu permisiuni numite. Puteți retrage permisiunea.
- Agentul poate pregăti o comandă. Nu o poate plasa și nu poate plăti. Când un asistent care s-a autentificat pentru dumneavoastră cere plasarea unei comenzi, răspunsul este „este nevoie de aprobare” și un link spre site-ul nostru. Nimic nu este comandat încă. Deschideți linkul, vă autentificați, vedeți comanda și totalul exacte și aprobați sau refuzați. Linkul funcționează o dată, este legat de contul dumneavoastră, expiră după 24 de ore și nu mai funcționează dacă se schimbă oferta sau totalul. Plata se face prin transfer bancar, pe care îl faceți dumneavoastră.
- Un inginer confirmă fiecare comandă. Oricine a plasat-o, un inginer verifică fișierele și comanda înainte să înceapă producția.
- Fiecare instrument spune ce fel este. Un instrument este marcat ca numai pentru citire, ca unul care scrie o înregistrare sau ca unul care angajează. Cele două care angajează, plasarea și anularea unei comenzi, iau o cheie care face ca un apel repetat să aibă loc o dată.
- Dumneavoastră vă autentificați cu contul propriu și permiteți agentului să acționeze pentru dumneavoastră.
- Agentul pregătește o comandă. Nu o poate plasa și nu poate plăti.
- Site-ul arată comanda și totalul exacte în spatele unui link.
- Un inginer confirmă fiecare comandă înainte de producție.
- Calea chihlimbar este linkul de aprobare. Agentul vi-l transmite dumneavoastră, iar acesta funcționează numai pentru dumneavoastră, după autentificare.
În mod deliberat nu există niciun instrument care să plătească, care să adauge sau să schimbe o adresă ori care să creeze o cheie API. Acestea se fac numai în browser, acolo unde sunteți dumneavoastră.
O cheie API funcționează la fel. Este propriul dumneavoastră program care acționează ca dumneavoastră, iar o comandă pe care o trimite este pregătită, nu plasată: răspunsul este linkul de aprobare, iar comanda este plasată după ce o aprobați dumneavoastră pe site.
Tratăm și textul din fișierele dumneavoastră ca date. Numele de fișiere, textul din fișierele de proiectare și descrierile BOM revin în câmpuri cu lungime limitată, niciodată ca instrucțiuni. Descrierea fiecărui instrument numește câmpurile care poartă un astfel de text și îi spune asistentului să nu urmeze nimic scris acolo. Textul dintr-un fișier nu poate schimba ce are voie agentul să facă.
Instrumentele
Acestea sunt instrumentele pe care le oferă serverul. Un asistent le vede numai pe cele pe care le poate folosi: fără autentificare primele cinci grupuri, iar după ce vă conectați contul, pe cele pe care le acoperă permisiunile dumneavoastră.
| Grup | Instrumente |
|---|---|
| Citirea a ceea ce putem fabrica | get_capabilities |
| Lucrul fără cont | start_guest_session |
| Încărcarea și citirea unei plăci | create_upload_session, complete_upload, list_designs, get_design, set_layer_mapping |
| Verificare | validate_design, get_validation_report |
| Ofertă | preview_quote, create_pcb_quote, list_quotes, get_quote, update_quote_options |
| Adrese | list_addresses |
| Comandă | place_order, list_orders, get_order, cancel_order, answer_engineering_query |
| Mesaje cu fabrica | list_threads, get_thread, create_thread, post_thread_message, mark_thread_read, close_thread |
Instrumentul place_order răspunde cu linkul de aprobare descris mai sus. Instrumentul cancel_order funcționează numai înainte ca o comandă să fie eliberată pentru producție. La o întrebare pe care fabrica a marcat-o ca personală nu se poate răspunde printr-un asistent: instrumentul refuză și îi spune asistentului să vă arate întrebarea.
Serverul conține și ghidul nostru de proiectare pentru asistenți ca resursă, ulike://guide/pcb-design, și un prompt, check-and-quote-a-board, care conduce un asistent prin încărcare, verificare și ofertă.
Cum arată o comandă printr-un asistent
Să presupunem că cereți unui asistent să comande douăzeci de plăci. Citește capacitățile de fabricație, trimite fișierul dumneavoastră zip la adresa de încărcare, citește raportul de verificare și vă spune ce a găsit. Creează o ofertă și vă arată prețul. Acolo unde un preț are nevoie de un inginer, oferta poate fi comandată după ce inginerul a confirmat-o. Asistentul pregătește apoi comanda și vă dă un link. Îl deschideți, vă autentificați, verificați totalul și adresa și aprobați. Pagina comenzii arată datele bancare și referința pentru transferul dumneavoastră. Un inginer confirmă comanda, iar producția începe când plata dumneavoastră a sosit.
În niciun moment asistentul nu deține date de plată. În niciun moment un asistent care s-a autentificat pentru dumneavoastră nu poate plasa o comandă fără aprobarea dumneavoastră. Dacă răspunsul lui pare greșit, vedeți acest lucru pe pagina de aprobare înainte să fie comandat ceva.
Ce nu schimbă MCP
MCP este o modalitate de a ajunge la același serviciu. Nu adaugă puteri noi. Un agent care folosește serverul MCP întâlnește aceeași verificare a fișierelor, aceleași limite, aceleași prețuri și aceeași verificare tehnică a unui inginer ca o persoană care folosește site-ul. Permisiunile pe care i le dați unui agent nu sunt niciodată mai largi decât ale dumneavoastră. Un instrument poate face numai ceea ce îi permite permisiunea lui, iar dumneavoastră puteți retrage permisiunea oricând.
Ce puteți face acum
Adăugați adresa serverului MCP la un asistent care acceptă MCP sau creați o cheie API pentru programul dumneavoastră. Pagina Pentru dezvoltatori și asistenți arată ambele. Dacă lucrați cu un asistent, dați-i Ghidul de proiectare PCB pentru asistenți AI. Dacă vreți să știți cum lucrați cu un asistent în general, citiți Comandarea plăcilor cu un asistent AI.