ZDALNE MCP · TRZY NARZĘDZIA

Twoje reguły.
W narzędziach agenta.

Policz wycenę usług, sprawdź własne przypadki i zobacz, co zmiana reguł zrobi ze składnikami ceny. Z tego samego silnika, który działa w kalkulatorze Napędza.

Podłącz przez HTTPS

Bez pobierania i instalacji · dane podajesz w wywołaniu

01 / POŁĄCZENIE HTTPS

Dodaj integrację w kliencie agenta.

Podłączenie działa jako zdalne MCP przez HTTPS. Nie pobierasz paczki, nie instalujesz Node i nie potrzebujesz dostępu do repozytorium. Klient musi obsługiwać zdalny transport MCP.

Adres zdalnego MCPhttps://napedza.pl/api/mcp

Zdalny adres MCP przez HTTPS. Po dodaniu go klient przechodzi przez zgodę w przeglądarce; dopiero lista narzędzi i udane wywołanie potwierdzają Twoje połączenie.

  1. Dodaj zdalny serwer MCP

    Otwórz integracje lub narzędzia w swoim kliencie i dodaj serwer HTTPS. Użyj dokładnego adresu podanego powyżej. Adres tej strony dokumentacji nie jest adresem transportu.

  2. Potwierdź połączenie w przeglądarce

    Klient otworzy ekran zgody Napędza. Sprawdź jego nazwę i zakres tools:read. Zgoda dotyczy obliczeń z podanych reguł; nie jest logowaniem do konta ani dostępem do zakupów. Sprawdź czas połączenia i sposób odwołania.

  3. Sprawdź listę narzędzi

    Po zakończeniu wymiany protokołu klient powinien pokazać trzy nazwy poniżej. Samo otwarcie strony, zapisanie adresu lub odpowiedź HTTP nie oznacza jeszcze działającego połączenia MCP.

  4. Wykonaj pierwszą wycenę

    Poproś o napedza_list_templates z {"template":"cleaning"}. Następnie przekaż zwrócone reguły do napedza_calculate_quote z {"units":80,"addonIds":["windows"]}. Oczekiwany przykład to 40000–56000 groszy PLN netto, czyli 400–560 zł.

Co jest dostępem do danych, a co obliczeniem?

Narzędzia otrzymują reguły i scenariusze jawnie w wywołaniu. Nie łączą się z prywatnym kontem Napędza, zakupami ani zapisanymi publikacjami. Nie podawaj klucza właściciela, danych klientów ani sekretów jako argumentów. Polityka klienta lub agenta dotycząca danych pozostaje osobna.

Zgoda na obliczenia z podanych reguł.

Przy podłączaniu klient otworzy w przeglądarce ekran zgody Napędza. Sprawdź nazwę klienta i zatwierdź połączenie tylko wtedy, gdy je rozpoznajesz. Nie zakładasz konta i nie logujesz się do zapisanych kalkulatorów.

Trzy narzędzia
Zakres tools:read pozwala pobrać przykład, policzyć wycenę i sprawdzić scenariusze z argumentów wywołania. Nie daje dostępu do szkicu, zakupów ani publikacji.
Do 7 dni
Token dostępu działa do 15 minut. Klient może go odświeżać w ramach tego połączenia najwyżej przez 7 dni; potem potrzebna jest nowa zgoda.
Reguły przez HTTPS
Reguły i próby przekazujesz zdalnemu serwerowi. Narzędzia nie zapisują ich treści. Nie dołączaj danych klientów, klucza właściciela ani sekretów.

Co pozostaje po stronie połączenia?

Usługa przechowuje techniczną rejestrację klienta, stan zgody oraz skróty tokenów z terminem wygaśnięcia. Kod zgody działa przez 5 minut i można go użyć raz. To pseudonimowe połączenie do obliczeń, bez potwierdzania tożsamości lub płatnego dostępu.

Aby zakończyć dostęp, użyj odwołania połączenia OAuth w swoim kliencie. Samo usunięcie adresu z ustawień nie gwarantuje odwołania tokenu. Jeżeli klient nie obsługuje odwołania, usuń połączenie w jego ustawieniach. Wydane tokeny mogą pozostać ważne do opisanych terminów. Nowa zgoda tworzy osobne połączenie.

Do 100 żądań MCP dziennie na połączenie, jedna operacja jednocześnie; wspólna pula wszystkich produktów to 5000 żądań dziennie i dwie operacje jednocześnie. Inne limity ochronne mogą wcześniej wstrzymać żądanie. Komunikat 429 oznacza ograniczenie — kieruj się czasem ponowienia podanym przez serwer.

02 / NARZĘDZIA

Od szablonu do jawnych wyników.

01

napedza_list_templates

Wejście: {} albo template: cleaning, photography, training.

Wynik: trzy lub jeden zestaw demonstracyjnych reguł, provenance:built_in_example. To punkt wyjścia, nie rynkowy cennik.

02

napedza_calculate_quote

Wejście: config i input:{units,addonIds}.

Wynik: minCents, maxCents i lines lub jawny błąd. Kwoty są całkowitymi groszami PLN netto. Wbudowane sprzątanie: 80 m² z windows daje 40000–56000 groszy, czyli 400–560 zł.

03

napedza_check_scenarios

Wejście: config, 1–6 cases:[{name,input}], opcjonalnie comparisonConfig.

Wynik: każda próba z własnym wynikiem lub błędem. Przy porównaniu: obie wyceny, literalne zmiany parametrów i osobno zgodność przedziału oraz składników. Niepoprawne przypadki nie znikają z listy.

Dokładny zakres wejść i ograniczeń · Opis w Markdown

03 / PRÓBA ZMIANY REGUŁ

Ta sama suma nie kończy sprawdzania.

Poproś agenta o przykład cleaning. Dla poprzednich reguł ustaw baseCents:8000 i rateCents:300; dla bieżących baseCents:0 i rateCents:400. Resztę zachowaj. Sprawdź 80 jednostek z dodatkiem windows.

Wybierz próby. Zobacz pełne wywołanie i klienta.

To lokalna demonstracja tych samych funkcji co narzędzie. Nie wysyła żądań MCP, nie sprawdza połączenia Twojego agenta i nie odczytuje własnego szkicu. Kwoty są przykładowe.

Które próby porównać?

Uruchamianie lokalnego przykładu. Opis i statyczne wyniki poniżej pozostają dostępne bez JavaScript.

Pełne wywołanie JSON dla podłączonego agenta

Obiekt zawiera nazwę narzędzia oraz kompletne reguły i wybrane przypadki. Nie zawiera tokenu ani danych konta. Możesz przekazać go agentowi w swoim kliencie; ta strona niczego nie kopiuje ani nie wysyła.

Przygotowanie wywołania wymaga JavaScript.
Użyj napedza_check_scenarios z tymi dwoma zestawami reguł. Pokaż obie wyceny, zmienione parametry i składniki. Nie zatwierdzaj stawek ani podglądu klienta.

W obu wersjach otrzymasz 480–672 zł netto. Przegląd powinien równocześnie zawierać:

"comparisonReview": {
  "state": "comparable",
  "parameterChanges": [
    {"field":"baseCents","before":8000,"after":0},
    {"field":"rateCents","before":300,"after":400}
  ],
  "sameRange": true,
  "sameIngredients": false
}

Pełne wejście zawiera config, comparisonConfig oraz jedną próbę cases:[{name,input:{units:80,addonIds:["windows"]}}]. sameIngredients obejmuje również nazwy i kolejność składników. Przegląd dotyczy globalnych reguł i wybranych dodatków; nie porównuje kontaktu, tytułu ani niewybranych opcji.

Gdy porównanie nie jest możliwe

Inny szablon lub jednostka daje state:incompatible. Błąd bieżącej, poprzedniej lub obu prób daje odpowiednio current_scenario_invalid, comparison_scenario_invalid albo both_scenarios_invalid. Wtedy sameRange i sameIngredients mają null, zamiast udawać zgodność. Brak dodatku opisuje present:false, nie zero złotych.

Starszy proces bez pola comparisonReview nie potwierdza braku zmian. Sprawdź wersję narzędzia widoczną w kliencie. humanReview:not_performed pozostaje jawne w wyniku scenariuszy.

04 / GRANICE

Obliczenia z podanych danych. Dostęp pozostaje po Twojej stronie.

MCP nie łączy się z kontem Napędza, nie odczytuje zapisanych publikacji i nie przyjmuje klucza właściciela. Nie publikuje, nie przygotowuje płatnych eksportów, nie tworzy leadów i nie wysyła wiadomości. MCP nie przyznaje dostępu do płatnej oferty.

6 prób
na wywołanie; do 10 znanych, unikalnych dodatków, ilość całkowita w zakresie reguł
Dane z wywołania
reguły i ilości podane przez agenta; bez odczytu konta, zakupów i publikacji
900 / 512 KiB
maksimum argumentów / wyniku; 512 elementów lub członków obiektów, głębokość 16

Nieznane pola, nieprawidłowe dane i przekroczenia limitów są odrzucane, bez ucinania wyników. Funkcje narzędzi nie odczytują zewnętrznych adresów, konta ani zapisów przeglądarki. Reguły przesyłasz do zdalnego serwera w wywołaniu HTTPS. Klient lub agent ma własne zasady przetwarzania danych.

Reguły agenta mają pochodzenie caller_supplied_unverified. Wynik jest orientacyjną ceną netto do potwierdzenia przez firmę, bez rezerwacji i płatności za usługę. MCP nie ogląda podglądu ani docelowej witryny.

05 / WYNIK DLA KLIENTA

Agent sprawdza reguły. Ty oglądasz kalkulator.

Po sprawdzeniu przypadków wprowadź własne reguły w Napędza, przejdź przez plan prób i rzeczywisty podgląd klienta. Dane z MCP nie są automatycznie przyjmowane do projektu.

Otwórz własne reguły Zobacz istniejącą ofertę osadzenia →

Obliczenia MCP nie przyznają dostępu do płatnej publikacji. Publikacja i płatne funkcje mają osobną dostępność oraz warunki w istniejącej ofercie i podsumowaniu zakupu.