Luftfahrt-MCP-Server — Einrichtung & Tools (v3.1)

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

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:

{
  "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 — siehe Erste Schritte.

Konfigurationsfelder

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

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

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 <name> not found — es wird für Ihren Schlüssel gar nicht erst registriert, statt erst beim Aufruf fehlzuschlagen.

Direkter Aufruf

Ihr Client übernimmt das Protokoll, aber zum Testen:

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`

Die genauen Tool-Namen und Parameterschemas werden nach erfolgreicher Verbindung in Ihrem MCP-Client aufgelistet.

Client-Typen

"""MCP client configuration models."""from __future__ import annotationsfrom dataclasses import dataclass@dataclassclass McpHttpServerEntry:    """Direct API: a streamable HTTP endpoint authenticated by header."""    url: str    headers: dict[str, str]@dataclassclass McpBridgeServerEntry:    """RapidAPI marketplace: the `mcp-remote` stdio bridge."""    command: str    args: list[str]McpServerEntry = McpHttpServerEntry | McpBridgeServerEntry@dataclassclass McpClientConfig:    mcp_servers: dict[str, McpServerEntry]

Integration

Das folgende Beispiel erstellt das MCP-Konfigurationsobjekt aus Umgebungsvariablen, sodass Sie es in Claude Desktop oder Cursor einfügen können.

import osMCP_URL = "https://data.skylinkapi.com/mcp"def build_mcp_config(api_key: str | None = None) -> dict:    """Build the MCP client config block for the SkyLink direct API."""    key = api_key or os.getenv("SKYLINK_API_KEY", "YOUR_API_KEY")    return {        "mcpServers": {            "skylink": {                "url": MCP_URL,                "headers": {"x-api-key": key},            }        }    }if __name__ == "__main__":    import json    print(json.dumps(build_mcp_config(), indent=2))

Hinweise zur Implementierung

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.

Tarifabhängige Tools. Historische ADS-B-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.

Fehlerantworten

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 — die Strukturen entsprechen der direkten REST-Nutzung.

Siehe auch: Erste Schritte · API v3.1 – Überblick · Rate Limits

MCP-Server