API i MCP — povezivanje poslovnih sistema i AI asistenata

Odeljak API i MCP otvara podatke jeCheck-a drugim sistemima i AI asistentima: ERP može da preuzima provere i kreira zadatke, BI pravi izveštaje, a Claude ili ChatGPT odgovaraju na pitanja o vašoj mreži i pripremaju analize. Sve radi sa istim pravima kao veb: ključ ili asistent vidi samo ono što mu je dozvoljeno.

Otvara se iz menija Upravljanje → API i MCP ili iz menija profila (kliknite na svoje ime na dnu bočnog menija). API i MCP su dostupni u paketu Enterprise.

Tehnička dokumentacija za programere (na engleskom) — sve metode, primeri zahteva i odgovora, greške — nalazi se na portalu jecheck.io/developers.

Šta možete povezati

• Knjigovodstvene i kadrovske sisteme — izvoz provera, evidencije rada i zarada, sinhronizacija zaposlenih i objekata, kreiranje zadataka.
• BI (Power BI, Looker, Metabase) — provere, prekršaji, izvršenje procedura i HACCP podaci za vaše izveštaje.
• Botove i portale — prikaz uputstava, prijem zahteva, podsetnici na zadatke.
• AI asistente (Claude, ChatGPT, Cursor i drugi) — preko MCP-a asistent sam pronalazi podatke i može da kreira zadatke u vaše ime.

Ključevi kompanije

Ključ kompanije služi za integracije koje rade same, bez određene osobe. Izdaje ga zaposleni sa pravom API ključevi kompanije (administrator ga ima).

1. Otvorite API i MCP → Ključevi kompanije i kliknite Novi ključ.
2. Nazovite ključ po sistemu koji će ga koristiti, npr. „ERP“ ili „Power BI“.
3. Izaberite Pristup: Samo čitanje ili Čitanje i pisanje.
4. Označite Uloge ključa — ključ dobija tačno prava tih uloga. Možete dodeliti samo uloge čija sva prava i sami imate.
5. Izaberite Objekte — ključ vidi samo podatke tih objekata (ili sve, uključujući nove).
6. Po potrebi postavite rok važenja i kliknite Napravi.
7. Kopirajte token — prikazuje se samo jednom. Prosledite ga programeru integracije na bezbedan način.

Ključ radi kao servisni korisnik „API: naziv“. Ne može da se prijavi na veb ni u aplikaciju, a sve što integracija kreira ili izmeni vidi se u istoriji pod tim imenom.

Pun pristup (kao administrator) može dodeliti samo administrator. Koristite ga samo ako su integraciji zaista potrebni svi odeljci.

Ključ možete Izmeni — promeniti naziv, uloge, objekte i pristup bez zamene tokena — ili Opozovi: integracija odmah prestaje da radi.

Lični tokeni

Lični token radi sa vašim pravima i pogodan je za skripte, isprobavanje API-ja i AI alate za programere (Cursor, Claude Code, VS Code). Napravite ga na kartici Moji tokeni ako imate pravo Lični API tokeni i AI aplikacije. Ne delite lični token sa drugima.

Povezivanje AI asistenta (MCP)

MCP je otvoreni protokol preko kog se AI asistenti povezuju sa servisima. Kartica AI aplikacije (MCP) prikazuje adresu servera i uputstvo korak po korak.

Claude i ChatGPT se povezuju bez tokena:

1. Kopirajte Adresu servera.
2. U Claude-u: Podešavanja → Konektori → Dodaj prilagođeni konektor. U ChatGPT-u: Podešavanja → Aplikacije i konektori → Kreiraj.
3. Nalepite adresu, kliknite Poveži, prijavite se u jeCheck i dozvolite pristup. Oznaku Dozvoli izmene možete ukloniti — tada asistent samo čita.

Cursor, VS Code, Claude Code se povezuju ličnim tokenom — gotova podešavanja za kopiranje su na istoj kartici.

Primeri pitanja za asistenta:

• „Kojih pet objekata je ovog meseca najgore prošlo proveru kuhinje i koji se prekršaji ponavljaju?“
• „Koji zadaci kasne na objektu Dostik? Grupiši po odgovornima.“
• „Da li danas nedostaju unosi u HACCP dnevnicima temperature?“
• „Ko je sada u smeni u centralnoj kuhinji?“

Povezane aplikacije su na listi Povezane aplikacije; Odvoji im odmah zatvara pristup.

Dnevnik poziva

Kartica Dnevnik poziva prikazuje poslednjih 100 zahteva ka API-ju i MCP-u: vreme, ključ, operaciju, kod odgovora i IP. Administrator i oni sa pravom „API ključevi kompanije“ vide pozive ključeva kompanije, a svaki zaposleni pozive svojih tokena i aplikacija. Dnevnik se čuva 30 dana. Izdavanje i opoziv ključeva beleže se u dnevniku pristupa odeljka „Prava i uloge“.

Bezbednost

• Napravite poseban ključ za svaki sistem sa minimalnim ulogama i objektima — lakše ga je ograničiti i opozvati.
• Ako integracija samo čita podatke, dajte Samo čitanje.
• Za privremena povezivanja postavite rok važenja.
• Opozovite ključeve koji se više ne koriste. Ako je token mogao da dospe u tuđe ruke, odmah ga opozovite i napravite novi.

Česta pitanja