Авиационный MCP-сервер — настройка и инструменты (v3.1)

Подключите SkyLink к любому клиенту Model Context Protocol (MCP) — Claude Desktop, Cursor, Cline, Windsurf и другим — и откройте весь набор данных SkyLink v3.1 в виде инструментов, которые может вызывать ваша модель. Разворачивать какие-либо бинарные файлы не нужно.

После подключения запросы на естественном языке, например «Какой METAR сейчас в KJFK?» или «Оцени блочное время из SFO в JFK на 737», автоматически направляются к нужным эндпоинтам SkyLink. Ваш ключ передаётся в заголовке транспорта и никогда не встраивается в промпты.

Настройка MCP различается для двух каналов, поэтому выберите свой:

Конфигурация

MCP-сервер SkyLink — это эндпоинт streamable HTTP: POST https://data.skylinkapi.com/mcp, без сохранения состояния, с аутентификацией через тот же заголовок x-api-key, что и REST API. Большинство клиентов принимают URL и объект заголовков:

{
  "mcpServers": {
    "skylink": {
      "url": "https://data.skylinkapi.com/mcp",
      "headers": { "x-api-key": "YOUR_API_KEY" }
    }
  }
}

Замените YOUR_API_KEY лицензионным ключом, полученным при покупке через Polar, — см. Начало работы.

Поля конфигурации

Поле	Значение	Описание
`url`	`https://data.skylinkapi.com/mcp`	MCP-эндпоинт streamable HTTP
Заголовок `x-api-key`	Ваш лицензионный ключ	Аутентифицирует вызовы инструментов в рамках вашей квоты

Клиент	Куда вставлять
Claude Desktop	Settings → Developer → Edit Config → `mcpServers` → перезапустите
Cursor	Settings → MCP → Add MCP Server → Manual config → перезапустите
Другие MCP-клиенты	Используйте расположение конфигурационного файла MCP вашего клиента — структура JSON та же

Ответ

MCP не возвращает единое тело JSON, как REST, — сервер предоставляет инструменты, которые может вызывать модель. Каждый инструмент соответствует эндпоинту SkyLink. Вызовы инструментов возвращают структурированный JSON, идентичный ответам соответствующих эндпоинтов REST API, описанным в этом справочнике.

Инструменты фильтруются по вашему тарифу — вы видите только те инструменты, которые может вызывать ваш ключ, поэтому ассистент не потратит ход на то, что ваш тариф не включает:

Тариф	Доступно инструментов
Basic	46
Pro	52 (+ история за 90 дней)
Ultra / Mega	58 (+ история за 365 дней)

Имена инструментов формируются из базовой операции, например search_airport_airports_search_get или ultra_flights_ultra_history_flights_get. Вызовите tools/list, чтобы увидеть точный набор, доступный вашему ключу. Запрос инструмента за пределами вашего тарифа возвращает MCP error -32602: Tool <name> not found — такой инструмент просто не регистрируется для вашего ключа, а не завершается ошибкой в момент вызова.

Прямой вызов

Протокол обрабатывает ваш клиент, но для тестирования можно так:

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":{}}'

Ответы приходят в виде server-sent events (event: message / data: {...}).


Заголовок `Accept`	Должен включать и `application/json`, и `text/event-stream`, иначе вы получите `406`
Пакетные запросы JSON-RPC	Не поддерживаются — отправляйте один запрос на вызов (`400`)
`GET` / `DELETE` на `/mcp`	`405 Method not allowed`
Отсутствует API-ключ	`401 missing_api_key`

Точные имена инструментов и схемы параметров отображаются в вашем MCP-клиенте после успешного подключения.

Клиентские типы

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

Интеграция

Пример ниже собирает объект конфигурации MCP из переменных окружения, чтобы его можно было вставить в Claude Desktop или Cursor.

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

Примечания по реализации

Хранение ключа. Храните ключ в связке ключей ОС или в .env — конфигурация MCP передаёт его через заголовок, а не вставляет в текст переписки.

Важно: каждый MCP-запрос учитывается в вашем тарифе так же, как прямой REST-запрос, — включая initialize и tools/list, а не только tools/call. См. Ограничения частоты запросов.

Инструменты, зависящие от тарифа. Исторические данные ADS-B, вебхуки и другие премиальные эндпоинты подчиняются тем же ограничениям тарифа, что и в REST, — слой MCP не обходит квоты.

Устранение неполадок. Если инструменты не появляются, убедитесь, что заголовок x-api-key передаётся, а URL заканчивается на /mcp, перезапустите клиент после изменения конфигурации и проверьте, что нужные инструменты входят в ваш тариф.

Ответы с ошибками

Сбои подключения MCP отображаются в интерфейсе клиента (ошибки аутентификации или завершение процесса stdio-моста). HTTP-ошибки, возвращаемые в результатах инструментов, описаны в разделе Обработка ошибок — их структура совпадает с прямыми REST-запросами.

См. также: Начало работы · Обзор API v3.1 · Ограничения частоты запросов

MCP-сервер