SaaS dla agentów AI: interfejs WWW, API czy dostęp MCP?

SaaS to oprogramowanie oferowane jako usługa. Narzędzie do sprawdzania dokumentów może działać w przeglądarce, stanowić część ustalonej automatyzacji albo być wywoływane przez agenta AI. Agent wykorzystuje model językowy do wyboru funkcji potrzebnych w zadaniu. Każdy z tych sposobów dostępu powinien niezawodnie wykonywać tę samą pracę. Samo dodanie połączenia nie dowodzi popytu.

Interfejs wspiera kontrolę wzrokową

Interfejs WWW pokazuje razem dane wejściowe, podgląd i wyniki. Narzędzie do sprawdzania dokumentów może zaznaczać błędy przed zatwierdzeniem eksportu pliku. Jest to szczególnie przydatne przy sporadycznych zadaniach i decyzjach wymagających oceny kompetentnej osoby.

Czytelna lista zadań pozostaje przydatna po dodaniu automatycznego dostępu. Zadanie może oczekiwać, trwać, być ukończone albo zatrzymać się z powodu braku uprawnień. Taki opis ułatwia znalezienie problemu bez odczytywania technicznych dzienników.

API wspiera ustalone procesy

API to interfejs przeznaczony dla innych programów. Ustalony proces może przez API rozpocząć sprawdzanie, odczytać postęp i pobrać wynik. Dokumentacja określa dozwolone dane wejściowe, limity czasu żądań i odpowiedzi na błędy. Informacja o wersji pomaga zaplanować dostosowanie do zmian interfejsu.

Sam identyfikator zadania nie zapobiega podwójnemu wykonaniu. Serwer musi zapisać klucz ponowienia i przypisywać kolejne żądania z tym kluczem do tego samego zadania, także przy równoczesnych żądaniach. Program wywołujący musi ponownie przesłać ten sam klucz; zmienione dane wymagają jasno określonej obsługi błędu. Ta właściwość nazywa się idempotencją. [4] Przy długich operacjach pierwsza odpowiedź potwierdza przyjęcie, a wynik pojawia się później. Przyjęte zadanie nadal może zakończyć się błędem.

MCP udostępnia narzędzia zgodnym klientom

MCP oznacza Model Context Protocol. Protokół określa między innymi sposób pobierania listy narzędzi i wymaganych danych oraz wywoływania narzędzia przez aplikację. [1] Dla kontroli dokumentów mogą to być trzy wąskie funkcje: rozpoczęcie sprawdzania, odczyt postępu i odczyt wyniku. MCP nie gwarantuje trafnego wyboru narzędzia ani poprawnego wyniku.

Opis narzędzia powinien jasno wskazywać skutki wywołania. Sprawdzenie pliku różni się od wysłania albo usunięcia pliku. Krytyczne działania wymagają odpowiedniego zatwierdzenia i kontroli uprawnień na serwerze. Samo oznaczenie funkcji jako „tylko do odczytu” nie zastępuje tej kontroli.

Serwer sprawdza każdy dostęp

Agent potrzebuje dostępu tylko do danych i operacji niezbędnych w zadaniu. Na przykład zadanie firmy A nie może odczytywać dokumentów firmy B. Serwer musi więc przy każdym zadaniu sprawdzać tożsamość, konto klienta i dozwoloną operację. Sama przesłana nazwa konta nie dowodzi uprawnienia.

Dla chronionych połączeń HTTP specyfikacja MCP opisuje procedurę opartą na OAuth: token dostępu potwierdza przyznane uprawnienie wobec właściwego serwera. Lokalne połączenia stdio przesyłają dane przez wejście i wyjście uruchomionego programu i nie korzystają z tej procedury. [2] MCP zabrania przyjmowania tokenów niewystawionych dla serwera MCP. W przeciwnym razie pośrednik mógłby nadużyć cudzych uprawnień. Zgoda dotycząca jednej podłączonej aplikacji nie może automatycznie obejmować innej aplikacji. [3]

Rozliczanie pracy zamiast rozmowy

Jasno określone zadanie jest lepszą podstawą rozliczenia niż liczba tur rozmowy. Agent może wielokrotnie pytać o postęp bez uruchamiania kolejnej kontroli dokumentu. Możliwy model rezerwuje kwotę z budżetu przed rozpoczęciem i rozlicza uzgodnioną pracę. Zasady dotyczące błędów oraz anulowanych zadań muszą być wyraźnie opisane.

Hipotetyczny przykład obejmuje 1000 zadań dokumentowych i łącznie 100 dodatkowych prób przetwarzania. Przy koszcie 0,02 jednostki pieniężnej na próbę koszt zmienny wynosi 1100 × 0,02 = 22. To koszt rzeczywiście wykonanych prób, na przykład po błędzie przetwarzania, a nie automatycznie każdego ponowionego żądania HTTP. Ochrona przed podwójnymi zadaniami ma właśnie ograniczać zbędne powtarzanie pracy. Odczyt statusu może mieć osobny limit, choć także powoduje pewien koszt obsługi serwera. Przykład nie przedstawia taryfy platformy.

Pilotaż bez przebudowy platformy

Mała próba może najpierw udostępniać trzy funkcje przez interfejs WWW i API: rozpoczęcie sprawdzania, odczyt postępu i odczyt wyniku. Połączenie MCP korzysta następnie z tych samych reguł sprawdzania oraz tej samej obsługi zadań. Grupa pilotażowa zapisuje liczbę ukończonych zadań, wymagane zatwierdzenia, duplikaty i czas wsparcia.

Krótka instrukcja z pełnym przykładem ułatwia integrację bardziej niż długa lista niejasnych narzędzi. Połączenie MCP jest szczególnie przydatne, gdy rzeczywiści klienci korzystają ze zgodnej aplikacji, a dodatkowy sposób dostępu pozwala wyraźnie ograniczyć liczbę czynności.

Źródła

1. MCP: tools specification
2. MCP: authorization
3. MCP: security best practices
4. Stripe: Ponawianie żądań z kluczem idempotencji

Źródła sprawdzone: 25 października 2026.