Czym jest MCP
Model Context Protocol (MCP) to otwarty standard, który pozwala asystentowi AI korzystać z usług zewnętrznych w jednolity sposób. Usługa publikuje listę narzędzi. Każde narzędzie ma nazwę, opis, dane wejściowe, które przyjmuje, i kształt tego, co zwraca. Asystent czyta listę, wybiera narzędzie, gdy rozmowa tego wymaga, i otrzymuje w odpowiedzi dane strukturalne.
Rysunek pokazuje kształt naszego serwera MCP.
- Asystent czyta listę narzędzi i wybiera jedno, gdy rozmowa tego wymaga.
- Narzędzia tylko do odczytu: możliwości produkcyjne, projekt, raport weryfikacji, wyceny, zamówienia i wiadomości.
- Narzędzia, które zapisują: przesyłanie, wyceny i wiadomości.
- Narzędzie, które prowadzi do zamówienia, może je tylko przygotować. Pan/Pani zatwierdza je na stronie.
- Strona odpowiada w formie strukturalnej, z dokładnymi liczbami.
Dla Pana/Pani efekt jest prosty. Zamiast zgadywać, jak działa strona internetowa, asystent dowiaduje się od strony dokładnie, co może zrobić. Asystent może wtedy robić takie rzeczy jak „sprawdź ten plik płytki” albo „pokaż cenę” w sposób dokładny i powtarzalny.
Dlaczego fabryka oferuje narzędzia zamiast formularza internetowego
Formularz internetowy jest zrobiony dla ludzkich oczu. Asystent, który go używa, musi patrzeć na zrzuty ekranu albo odczytywać stronę i psuje się, gdy strona się zmienia.
Lista narzędzi jest zrobiona dla oprogramowania. Mówi, czego potrzebuje każdy krok i co wraca. Przy zamówieniu płytki ma to znaczenie, ponieważ kroki są precyzyjne: przesłanie plików, przeczytanie raportu weryfikacji, zmiana opcji, przeczytanie ceny, potwierdzenie. Każdy krok ma liczby, które muszą być dokładne, na przykład rozmiar otworu w mikrometrach albo cenę w walucie. Odpowiedzi strukturalne utrzymują je w dokładności.
Narzędzia ułatwiają też bezpieczeństwo. Narzędzie może wprost powiedzieć, że wydaje pieniądze, a asystent może być zbudowany tak, aby zapytać Pana/Panią przed jego użyciem. Formularz internetowy nie daje takiego sygnału.
Co istnieje dziś
Serwer MCP. Jego adres to https://uliketechnology.com/api/mcp. Bez logowania asystent może odczytać, co wykonujemy, otworzyć sesję gościa, wysłać płytkę do weryfikacji plików i uzyskać ceny, w ramach dziennego limitu. Aby asystent mógł pracować z Pana/Pani kontem, proszę połączyć https://uliketechnology.com/api/mcp/account: adres ten prosi asystenta o zalogowanie się jako Pan/Pani. Asystent może wtedy także odczytywać Pana/Pani zamówienia, przygotować zamówienie do Pana/Pani zatwierdzenia oraz czytać i pisać w Pana/Pani rozmowach z zakładem produkcyjnym.
Dwa sposoby połączenia. Asystent loguje się jako Pan/Pani: otwiera stronę tej witryny w Pana/Pani przeglądarce, która pokazuje jego nazwę, jego adres i to, o co prosi, a niczego nie zezwala się, dopóki Pan/Pani nie naciśnie przycisku Zezwól. Albo Pan/Pani tworzy klucz API na swoim koncie, wybiera, co może robić, i przekazuje klucz własnemu programowi. Oba działają jako Pan/Pani, w granicach uprawnień, które Pan/Pani wybrał(a), a dostęp można zakończyć w każdej chwili. Strona Dla programistów i asystentów zawiera adresy i kroki.
REST API. Jest to ta sama usługa bez MCP: przesyłanie, weryfikacja plików, wycena i zamówienie. Artykuł Szybki start API pokazuje wywołania.
Model bezpieczeństwa
Opiera się na czterech zasadach.
- Agent zawsze pracuje dla zalogowanej osoby. Agenci nie mają własnych kont. Pan/Pani loguje się na własne konto i pozwala agentowi działać w Pana/Pani imieniu z nazwanymi uprawnieniami. Uprawnienie można cofnąć.
- Agent może przygotować zamówienie. Nie może go złożyć ani zapłacić. Gdy asystent, który zalogował się dla Pana/Pani, prosi o złożenie zamówienia, odpowiedzią jest „wymagane zatwierdzenie” i link do naszej strony. Nic nie jest jeszcze zamówione. Pan/Pani otwiera link, loguje się, widzi dokładne zamówienie i sumę oraz zatwierdza albo odrzuca. Link działa raz, jest związany z Pana/Pani kontem, wygasa po 24 godzinach i przestaje działać, jeśli zmieni się wycena albo suma. Płatność następuje przelewem bankowym, który Pan/Pani wykonuje sam(a).
- Inżynier potwierdza każde zamówienie. Niezależnie od tego, kto je złożył, inżynier sprawdza pliki i zamówienie przed rozpoczęciem produkcji.
- Każde narzędzie mówi, jakiego jest rodzaju. Narzędzie jest oznaczone jako tylko do odczytu, jako zapisujące rekord albo jako zobowiązujące. Dwa narzędzia, które zobowiązują, złożenie i anulowanie zamówienia, przyjmują klucz, który sprawia, że powtórzone wywołanie następuje raz.
- Pan/Pani loguje się na własne konto i pozwala agentowi działać w Pana/Pani imieniu.
- Agent przygotowuje zamówienie. Nie może go złożyć ani zapłacić.
- Strona pokazuje dokładne zamówienie i sumę za linkiem.
- Inżynier potwierdza każde zamówienie przed produkcją.
- Bursztynowa ścieżka to link zatwierdzający. Agent przekazuje go Panu/Pani, a działa on tylko dla Pana/Pani, po zalogowaniu.
Celowo nie ma narzędzia, które płaci, które dodaje albo zmienia adres, ani które tworzy klucz API. Czynności te wykonuje się tylko w przeglądarce, tam gdzie jest Pan/Pani.
Klucz API działa tak samo. Jest to Pana/Pani własny program działający jako Pan/Pani, a zamówienie, które on wysyła, jest przygotowywane, a nie składane: odpowiedzią jest link zatwierdzający, a zamówienie jest składane dopiero po tym, jak Pan/Pani zatwierdzi je na stronie.
Tekst z Pana/Pani plików traktujemy też jako dane. Nazwy plików, tekst wewnątrz plików projektowych i opisy BOM wracają w polach o ograniczonej długości, nigdy jako instrukcje. Opis każdego narzędzia nazywa pola, które niosą taki tekst, i mówi asystentowi, aby nie stosował się do niczego, co tam napisano. Tekst w pliku nie może zmienić tego, co agent ma prawo robić.
Narzędzia
Są to narzędzia, które oferuje serwer. Asystent widzi tylko te, z których może korzystać: bez logowania pierwszych pięć grup, a po połączeniu Pana/Pani konta te, które obejmują Pana/Pani uprawnienia.
| Grupa | Narzędzia |
|---|---|
| Odczyt tego, co możemy wykonać | get_capabilities |
| Praca bez konta | start_guest_session |
| Przesłanie i odczyt płytki | create_upload_session, complete_upload, list_designs, get_design, set_layer_mapping |
| Weryfikacja | validate_design, get_validation_report |
| Wycena | preview_quote, create_pcb_quote, list_quotes, get_quote, update_quote_options |
| Adresy | list_addresses |
| Zamówienie | place_order, list_orders, get_order, cancel_order, answer_engineering_query |
| Wiadomości z zakładem produkcyjnym | list_threads, get_thread, create_thread, post_thread_message, mark_thread_read, close_thread |
Narzędzie place_order odpowiada linkiem zatwierdzającym opisanym powyżej. Narzędzie cancel_order działa tylko przed przekazaniem zamówienia do produkcji. Na pytanie, które zakład produkcyjny oznaczył jako osobiste, nie można odpowiedzieć przez asystenta: narzędzie odmawia i mówi asystentowi, aby pokazał Panu/Pani pytanie.
Serwer zawiera też nasz poradnik projektowania dla asystentów jako zasób, ulike://guide/pcb-design, oraz prompt, check-and-quote-a-board, który prowadzi asystenta przez przesyłanie, weryfikację i wycenę.
Jak wygląda zamówienie przez asystenta
Załóżmy, że prosi Pan/Pani asystenta o zamówienie dwudziestu płytek. Czyta on możliwości produkcyjne, wysyła Pana/Pani plik zip na adres przesyłania, czyta raport weryfikacji i mówi Panu/Pani, co znalazł. Tworzy wycenę i pokazuje Panu/Pani cenę. Tam, gdzie cena wymaga inżyniera, wycenę można zamówić po tym, jak inżynier ją potwierdzi. Następnie asystent przygotowuje zamówienie i podaje Panu/Pani link. Pan/Pani otwiera go, loguje się, sprawdza sumę i adres oraz zatwierdza. Strona zamówienia pokazuje dane bankowe i sygnaturę Pana/Pani przelewu. Inżynier potwierdza zamówienie, a produkcja zaczyna się, gdy wpłynie Pana/Pani płatność.
W żadnym momencie asystent nie przechowuje danych płatniczych. W żadnym momencie asystent, który zalogował się dla Pana/Pani, nie może złożyć zamówienia bez Pana/Pani zatwierdzenia. Jeśli jego odpowiedź wygląda źle, widzi to Pan/Pani na stronie zatwierdzania, zanim cokolwiek zostanie zamówione.
Czego MCP nie zmienia
MCP to sposób dotarcia do tej samej usługi. Nie dodaje nowych uprawnień. Agent korzystający z serwera MCP spotyka tę samą weryfikację plików, te same limity, te same ceny i tę samą kontrolę inżynierską co osoba korzystająca ze strony internetowej. Uprawnienia, które Pan/Pani daje agentowi, nie są nigdy szersze niż Pana/Pani własne. Narzędzie może zrobić tylko to, na co pozwala jego uprawnienie, a uprawnienie można usunąć w każdej chwili.
Co może Pan/Pani zrobić teraz
Proszę dodać adres serwera MCP do asystenta, który obsługuje MCP, albo utworzyć klucz API dla własnego programu. Strona Dla programistów i asystentów pokazuje oba sposoby. Jeśli Pan/Pani pracuje z asystentem, proszę dać mu nasz Poradnik projektowania PCB dla asystentów AI. Jeśli Pan/Pani chce wiedzieć, jak pracować z asystentem w ogólności, proszę przeczytać artykuł Zamawianie płytek z asystentem AI.