GribStream per strumenti di IA

Questa pagina è il punto di partenza per collegare GribStream a ChatGPT, Claude, Gemini, Codex, Claude Code, Cursor, agenti IA personalizzati o qualsiasi ambiente IA capace di chiamare strumenti ed eseguire richieste HTTP.

L'integrazione consigliata per gli strumenti di chat web è il connettore MCP ospitato di GribStream. Aiuta a scoprire dataset, risolvere selettori esatti, costruire richieste valide per /timeseries e /runs, validare expressions ed eseguire query meteorologiche in tempo reale protette da OAuth.

Connettore MCP ospitato

Usa il connettore MCP ospitato quando il tuo strumento IA supporta MCP via Streamable HTTP.

https://gribstream.com/mcp

Usa l'URL esattamente come mostrato. Non includere punteggiatura finale, come un punto, quando la copi in un client MCP.

Il connettore permette di scoprire dataset, risolvere selettori, costruire richieste e validarle prima di OAuth. Per eseguire query in tempo reale su /timeseries e /runs, il flusso OAuth di GribStream richiede l'accesso, l'approvazione del connettore e la scelta del token API attivo da usare. Il token API originale non viene mostrato al client IA.

Prima di collegarti

• Crea un account GribStream o accedi da /auth/login.
• Crea un token API da /app/dashboard. Un token API gratuito basta per autorizzare MCP per l'uso supportato dal piano gratuito.
• Inserisci https://gribstream.com/mcp come URL MCP esatto.
• Completa OAuth GribStream quando il tuo client IA lo richiede. Durante OAuth, scegli il token API che MCP deve usare per interrogare i dati in tempo reale.
• Se un form OAuth manuale richiede un client secret, lascialo vuoto. GribStream MCP usa un client OAuth pubblico con PKCE, non un segreto condiviso.

Se colleghi MCP prima di creare un token API, gli strumenti pubblici di scoperta possono comunque funzionare, ma gli strumenti autenticati che interrogano i dati non potranno eseguire query meteo in tempo reale finché un token non sarà disponibile e selezionato.

Configurazione per client

Le impostazioni dei fornitori IA cambiano spesso. Gli elementi stabili sono l'URL MCP remoto, il trasporto Streamable HTTP, OAuth GribStream e il requisito che l'account GribStream abbia un token API prima di interrogare i dati in tempo reale. Gli esempi sotto seguono la documentazione pubblica attuale dei fornitori; usa i link di riferimento se l'interfaccia del prodotto è cambiata.

codex mcp add gribstream --url https://gribstream.com/mcp
codex mcp list
codex mcp login gribstream

[mcp_servers.gribstream]
url = "https://gribstream.com/mcp"

claude mcp add --transport http gribstream https://gribstream.com/mcp
claude mcp list

gemini mcp add --transport http gribstream https://gribstream.com/mcp
gemini mcp list

{
  "mcpServers": {
    "gribstream": {
      "httpUrl": "https://gribstream.com/mcp",
      "timeout": 30000
    }
  }
}

Cosa fornisce MCP

GribStream MCP separa volutamente gli strumenti pubblici di pianificazione dagli strumenti autenticati che interrogano i dati.

• No auth / public / read-only: metadati dei dataset, scoperta dei parametri, ricerca dei selettori esatti, risoluzione di parametri condivisi tra dataset, guida alla sintassi delle expressions, strumenti per costruire richieste e validazione delle richieste.
• Auth required / data query: strumenti in tempo reale /timeseries e /runs che recuperano valori reali di previsione meteorologica tramite il token API GribStream selezionato.
• Output tabulare tipizzato: i risultati CSV e NDJSON possono essere restituiti come risorse MCP incorporate con numero di righe, byte, colonne, anteprime e nomi file suggeriti.

Se l'utente chiede a uno strumento IA di recuperare, scaricare, creare grafici, analizzare o confrontare valori meteo reali, lo strumento deve usare gli strumenti di query autenticati. Se sono visibili solo strumenti pubblici in sola lettura, completa OAuth o passa a un flusso API diretto con GRIBSTREAM_API_TOKEN.

Dalla conversazione all'analisi

Una richiesta di previsione può sembrare plausibile e comunque essere sbagliata. Il connettore aiuta lo strumento IA a controllare il catalogo, usare selettori esatti, scegliere l'endpoint corretto e validare la richiesta prima dell'esecuzione.

Una sessione può iniziare con una domanda ampia:

Quali modelli supporta GribStream per previsioni globali?

Poi restringersi a una richiesta concreta:

Costruisci una richiesta per temperatura, velocità del vento e umidità relativa a Lisbona domani.

E continuare per iterazioni:

1. Trasformalo in una griglia sul Portogallo a 0,5 gradi.
2. Mostra come sarebbe apparso usando un cutoff sull'orario del run del modello di 18 ore prima.
3. Dammi gli ultimi tre run del modello per gli stessi orari di validità.
4. Passa da GFS a IFS e risolvi di nuovo i selettori.

Con un connettore ospitato autenticato o un token API GribStream disponibile a uno strumento IA locale, questo può diventare analisi reale: confrontare modelli, calcolare l'errore assoluto medio rispetto a un dataset di analisi, cercare soglie meteo o riassumere dove due modelli divergono di più.

Indicazioni per gestire i dati

• Preferisci CSV per dati tabulari, workflow pandas, grafici, heatmap e confronti.
• Quando un risultato MCP include una risorsa CSV o NDJSON tipizzata, analizza il contenuto completo della risorsa, non solo l'anteprima visibile nella chat.
• Quando salvi più risultati MCP, usa il suggested_filename restituito per evitare che il risultato di un modello o dataset sovrascriva un altro.
• Le righe non arrivano necessariamente ordinate. Ordina l'output /timeseries per campi di localizzazione e forecasted_time; ordina l'output /runs per campi di localizzazione, forecasted_at e forecasted_time.
• Se una richiesta è troppo grande, dividi prima per intervallo temporale, poi per variabili e solo alla fine per coordinate o spazio della griglia.
• Per download voluminosi via API diretta, usa Accept: text/csv, Accept-Encoding: gzip e curl --compressed.

Risorse principali

• Connettore MCP ospitato: https://gribstream.com/mcp - server MCP remoto Streamable HTTP per strumenti IA che supportano custom connectors.
• File di istruzioni indipendente dal fornitore - istruzioni portabili per strumenti IA che devono usare GribStream correttamente.
• Specifica OpenAPI - specifica leggibile da macchine per catalogo, /timeseries e /runs.
• Swagger UI - vista browser della stessa specifica OpenAPI.
• Guida rapida - esempi di accesso diretto ai dati, expressions, lead time, backtesting e query runs.
• Modelli e inventari - riferimento parametri per dataset e scoperta selettori.

Configurazione autenticazione

Il connettore MCP ospitato usa OAuth per query MCP in tempo reale. Durante la configurazione, accedi a GribStream con un account che abbia già un token API attivo, approva il connettore e scegli quale token userà. Un token API gratuito basta per completare il flusso per l'uso supportato dal piano gratuito. Il token originale non viene restituito al client IA.

1. Crea un account o accedi da /auth/login.
2. Crea un token API da /app/dashboard.
3. Collega l'endpoint MCP e completa il flusso di accesso GribStream quando lo strumento IA chiede autorizzazione.

Per strumenti CLI locali, agenti locali di sviluppo o client che non supportano ancora OAuth per server MCP remoti, carica un token API nell'ambiente da un file di token privato e usa la richiesta API generata o il file di istruzioni portatile.

Configurazione shell per macOS o Linux. Il comando editor usa VISUAL o EDITOR se impostato e altrimenti usa vi; va bene anche aprire manualmente il file di token nel tuo editor preferito.

mkdir -p ~/.config/gribstream
chmod 700 ~/.config/gribstream
touch ~/.config/gribstream/token
chmod 600 ~/.config/gribstream/token
"${VISUAL:-${EDITOR:-vi}}" ~/.config/gribstream/token
export GRIBSTREAM_API_TOKEN="$(tr -d '\r\n' < ~/.config/gribstream/token)"

Configurazione Windows PowerShell. Questo apre Notepad per il file di token; qualsiasi editor che salvi testo semplice va bene.

$dir = Join-Path $env:APPDATA "GribStream"
New-Item -ItemType Directory -Force $dir | Out-Null
$tokenFile = Join-Path $dir "token"
New-Item -ItemType File -Force $tokenFile | Out-Null
Start-Process notepad $tokenFile -Wait
$env:GRIBSTREAM_API_TOKEN = (Get-Content $tokenFile -Raw).Trim()

Gli strumenti CLI di solito ereditano le variabili d'ambiente dalla shell che li avvia. In pratica, carica prima GRIBSTREAM_API_TOKEN e poi avvia lo strumento dalla stessa sessione terminale. Se lo strumento è già in esecuzione, riavvialo dopo aver impostato la variabile.

Incolla il token nell'editor, non in un comando export, set o in un'assegnazione PowerShell, così non finisce nella cronologia della shell. È preferibile una variabile d'ambiente caricata da un file privato, oppure un archivio segreto del fornitore mappato a GRIBSTREAM_API_TOKEN. Evita di incollare token in prompt, file versionati, cronologia shell o script riutilizzabili.

Cosa insegna il file di istruzioni

Il file pubblico di istruzioni è volutamente rigoroso sulle cose che gli strumenti IA tendono a sbagliare:

• scegliere tra /timeseries e /runs
• trattare tutti gli orari come UTC
• capire che timesList indica orari di validità su /timeseries e orari di run del modello su /runs
• trattare i selettori come tuple pubblicate esatte, non come testo libero
• usare endpoint di catalogo e di parametri condivisi quando servono scoperta o normalizzazione tra dataset
• fermarsi e chiedere chiarimenti quando le richieste in linguaggio naturale sono ambigue

Flusso consigliato per strumenti IA

1. Collega il MCP ospitato su https://gribstream.com/mcp se il tuo strumento IA supporta MCP remoto.
2. Assicurati che l'account GribStream usato per OAuth abbia un token API attivo prima di chiedere valori in tempo reale.
3. Chiedi allo strumento IA di usare GribStream MCP per scoprire dataset, risolvere selettori e costruire una richiesta validata. Questi strumenti di pianificazione in sola lettura funzionano prima di OAuth.
4. Controlla la richiesta generata, soprattutto intervalli temporali, coordinate, dimensione della griglia, variabili ed expressions.
5. Usa gli strumenti MCP autenticati di query in tempo reale per flussi di chat web, oppure esegui la richiesta generata contro la normale API GribStream con GRIBSTREAM_API_TOKEN per flussi locali con file, script e grafici.
6. Usa la specifica OpenAPI, il file di istruzioni, la guida rapida e la pagina Expressions come riferimenti o alternative per strumenti che non supportano MCP.

File diretto

Il file pubblico di istruzioni corrente può essere scaricato direttamente da:

https://gribstream.com/skills/gribstream-query.md

Questo file è pensato per essere portatile tra fornitori IA. È particolarmente utile per strumenti che non supportano ancora MCP remoto.