# MCP-Server SkyLink mit Claude Desktop, Cursor oder einem beliebigen MCP-Client verbinden – jeder v3.1-Endpoint als KI-Tool verfügbar. Verbinden Sie SkyLink mit einem beliebigen **Model Context Protocol (MCP)**-Client — Claude Desktop, Cursor, Cline, Windsurf und anderen — und stellen Sie den vollständigen Datenbestand von SkyLink v3.1 als Tools bereit, die Ihr Modell aufrufen kann. Es muss keine Binärdatei bereitgestellt werden. Sobald die Verbindung besteht, werden Prompts in natürlicher Sprache wie *„Wie lautet das [METAR](https://en.wikipedia.org/wiki/METAR) für KJFK?“* oder *„Schätze die Blockzeit von SFO nach JFK mit einer 737“* automatisch an die richtigen SkyLink-Endpoints weitergeleitet. Ihr Schlüssel wird als Transport-Header übergeben — niemals in Prompts eingebettet. Die MCP-Einrichtung unterscheidet sich zwischen den beiden Kanälen, wählen Sie also Ihren aus: ## Konfiguration [#configuration] Der MCP-Server von SkyLink ist ein **Streamable-HTTP-Endpoint** — `POST https://data.skylinkapi.com/mcp`, zustandslos und mit demselben `x-api-key`-Header authentifiziert wie die REST-API. Die meisten Clients erwarten eine URL und ein Header-Objekt: ```json { "mcpServers": { "skylink": { "url": "https://data.skylinkapi.com/mcp", "headers": { "x-api-key": "YOUR_API_KEY" } } } } ``` Ersetzen Sie `YOUR_API_KEY` durch den Lizenzschlüssel aus Ihrem Kauf bei [Polar](https://polar.sh) — siehe [Erste Schritte](/docs/getting-started). ### Konfigurationsfelder [#config-fields] | Feld | Wert | Beschreibung | | ------------------ | --------------------------------- | ------------------------------------------------------- | | `url` | `https://data.skylinkapi.com/mcp` | Streamable-HTTP-MCP-Endpoint | | `x-api-key`-Header | Ihr Lizenzschlüssel | Authentifiziert Tool-Aufrufe gegenüber Ihrem Kontingent | Auf dem Marktplatz wird der Server im **MCP Hub von RapidAPI** gehostet und über die stdio-Brücke `mcp-remote` erreicht. Fügen Sie den folgenden Block in die Konfigurationsdatei Ihres MCP-Clients ein und ersetzen Sie `YOUR_RAPIDAPI_KEY` durch Ihren Schlüssel aus [Erste Schritte](/docs/getting-started): ```json { "mcpServers": { "RapidAPI Hub - SkyLink API": { "command": "npx", "args": [ "mcp-remote", "https://mcp.rapidapi.com", "--header", "x-api-host: skylink-api.p.rapidapi.com", "--header", "x-api-key: YOUR_RAPIDAPI_KEY" ] } } } ``` **Wichtig:** Erfordert Node.js **18+** (für `npx mcp-remote`). Bei der ersten Verbindung wird `mcp-remote` bei Bedarf heruntergeladen. ### Konfigurationsfelder [#config-fields-1] | Feld | Wert | Beschreibung | | ------------------- | ---------------------------- | ------------------------------------------------------- | | `command` | `npx` | Startet die MCP-Remote-Brücke | | `args[1]` | `https://mcp.rapidapi.com` | Endpoint des RapidAPI MCP Hub | | `x-api-host`-Header | `skylink-api.p.rapidapi.com` | Leitet Tools an den RapidAPI-Proxy von SkyLink weiter | | `x-api-key`-Header | Ihr RapidAPI-Schlüssel | Authentifiziert Tool-Aufrufe gegenüber Ihrem Kontingent | | Client | Wo einfügen | | ---------------------- | ---------------------------------------------------------------------------------------------- | | **Claude Desktop** | Settings → Developer → Edit Config → `mcpServers` → neu starten | | **Cursor** | Settings → MCP → Add MCP Server → Manual config → neu starten | | **Andere MCP-Clients** | Speicherort der MCP-Konfigurationsdatei laut Dokumentation des Clients — gleiche JSON-Struktur | ## Antwort [#response] MCP liefert keinen einzelnen REST-JSON-Body — der Server stellt **Tools** bereit, die das Modell aufrufen kann. Jedes Tool entspricht einem SkyLink-Endpoint. Tool-Aufrufe liefern strukturiertes JSON, das mit den entsprechenden, in dieser Referenz dokumentierten REST-API-Antworten identisch ist. Tools werden **nach Ihrem Tarif gefiltert** — Sie sehen immer nur Tools, die Ihr Schlüssel aufrufen kann, sodass ein Assistent keinen Durchlauf für etwas verschwendet, das Ihr Tarif nicht umfasst: | Tarif | Sichtbare Tools | | ------------ | ------------------------ | | Basic | 46 | | Pro | 52 (+ 90-Tage-Historie) | | Ultra / Mega | 58 (+ 365-Tage-Historie) | Die Tool-Namen leiten sich von der zugrunde liegenden Operation ab, zum Beispiel `search_airport_airports_search_get` oder `ultra_flights_ultra_history_flights_get`. Rufen Sie `tools/list` auf, um genau die Tools zu sehen, die Ihr Schlüssel freischaltet. Die Anfrage eines Tools außerhalb Ihres Tarifs liefert `MCP error -32602: Tool not found` — es wird für Ihren Schlüssel gar nicht erst registriert, statt erst beim Aufruf fehlzuschlagen. ### Direkter Aufruf [#calling-directly] Ihr Client übernimmt das Protokoll, aber zum Testen: ```bash curl -X POST "https://data.skylinkapi.com/mcp" \ -H "x-api-key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -H "Accept: application/json, text/event-stream" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}' ``` Antworten sind Server-Sent Events (`event: message` / `data: {...}`). | | | | --------------------------- | --------------------------------------------------------------------------------------------------- | | `Accept`-Header | **Muss** sowohl `application/json` als auch `text/event-stream` enthalten, sonst erhalten Sie `406` | | JSON-RPC-Batching | Nicht unterstützt — senden Sie eine Anfrage pro Aufruf (`400`) | | `GET` / `DELETE` auf `/mcp` | `405 Method not allowed` | | Fehlender API-Schlüssel | `401 missing_api_key` | Repräsentative Tool-Namen, die über den Hub bereitgestellt werden: | Tool (Beispiele) | SkyLink-Funktion | | ----------------- | --------------------------------------- | | `weather.metar` | Aktuelles METAR nach ICAO | | `airports.search` | Flughafensuche nach Text/Standort | | `flight_status` | Live-Status von Gate zu Gate | | `adsb.aircraft` | Live-ADS-B-Positionen | | `carbon.estimate` | CO₂-Schätzung nach ICAO | | `ml.flight_time` | ML-Prognose der Blockzeit | | `charts` | Flugplatzkarten | | `notams` | NOTAM-Suche | | `history.flights` | Historische ADS-B-Daten (tarifabhängig) | Die genauen Tool-Namen und Parameterschemas werden nach erfolgreicher Verbindung in Ihrem MCP-Client aufgelistet. ## Client-Typen [#client-types] ## Integration [#integration] Das folgende Beispiel erstellt das MCP-Konfigurationsobjekt aus Umgebungsvariablen, sodass Sie es in Claude Desktop oder Cursor einfügen können. ### Hinweise zur Implementierung [#implementation-notes] **Umgang mit dem Schlüssel.** Speichern Sie Ihren Schlüssel im Schlüsselbund Ihres Betriebssystems oder in `.env` — die MCP-Konfiguration verweist per Header darauf, nicht inline in Chatprotokollen. **Wichtig:** Jede MCP-Anfrage wird genauso auf Ihren Tarif angerechnet wie eine direkte REST-Anfrage — einschließlich `initialize` und `tools/list`, nicht nur `tools/call`. Siehe [Rate Limits](/docs/rate-limits). **Tarifabhängige Tools.** Historische [ADS-B](https://www.faa.gov/air_traffic/technology/adsb)-Daten, Webhooks und andere Premium-Endpoints unterliegen denselben Tariflimits wie bei REST — die MCP-Schicht umgeht keine Kontingente. **Fehlerbehebung.** Wenn keine Tools erscheinen, prüfen Sie, ob der `x-api-key`-Header vorhanden ist und die URL auf `/mcp` endet, starten Sie den Client nach dem Bearbeiten der Konfiguration neu und prüfen Sie, ob die erwarteten Tools in Ihrem Tarif enthalten sind. **Fehlerbehebung.** Wenn keine Tools erscheinen, stellen Sie sicher, dass Node 18+ installiert ist, starten Sie den Client nach dem Bearbeiten der Konfiguration neu und prüfen Sie, ob sowohl der `x-api-host`- als auch der `x-api-key`-Header vorhanden sind. ## Fehlerantworten [#error-responses] Verbindungsfehler bei MCP werden in der Oberfläche des Clients angezeigt (Authentifizierungsfehler oder Beenden des Prozesses bei der stdio-Brücke). Zu HTTP-Fehlern, die in Tool-Ergebnissen zurückgegeben werden, siehe [Fehlerbehandlung](/docs/errors) — die Strukturen entsprechen der direkten REST-Nutzung. *** Siehe auch: [Erste Schritte](/docs/getting-started) · [API v3.1 – Überblick](/docs/v31/overview) · [Rate Limits](/docs/rate-limits)