Kosava public MCP

Uputstvo za AI asistente

Povezivanje javnog Kosava MCP servera sa ChatGPT, Claude i Gemini okruzenjima. Server daje read-only podatke o kvalitetu vazduha za javni SEPA opseg i koristi se direktno iz AI razgovora ili CLI alata.

Pregled servera

Kosava MCP trenutno radi bez autentikacije, ogranicen je na organizaciju 1 i paralelno nudi SSE i Streamable HTTP transport. Server je namijenjen agentima koji trebaju pouzdane, citljive i svjeze podatke o kvalitetu vazduha.

SSE Streamable HTTP No auth Org 1 SEPA

ChatGPT / OpenAI

Web konekcija ide kroz Developer mode. Codex CLI za remote MCP preferira Streamable HTTP, pa koristiti /mcp endpoint.

Web i CLI

Claude

Claude web koristi custom connectore, a Claude Code moze direktno dodati SSE server.

SSE radi

Gemini

Gemini CLI podrzava SSE konfiguraciju. Za Gemini web nema stabilno potvrdjenog custom MCP toka.

CLI radi

ChatGPT i OpenAI

WebCLI HTTP preporuka

ChatGPT web

  1. Otvoriti ChatGPT web.
  2. Uci u Settings > Apps > Advanced settings.
  3. Ukljuciti Developer mode.
  4. Dodati novu aplikaciju iz remote MCP servera.
  5. Unijeti https://mcp.kosava.cloud/sse.
  6. Izabrati No Authentication.
  7. U razgovoru izabrati Developer mode i ukljuciti Kosava MCP aplikaciju.

OpenAI Codex CLI

Kosava paralelno nudi Streamable HTTP endpoint /mcp, sto je preporuceni remote Codex CLI setup.

[mcp_servers.kosava]
url = "https://mcp.kosava.cloud/mcp"
enabled = true
tool_timeout_sec = 60
default_tools_approval_mode = "approve"

Claude

WebCLI

Claude web

  1. Pro/Max: otvoriti Customize > Connectors.
  2. Team/Enterprise: owner ili admin otvara Organization settings > Connectors.
  3. Izabrati Add custom connector.
  4. Unijeti https://mcp.kosava.cloud/sse.
  5. Ne unositi OAuth podatke.
  6. U razgovoru otvoriti + meni i ukljuciti Kosava connector.

Claude Code CLI

claude mcp add --transport sse kosava https://mcp.kosava.cloud/sse
claude mcp list
claude mcp get kosava

U Claude Code sesiji provjeriti dostupne alate komandom /mcp.

Gemini

Web nije potvrdjenCLI

Gemini web

Za Gemini web trenutno nema potvrdjen stabilan javni workflow za dodavanje proizvoljnog remote MCP servera. Za Kosava MCP koristiti Gemini CLI dok Google ne dokumentuje isti tok za web.

Gemini CLI settings.json

{
  "mcpServers": {
    "kosava": {
      "url": "https://mcp.kosava.cloud/sse",
      "trust": false,
      "timeout": 30000
    }
  }
}
Ako zelite ograniciti alate, u Gemini CLI dodajte includeTools. Za Streamable HTTP Gemini CLI moze koristiti httpUrl: "https://mcp.kosava.cloud/mcp".

Testiranje MCP endpointa

UpotrebljivoAccept header

Brza provjera servisa

Health endpoint ne koristi MCP protokol. On samo provjerava da servis radi, da Redis odgovara i da je payload dostupan.

curl -sS https://mcp.kosava.cloud/health

Streamable HTTP initialize

Za /mcp test klijent mora prihvatiti i text/event-stream, jer server moze vratiti JSON-RPC poruku kroz event stream.

curl -sS -i https://mcp.kosava.cloud/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"curl-test","version":"0.1"}}}'
Najcesca greska: poruka Not Acceptable: Client must accept text/event-stream znaci da test alat nije poslao Accept: application/json, text/event-stream. U Postman, Insomnia ili Bruno dodajte taj header rucno.
  • Koristite /mcp za Streamable HTTP klijente kao Codex CLI i rucni JSON-RPC test.
  • Koristite /sse za klijente koji eksplicitno traze SSE konekciju. To nije obican JSON POST endpoint.
  • Ne saljite bearer token dok je server u javnom read-only rezimu bez autentikacije.

Preporuceni promptovi

Copy readyOperativni upiti

Trenutno stanje i preporuke

  • Koristi Kosava MCP, domen vazduh.sepa.gov.rs, i daj trenutnu procjenu kvaliteta vazduha za Beograd. Navedi dominantne komponente, najrizicnije stanice i preporuku za osjetljive grupe.
  • Koristi Kosava MCP i procijeni da li je boravak napolju preporucljiv za djecu, starije, trudnice i osobe sa respiratornim tegobama. Odvoji preporuke po kategorijama rizika.
  • Koristi Kosava MCP i daj preporuku za setnju, trcanje i voznju bicikla u naredna 2 sata na osnovu trenutnog indeksa i trenda kvaliteta vazduha.

Analitika i poredjenja

  • Koristi Kosava MCP i izdvoji 10 stanica sa najlosijim kvalitetom vazduha u posljednja 24 sata. Za svaku stanicu navedi indeks, CAQI, dominantnu komponentu i kratko tumacenje.
  • Koristi Kosava MCP i uporedi trend org_index za posljednja 24 sata sa trenutnim stanjem. Da li se kvalitet vazduha poboljsava, pogorsava ili je stabilan?
  • Koristi Kosava MCP i pronadji peak za PM2.5, PM10, NO2, O3 i SO2 u posljednja 24 sata. Vrati tabelu sa stanicom, vremenom, vrijednoscu i zdravstvenim znacenjem.
  • Koristi Kosava MCP i provjeri UVI stanje za organizaciju. Navedi koliko stanica je uslo u obracun, koja agregacija je primijenjena i kakva je preporuka za zastitu od sunca.

Javni dogadjaji i operativne odluke

  • Koristi Kosava MCP i napravi preporuku za posjetioce velikog skupa u centru Beograda. Ukljuci maksimalno preporuceno zadrzavanje, rizicne grupe, vodu/hranu/alkohol i najblize relevantne stanice.
  • Koristi Kosava MCP i pripremi kratak krizni brief za medije: trenutno stanje, najvazniji rizik, ko treba da izbjegava boravak napolju i sta pratiti u naredna 3 sata.

Promptovi za graficke prikaze

ChartsDashboard ready

Ovi promptovi traze od AI klijenta da prvo povuce serije iz Kosava MCP-a, zatim da napravi vizuelni prikaz u tabeli, grafikonu ili dashboard formatu. Najbolje rade u okruzenjima koja mogu renderovati grafikone ili generisati HTML/CSV.

  • Koristi Kosava MCP get_chart_series za org_index u posljednja 24 sata i napravi linijski grafikon sa oznacenim periodima pogorsanja. Ispod grafikona dodaj kratko tumacenje.
  • Koristi Kosava MCP i napravi bar chart top 10 stanica po najgorem station_caqi u posljednja 24 sata. Boje neka prate AQI kategorije, a tooltip neka sadrzi dominantnu komponentu.
  • Koristi Kosava MCP i napravi multi-line grafikon za PM2.5, PM10, NO2 i O3 za organizaciju u posljednja 24 sata. Prikazi samo komponente koje imaju podatke i dodaj legendu sa jedinicama.
  • Koristi Kosava MCP i napravi heatmap prikaz stanica kroz vrijeme: redovi su stanice, kolone su sati, boja je station_index. Izdvoji tri najkriticnija perioda.
  • Koristi Kosava MCP i napravi mali HTML dashboard: kartice za org_index, dominantnu komponentu, UVI, top 5 stanica i preporuku za aktivnosti napolju. Koristi podatke iz MCP-a, bez izmisljanja vrijednosti.

Ogranicenja i sigurnost

Read-onlyPublic
  • Server je trenutno bez autentikacije, zato mora ostati read-only i bez osjetljivih podataka.
  • Podaci su javni i ograniceni na organizaciju 1; agent ne treba obecavati privatne ili nepostojace izvore.
  • Remote CLI kompatibilnost pokrivaju oba endpointa: /sse za SSE klijente i /mcp za Streamable HTTP klijente.
  • Web klijenti se brzo mijenjaju, pa instrukcije treba povremeno provjeriti prije javne objave.
  • AI klijenti mogu traziti da korisnik rucno potvrdi upotrebu MCP alata.

Izvori

Kosava MCP - javno uputstvo za AI asistente, azurirano 2026-06-30.