MCP Server

NBNL für KI-Assistenten

Motorradkatalog, Routing, POI-Suche und Wetter – direkt in Claude, ChatGPT, Gemini und mehr.

1 — Überblick

Was bietet der NBNL MCP Server?

Der NBNL MCP Server verbindet deinen KI-Assistenten mit dem Motorradkatalog, dem Routenplaner, POI-Suche, Wettervorhersagen und Trenddaten – ohne Scraping, ohne Umwege. Eine einzige URL, direkt in Claude, ChatGPT, Gemini oder jedem anderen MCP-Client nutzbar.

Endpoint

https://mcp.nbnl.de/mcp/sse

Transport

Server-Sent Events (SSE) · MCP 2024-11

🏍️

Motorradkatalog

Marken, Modelle, technische Daten, Vergleiche

🗺️

Routing & POIs

Routen planen, Tankstellen, Pässe, Campingplätze

🌤️

Wetter & Trends

Wetter entlang der Route, Marktrends

2 — Funktionen

Welche Funktionen bietet NBNL?

Alle Tools sind über denselben Endpoint erreichbar. Freemium-Tools stehen ohne Authentifizierung zur Verfügung, Premium-Tools benötigen einen API-Key.

search_bikes_v2Freemium

Motorräder nach Marke, Kategorie, Baujahr, PS-Bereich oder Stichwort suchen.

get_bike_v2Freemium

Einzelnes Motorradmodell abrufen – mit Quartett-Daten, technischen Daten und Medien.

get_bike_imagesFreemium

Alle Bilder eines Modells abrufen – mit gehostetem NBNL-URL, Medientyp und Quellennachweis (Hersteller-Domain als Attribution). Free: Bilder ohne direkte URLs, nur Anzahl und Attribution.

plan_routeFreemium

Route von A nach B berechnen – schnell, direkt oder kurvig. Gibt Distanz, Dauer, Höhenmeter und Kurvigkeit zurück. Free: max. 2 Wegpunkte, kein Kurvig-Modus.

search_pois_along_routeFreemium

Tankstellen, Blitzer, Campingplätze, Pässe, Biker-Treffs und Werkstätten entlang der Route. Free: max. 1 POI-Typ, max. 5 Ergebnisse.

find_nearest_poiFreemium

Nächste POIs zu einem Standort finden. Free: max. 10 km Radius, 3 Ergebnisse.

get_weather_along_routeFreemium

Wettervorhersage entlang der Route – Temperatur, Wind, Niederschlag. Free: nur aktuelle Zeit, Messpunkt alle 60 km.

compare_bikes_v2Premium

Bis zu 10 Modelle in einer Anfrage vergleichen – Leistung, Gewicht, Hubraum, Preis.

search_accident_posts_v2Premium

Gemeldete Motorradunfälle nach Stichwort, Jahr, Ursache, Typ oder Schweregrad durchsuchen.

get_trend_overview_v2Premium

Trendanalyse: beliebteste Marken und Kategorien der letzten N Tage (max. 365).

Beispiel-Prompts für KI-Assistenten

Sobald der MCP Server verbunden ist, kannst du diese Fragen direkt stellen:

Freemium

Zeige mir alle Naked Bikes von KTM unter 100 PS.

Freemium

Was sind die technischen Daten der BMW R 1300 GS?

Freemium

Plane eine Route von München nach Innsbruck ohne Autobahn.

Freemium

Gibt es Tankstellen und Blitzer auf der Route? Zeige alles in 5 km Umkreis.

Freemium

Wie ist das Wetter auf der Strecke morgen früh um 9 Uhr?

Freemium

Finde den nächsten Campingplatz bei Garmisch.

Freemium

Zeige mir Fotos der Yamaha MT-09 – woher stammen die Bilder?

Premium

Vergleiche Honda Africa Twin, BMW R 1300 GS und KTM 1290 Super Adventure direkt.

Premium

Welche Motorradmarken waren in den letzten 30 Tagen am häufigsten gesucht?

Premium

Zeige Motorradunfälle aus Bayern mit Ursache Überholen aus 2024.

3 — Zugangsstufen

Was bietet der Premium Zugang?

Beide Profile nutzen denselben Endpoint. Der Unterschied liegt ausschließlich in der Authentifizierung.

FreemiumFreemium

Kein API-Key erforderlich

  • Tools7 Tools (Katalog + Routing)
  • Ergebnissemax. 10 pro Anfrage
  • Routing – Wegpunktemax. 2 (nur A→B)
  • Routing – Kurvig / Avoidnicht verfügbar
  • POI-Suche1 Typ, max. 5 Ergebnisse
  • Nächste POImax. 10 km Radius, 3 Treffer
  • Wetternur aktuelle Zeit, alle 60 km
  • Modellvergleichnicht verfügbar
  • Trenddatennicht verfügbar
  • Rate Limit60 Anfragen / Min · Burst 10
PremiumPremium

Authorization: Bearer API_KEY oder X-API-Key: API_KEY

  • ToolsAlle 10 Tools
  • Ergebnissemax. 50 pro Anfrage
  • Routing – Wegpunktemax. 8 (via C, D …)
  • Routing – Kurvig / Avoidverfügbar
  • POI-Suchealle Typen, unbegrenzt
  • Nächste POIfreier Radius, 5 Treffer
  • Wetterfrei wählbare Abfahrtszeit, alle 30 km
  • Modellvergleichbis zu 10 Modelle
  • Trenddatenbis 365 Tage
  • Rate Limit240 Anfragen / Min · Burst 30

4 — Einbindung

Wie verwende ich den MCP von NBNL?

Der NBNL MCP Server nutzt Server-Sent Events (SSE) – eine einzige URL genügt für alle Clients.

Mit Claude

Claude.ai (Web & App) — einfachster Einstieg

  1. Öffne claude.ai im Browser oder in der Claude-App
  2. Gehe zu Settings → Connectors
  3. Klicke auf Add custom connector
  4. Server-URL eintragen: https://mcp.nbnl.de/mcp/sse
  5. Namen vergeben, z. B. „NBNL", und auf Connect klicken

Für Premium: API-Key beim Hinzufügen als Bearer-Token hinterlegen.

Claude Desktop (JSON-Config)

Freemium

{
  "mcpServers": {
    "nbnl": {
      "url": "https://mcp.nbnl.de/mcp/sse",
      "type": "sse"
    }
  }
}

Premium (mit API-Key)

{
  "mcpServers": {
    "nbnl": {
      "url": "https://mcp.nbnl.de/mcp/sse",
      "type": "sse",
      "headers": {
        "Authorization": "Bearer DEIN_KEY"
      }
    }
  }
}

Config-Pfad: macOS ~/Library/Application Support/Claude/claude_desktop_config.json · Windows %APPDATA%\Claude\claude_desktop_config.json

Claude Code (CLI)

# Freemium
claude mcp add --transport sse nbnl https://mcp.nbnl.de/mcp/sse

# Premium
claude mcp add --transport sse nbnl https://mcp.nbnl.de/mcp/sse \
  --header "Authorization: Bearer DEIN_KEY"

# Für alle Projekte verfügbar machen
claude mcp add --transport sse nbnl https://mcp.nbnl.de/mcp/sse --scope user

Mit ChatGPT

ChatGPT unterstützt MCP-Server direkt über Settings → Connectors → Add MCP Server. Server-URL eintragen und verbinden – fertig.

Server-URL: https://mcp.nbnl.de/mcp/sse

# Premium: API-Key als Header hinterlegen
Authorization: Bearer DEIN_KEY

Alternativ über eigene GPTs: Explore GPTs → Create → Actions – dort den Endpoint eintragen und den API-Key unter Authentication als Header hinterlegen.

Mit Gemini / Google AI Studio

In Google AI Studio unter Tools → Add tool → MCP Server den NBNL-Endpoint eintragen. Gemini ruft die Tools dann eigenständig auf – Motorradsuche, Routing und POIs stehen direkt zur Verfügung.

Server-URL: https://mcp.nbnl.de/mcp/sse

# Premium: API-Key als Authorization-Header eintragen
Authorization: Bearer DEIN_KEY

Mit Perplexity

Perplexity unterstützt MCP-Server über drei Verbindungsarten. Die einfachste ist Advanced JSON.

Option 1 – Advanced JSON (empfohlen)

  1. Öffne Perplexity und gehe zu Einstellungen → MCP Servers.
  2. Klicke auf Add Connector, dann auf den Tab Advanced.
  3. Server-Name vergeben (z. B. „NBNL") und folgendes JSON eintragen:

Freemium

{
  "url": "https://mcp.nbnl.de/mcp/sse"
}

Premium (mit API-Key)

{
  "url": "https://mcp.nbnl.de/mcp/sse",
  "headers": {
    "Authorization": "Bearer DEIN_KEY"
  }
}

Option 2 – Server-Sent Events (SSE)

  1. Tab Simple wählen, im Dropdown Server-Sent Events auswählen.
  2. SSE Endpoint URL: https://mcp.nbnl.de/mcp/sse
  3. Für Premium: Header AuthorizationBearer DEIN_KEY hinzufügen.

Option 3 – Standard I/O (via mcp-remote)

  1. Tab Simple wählen, im Dropdown Standard I/O auswählen.
  2. Command eintragen:
# Freemium
npx -y mcp-remote https://mcp.nbnl.de/mcp/sse

# Premium (als Command mit Header-Argument)
npx -y mcp-remote https://mcp.nbnl.de/mcp/sse --header "Authorization: Bearer DEIN_KEY"

Node.js 18+ muss lokal installiert sein, damit npx den mcp-remote-Bridge starten kann.

Mit anderen MCP-Clients (Cursor, Windsurf, VS Code, Zed …)

Der NBNL MCP Server ist mit jedem SSE-kompatiblen MCP-Client nutzbar. Falls der Client nur stdio unterstützt, kann mcp-remote als Bridge genutzt werden:

{
  "mcpServers": {
    "nbnl": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.nbnl.de/mcp/sse"]
    }
  }
}

Premium mit mcp-remote: npx -y mcp-remote https://mcp.nbnl.de/mcp/sse --header "Authorization: Bearer DEIN_KEY"

Häufige Probleme

  • Tools erscheinen nicht? — Claude Desktop nach Config-Änderungen neu starten.
  • 401 Unauthorized? — API-Key prüfen. Beide Header funktionieren: Authorization: Bearer KEY und X-API-Key: KEY.
  • Rate Limit erreicht? — Response-Header X-RateLimit-Remaining und X-RateLimit-Reset prüfen.