Anleitung

NBNL MCP Server einbinden

Verbinde deinen KI-Assistenten mit dem NBNL-Motorradkatalog, Routenplaner und POI-Suche – ohne Scraping, ohne Umwege. Eine URL für alle Clients.

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

Schritt 1

MCP Server in Claude einbinden

Claude.ai (Web & App) — einfachster Einstieg

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

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

Claude Desktop (JSON-Config)

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

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"
      }
    }
  }
}

Nach Änderungen Claude Desktop neu starten — dann erscheinen die NBNL-Tools im Hammer-Icon.

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 (nicht nur aktuelles)
claude mcp add --transport sse nbnl https://mcp.nbnl.de/mcp/sse --scope user

Schritt 1 (alternativ)

MCP Server in anderen Clients einbinden

ChatGPT

  1. 1Öffne ChatGPT und gehe zu Settings → Connectors → Add MCP Server.
  2. 2Server-URL eintragen: https://mcp.nbnl.de/mcp/sse
  3. 3Verbinden. Für Premium: API-Key als Bearer-Token hinterlegen.

Gemini / Google AI Studio

  1. 1Öffne AI Studio und gehe zu Tools → Add tool → MCP Server.
  2. 2NBNL-Endpoint eintragen: https://mcp.nbnl.de/mcp/sse
  3. 3Speichern. Gemini nutzt die Tools dann eigenständig.

Perplexity

Perplexity unterstützt drei Verbindungsarten. Advanced JSON ist die einfachste Option.

Option 1 – Advanced JSON (empfohlen)

  1. 1Gehe zu Einstellungen → MCP Servers → Add Connector.
  2. 2Tab Advanced wählen, Server-Name „NBNL" vergeben.
  3. 3JSON eintragen: {"url": "https://mcp.nbnl.de/mcp/sse"}
  4. 4Für Premium: {"url": "...", "headers": {"Authorization": "Bearer DEIN_KEY"}}
  5. 5Save klicken.

Option 2 – Server-Sent Events (SSE)

  1. 1Tab Simple → Dropdown: Server-Sent Events.
  2. 2SSE Endpoint URL: https://mcp.nbnl.de/mcp/sse
  3. 3Für Premium: Header Authorization = Bearer DEIN_KEY hinzufügen.

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

  1. 1Tab Simple → Dropdown: Standard I/O.
  2. 2Command: npx -y mcp-remote https://mcp.nbnl.de/mcp/sse
  3. 3Node.js 18+ muss lokal installiert sein.

Cursor, Windsurf, VS Code, Zed

Clients, die nur stdio unterstützen, können mcp-remote als Bridge nutzen:

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

// Premium
// args: ["-y", "mcp-remote", "https://mcp.nbnl.de/mcp/sse",
//   "--header", "Authorization: Bearer DEIN_KEY"]

Schritt 2

Verbindung testen

Nach der Einbindung kannst du sofort loslegen. Tippe einfach in deinen KI-Assistenten:

“Welche NBNL-Tools stehen mir zur Verfügung?”

“Suche Naked Bikes von KTM unter 100 PS.”

“Was sind die technischen Daten der BMW R 1300 GS?”

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

Referenz

Alle verfügbaren Tools

Freemium-Tools sind ohne API-Key verfügbar. Premium-Tools benötigen Authorization: Bearer DEIN_KEY.

search_bikes_v2Freemium

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

Beispiel-Prompt

“Suche alle Adventure-Bikes mit mehr als 100 PS unter 15.000 €.”

get_bike_v2Freemium

Vollständiger Datensatz zu einem Modell: Spezifikationen, Preise, KBA-Zulassungen, Medien-Übersicht.

Beispiel-Prompt

“Zeige alle Daten zur BMW R 1300 GS.”

get_bike_imagesFreemium

Bilder eines Modells abrufen – inkl. Quellennachweis (Hersteller-Domain als Attribution). Free: Anzahl + Attribution ohne direkte Bild-URLs.

Beispiel-Prompt

“Zeige mir Fotos der Yamaha MT-09. Woher stammen die Bilder?”

plan_routeFreemium

Route berechnen (schnell, direkt oder kurvig). Gibt Distanz, Dauer, Höhenmeter und Kurvigkeit zurück. Free: max. 2 Wegpunkte.

Beispiel-Prompt

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

search_pois_along_routeFreemium

POIs entlang einer Route: Tankstellen, Blitzer, Camping, Pässe, Biker-Treffs, Werkstätten. Free: 1 Typ, max. 5 Ergebnisse.

Beispiel-Prompt

“Gibt es Tankstellen und Campingplätze auf der Route?”

find_nearest_poiFreemium

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

Beispiel-Prompt

“Finde den nächsten Biker-Treff bei Garmisch.”

get_weather_along_routeFreemium

Wettervorhersage entlang der Route. Free: nur aktuelle Zeit, alle 60 km.

Beispiel-Prompt

“Wie ist das Wetter morgen früh auf der Strecke?”

compare_bikes_v2Premium

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

Beispiel-Prompt

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

search_accident_posts_v2Premium

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

Beispiel-Prompt

“Zeige Unfälle aus Bayern mit Ursache Überholen aus 2024.”

get_trend_overview_v2Premium

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

Beispiel-Prompt

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

Hinweis

Bilder & Quellennachweis

Das Tool get_bike_images liefert zu jedem Bild das Feld attribution — die Domain des Originalherstellers (z. B. bmw-motorrad.com, yamaha-motor.eu). Damit kannst du Bilder mit korrektem Quellennachweis darstellen.

// Beispiel-Antwort von get_bike_images

{
  "images": [
    {
      "url": "https://nbnl.de/media/abc123.jpg",
      "media_type": "gallery",
      "source_url": "https://www.bmw-motorrad.com/...",
      "attribution": "bmw-motorrad.com"
    }
  ],
  "total": 12
}

Im Freemium-Tier ist url und source_url null — nur Anzahl und Attribution sind sichtbar. Für direkte Bild-URLs ist ein Premium-Zugang erforderlich.

Hilfe

Häufige Probleme

Tools erscheinen nicht im KI-Assistenten

Claude Desktop nach Config-Änderungen neu starten. Bei Claude.ai: Seite neu laden und Connector-Status prüfen.

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. Freemium: 60 Anfragen/Min. Premium: 240 Anfragen/Min.

Tool gibt keine Bilder zurück

Im Freemium-Tier sind url und source_url null. Die Felder total und attribution sind immer vorhanden. Für direkte Bild-URLs Premium-Key verwenden.

mcp-remote funktioniert nicht

Node.js 18+ installiert? npx -y mcp-remote https://mcp.nbnl.de/mcp/sse im Terminal testen und die Fehlerausgabe prüfen.

Mehr über den NBNL MCP Server

Alle Details zu Zugangsstufen, Rate Limits und Premium-Zugang findest du auf der MCP-Seite.

Zur MCP-Übersicht