Serwer MCP — podłącz AI do swoich tras

Waydo udostępnia serwer MCP (Model Context Protocol) — standard, dzięki któremu asystenci AI (np. Claude) mogą bezpiecznie korzystać z zewnętrznych narzędzi. Po podłączeniu AI może czytać i edytować Twoje zapisane trasy: przeglądać dni i przystanki, wyszukiwać miejsca, dodawać, usuwać i przestawiać przystanki.

Wymagania

Integracja MCP jest częścią planu Premium. Narzędzia operują na zapisanych trasach („Moje trasy" w aplikacji) — po zmianach wczytaj trasę ponownie, aby zobaczyć efekt.

Krok 1 — wygeneruj klucz API

1. Zaloguj się na waydo.app i otwórz menu użytkownika → Konto i subskrypcja.
2. Przejdź na zakładkę Subskrypcja → sekcja Klucz API (MCP).
3. Kliknij Wygeneruj klucz i skopiuj go od razu — klucz (format wd_…) jest pokazywany tylko raz. W każdej chwili możesz wygenerować nowy (stary przestaje działać) lub usunąć klucz.

Traktuj klucz jak hasło

Każdy, kto zna Twój klucz, może czytać i modyfikować Twoje zapisane trasy. W razie wycieku natychmiast wygeneruj nowy lub usuń klucz w aplikacji.

Krok 2 — podłącz klienta MCP

Endpoint: https://waydo.app/api/mcp (streamable HTTP). Autoryzacja nagłówkiem Authorization: Bearer <klucz>.

Claude Code

Dodaj do .mcp.json w projekcie (albo przez claude mcp add):

{
  "mcpServers": {
    "waydo": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://waydo.app/api/mcp",
        "--header", "Authorization:Bearer ${WAYDO_API_KEY}"
      ],
      "env": { "WAYDO_API_KEY": "wd_TWOJ_KLUCZ" }
    }
  }
}

Bezpieczniej: zamiast wpisywać klucz do pliku, trzymaj go w zmiennej środowiskowej lub menedżerze sekretów i podstawiaj przez env.

Claude Desktop

W claude_desktop_config.json (Ustawienia → Developer → Edit Config):

{
  "mcpServers": {
    "waydo": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://waydo.app/api/mcp",
        "--header", "Authorization:Bearer wd_TWOJ_KLUCZ"
      ]
    }
  }
}

Po restarcie klienta narzędzia Waydo pojawią się automatycznie.

Dostępne narzędzia

Narzędzie	Opis
list_trips	Lista Twoich zapisanych tras (id, nazwa, liczba dni i przystanków)
get_trip	Pełny plan trasy: dni, przystanki (pozycje, adresy, współrzędne), odcinki z trybem podróży, dystansem i czasem
search_places	Wyszukiwanie miejsc po nazwie (Google Places) — zwraca place_id do użycia w add_stop
add_stop	Dodanie przystanku do dnia (na końcu lub na wskazanej pozycji)
remove_stop	Usunięcie przystanku ze wskazanej pozycji
move_stop	Zmiana kolejności przystanków w obrębie dnia
set_travel_mode	Ustawienie trybu podróży odcinka (auto / pieszo / lot / prom) — nowe odcinki po edycjach domyślnie są „autem"

Przykładowe polecenia dla asystenta:

„Pokaż moją trasę Majówka i zaproponuj, co zwiedzić po drodze."

„Dodaj Sandomierz na koniec pierwszego dnia trasy Majówka."

„Przenieś Kazimierz Dolny przed Lublin w dniu drugim."

Zasady i ograniczenia

• Pozycje przystanków są 1-based (pierwszy przystanek = 1).
• Pierwszy przystanek dnia 2+ to lustrzane odbicie ostatniego przystanku dnia poprzedniego — nie można go usunąć, przesunąć ani wstawić niczego przed nim. Zmiana ostatniego przystanku dnia automatycznie aktualizuje pierwszy przystanek dnia następnego (tak samo jak w aplikacji).
• Po edycji przystanków trasy i dystanse przeliczają się przy następnym otwarciu trasy w aplikacji.
• Limit: 120 żądań na minutę.
• Klucz działa tylko przy aktywnej subskrypcji Premium — po jej wygaśnięciu żądania zwracają 403.