Povezite AI agenta sa MCL-DPP

MCL-DPP ima MCP (Model Context Protocol) server — AI agenti poput Claude-a mogu direktno da resolvuju GS1 identifikatore, čitaju digitalne pasoše i verifikuju integritet.

1. Remote MCP endpoint

MCP server radi na našoj infrastrukturi — bez instalacije. Endpoint je JSON-RPC 2.0 preko HTTP POST-a:

curl -X POST https://dpp.mcldhi.com/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Javni alati rade bez ključa. Tenant alati zahtevaju X-Api-Key header — ključ pravite u portalu → Podešavanja → API ključevi.

2. Podešavanje u MCP klijentu

Primer konfiguracije za MCP klijente sa remote (HTTP) transportom:

{
  "mcpServers": {
    "mcl-dpp": {
      "url": "https://dpp.mcldhi.com/mcp",
      "headers": { "X-Api-Key": "vas-api-kljuc" }
    }
  }
}

3. Dostupni alati

Alat	Opis	Pristup
`passport_resolve`	Javni pasoš po slug-u ili GS1 Digital Link segmentu	javno
`passport_verify`	Verifikacija SHA-256 hash vrednosti i ES256 potpisa svih verzija	javno
`epcis_document`	EPCIS 2.0 JSON-LD događaji životnog ciklusa pasoša	javno
`passport_list`	Lista pasoša vašeg tenanta	API ključ

4. Primeri upita za agenta

„Prikaži pasoš demo-0001"
„Proveri da li je pasoš demo-0001 verifikovan i ko ga je potpisao"
„Izlistaj poslednjih 10 pasoša moje firme i njihov status"
„Prikaži EPCIS događaje životnog ciklusa za pasoš demo-0001"

5. Model autentifikacije

Javni alati (passport_resolve, passport_verify, epcis_document) ne zahtevaju ključ — isti pristup kao skeniranje QR koda telefonom.
Tenant alati (passport_list) šalju vaš X-Api-Key header — agent vidi samo ono što scope-ovi ključa dozvoljavaju.
Ključ stavljate u headers konfiguraciju klijenta — nikad u prompt ni u deljene fajlove. Rotacija: novi ključ u portalu → zamena u config → opoziv starog.

Bezbednosna napomena: agent radi samo ono što vaš API ključ dozvoljava — javni resolver ne zahteva ključ, a tenant podaci su dostupni samo sa vašim ključem i njegovim scope-ovima. Ključ možete povući u svakom trenutku.

6. Primer poziva alata

tools/call poziv za passport_resolve:

curl -X POST https://dpp.mcldhi.com/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call",
       "params":{"name":"passport_resolve","arguments":{"slug":"demo-0001"}}}'