Pređi na sadržaj

AI konektor (MCP)

Povežite Claude, ChatGPT ili drugog AI asistenta sa BokaPOS-om. Asistent čita dokumentaciju i bez prijave, a uz odobrenje vlasnika ili administratora radi sa podacima vaše organizacije, u sandboxu ili u produkciji, samo onoliko koliko dozvolite.

Ažurirano: 31. 10. 2026. · Verzija ugovora 1.0.0

Adrese

AdresaPrijavaŠta asistent dobija
https://mcp.bokapos.rs/mcpBokaPOS nalog; vezu odobrava vlasnik ili administratordokumentaciju i rad sa podacima organizacije, prema dozvolama veze
https://mcp.bokapos.rs/docsbez prijavesamo dokumentaciju: vodič, operacije, šeme i greške

Povezivanje

  1. Dodajte konektor

    U AI aplikaciji dodajte prilagođeni MCP konektor (custom connector) sa adresom https://mcp.bokapos.rs/mcp. U Claude Code je dovoljna jedna komanda: claude mcp add --transport http --scope user bokapos https://mcp.bokapos.rs/mcp (--scope user dodaje konektor za sve vaše projekte).

  2. Prijavite se

    Aplikacija otvara BokaPOS prijavu; u Claude Code-u je otvarate sami: otkucajte /mcp, izaberite bokapos i Authenticate. Prijavite se nalogom kojim ulazite u cloud.bokapos.rs; ako ste već prijavljeni u portal, lozinka se ne traži ponovo. Lozinku unosite samo na BokaPOS stranici, nikad u AI aplikaciju.

  3. Odobrite vezu

    Na BokaPOS stranici za odobrenje vidite koja aplikacija traži pristup i kuda se vraća, pa birate okruženje (sandbox ili produkcija), dozvole i naziv veze. Odobriti mogu samo vlasnik i administrator organizacije; operater i posmatrač vide poruku da se obrate njima. Za produkciju sa bilo kojom dozvolom za upis potrebna je i izričita potvrda da AI aplikacija izdaje prave fiskalne račune.

  4. Radite i upravljajte

    Asistent od tada vidi alate koje dozvole pokrivaju. Svaku vezu menjate ili uklanjate u portalu, u delu AI veze.

Podržane AI aplikacije

  • Claude: web (claude.ai), desktop i mobilna aplikacija, i Claude Code.
  • ChatGPT (prilagođeni konektor).
  • Cursor: desktop i web.
  • Visual Studio Code sa GitHub Copilot-om.
  • Gemini CLI i Perplexity.

Aplikacije koje rade na vašem računaru (lokalna adresa, na primer Claude Code ili Cursor) rade uvek. Web aplikacije se prijavljuju samo preko povratnih adresa koje njihovi proizvođači zvanično objavljuju, pa lažna aplikacija na drugom sajtu ne može da dobije pristup. Drugu web aplikaciju dodajemo na zahtev.

Dozvole

Svaka veza ima jedno okruženje i svoje dozvole. Čitanje je uvek uključeno, a upis birate po vezi. Veza nikad ne može više od API kredencijala za integraciju i nikad ne vidi tajne.

Podrazumevano pri odobrenju. Vlasnik ili administrator menja dozvole pre odobrenja i kasnije u portalu.
DozvolaŠta pokrivaSandboxProdukcija
Čitanje (uvek)dnevnik, računi, izveštaji, katalog, poreske stope, obveznici, prodajna mesta, bezbednosni elementi, licencauključenouključeno
Izdavanje računa i slanje e-poštomprodaja, kopija, slanje računa kupcuuključenoisključeno
Refundacijerefundacija prodajeuključenoisključeno
Avansiotvaranje, uplata, otkazivanje uplate, zatvaranjeuključenoisključeno
Predračun i obukapredračun i dokument obukeuključenoisključeno
Izmene katalogadodavanje, izmena i uvoz proizvodauključenoisključeno

Promena dozvola i uklanjanje veze važe najkasnije za jedan minut. Računi koje je veza već izdala ostaju u dnevniku.

Alati

Imena alata su na engleskom i počinju sa bokapos_. Asistent vidi samo alate koje dozvole veze pokrivaju; adresa /docs nudi samo prvu grupu.

GrupaAlati
Dokumentacijabokapos_search_docs, bokapos_read_docs, bokapos_list_operations, bokapos_get_operation, bokapos_get_schema, bokapos_get_error
Podešavanje i licencabokapos_get_runtime, bokapos_get_license, bokapos_list_taxpayers, bokapos_get_taxpayer, bokapos_list_business_premises, bokapos_get_business_premise, bokapos_list_tax_rates, bokapos_list_security_elements, bokapos_get_security_element
Dnevnik i računibokapos_search_journal, bokapos_get_fiscal_document, bokapos_export_journal, bokapos_get_receipt, bokapos_get_turnover_report, bokapos_export_turnover_report, bokapos_get_operation_status, bokapos_list_receipt_deliveries, bokapos_get_receipt_delivery
Izdavanjebokapos_issue_sale, bokapos_issue_copy, bokapos_send_receipt_email
Refundacijabokapos_create_refund
Avansbokapos_list_advance_cases, bokapos_get_advance_case, bokapos_create_advance_case, bokapos_add_advance_payment, bokapos_cancel_advance_payment, bokapos_close_advance_case
Predračun i obukabokapos_issue_proforma_or_training, bokapos_get_proforma_training
Katalogbokapos_list_products, bokapos_get_product, bokapos_export_products, bokapos_create_product, bokapos_update_product, bokapos_import_products

Pravila za fiskalne dokumente

  • Svaki odgovor kaže okruženje: u sandboxu su to probni dokumenti na test sistemu Poreske uprave, u produkciji pravi fiskalni računi.
  • Račun postoji tek kada alat vrati potpisan odgovor V-PFR-a (fiscalized: true). Prihvaćen zahtev, greška ili poslata e-poruka nisu račun.
  • Alati za izdavanje traže idempotencyKey. Isti ključ posle prekida vraća isti dokument, nikad novi.
  • OUTCOME_UNKNOWN i 503 sa retryable: false se nikad ne ponavljaju; alat upućuje na bokapos_get_operation_status sa id operacije.
  • Pre izdavanja u produkciji asistent dokument prvo potvrđuje sa vama.
  • Konektor ne menja bezbednosne elemente, članove tima ni podešavanja organizacije.

Bezbednost i cena

  • Token AI aplikacije važi samo za konektor i nikad ne stiže do BokaPOS API-ja. Svaka veza ima svoj kratkotrajni API pristup vezan za organizaciju i okruženje, pa API proverava ista prava kao za svaku integraciju.
  • Sve što asistent uradi upisuje se u isti dnevnik i istoriju promena kao rad integracije.
  • Konektor se ne naplaćuje posebno. Dokumenti koje veza izda računaju se kao i svi ostali, po cenovniku.
  • Korišćenje AI veze je opciono. Sve što AI aplikacija uradi preko veze smatra se radnjom vaše organizacije, a AI aplikaciju pruža njen proizvođač po svojim uslovima. Pravila su u članu 9a Uslova korišćenja, koji prihvatate odobravanjem veze.

Ako sami pišete integraciju uz AI asistenta, prompt i dokumentacija kao tekst su na stranici Početak.