Narzędzia MCP Requiply
To narzędzia, które serwer MCP Requiply udostępnia połączonemu asystentowi. Narzędzia tylko do odczytu można wywoływać bez ograniczeń. Każde narzędzie, które coś zmienia, najpierw pokazuje podgląd i zapisuje zmiany dopiero po Twoim potwierdzeniu. Przykłady ich użycia znajdziesz w Zastosowaniach.
Jak asystent pracuje z Requiply
Requiply udostępnia niewielki, spójny zestaw narzędzi. Poniższe narzędzia pozwalają asystentowi zorientować się w sytuacji, zanim zajmie się danymi:
| Narzędzie | Co robi |
|---|---|
whoami | Zwraca profil firmy (waluta, język, strefa czasowa, godziny pracy i dni wolne, oddziały, opcje płatności i dostawy), informację, w czyim imieniu działa asystent, macierz dostępu dla każdego typu obiektu oraz pracowników z ich grupami uprawnień. Asystenci wywołują je jako pierwsze w rozmowie. |
describe | Odkrywanie schematu. Wymienia typy obiektów dostępne dla połączenia, sekcje ustawień i tematy instrukcji. Dla jednego typu obiektu zwraca pola, filtry, aktualne wartości, takie jak statusy rezerwacji czy kategorie, Twoje pola dodatkowe rezerwacji, klientów i grup pozycji oraz pola, według których objects_query może filtrować i grupować. Dla sekcji ustawień zwraca pola tej sekcji. |
get_guidance | Zwraca szczegółowe instrukcje do zadania: każde makro obsługiwane przez Twoją organizację (w tym Twoje pola dodatkowe), zasady formatu szablonów, struktury wyzwalaczy i akcji automatyzacji z gotowymi przepisami, operatory filtrów, katalog raportów, język zapytań i mapę stron aplikacji. |
get_profile | Zwraca konto Requiply, na które loguje się połączenie: imię i nazwisko, e-mail i organizację. Tylko w połączeniach zalogowanych jako członek zespołu. |
search_help | Przeszukuje tę bazę wiedzy pod kątem tego, jak działa Requiply i jak coś skonfigurować, oraz czyta całą stronę. Asystent podaje strony, z których skorzystał. |
Makra i struktury automatyzacji pochodzą z narzędzi, a nie z pamięci asystenta, więc szablon przygotowany przez asystenta używa dokładnie tych makr, które ma Twoja organizacja.
get_guidance przyjmuje jeden lub kilka z tych tematów:
| Temat | Czego dotyczy |
|---|---|
getting_started | Jak narzędzia ze sobą współpracują i zasada „najpierw podgląd, potem potwierdzenie” przy zapisie. |
booking_rules | Godziny pracy, bufory, status zapytania oraz to, co zapytanie o rezerwację robi, a czego nie robi. |
email_template_macros | Każde {{macro}} dostępne w szablonach e-maili, w tym Twoje pola dodatkowe. |
message_template_macros | Makra i zasady formatu szablonów wiadomości SMS, Viber i Telegram. |
export_template_macros | Makra i składnia kolumn tabel w szablonach dokumentów PDF. |
template_conditionals | Bloki {{#if}} i zachowanie pustych wartości. |
workflow_recipes | Struktury wyzwalaczy i akcji z gotowymi przepisami automatyzacji. |
workflow_filters | Nazwy właściwości filtrów, operatory i formaty wartości w automatyzacjach. |
reports_catalog | Który raport odpowiada na które pytanie biznesowe i jakie ma parametry. |
query_language | Składnia objects_query: pola, operatory, daty, grupowanie i omówione przykłady. |
app_navigation | Każda strona aplikacji webowej Requiply ze ścieżką w menu i linkiem, do pytań typu „gdzie znajdę” i „jak to zrobić”. |
Rekordy
Rekordy odczytuje się dwoma ogólnymi narzędziami, a zmienia narzędziem zapisu przeznaczonym dla danego typu. Argument objectType wybiera, z czym pracujesz. Każdy rekord, który ma stronę w Requiply, zawiera url, który ją otwiera, i asystenci podają linki do rekordów właśnie przez niego.
| Typ obiektu | Odczyt | Zapis | Uwagi |
|---|---|---|---|
booking | Tak | Przez bookings_manage; pola dodatkowe przez objects_manage | Wyszukiwanie zwraca uproszczone wiersze, a get pełne pozycje, usługi, płatności i pola dodatkowe. Numer rezerwacji widoczny dla użytkownika to reservationOrgId. |
client | Tak | Tworzenie, aktualizacja, pola dodatkowe | Dokładne wyszukiwanie po e-mailu lub telefonie, wyszukiwanie przybliżone po nazwie. Tworzenie zabezpiecza przed duplikatami. Tworzenie i aktualizacja przyjmują customFields. |
item_group | Tak | Tylko pola dodatkowe | Pozycje do wynajęcia ze stanem, cenami, progami cenowymi, polami dodatkowymi i dostępnością w wybranym okresie. Same pozycje edytuje się w aplikacji. |
sale_item | Tak | Nie | Towary na sprzedaż (Sprzedaż): nazwa, SKU, kod kreskowy, kategoria, cena sprzedaży, stan na magazynie (może być ujemny), sprzedaż z ostatnich 30 dni. purchaseCost tylko dla kont z uprawnieniem Zezwalaj na zarządzanie stanem magazynowym. Wymaga włączonej sprzedaży i uprawnienia do sprzedaży. |
sale | Tak | Przez sales_manage | Sprzedaż towarów, samodzielna lub w ramach rezerwacji, od najnowszej. Filtry: kind (samodzielna lub w rezerwacji), status, unpaid, clientId, soldFrom, soldTo. Get zwraca pozycje, zwroty i płatności. Numer widoczny dla użytkownika to saleOrgId. Przekaż idKind="org", aby pobrać sprzedaż po tym numerze. |
category | Tak | Tworzenie, aktualizacja | Kategorie pozycji, zagnieżdżane przez parentId. |
service | Tak | Tworzenie, aktualizacja | Usługi dodatkowe. Zamiast usuwać, archiwizuj. |
location | Tak | Tworzenie, aktualizacja | Oddziały wydania i zwrotu. |
reservation_status | Tak | Nie | Statusy rezerwacji, używane do ustalania identyfikatorów w automatyzacjach i filtrach. |
email_template, message_template, export_template | Tak | Przez templates_manage | Na liście bez treści, treść zwraca get. templates_preview wyświetla szablon na danych wybranej rezerwacji. |
workflow | Tak | Przez workflows_manage | Na liście z czytelnym podsumowaniem wyzwalacza i akcji, get zwraca pełną konfigurację. |
bundle | Tak | Nie | Zestawy, które można zarezerwować, z ich pozycjami i rabatem. Przekaż daty do wyszukiwania, aby sprawdzić, ile kompletów jest wolnych. Zestawy tworzy się i edytuje w aplikacji. |
conversation | Tak | Przez conversations_manage | Skrzynka rozmów, od najnowszych: kanał, kontakt, powiązany klient, kto teraz odpowiada (AI czy człowiek), właściciel, status i liczba nieprzeczytanych. Filtry: view (needs_human, mine, ai, closed), period (today, week), channel. Get zwraca najnowsze wiadomości i informację, czy na tym kanale można jeszcze wysłać odpowiedź. |
comment | Tak | Przez comments_manage | Komentarze do rezerwacji, klienta, egzemplarza lub zadania. Wyszukiwanie wymaga entityType i entityId (wątek jednego rekordu) albo mentionsMe=true (komentarze, w których oznaczono Ciebie, w połączeniach członków zespołu). Wpisy systemowe są pomijane, chyba że podasz includeSystem=true. |
| Narzędzie | Co potrafi |
|---|---|
objects_search | Wyświetla lub przeszukuje jeden typ obiektu z tekstem w query, typowanymi filters (daty, nazwy statusów, identyfikator klienta, kategoria, okres dostępności, widok skrzynki) i stronicowaniem kursorowym. |
objects_get | Pobiera do 20 rekordów po identyfikatorze ze wszystkimi szczegółami, w tym z polami dodatkowymi rezerwacji, klientów i grup pozycji. W przypadku rezerwacji i sprzedaży idKind="org" przyjmuje numer widoczny w aplikacji. |
objects_query | Odpowiada na pytania z filtrowaniem i grupowaniem dotyczące rezerwacji, klientów, grup pozycji i sprzedaży za pomocą RQL (Requiply Query Language), zapytania w formacie JSON: warunki łączone przez AND i OR na dowolnym polu, w tym na kliencie, statusie, pozycjach i ich kategorii, saldzie do zapłaty i polach dodatkowych. Zwraca pasujące rekordy z linkami albo po jednym wierszu na grupę z liczbą, sumami, średnimi i medianami, na przykład przychód w poszczególnych miesiącach. Tylko do odczytu. Sumy kwot wymagają dostępu do raportów. |
objects_manage | Tworzy lub aktualizuje klienta, kategorię, usługę lub oddział oraz ustawia wartości pól dodatkowych w istniejącej rezerwacji, kliencie lub grupie pozycji (set_custom_fields). Wymaga odpowiedniego uprawnienia: Zezwalaj na zarządzanie klientami dla klientów, Zezwalaj na zarządzanie sprzętem dla kategorii i pól dodatkowych grup pozycji, Zezwalaj na zarządzanie usługami dla usług, Zezwalaj na zarządzanie rezerwacjami dla pól dodatkowych rezerwacji i Zezwalaj na dostęp do ustawień dla oddziałów. |
objects_search znajduje rekordy po nazwie, numerze lub kilku stałych filtrach. reports_run odpowiada standardowymi raportami biznesowymi. objects_query obsługuje pytania pomiędzy nimi, takie jak „rezerwacje w lipcu z dronem, które nadal nie są opłacone” albo „klienci z co najmniej trzema rezerwacjami, którzy nie rezerwowali od czerwca”. Przed pierwszym zapytaniem asystenci czytają temat instrukcji query_language.Narzędzia rezerwacji, sprzedaży, dostępności i cen
| Narzędzie | Co potrafi |
|---|---|
availability_check | mode="items" zwraca grupy pozycji, w których co najmniej jeden egzemplarz jest wolny przez cały okres. mode="calendar" zwraca liczby dla każdej grupy pozycji dzień po dniu. |
pricing_quote | Oblicza dokładną wycenę na podstawie wybranych grup pozycji, zestawów, usług, dat wynajmu, progów cenowych i opcjonalnego rabatu klienta. Data bez godziny jest wyceniana od godziny otwarcia do godziny zamknięcia, a wynik podaje daty, których użyto. |
sales_manage | create rejestruje samodzielną sprzedaż towarów po cenie katalogowej, z opcjonalnym klientem (po identyfikatorze albo po nazwie z e-mailem lub telefonem) i metodą płatności. Podgląd pokazuje pozycje, sumę, ostrzeżenia o stanie magazynowym (stan może spaść poniżej zera, sprzedaż i tak jest dozwolona) oraz to, czy metoda płatności działa. Potwierdzone wywołanie rejestruje sprzedaż i zwraca link do płatności dla metod online. Wymaga uprawnienia Zezwalaj na sprzedaż towarów. Zwroty, anulowanie, edycję pozycji i oznaczanie płatności jako opłaconych wykonuje się w aplikacji. |
bookings_manage | create_request tworzy szkic rezerwacji w statusie ustawionym w Status zapytań o rezerwację Twojej organizacji (Zapytanie, chyba że zmieniono to w Tworzenie rezerwacji). Wywołanie podglądu sprawdza dostępność, wycenia sprzęt i zwraca podsumowanie, a potwierdzone wywołanie tworzy zapytanie. Przyjmuje customFields rezerwacji z kluczami pól, które podaje describe. add_note dodaje do rezerwacji wewnętrzną notatkę widoczną tylko dla pracowników. Pracownicy, których grupa uprawnień ma Zezwalaj na rezerwacje poza godzinami pracy, mogą poprosić o wydanie lub zwrot poza godzinami pracy, a narzędzie przekazuje dla nich allowOutsideWorkingHours. Pracownicy, których grupa ma Zezwalaj na korekty kosztu i kaucji, mogą też przekazać jedną korektę adjustment (units, percent lub amount, ze znakiem), zobacz Korekta kosztu rezerwacji. Pracownicy z uprawnieniem Zezwalaj na sprzedaż towarów mogą przekazać saleLines, aby sprzedać towary razem z rezerwacją po cenie katalogowej: podgląd pokazuje je jako saleSubtotal, wliczone w sumę i nigdy nie objęte rabatem, a ich stan magazynowy spada po utworzeniu zapytania. Zapytanie może też zawierać bundles, rezerwowane jako ich pozycje z rabatem zestawu. |
Zapytanie o rezerwację nigdy nie blokuje sprzętu i nie pobiera płatności. Pracownik zatwierdza je w aplikacji, a zatwierdzenie ponownie sprawdza dostępność. Zmiany statusu, płatności i edycję pozycji w istniejącej rezerwacji wykonuje się w aplikacji.
Daty i godziny są w Twoim czasie lokalnym. Asystenci przekazują daty i godziny bez strefy czasowej, na przykład 2026-10-06T10:00:00, a Requiply odczytuje je w strefie czasowej organizacji z ustawień daty i godziny, z uwzględnieniem czasu letniego. Data bez godziny, taka jak 2026-10-06, oznacza godzinę otwarcia dla wydania i godzinę zamknięcia dla zwrotu. Wartości z własnym przesunięciem, takie jak 2026-10-06T10:00:00+03:00, są używane bez zmian.
Godziny pracy są sprawdzane w podglądzie. Gdy żądane wydanie lub zwrot przypada na dzień zamknięcia albo poza godzinami pracy, podgląd informuje o tym w workingHours, podając najbliższy dzień pracy lub dozwolony przedział, a asystent nie prosi o potwierdzenie. Zamiast tego proponuje inny termin.
Każda reguła biznesowa jest sprawdzana w podglądzie. Gdy zapytania nie da się zarezerwować w podanej postaci, podgląd zwraca bookable: false i listę problems, każdy z kodem, przyczyną i krokiem nextStep, który asystent wykonuje, zanim poprosi o potwierdzenie:
| Kod | Znaczenie | Co asystent robi dalej |
|---|---|---|
working_hours | Wydanie lub zwrot w dzień zamknięcia albo poza godzinami pracy. | Proponuje najbliższy prawidłowy termin. |
minimum_duration | Krócej niż Minimalny czas rezerwacji z Czas trwania rezerwacji. | Proponuje najwcześniejszy zwrot, który zostanie przyjęty. |
unavailable | Za mało wolnego sprzętu w tych datach. | Podaje, ile jest wolnych egzemplarzy, i proponuje inne daty, mniejszą ilość albo podobną pozycję. |
not_found | Nie znaleziono pozycji, usługi lub klienta. | Wyszukuje ponownie albo prosi o dane klienta. |
not_allowed | Twoja grupa uprawnień lub plan nie pozwala na część zapytania. | Proponuje kontynuowanie bez tej części, na przykład bez korekty. |
invalid_request | Coś w zapytaniu jest nieprawidłowe, na przykład zwrot przed wydaniem. | Poprawia zapytanie i ponownie pokazuje podgląd. |
system_error | Chwilowa awaria. | Próbuje jeszcze raz. |
Problemy są zwracane jako zwykłe odpowiedzi, a nie błędy, więc asystent zawsze mówi, co się stało i co proponuje, zamiast po cichu przerwać pracę. pricing_quote i availability_check odpowiadają w ten sam sposób: dostępność jest sprawdzana dla dokładnie podanych godzin, z uwzględnieniem buforów rezerwacji.
Powtórzone „tak” nie tworzy podwójnej rezerwacji. Jeśli potwierdzisz to samo zapytanie dwa razy w ciągu 30 minut (ten sam klient, daty i sprzęt), drugie wywołanie zwraca numer już utworzonego zapytania, zamiast tworzyć kolejne.
Rozmowy i komentarze
| Narzędzie | Co potrafi |
|---|---|
conversations_manage | Działania w skrzynce w imieniu zalogowanego członka zespołu. reply wysyła wiadomość do klienta na jego kanale (Telegram, Instagram, Viber, OLX lub czat na stronie). Członek zespołu staje się właścicielem rozmowy, a asystent AI przestaje w niej odpowiadać. update przekazuje rozmowę człowiekowi lub z powrotem AI (handler), zamyka ją lub otwiera ponownie (status) albo ustawia członka zespołu jako właściciela lub usuwa właściciela (assign). Podgląd pokazuje kanał, osobę, obecnego właściciela, to, czy okno odpowiedzi kanału jest nadal otwarte, i ewentualny powód odrzucenia odpowiedzi. Na rozmowę należącą do innego członka zespołu asystent odpowiada tylko wtedy, gdy poprosisz go o jej przejęcie. Wymaga uprawnienia Zezwalaj na dostęp do rozmów i połączenia zalogowanego jako członek zespołu. Klucze API organizacji nie mogą odpowiadać. |
comments_manage | add dodaje wewnętrzny komentarz do rezerwacji, klienta, egzemplarza lub zadania w imieniu zalogowanego członka zespołu (klucz API organizacji dodaje go bez autora). mentionUserIds oznacza członków zespołu z whoami, którzy dostają powiadomienie push, a parentCommentId zamienia komentarz w odpowiedź na inny komentarz w tym samym rekordzie. Klienci nigdy nie widzą tych komentarzy. |
Raporty
| Narzędzie | Na co odpowiada |
|---|---|
reports_run | Jedno narzędzie z argumentem report: revenue, bookings_summary, utilization, top_items, top_clients, outstanding, overdue, pipeline i inventory_status (egzemplarze obecnie w wynajmie). Domyślnie obejmuje ostatnie 30 dni. Wymaga dostępu do raportów. |
Na pytania, których nie obejmują standardowe raporty, na przykład przychód w poszczególnych miesiącach dla jednej wartości pola dodatkowego, asystent odpowiada za pomocą objects_query (zobacz Rekordy).
Narzędzia konfiguracji
Odczyt i sprawdzanie to osobne narzędzia niż zmiany, więc asystent może przejrzeć Twoją konfigurację, nie proponując żadnych zmian. Narzędzia odczytu działają w każdym połączeniu. Narzędzia zapisu wymagają uprawnienia Zezwalaj na dostęp do ustawień, które grupa Administratorzy ma zawsze.
| Narzędzie | Odczyt czy zapis | Co potrafi |
|---|---|---|
settings_get | Odczyt | Zwraca bieżące ustawienia jednej sekcji: organization (nazwa, opis, dane kontaktowe, język oraz pola dodatkowe na poziomie organizacji), working_hours (strefa czasowa i tygodniowy harmonogram), booking_rules (wybór dat, minimalny czas, bufory), deposits i features. |
settings_manage | Zapis | Aktualizuje jedną sekcję tylko w zmienianych polach i najpierw pokazuje różnicę przed zmianą i po niej. Sekcja organization przyjmuje też customFields. Funkcje wymagające wyższego planu są zgłaszane jako zablokowane i nie da się ich tu włączyć. |
templates_preview | Odczyt | Wyświetla szablon e-maila, wiadomości (SMS, Viber, Telegram) lub dokumentu (PDF) na danych prawdziwej rezerwacji bez zapisywania czegokolwiek: zapisany szablon po identyfikatorze albo niezapisany szkic. Zwraca temat, HTML i zwykły tekst oraz wymienia każde makro, którego organizacja nie ma. |
templates_manage | Zapis | Tworzy, aktualizuje i usuwa szablony e-maili, wiadomości i dokumentów. Podgląd sprawdza poprawność szablonu i wymienia nieznane makra. Usunięcie jest odrzucane, jeśli szablonu nadal używa automatyzacja lub inny szablon. |
workflows_validate | Odczyt | Sprawdza pełną lub częściową automatyzację bez zapisywania: zamienia identyfikatory statusów i szablonów na nazwy, sprawdza, czy identyfikatory pracowników należą do członków zespołu, czy format szablonu wiadomości pasuje do kanału, i ostrzega, gdy operator wiadomości nie jest połączony. |
workflows_manage | Zapis | Tworzy, aktualizuje, włącza lub wyłącza (set_enabled) i usuwa automatyzacje. Oprócz akcji e-mail, push i wiadomości do klienta może ustawić change_booking_status i send_group_push_notification, które wysyła powiadomienia push do grup uprawnień według groupIds. whoami podaje grupę każdego członka zespołu. |
Szablony i automatyzacje wyświetla się i odczytuje za pomocą objects_search i objects_get, tak jak każdy inny rekord.
Opinie
| Narzędzie | Co robi |
|---|---|
send_feedback | Wysyła Twoją opinię o tych narzędziach do zespołu Requiply: narzędzie, które nie zadziałało lub zwróciło błędne dane, coś, czego potrzebujesz, a czego nie potrafi żadne narzędzie, albo pochwałę. Zawiera Twoje własne słowa bez nazw klientów, adresów e-mail i numerów telefonów i niczego nie zmienia w Twojej organizacji. |
Łączenie
Dodaj Requiply do Claude z Claude Directory albo jako własny konektor lub do ChatGPT jako własny serwer MCP, zaloguj się przez OAuth jako administrator i zacznij korzystać z narzędzi.
Zastosowania
Pytania, które można zadać asystentowi połączonemu z Requiply, narzędzia MCP, które na nie odpowiadają, i skrócone przykłady tego, co zwraca każde narzędzie.