Hopp til innhold
Dokumentasjonsmeny

MCP og koblinger

Itemras MCP-server for KI-agenter, og koblingskildene for Zapier og Make.

MCP-serveren

Itemra leverer en MCP-server slik at KI-agenter kan arbeide med lageret gjennom Customer API-et: søke i varer, svare på beholdnings- og tilgjengelighetsspørsmål, gjøre kontrollerte justeringer og flyttinger, utarbeide innkjøpsordrer og spørre lagerrapporter. Den er en lokal stdio-adapter (Node 22+, ingen tredjeparts kjøretidsavhengigheter) — den legger ikke til noe offentlig endepunkt og omgår ingenting: API-ets tenant-isolasjon, omfang og tilganger forblir håndhevingsgrensen.

Sikkerhetsmodellen i korte trekk:

  • API-nøkkelen kommer fra subprosessens miljø, aldri et verktøyargument, og sladdes fra hver nyttelast serveren sender ut.
  • Kun HTTPS (loopback unntatt for lokal testing); omdirigeringer avvises.
  • Bruk en dedikert minstetilgangsnøkkel etter verktøysettet: lesing trenger items:read / stock:read / reports:read; skriveverktøyene svarer til stock:write, movements:write, purchasing:write.
  • Skriveverktøy krever eksplisitte idempotensnøkler, og en god MCP-klient bør spørre et menneske før noen skriving fyrer — leseverktøyene er merket skrivebeskyttet.

Pek den mot en dev-miljønøkkel og sandkassedatasettet under bygging.

Zapier og Make

Itemra vedlikeholder koblingskilder for Zapier (umiddelbare webhook-utløsere med full signaturverifisering) og Make (sjekkpunktet polling av hendelsesstrømmen) — utløsere for stock.changed, low-stock, item.created og po.received, pluss handlinger for å opprette varer, justere beholdning og opprette innkjøpsordrer. Begge bruker én dedikert API-nøkkel per plattform og krever stabil idempotensnøkkel per handling. Kontakt Itemra-support for gjeldende tilgjengelighet og oppsettshjelp på plattformen deres.