MCP konektor · radi u claude.ai, Claude Code, Cursor, Codex

Tvoj AI asistent, povezan sa kasom

Tezga je dostupna kao MCP alat (Model Context Protocol): dodaš jedan URL, prijaviš se svojom firmom i odobriš pristup. Posle toga asistent po tvom nalogu izdaje račune, radi storno i refundaciju, otvara i zatvara avanse i proverava stanje dokumenata, dok ti radiš svoj posao.

bez ključeva i podešavanja: 1 URLbez ključeva i podešavanja
prijava i jedno „Odobri”: OAuthprijava i jedno „Odobri”
opoziv pristupa u Podešavanjima: 1 klikopoziv pristupa u Podešavanjima

Podešavanje u claude.ai

1Otvori Settings → ConnectorsU claude.ai (web ili desktop) klikni Add custom connector.
2Upiši ime i adresuName: Tezga. Remote MCP server URL: https://pos.narbiz.com/mcp. Polja OAuth Client ID i Secret ostavi prazna: Tezga podržava automatsku registraciju klijenta.
3Poveži i prijavi seKlikni Connect: otvara se Tezga prijava. Uloguj se nalogom firme (administrator).
4Odobri pristupNa ekranu „Povezivanje aplikacije” klikni Odobri pristup. To napravi namenski API ključ za tvoju firmu i vraća te u Claude: povezano.

Name	`Tezga`
Remote MCP server URL	`https://pos.narbiz.com/mcp`
OAuth Client ID / Secret	ostaje prazno

Prva proba u ćaskanju: „proveri tezga okruženje”. Treba da vrati produkcija, sandbox ili simulacija.

Claude Code, Cursor, Codex

Alati za programiranje se povezuju direktno API ključem, bez OAuth-a. Ključ napraviš u kasi (Podešavanja → Integracije), pa u mcp.json (ili ekvivalent) dodaš:

{
  "mcpServers": {
    "tezga": {
      "url": "https://pos.narbiz.com/mcp",
      "headers": { "X-Tezga-Api-Key": "tzg_…" }
    }
  }
}

Šta asistent ume

tezga_okruzenjeokruženje naloga (produkcija / sandbox / simulacija) i poreske oznake

tezga_izdaj_racunizdaje i fiskalizuje račun; vraća PFR broj, QR, verifikacioni URL i PDF

tezga_storno_ili_refundacijastorno celog računa ili refundacija, cela ili po stavkama

tezga_avansavansni račun: otvaranje i zatvaranje konačnim računom

tezga_stanje_dokumentafiskalni podaci dokumenta po Tezga ID-ju

tezga_lista_dokumenatalista dokumenata naloga, sa filterima

Bezbednost

Odobrenjem nastaje namenski ključ „Claude konektor (MCP)” samo za tvoju firmu; brisanje ključa prekida pristup odmah.
U produkciji alati koji menjaju stanje traže izričitu potvrdu (potvrdiProdukciju), pa pravi fiskalni račun ne nastaje slučajno.
Za probu služe zvanični sandbox Poreske uprave i simulacija (PFR broj počinje sa MOCK, ništa ne ide Poreskoj).
Bezbednosni element, lozinke i ključevi se kroz konektor nikad ne prikazuju.

Česta pitanja

Konektor

Da li asistent vidi podatke moje firme?

Vidi samo ono što API vraća za tvoju firmu, preko namenskog ključa koji je nastao tvojim odobrenjem. Bezbednosni element, lozinke i ključevi se kroz konektor nikad ne prikazuju.

Kako opozivam pristup?

U kasi: Podešavanja → Integracije → obriši ili pauziraj ključ „Claude konektor (MCP)”. Pristup prestaje odmah, a konektor možeš ponovo da odobriš kad želiš.

Može li asistent slučajno da izda pravi račun?

Ne može tek tako: na nalogu koji je u produkciji alati za izdavanje, storno i avans odbijaju rad dok se izričito ne potvrdi (potvrdiProdukciju). Za probu služe sandbox Poreske uprave i simulacija, u kojoj PFR broj počinje sa MOCK i ništa ne ide Poreskoj.

Šta mi treba od naloga?

Tezga nalog sa API pristupom (paket Biznis ili Enterprise nivo). Sama integracija je besplatna: bez naknade za uvođenje i bez naplate po pozivu.

Gradiš nešto svoje preko API-ja?

Ceo REST API, primeri koda po steku i otvoren OpenAPI opis stoje na strani za programere. Integracija je besplatna.

API za fiskalizaciju podrska@tezgafiskal.com