MCP dokumentacija

Status aktivacije

Server radi. Klijent i korisnik odobravaju se odvojeno.

Produkcijski servis na Hetzneru već je uključen, objavljuje OAuth metadata dokument i traži važeći korisnički token. Tijekom pilota javna samoregistracija AI klijenata nije uključena.

1. ServisZnalac MCP je online na javnom HTTPS endpointu.

2. AI klijentCodex ili Claude mora biti registriran i dopušten u Znalcu.

3. KorisnikPozvani korisnik prijavljuje se i izričito odobrava pristup.

Povezivanje klijenta

Jedan endpoint, dva načina aktivacije.

Ne unosite Znalac lozinku u AI klijent. Povezivanje otvara Znalac OAuth prijavu i ekran na kojem vidite koja aplikacija traži pristup.

CodexCLI, aplikacija i IDE

Nakon što administrator uključi Codex client-registration tok:

codex mcp add znalac --url https://znalac.pro/mcp
codex mcp login znalac
codex mcp list

Trenutačni pilot ne dopušta javni dynamic client registration, pa ove naredbe nisu dovoljne prije administratorske aktivacije Codexa.

ClaudeCustom connector

Otvorite Customize → Connectors.
Odaberite Add custom connector.
Unesite https://znalac.pro/mcp.
U Advanced settings unesite client ID i secret koje je izdao Znalac.
Kliknite Connect i odobrite pristup na Znalac consent ekranu.

Za Team i Enterprise connector prvo dodaje Owner ili Primary Owner.

Aktualne upute klijenata: Codex MCP · Claude custom connectors

Javni ugovor

11 read-only alata u produkcijskom pilotu.

Nazivi alata stabilni su i koriste engleski snake_case. Opisi, sažeci, upozorenja i rezultati vraćaju se na hrvatskom.

search_companiesFinancije · Forensis

Pretražuje poslovne subjekte po nazivu, OIB-u, statusu, NKD-u i lokaciji.

Ulazi: query, name, oib, status, activity_code, city, county, postal_code, founded_from, founded_to, offset, limit

check_companyFinancije · Forensis

Pokreće odabrane provjere društva i zadržava uspješne nalaze ako jedan izvor nije dostupan.

Ulazi: oib, sections, financial_years

compare_company_peersFinancije · Forensis

Uspoređuje društvo s dostupnom skupinom usporedivih društava iz iste djelatnosti.

Ulazi: oib

get_company_timelineFinancije · Forensis

Dohvaća vremensku liniju registracijskih i drugih dostupnih promjena društva.

Ulazi: oib, limit

get_relationship_graphFinancije · Forensis

Dohvaća ograničeni graf osoba, poslovnih funkcija ili vlasničkog lanca.

Ulazi: oib, graph_type, depth, max_nodes, active_only, expanded_subject_oibs

check_personForensis

Provjerava jednu osobu kroz poslovne funkcije, stvarno vlasništvo, e-Oglasnu i sankcije.

Ulazi: oib, name, sections

search_real_estateNekretnine · Forensis

Pretražuje RH ZK/KPU ili zemljišne knjige Republike Srpske, ovisno o paketu.

Ulazi: query, jurisdiction, sources, history, limit

search_vesselsForensis

Pretražuje plovila po vlasniku, registraciji, NIB-u, luci ili vrsti plovila.

Ulazi: query, registration, nib, port, vessel_type, limit

search_legal_documentsSudska praksa

Pretražuje sudsku praksu, pravna shvaćanja i propise tekstualnim ili hibridnim načinom.

Ulazi: query, mode, jurisdiction, corpus_type, court_type, date_from, date_to, include_expanded, limit

get_legal_documentSudska praksa

Dohvaća metapodatke, izvore, citate i paginirani puni tekst odabranog pravnog dokumenta.

Ulazi: document_id, text_offset, text_limit

list_checksSvi MCP paketi

Vraća zadnje provjere trenutačno prijavljenog korisnika.

Ulazi: limit

get_checkSvi MCP paketi

Dohvaća detalj jedne provjere samo ako pripada prijavljenom korisniku.

Ulazi: check_id

get_source_statusSvi MCP paketi

Vraća sanitiziranu aktualnost izvora bez infrastrukture, tajni i administratorskih podataka.

Ulazi: bez parametara

Sekcije alata check_company

profileviescourt_registrypeoplefinancialsfinancial_riskblockadestax_debtwage_nonpaymentsconcessionsstate_aidtede_noticesbeneficial_ownerssanctionsweb_enrichment

Strukturirani rezultat

Isti oblik odgovora za svaki alat.

Prazan rezultat nije isto što i nedostupan izvor. Znalac uz podatke vraća status, korištene izvore, identifikatore provjera, trajanje i upozorenja.

{
  "status": "succeeded | partial | failed",
  "summary": "Kratak sažetak rezultata",
  "data": {},
  "meta": {
    "check_ids": [],
    "sources": [],
    "created_at": "2026-07-23T09:00:00Z",
    "elapsed_ms": 182,
    "cached": false
  },
  "warnings": []
}

succeededSve tražene provjere završile su uspješno.

partialDio izvora nije dostupan, ali uspješni nalazi ostaju.

failedZahtjev nije moguće izvršiti ili nema potrebnu ovlast.

Zaštite

AI pristup ne zaobilazi pravila web aplikacije.

30MCP poziva u minuti po korisniku i klijentu

120ponderiranih kredita na sat

3istodobne operacije po korisniku

20najviše rezultata jedne pretrage

100najviše čvorova u grafu, dubina najviše 3

256 KBnajveći strukturirani odgovor

FastAPI ponovno provjerava korisnika, paket, modul i vlasništvo nad zapisom.
Nema izravnog pristupa bazama ni ključevima vanjskih izvora.
Nema bulk alata za popise OIB-a ni masovno pretraživanje osoba.
Vanjski tekst uvijek se tretira kao podatak, nikada kao naredba AI klijentu.
Svaki poziv ulazi u redigirani audit bez tokena i punog odgovora.

Komercijalni model

MCP prati ugovorene module.

Znalac Financije

Tvrtke, financije, rizici, osobe i poslovne veze dostupne u tom paketu.

Znalac Nekretnine

RH ZK/KPU i Republika Srpska prema istim modulskim ovlastima kao u webu.

Sudska praksa

Tekstualna i pametna pretraga odluka, pravnih shvaćanja i propisa uz dohvat citata.

Znalac Forensis

Puni read-only MCP pristup uključenim modulima, uključujući osobe i plovila.

MCP se tijekom read-only pilota ne naplaćuje zasebno. Pretplata na Codex, Claude ili drugi AI klijent nije uključena u cijenu Znalca.

Usporedite pakete Zatražite MCP aktivaciju