# API i MCP — povezivanje poslovnih sistema i AI asistenata

> API ključevi kompanije, lični tokeni, povezivanje Claude-a, ChatGPT-a i Cursor-a sa jeCheck-om preko MCP-a, dnevnik poziva i bezbednost.

Источник: https://jecheck.io/sr/docs/account/api-mcp

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](https://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

### Zašto zahtevi vraćaju grešku plan_required?

API i MCP su deo paketa Enterprise. Ključeve možete napraviti unapred, ali zahtevi će biti odbijeni dok kompanija ne pređe na Enterprise.

### Ključ ne vidi deo podataka

Ključ vidi samo podatke svojih uloga i objekata — kao zaposleni sa tim pravima na vebu. Proverite uloge i objekte ključa ili prava uloga u „Prava i uloge“.

### Da li stari ključ bota uputstava i dalje radi?

Da. Ključevi ranije izdati za bot baze znanja nastavljaju da rade sa uputstvima. Za druge odeljke napravite novi ključ.