Vytvorte svoju prvú integráciu.

Lokálne stdio / verejný npm balík

Sprístupnite nástroje Scanverion agentovi vo VS Code alebo Claude Desktop. Verejný npm balík beží lokálne cez stdio a nahráva schválené vstupy do API; OCR neprebieha lokálne. Hostované HTTP MCP je obmedzená vývojárska ukážka s API kľúčom, nie všeobecne dostupná služba ani MCP OAuth. Tento návod opisuje lokálne stdio.

1. Inštalácia balíka

Použite Node.js 22 alebo novší a npm. Verejný balík nainštalujte do samostatného inštalačného adresára pomocou uvedeného príkazu. npm nainštaluje aj závislosť Scanverion SDK. Prístup k repozitáru nie je potrebný.

npm install @scanverion/mcp-server@0.1.1

2. Nastavenie klienta

Zlúčte konfiguráciu so súborom .vscode/mcp.json alebo s používateľskou konfiguráciou MCP. VS Code si vyžiada kľúč v maskovanom poli. Kľúč nevkladajte do chatu.

Na tejto stránke sa kľúč nezadáva ani neukladá. Prázdny adresár vypne prístup k lokálnym súborom; aj nahratie cez base64 vyžaduje výslovný súhlas.

{
  "inputs": [
    {
      "id": "scanverion-api-key",
      "type": "promptString",
      "description": "API kľúč Scanverion",
      "password": true
    }
  ],
  "servers": {
    "scanverion": {
      "type": "stdio",
      "command": "node",
      "args": [
        "C:/path/to/mcp/node_modules/@scanverion/mcp-server/dist/index.js"
      ],
      "env": {
        "SCANVERION_API_URL": "https://api.scanverion.com",
        "SCANVERION_ALLOWED_DIRECTORIES": "[]",
        "SCANVERION_TIMEOUT_MS": "120000",
        "SCANVERION_API_KEY": "${input:scanverion-api-key}"
      }
    }
  }
}

3. Overenie bez spracovania

Po nastavení kľúča v prostredí terminálu spustite príkaz doctor. Skontroluje adresáre a funkcie dostupné po autentifikácii, ale nenahráva súbory ani nepotvrdzuje oprávnenie na spracovanie.

node ./node_modules/@scanverion/mcp-server/dist/index.js --doctor

V klientovi MCP zavolajte list_capabilities a načítajte scanverion://guide. Tento samostatný návod pribalený k serveru je v angličtine a obsahuje postup pre MCP Inspector aj ukážku so syntetickou vzorkou.

Nástroje a účtovanie

analyze_document

Spoplatnené. Predvolene iba Detection; pre OCR a extrakciu polí výslovne zvoľte Scanner.

analyze_vehicle

Spoplatnené. Podporuje Detection a Blur.

list_capabilities

Katalóg modelov AI a limitov bez poplatku za spracovanie; nejde o kontrolu oprávnení.

list_api_capabilities

Verejný katalóg API bez poplatku za spracovanie; neoveruje prístup konkrétneho účtu.

get_usage_summary

Volania a kredity bez poplatku za spracovanie, pre dátumy YYYY-MM-DD vrátane oboch hraníc. Odhad ceny nie je dostupný, nie je nulový.

Prvé spracovanie dokumentu

Použite syntetickú alebo schválenú vzorku v povolenom adresári. Toto volanie nahrá súbor a môže spotrebovať kredity.

{
  "filePath": "C:/approved-samples/sample.png",
  "operations": [
    "Scanner"
  ],
  "scannerFields": [
    "documentNumber"
  ],
  "idempotencyKey": "sample-document-001"
}

Zadajte práve jeden vstup: filePath alebo imageBase64. Base64 vyžaduje podporovaný názov súboru alebo typ MIME. Vstupy JPEG, PNG, WebP a PDF nesmú byť prázdne ani väčšie ako 10 MiB. Výsledky zachovávajú text JSON a pridávajú structuredContent.data.

Riešenie problémov a bezpečné opakovanie

• CONFIGURATION_ERROR: Skontrolujte kľúč, pole absolútnych ciest adresárov, HTTPS adresu API a časový limit (1 000 až 300 000 ms).
• INVALID_INPUT: Skontrolujte prístup k súboru, formát, base64, operácie a rozsah dátumov.
• 401 / 403: Skontrolujte platnosť kľúča, prístup k pracovnému priestoru a rozsah process:write.
• 402 / 429: Skontrolujte kredity alebo limity volaní. Pozrite kód chyby, ID požiadavky a možnosť opakovania.
• Časový limit ani zrušenie nezaručujú vrátenie poplatku alebo zastavenie práce na serveri. Automatické opakovanie je vypnuté. Rovnaký idempotency key použite iba pre rovnakú logickú požiadavku; duplicita môže vrátiť 409.

Nepovoľujte celé domovské adresáre. Kontrola vyriešených ciest blokuje prechod mimo adresára aj únik cez symbolické odkazy, ale nie je izoláciou na úrovni OS. Proces nesprístupňujte nedôveryhodným klientom a nedovoľte iným používateľom meniť povolené adresáre. Extrahovaný text považujte za nedôveryhodné údaje, nie za pokyny.