[Home](/pl)›[Developer Hub](/pl/developers)›Serwer MCP Serwer MCP · OAuth 2.1 # Twój TMS wewnątrz asystenta AI, którego już używasz Transportial obsługuje Model Context Protocol. Połącz raz Claude, ChatGPT, Cursor lub VS Code, zaloguj się i pytaj zwykłym językiem o tripy, zlecenia, pojazdy i faktury. Asystent działa jako Ty: widzi to, co Ty możesz zobaczyć, i zmienia tylko to, na co pozwolisz. [Połącz swojego asystenta](#connect)[Instrukcja krok po kroku](/pl/help/connected-apps) ClaudeChatGPTClaude CodeCursorVS CodeOAuth 2.1 Asystent AI · Transportial połączony Które tripy są dziś opóźnione i gdzie są teraz te ciężarówki? search\_trips trwające tripy, posortowane według opóźnienia get\_vehicle\_locations ostatnia pozycja 3 pojazdów Trzy tripy są opóźnione: * T-1042 Rotterdam → Lyon, 45 min opóźnienia. Ciężarówka w okolicy Reims, następny postój: rozładunek w Lyonie. * T-1057 Venlo → Duisburg, 20 min opóźnienia. Czeka przy rampie załadunkowej w Venlo. * T-1063 Antwerpia → Gandawa, 15 min opóźnienia. Na E17, przyjazd 14:25. URL serwera MCP`https://api.app.transportial.com/mcp` MCP to otwarty standard, który pozwala asystentom AI korzystać z innego oprogramowania. Dzięki serwerowi MCP Transportial Twój asystent może wyszukiwać tripy, zlecenia, pojazdy, kierowców, klientów, wyceny i faktury, a jeśli na to pozwolisz, także je tworzyć i zmieniać. Bez eksportów i kopiowania między oknami: pytasz, asystent wykonuje pracę w Transportial i mówi Ci, co zrobił. ## Połącz w dwie minuty Dodaj URL serwera do swojego asystenta. Przy pierwszym połączeniu otworzy się okno Transportial, w którym się logujesz i zatwierdzasz połączenie. ### Claude claude.ai i aplikacja desktopowa Claude 1. Otwórz Ustawienia › Konektory. 2. Wybierz Dodaj własny konektor. 3. Nazwij go Transportial i wklej URL serwera. 4. Kliknij Połącz, zaloguj się do Transportial i zatwierdź. ### ChatGPT chatgpt.com, w trybie deweloperskim 1. Otwórz Ustawienia › Aplikacje i konektory i włącz tryb deweloperski w ustawieniach zaawansowanych. 2. Utwórz konektor z URL serwera i OAuth jako metodą uwierzytelniania. 3. Zaloguj się do Transportial i zatwierdź. 4. Wybierz konektor w nowym czacie. ### Claude Code W terminalu 1. Uruchom poniższe polecenie. 2. Uruchom Claude Code i wpisz /mcp. 3. Wybierz transportial, potem Authenticate, i zaloguj się w przeglądarce. Terminal ``` claude mcp add --transport http transportial https://api.app.transportial.com/mcp ``` ### Cursor Globalnie lub dla projektu 1. Dodaj serwer do \~/.cursor/mcp.json lub do .cursor/mcp.json w projekcie. 2. Otwórz ustawienia MCP w Cursor i zaloguj się do transportial, gdy pojawi się prośba. 3. Zaloguj się do Transportial i zatwierdź. [Dodaj do Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=transportial&config=eyJ1cmwiOiJodHRwczovL2FwaS5hcHAudHJhbnNwb3J0aWFsLmNvbS9tY3AifQ%3D%3D) \~/.cursor/mcp.json ``` { "mcpServers": { "transportial": { "url": "https://api.app.transportial.com/mcp" } } } ``` ### VS Code Tryb agenta GitHub Copilot 1. Dodaj serwer do .vscode/mcp.json lub uruchom MCP: Add Server z palety poleceń. 2. Uruchom serwer i zezwól na logowanie, gdy VS Code o to poprosi. 3. Zaloguj się do Transportial i zatwierdź. [Dodaj do VS Code](vscode:mcp/install?%7B%22name%22%3A%22transportial%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fapi.app.transportial.com%2Fmcp%22%7D) .vscode/mcp.json ``` { "servers": { "transportial": { "type": "http", "url": "https://api.app.transportial.com/mcp" } } } ``` ### Dowolny inny klient MCP Serwery zdalne przez HTTP z OAuth 1. Wskaż klientowi URL serwera. 2. Klient sam znajduje logowanie przez standardowe wykrywanie OAuth i sam się rejestruje. 3. Zaloguj się do Transportial i zatwierdź. Nazwy menu mogą się nieco różnić między wersjami i planami poszczególnych asystentów. W planach zespołowych i enterprise właściciel może najpierw musieć dodać konektor dla organizacji. ## Co się dzieje podczas łączenia Na każdym etapie zachowujesz kontrolę. Nic nie jest udostępniane, dopóki nie zatwierdzisz tego w samym Transportial. 1. ### Dodajesz serwer Wklej URL serwera do swojego asystenta. Rozpozna Transportial i poprosi Cię o zalogowanie. 2. ### Logujesz się do Transportial Otwiera się okno przeglądarki z Transportial. Zaloguj się jak zawsze, także z uwierzytelnianiem dwuskładnikowym lub single sign-on. 3. ### Wybierasz platformę i dostęp Wybierz platformę, w której asystent może pracować, oraz czy może tylko przeglądać dane, czy także je tworzyć, zmieniać i usuwać. Następnie kliknij Zezwól. 4. ### Pytasz Wróć do asystenta i zadaj pytanie. Asystent wywołuje Transportial jako Ty i pokazuje, których narzędzi użył. ### Połącz Claude Claude chce pracować w Transportial w Twoim imieniu (ty@twojafirma.pl). Może robić tylko to, co Ty, w zakresie dostępu wybranym poniżej. Po podjęciu decyzji wrócisz do claude.ai. Nazwę aplikacji podaje sama aplikacja. Łącz tylko aplikację, której połączenie sam rozpocząłeś i której ufasz. Platforma Twoja firma Twoja firma UK (niewłączona) Dostęp Przeglądanie danych Tworzenie, zmiana i usuwanie danych OdmówZezwól Ekran zatwierdzania w Transportial. Nie można wybrać platform, na których połączone aplikacje nie są włączone. ## Co może Twój asystent 37 dedykowanych narzędzi obejmuje najczęstsze pytania i zadania. Trzy narzędzia ogólne sięgają do reszty API Transportial, ponad 800 operacji, więc asystent nie utknie na końcu listy. ### Zlecenia i przesyłki Wyszukuj, czytaj, twórz, aktualizuj i anuluj zlecenia transportowe oraz sprawdzaj ich przesyłki i tripy. * `search_transport_orders`Przeglądanie * `get_transport_order`Przeglądanie * `list_transport_order_trips`Przeglądanie * `create_transport_order`Zmiana * `update_transport_order`Zmiana * `cancel_transport_order`Zmiana * `search_consignments`Przeglądanie * `get_consignment`Przeglądanie ### Tripy Wyszukuj tripy po tekście, statusie, pojeździe, kierowcy lub dacie, czytaj pełny trip, potwierdzaj go lub anuluj. * `search_trips`Przeglądanie * `get_trip`Przeglądanie * `confirm_trip`Zmiana * `cancel_trip`Zmiana ### Pojazdy i kierowcy Wyszukuj pojazdy i kierowców, sprawdzaj tripy pojazdu i ostatnią znaną pozycję swojej floty. * `search_vehicles`Przeglądanie * `get_vehicle`Przeglądanie * `list_vehicle_trips`Przeglądanie * `get_vehicle_locations`Przeglądanie * `search_chauffeurs`Przeglądanie * `get_chauffeur`Przeglądanie ### Klienci i adresy Wyszukuj klientów, przewoźników i inne relacje biznesowe oraz adresy w książce adresowej. W razie potrzeby twórz nowe. * `search_businesses`Przeglądanie * `get_business`Przeglądanie * `create_business`Zmiana * `search_locations`Przeglądanie * `get_location`Przeglądanie * `create_location`Zmiana ### Wyceny i faktury Wyszukuj faktury i wyceny w każdej administracji, twórz wycenę i wysyłaj ją klientowi. * `search_administrations`Przeglądanie * `search_invoices`Przeglądanie * `get_invoice`Przeglądanie * `search_quotes`Przeglądanie * `get_quote`Przeglądanie * `create_quote`Zmiana * `send_quote`Zmiana ### Przetargi Sprawdzaj przetargi i ich szczegóły. * `search_tenders`Przeglądanie * `get_tender`Przeglądanie ### Alerty, zdarzenia i czat Czytaj otwarte alerty planowania i realizacji i rozwiązuj je, wyszukuj zdarzenia i wysyłaj wiadomości na czacie. * `list_alerts`Przeglądanie * `solve_alert`Zmiana * `search_events`Przeglądanie * `send_chat_message`Zmiana ### Wszystko inne Przeszukuj pełne API, czytaj, jak działa operacja, i wywołuj ją jako zalogowany użytkownik na jego platformie. * `search_operations` * `describe_operation` * `call_operation` ## O co zapytać Pytaj tak, jak zapytałbyś kolegę z pracy. Asystent sam wybierze właściwe narzędzia. * “Które tripy są dziś opóźnione i kto je prowadzi?” * “Gdzie jest teraz ciężarówka 12-BXL-4 i jaki jest jej następny postój?” * “Utwórz zlecenie transportowe: 12 palet z Rotterdamu do Lyonu, załadunek we wtorek o 08:00.” * “Które faktury tego klienta są nadal otwarte i jaka jest ich suma?” * “Przygotuj wycenę na całopojazdowy transport z Venlo do Mediolanu i wyślij ją klientowi.” * “Podsumuj dzisiejsze otwarte alerty i rozwiąż te, które zostały już załatwione.” * “Wyślij kierowcy tripu T-1042 wiadomość, że rampa rozładunkowa zmieniła się na 7.” * “Które z naszych pojazdów nie mają jutro zaplanowanych tripów?” ## Bezpieczny z założenia Asystent dostaje dokładnie taki dostęp, jaki mu dasz, i w każdej chwili możesz go odebrać. * Działa jako Ty Każde wywołanie jest wykonywane jako zalogowany użytkownik, z jego rolą i uprawnieniami. Asystent nigdy nie zrobi więcej niż Ty sam. * Tylko odczyt lub pełny dostęp Przyznaj tylko Przeglądanie danych, a połączenie będzie tylko do odczytu na każdym poziomie: narzędzia zmieniające dane znikają, a Transportial odrzuca zmiany. * Jedna platforma na połączenie Połączenie sięga tylko do platformy wybranej podczas zatwierdzania, nawet jeśli pracujesz w kilku. * Rozłącz w dowolnym momencie Ustawienia › Bezpieczeństwo › Połączone aplikacje pokazuje każdego asystenta z jego platformą, dostępem i datą ostatniego użycia. Rozłączenie natychmiast kończy jego dostęp. * Standardowy OAuth 2.1 Logowanie z PKCE, tokeny dostępu ważne godzinę i tokeny odświeżania zmieniane przy każdym użyciu. Ponowne użycie starego tokenu odświeżania kończy całe połączenie. * Włączane per platforma Połączone aplikacje są włączane dla każdej platformy osobno. Jeśli Twoja nie jest jeszcze włączona, ekran zatwierdzania o tym poinformuje. Poproś administratora lub skontaktuj się z nami, aby to włączyć. ## Szczegóły techniczne Dla deweloperów łączących klienta lub budujących własnego agenta. Serwer jest zgodny ze specyfikacją MCP i standardami OAuth, na których się opiera. [Developer Hub](/pl/developers) Endpoint POST https://api.app.transportial.com/mcp Transport Streamable HTTP z odpowiedziami JSON. Bezstanowy, bez strumienia server-sent events. Wersje protokołu 2025-11-25, 2025-06-18 i 2025-03-26. Wykrywanie /.well-known/oauth-protected-resource (RFC 9728) i /.well-known/oauth-authorization-server (RFC 8414). Rejestracja klienta Dynamiczna rejestracja klienta (RFC 7591) pod /oauth/register. Adresy przekierowań HTTPS, loopback i schematy aplikacji. Autoryzacja Authorization code z PKCE (tylko S256). Tokeny są powiązane z serwerem MCP jako ich odbiorcą (audience). Zakresy read i write. Token bez write może wywoływać tylko operacje get, search i exists. Czas życia Token dostępu 1 godzina, token odświeżania 30 dni, rotowany przy każdym użyciu. Agenci bez użytkownika Utwórz integrację dostępu do API i użyj jej klucza i sekretu z grantem client\_credentials. Token ma uprawnienia integracji. Limity Wywołanie narzędzia przekracza limit czasu po 120 sekundach. Bardzo długie wyniki są obcinane ze wskazówką, by poprosić o mniej wyników. ## Najczęściej zadawane pytania ### Czym jest MCP? Model Context Protocol to otwarty standard, który pozwala asystentom AI łączyć się z innym oprogramowaniem za pomocą narzędzi. Obsługują go Claude, ChatGPT, Cursor, VS Code i wielu innych asystentów. ### Których asystentów AI mogę połączyć? Każdego asystenta obsługującego zdalne serwery MCP przez HTTP z logowaniem OAuth, np. Claude, ChatGPT w trybie deweloperskim, Claude Code, Cursor i VS Code z GitHub Copilot. ### Czy asystent widzi wszystkie nasze dane? Widzi to, co widzi zalogowany użytkownik na jednej platformie wybranej podczas zatwierdzania, i nic więcej. Uprawnienia roli obowiązują przy każdym wywołaniu. ### Czy asystent może zmieniać lub usuwać dane? Tylko jeśli przyznasz Tworzenie, zmianę i usuwanie danych. Przy samym Przeglądaniu danych każda zmiana jest odrzucana. ### Jak rozłączyć asystenta? Otwórz Ustawienia › Bezpieczeństwo, znajdź go w sekcji Połączone aplikacje i kliknij Rozłącz. Jego dostęp kończy się natychmiast. ### Czy możemy połączyć własnego agenta AI? Tak. Agent działający w imieniu osoby loguje się przez OAuth jak każdy inny klient. Agent działający samodzielnie używa klucza i sekretu integracji dostępu do API. ### Dlaczego ekran zatwierdzania informuje, że połączone aplikacje nie są włączone? Połączone aplikacje są włączane dla każdej platformy osobno. Poproś administratora lub skontaktuj się z Transportial, aby je włączyć dla Twojej platformy. ## Wprowadź Transportial do swojego asystenta Dodaj URL serwera, zaloguj się i zadaj pierwsze pytanie. [Przeczytaj instrukcję krok po kroku](/pl/help/connected-apps)[Porozmawiaj z nami](/pl/contact) --- Canonical page: https://transportial.com/pl/mcp