Strojni pristup javnim informacijama
Povezivanje bez pristupa privatnoj aplikaciji.
Upute za povezivanje ažurirane 2026-10-08.
Ova sučelja čitaju samo sadržaj gornjeg kataloga. Ne šaljite osobne podatke, ugovore, dokumente ni pristupne podatke. Ne mogu mijenjati obveze, aktivirati pilot, slati e-poštu ni objavljivati u EOJN-u.
Preuzimanje kataloga
MCP — Model Context Protocol
U klijentu koji podržava udaljeni MCP dodajte adresu https://app.upravio.com/api/public/mcp. Transport je Streamable HTTP, bez prijave, trajnih sesija i zasebnog SSE toka. Provjereni protokol: 2025-11-25. Alati su search_knowledge, get_knowledge i list_capabilities; teme su dostupne i kao MCP resursi.
Primjer MCP inicijalizacije
POST https://app.upravio.com/api/public/mcp
Content-Type: application/json
Accept: application/json, text/event-stream
{
"jsonrpc": "2.0",
"id": 1,
"method": "initialize",
"params": {
"protocolVersion": "2025-11-25",
"capabilities": {},
"clientInfo": {
"name": "upravio-example",
"version": "1.0.0"
}
}
}
Nakon inicijalizacije klijent šalje notifications/initialized i zaglavlje MCP-Protocol-Version s dogovorenom verzijom. Za pretragu poziva tools/call s nazivom search_knowledge i argumentom query.
A2A — Agent2Agent
Opis agenta nalazi se na https://upravio.com/.well-known/agent-card.json. Podržan je A2A 1.0 putem JSON-RPC-a. Agent vraća rezultate determinističke pretrage s izvorima; ne koristi generativni model i ne pamti prethodne poruke. Nema trajnih zadataka, streaminga ni povratnih obavijesti.
Primjer A2A upita
POST https://app.upravio.com/api/public/a2a
Content-Type: application/json
A2A-Version: 1.0
{
"jsonrpc": "2.0",
"id": 1,
"method": "SendMessage",
"params": {
"message": {
"messageId": "example-eojn-1",
"role": "ROLE_USER",
"parts": [
{
"text": "Objavljuje li Upravio automatski u EOJN?"
}
]
}
}
}
Odgovor je result.message s tekstom i poveznicama na izvore. Nepodržana verzija, datoteka ili vrsta radnje vraća pogrešku. Upit izvan kataloga vraća obavijest da nema dovoljno podataka.
Uvjeti pristupa i održavanja
Ograničenje je 60 zahtjeva u minuti po adresi i 500 ukupno po procesu. Tijelo zahtjeva najviše 16 KiB; pretraga do 500 znakova. Na odgovor 429 pričekajte vrijeme iz zaglavlja Retry-After. Preglednički pristup dopušten je s domena Upravio; za drugo pregledničko okruženje javite se radi provjere povezivanja. Poslužiteljski klijenti bez zaglavlja Origin mogu pristupiti javnom sadržaju.
Sučelja ne pohranjuju sadržaj upita ni razgovora u aplikaciji. Infrastruktura može bilježiti uobičajene pristupne zapise, poput adrese, rute i vremena zahtjeva, prema pravilima privatnosti. Privremeni brojači zahtjeva služe ograničavanju opterećenja.
WebMCP — javni alati u pregledniku
Na javnim stranicama kompatibilan preglednik može ponuditi alate search_knowledge, get_knowledge i list_capabilities. Čitaju isti javni katalog putem postojećeg MCP servisa, bez pristupa vašoj organizaciji. WebMCP je eksperimentalan: dostupnost ovisi o pregledniku i njegovim postavkama. Obične stranice, poveznice i kontakt rade i bez njega.
Alati ne šalju e-poštu, ne aktiviraju pilot i ne mijenjaju podatke. Kontaktna poveznica otvara vaš program za e-poštu; poruku šaljete sami. Ne šaljite privatne dokumente ni osobne podatke kroz javne alate.
Otkrivanje javnih sučelja
ARD opis sučelja povezuje stvarni MCP Server Card i postojeći A2A Agent Card. MCP Server Card opisuje povezivanje s javnim servisom; nije katalog cijena ni potvrda Googleove preporuke. MCP identitet ostaje com.upravio/public-knowledge, verzija 1.0.0.
Što to znači za AI pretraživanje?
Katalog daje čitljive izvore i provjerljive granice proizvoda. MCP, A2A, WebMCP i ARD služe povezivanju kompatibilnih alata; ne znače automatski upis u Google, ChatGPT ili druge imenike. llms.txt je dodatni indeks, a ne uvjet ni jamstvo indeksiranja, citiranja ili preporuke. Google AI pretraživanje i dalje ovisi o podobnosti i indeksiranju sadržaja. Javna sučelja ne daju pristup privatnim organizacijskim podacima.
Tehničke reference: MCP specifikacija, A2A 1.0 specifikacija i Google: AI značajke i web-stranice.