Serwer MCP Requiply

Integracja AI MCP to serwer MCP Requiply, który łączy dane organizacji z asystentami AI obsługującymi Model Context Protocol (MCP). Pozwala asystentowi odpowiadać na praktyczne pytania biznesowe na podstawie aktualnego katalogu Requiply, rezerwacji, klientów, cen, dostępności, rozmów w skrzynce i raportów.

Ta strona znajduje się w Ustawienia → Integracje → AI MCP.

Adres URL serwera MCP:

https://api.requiply.com/api/mcp

Do dostępu konektorów MCP Requiply używa OAuth. Gdy obsługiwany asystent się łączy, użytkownik loguje się do Requiply i zatwierdza dostęp. Nie trzeba kopiować do adresu URL żadnego klucza API ani tajnego tokenu.

Dlaczego integracja AI jest ważna

Integracja AI daje asystentowi uporządkowany sposób pracy z Requiply, zamiast zgadywania na podstawie wyeksportowanych arkuszy czy zrzutów ekranu. Po zatwierdzeniu dostępu asystent może wywoływać narzędzia MCP Requiply, aby sprawdzić organizację, wyszukać sprzęt, sprawdzić dostępność, obliczyć wyceny, znaleźć klientów, przejrzeć rezerwacje, odpowiedzieć na pytania raportowe i pytania z filtrami, czytać rozmowy w skrzynce i na nie odpowiadać, zostawiać komentarze dla zespołu, a w przypadku użytkowników z odpowiednimi uprawnieniami także zarządzać szablonami, automatyzacjami i ustawieniami organizacji.

Typowe zastosowania:

• Pytanie, jaki sprzęt jest dostępny w danym okresie.
• Oszacowanie sumy rezerwacji przed przygotowaniem zapytania o rezerwację.
• Znalezienie klienta po e-mailu, telefonie lub nazwie.
• Przygotowanie zapytania o rezerwację dla klienta (czeka na zatwierdzenie przez pracownika).
• Przegląd szczegółów rezerwacji i statusu płatności.
• Sprawdzenie przychodu, wykorzystania sprzętu, rezerwacji po terminie, niezapłaconych sald i najlepszych klientów.
• Odpowiedzi na pytania łączące filtry, takie jak nieopłacone lipcowe rezerwacje z dronem albo przychód w poszczególnych miesiącach tego roku.
• Czytanie rozmów, które czekają na zespół, i odpowiadanie klientowi.
• Zostawienie w rezerwacji komentarza z oznaczeniem współpracownika albo przeczytanie komentarzy, w których oznaczono Ciebie.
• Odczyt i uzupełnianie własnych pól dodatkowych rezerwacji, klientów i pozycji.
• Napisanie lub poprawienie szablonu e-maila, wiadomości lub dokumentu z prawidłowymi makrami.
• Konfiguracja automatyzacji, takiej jak przypomnienie o wydaniu albo e-mail z potwierdzeniem.
• Zmiana godzin pracy, zasad kaucji lub buforów rezerwacji.
• Sprawdzenie, jak coś działa w Requiply, z linkami do tej bazy wiedzy.

Każdy rekord, o którym wspomina asystent, ma link, który otwiera go w Requiply, więc z odpowiedzi przechodzisz prosto do rezerwacji, klienta lub rozmowy.

Czym jest MCP w Requiply

MCP to warstwa protokołu, która pozwala asystentom AI używać Requiply jako połączonego źródła narzędzi. Zamiast tylko czytać statyczną stronę, asystent może pobierać uporządkowany JSON z narzędzi Requiply i wykorzystywać te wyniki w odpowiedzi.

Dostęp jest ograniczony do uwierzytelnionego konta Requiply i organizacji. Połączenie może zatwierdzić tylko użytkownik z rolą Administrator (grupa uprawnień Administratorzy), a ta grupa zawsze ma wszystkie uprawnienia dostępu, więc połączony asystent może korzystać ze wszystkich poniższych narzędzi. Wyjątkiem są uprawnienia z sekcji Tworzenie rezerwacji i Komunikacja, które można wyłączyć dla Administratorów: gdy uprawnienie Zezwalaj na rezerwacje poza godzinami pracy jest wyłączone dla grupy, asystent również nie może utworzyć zapytania o rezerwację poza godzinami pracy. Klucze API organizacji działają w imieniu całej organizacji.

Rozmowy są dostępne tylko wtedy, gdy włączona jest funkcja skrzynki rozmów, a odpowiadać na nie lub je przejmować może tylko połączenie zalogowane jako członek zespołu, ponieważ odpowiedź jest wysyłana w imieniu tego członka zespołu.

Każde narzędzie służy albo tylko do odczytu, albo do zapisu, nigdy do obu. Narzędzia tylko do odczytu (whoami, describe, get_guidance, get_profile, objects_search, objects_get, objects_query, availability_check, pricing_quote, reports_run, settings_get, templates_preview, workflows_validate, search_help) nigdy niczego nie zmieniają, więc asystent może je wywoływać bez ograniczeń. Narzędzia, które zmieniają dane organizacji, zawsze najpierw pokazują podgląd.

Co warto wiedzieć

• Wyniki narzędzi są zwracane jako uporządkowany JSON, więc asystent może je podsumowywać, porównywać, filtrować i łączyć.
• Każdy rekord, o którym wspomina asystent, zawiera url, który otwiera go w Requiply.
• Zapis zawsze zaczyna się od podglądu, a zmiany są zapisywane dopiero wtedy, gdy asystent powtórzy wywołanie z confirmed=true po Twojej akceptacji. Podgląd zawiera dokładne wartości albo różnicę przed zmianą i po niej, która zostanie zapisana.
• Usuwać można tylko szablony i automatyzacje, a szablonu, którego nadal używa automatyzacja lub inny szablon, nie da się usunąć. Kategorie, oddziały i usługi nigdy nie są usuwane przez asystenta. Usługi są zamiast tego archiwizowane.
• Zapytanie o rezerwację utworzone przez asystenta trafia do statusu ustawionego w Status zapytań o rezerwację i czeka na zatwierdzenie przez pracownika. Zatwierdzenie ponownie sprawdza dostępność, pobiera płatność i blokuje sprzęt. Do tego czasu zapytanie nie robi żadnej z tych rzeczy.
• To, co asystent może zobaczyć i zmienić, zależy od uprawnień łączącego się konta. whoami pokazuje macierz dostępu, a asystent ma polecenie wyjaśnić brakujące uprawnienie, zamiast próbować wprowadzić zmianę.
• Integracja AI działa na danych organizacji dostępnych dla uwierzytelnionego konta Requiply.
• Adres URL MCP nie zawiera klucza tajnego. Uwierzytelnianie odbywa się przez logowanie OAuth i zatwierdzenie dostępu.

Więcej o MCP Requiply

• Łączenie asystenta: dodanie Requiply do Claude lub ChatGPT przez OAuth krok po kroku.
• Narzędzia MCP: wszystkie narzędzia, rekordy, które odczytują i zmieniają, oraz uprawnienia, których wymagają.
• Zastosowania: pytania, które warto zadać, i JSON zwracany przez narzędzia.
• Rozwiązywanie problemów: błędy logowania, odrzucone zmiany i narzędzia, które się nie pojawiają.