{"id":21527,"date":"2026-11-10T14:30:00","date_gmt":"2026-11-10T13:30:00","guid":{"rendered":"https:\/\/www.lukaswojcik.com\/blog\/?p=21527"},"modified":"2026-10-25T22:32:11","modified_gmt":"2026-10-25T21:32:11","slug":"saas-dla-agentow-ai-interfejs-www-api-czy-dostep-mcp","status":"publish","type":"post","link":"https:\/\/www.lukaswojcik.com\/blog\/pl\/saas-internet-earning-pl\/saas-dla-agentow-ai-interfejs-www-api-czy-dostep-mcp\/","title":{"rendered":"SaaS dla agent\u00f3w AI: interfejs WWW, API czy dost\u0119p MCP?"},"content":{"rendered":"

SaaS to oprogramowanie oferowane jako us\u0142uga. Narz\u0119dzie do sprawdzania dokument\u00f3w mo\u017ce dzia\u0142a\u0107 w przegl\u0105darce, stanowi\u0107 cz\u0119\u015b\u0107 ustalonej automatyzacji albo by\u0107 wywo\u0142ywane przez agenta AI. Agent wykorzystuje model j\u0119zykowy do wyboru funkcji potrzebnych w zadaniu. Ka\u017cdy z tych sposob\u00f3w dost\u0119pu powinien niezawodnie wykonywa\u0107 t\u0119 sam\u0105 prac\u0119. Samo dodanie po\u0142\u0105czenia nie dowodzi popytu.<\/p>\n

\"Interfejs
Trzy sposoby dost\u0119pu korzystaj\u0105 z tych samych regu\u0142 sprawdzania i obs\u0142ugi zada\u0144.<\/figcaption><\/figure>\n

Interfejs wspiera kontrol\u0119 wzrokow\u0105<\/h2>\n

Interfejs WWW pokazuje razem dane wej\u015bciowe, podgl\u0105d i wyniki. Narz\u0119dzie do sprawdzania dokument\u00f3w mo\u017ce zaznacza\u0107 b\u0142\u0119dy przed zatwierdzeniem eksportu pliku. Jest to szczeg\u00f3lnie przydatne przy sporadycznych zadaniach i decyzjach wymagaj\u0105cych oceny kompetentnej osoby.<\/p>\n

Czytelna lista zada\u0144 pozostaje przydatna po dodaniu automatycznego dost\u0119pu. Zadanie mo\u017ce oczekiwa\u0107, trwa\u0107, by\u0107 uko\u0144czone albo zatrzyma\u0107 si\u0119 z powodu braku uprawnie\u0144. Taki opis u\u0142atwia znalezienie problemu bez odczytywania technicznych dziennik\u00f3w.<\/p>\n

API wspiera ustalone procesy<\/h2>\n

API to interfejs przeznaczony dla innych program\u00f3w. Ustalony proces mo\u017ce przez API rozpocz\u0105\u0107 sprawdzanie, odczyta\u0107 post\u0119p i pobra\u0107 wynik. Dokumentacja okre\u015bla dozwolone dane wej\u015bciowe, limity czasu \u017c\u0105da\u0144 i odpowiedzi na b\u0142\u0119dy. Informacja o wersji pomaga zaplanowa\u0107 dostosowanie do zmian interfejsu.<\/p>\n

Sam identyfikator zadania nie zapobiega podw\u00f3jnemu wykonaniu. Serwer musi zapisa\u0107 klucz ponowienia i przypisywa\u0107 kolejne \u017c\u0105dania z tym kluczem do tego samego zadania, tak\u017ce przy r\u00f3wnoczesnych \u017c\u0105daniach. Program wywo\u0142uj\u0105cy musi ponownie przes\u0142a\u0107 ten sam klucz; zmienione dane wymagaj\u0105 jasno okre\u015blonej obs\u0142ugi b\u0142\u0119du. Ta w\u0142a\u015bciwo\u015b\u0107 nazywa si\u0119 idempotencj\u0105. [4<\/a>] Przy d\u0142ugich operacjach pierwsza odpowied\u017a potwierdza przyj\u0119cie, a wynik pojawia si\u0119 p\u00f3\u017aniej. Przyj\u0119te zadanie nadal mo\u017ce zako\u0144czy\u0107 si\u0119 b\u0142\u0119dem.<\/p>\n

MCP udost\u0119pnia narz\u0119dzia zgodnym klientom<\/h2>\n

MCP oznacza Model Context Protocol. Protok\u00f3\u0142 okre\u015bla mi\u0119dzy innymi spos\u00f3b pobierania listy narz\u0119dzi i wymaganych danych oraz wywo\u0142ywania narz\u0119dzia przez aplikacj\u0119. [1<\/a>] Dla kontroli dokument\u00f3w mog\u0105 to by\u0107 trzy w\u0105skie funkcje: rozpocz\u0119cie sprawdzania, odczyt post\u0119pu i odczyt wyniku. MCP nie gwarantuje trafnego wyboru narz\u0119dzia ani poprawnego wyniku.<\/p>\n

Opis narz\u0119dzia powinien jasno wskazywa\u0107 skutki wywo\u0142ania. Sprawdzenie pliku r\u00f3\u017cni si\u0119 od wys\u0142ania albo usuni\u0119cia pliku. Krytyczne dzia\u0142ania wymagaj\u0105 odpowiedniego zatwierdzenia i kontroli uprawnie\u0144 na serwerze. Samo oznaczenie funkcji jako \u201etylko do odczytu\u201d nie zast\u0119puje tej kontroli.<\/p>\n

Serwer sprawdza ka\u017cdy dost\u0119p<\/h2>\n

Agent potrzebuje dost\u0119pu tylko do danych i operacji niezb\u0119dnych w zadaniu. Na przyk\u0142ad zadanie firmy A nie mo\u017ce odczytywa\u0107 dokument\u00f3w firmy B. Serwer musi wi\u0119c przy ka\u017cdym zadaniu sprawdza\u0107 to\u017csamo\u015b\u0107, konto klienta i dozwolon\u0105 operacj\u0119. Sama przes\u0142ana nazwa konta nie dowodzi uprawnienia.<\/p>\n

Dla chronionych po\u0142\u0105cze\u0144 HTTP specyfikacja MCP opisuje procedur\u0119 opart\u0105 na OAuth: token dost\u0119pu potwierdza przyznane uprawnienie wobec w\u0142a\u015bciwego serwera. Lokalne po\u0142\u0105czenia stdio przesy\u0142aj\u0105 dane przez wej\u015bcie i wyj\u015bcie uruchomionego programu i nie korzystaj\u0105 z tej procedury. [2<\/a>] MCP zabrania przyjmowania token\u00f3w niewystawionych dla serwera MCP. W przeciwnym razie po\u015brednik m\u00f3g\u0142by nadu\u017cy\u0107 cudzych uprawnie\u0144. Zgoda dotycz\u0105ca jednej pod\u0142\u0105czonej aplikacji nie mo\u017ce automatycznie obejmowa\u0107 innej aplikacji. [3<\/a>]<\/p>\n

Rozliczanie pracy zamiast rozmowy<\/h2>\n

Jasno okre\u015blone zadanie jest lepsz\u0105 podstaw\u0105 rozliczenia ni\u017c liczba tur rozmowy. Agent mo\u017ce wielokrotnie pyta\u0107 o post\u0119p bez uruchamiania kolejnej kontroli dokumentu. Mo\u017cliwy model rezerwuje kwot\u0119 z bud\u017cetu przed rozpocz\u0119ciem i rozlicza uzgodnion\u0105 prac\u0119. Zasady dotycz\u0105ce b\u0142\u0119d\u00f3w oraz anulowanych zada\u0144 musz\u0105 by\u0107 wyra\u017anie opisane.<\/p>\n

Hipotetyczny przyk\u0142ad obejmuje 1000 zada\u0144 dokumentowych i \u0142\u0105cznie 100 dodatkowych pr\u00f3b przetwarzania. Przy koszcie 0,02 jednostki pieni\u0119\u017cnej na pr\u00f3b\u0119 koszt zmienny wynosi 1100 \u00d7 0,02 = 22. To koszt rzeczywi\u015bcie wykonanych pr\u00f3b, na przyk\u0142ad po b\u0142\u0119dzie przetwarzania, a nie automatycznie ka\u017cdego ponowionego \u017c\u0105dania HTTP. Ochrona przed podw\u00f3jnymi zadaniami ma w\u0142a\u015bnie ogranicza\u0107 zb\u0119dne powtarzanie pracy. Odczyt statusu mo\u017ce mie\u0107 osobny limit, cho\u0107 tak\u017ce powoduje pewien koszt obs\u0142ugi serwera. Przyk\u0142ad nie przedstawia taryfy platformy.<\/p>\n

Pilota\u017c bez przebudowy platformy<\/h2>\n

Ma\u0142a pr\u00f3ba mo\u017ce najpierw udost\u0119pnia\u0107 trzy funkcje przez interfejs WWW i API: rozpocz\u0119cie sprawdzania, odczyt post\u0119pu i odczyt wyniku. Po\u0142\u0105czenie MCP korzysta nast\u0119pnie z tych samych regu\u0142 sprawdzania oraz tej samej obs\u0142ugi zada\u0144. Grupa pilota\u017cowa zapisuje liczb\u0119 uko\u0144czonych zada\u0144, wymagane zatwierdzenia, duplikaty i czas wsparcia.<\/p>\n

Kr\u00f3tka instrukcja z pe\u0142nym przyk\u0142adem u\u0142atwia integracj\u0119 bardziej ni\u017c d\u0142uga lista niejasnych narz\u0119dzi. Po\u0142\u0105czenie MCP jest szczeg\u00f3lnie przydatne, gdy rzeczywi\u015bci klienci korzystaj\u0105 ze zgodnej aplikacji, a dodatkowy spos\u00f3b dost\u0119pu pozwala wyra\u017anie ograniczy\u0107 liczb\u0119 czynno\u015bci.<\/p>\n

\n

Powi\u0105zane narz\u0119dzia<\/h2>\n