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 Instrukcja krok po kroku

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.

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

Otwórz Ustawienia › Konektory.
Wybierz Dodaj własny konektor.
Nazwij go Transportial i wklej URL serwera.
Kliknij Połącz, zaloguj się do Transportial i zatwierdź.

ChatGPT

chatgpt.com, w trybie deweloperskim

Otwórz Ustawienia › Aplikacje i konektory i włącz tryb deweloperski w ustawieniach zaawansowanych.
Utwórz konektor z URL serwera i OAuth jako metodą uwierzytelniania.
Zaloguj się do Transportial i zatwierdź.
Wybierz konektor w nowym czacie.

Claude Code

W terminalu

Uruchom poniższe polecenie.
Uruchom Claude Code i wpisz /mcp.
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

Dodaj serwer do ~/.cursor/mcp.json lub do .cursor/mcp.json w projekcie.
Otwórz ustawienia MCP w Cursor i zaloguj się do transportial, gdy pojawi się prośba.
Zaloguj się do Transportial i zatwierdź.

Dodaj do Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "transportial": {
      "url": "https://api.app.transportial.com/mcp"
    }
  }
}

VS Code

Tryb agenta GitHub Copilot

Dodaj serwer do .vscode/mcp.json lub uruchom MCP: Add Server z palety poleceń.
Uruchom serwer i zezwól na logowanie, gdy VS Code o to poprosi.
Zaloguj się do Transportial i zatwierdź.

Dodaj do VS Code

.vscode/mcp.json

{
  "servers": {
    "transportial": {
      "type": "http",
      "url": "https://api.app.transportial.com/mcp"
    }
  }
}

Dowolny inny klient MCP

Serwery zdalne przez HTTP z OAuth

Wskaż klientowi URL serwera.
Klient sam znajduje logowanie przez standardowe wykrywanie OAuth i sam się rejestruje.
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.

Dodajesz serwer
Wklej URL serwera do swojego asystenta. Rozpozna Transportial i poprosi Cię o zalogowanie.
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.
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.
Pytasz
Wróć do asystenta i zadaj pytanie. Asystent wywołuje Transportial jako Ty i pokazuje, których narzędzi użył.

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_ordersPrzeglądanie
get_transport_orderPrzeglądanie
list_transport_order_tripsPrzeglądanie
create_transport_orderZmiana
update_transport_orderZmiana
cancel_transport_orderZmiana
search_consignmentsPrzeglądanie
get_consignmentPrzeglądanie

Tripy

Wyszukuj tripy po tekście, statusie, pojeździe, kierowcy lub dacie, czytaj pełny trip, potwierdzaj go lub anuluj.

search_tripsPrzeglądanie
get_tripPrzeglądanie
confirm_tripZmiana
cancel_tripZmiana

Pojazdy i kierowcy

Wyszukuj pojazdy i kierowców, sprawdzaj tripy pojazdu i ostatnią znaną pozycję swojej floty.

search_vehiclesPrzeglądanie
get_vehiclePrzeglądanie
list_vehicle_tripsPrzeglądanie
get_vehicle_locationsPrzeglądanie
search_chauffeursPrzeglądanie
get_chauffeurPrzeglą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_businessesPrzeglądanie
get_businessPrzeglądanie
create_businessZmiana
search_locationsPrzeglądanie
get_locationPrzeglądanie
create_locationZmiana

Wyceny i faktury

Wyszukuj faktury i wyceny w każdej administracji, twórz wycenę i wysyłaj ją klientowi.

search_administrationsPrzeglądanie
search_invoicesPrzeglądanie
get_invoicePrzeglądanie
search_quotesPrzeglądanie
get_quotePrzeglądanie
create_quoteZmiana
send_quoteZmiana

Przetargi

Sprawdzaj przetargi i ich szczegóły.

search_tendersPrzeglądanie
get_tenderPrzeglą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_alertsPrzeglądanie
solve_alertZmiana
search_eventsPrzeglądanie
send_chat_messageZmiana

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

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 Porozmawiaj z nami