Vytvořte svou první integraci.

Lokální stdio / veřejný npm balíček

Zpřístupněte nástroje Scanverion agentovi ve VS Code nebo Claude Desktop. Veřejný npm balíček běží lokálně přes stdio a nahrává schválené vstupy do API; OCR neprobíhá lokálně. Hostované HTTP MCP je omezená vývojářská ukázka s API klíčem, nikoli obecně dostupná služba ani MCP OAuth. Tento návod popisuje lokální stdio.

1. Instalace balíčku

Použijte Node.js 22 nebo novější a npm. Veřejný balíček nainstalujte do samostatného instalačního adresáře pomocí uvedeného příkazu. npm nainstaluje také závislost Scanverion SDK. Přístup k repozitáři není potřeba.

npm install @scanverion/mcp-server@0.1.1

2. Nastavení klienta

Sloučte konfiguraci se souborem .vscode/mcp.json nebo s uživatelskou konfigurací MCP. VS Code si vyžádá klíč v maskovaném poli. Klíč nevkládejte do chatu.

Na této stránce se klíč nezadává ani neukládá. Prázdný adresář vypne přístup k místním souborům; i nahrání přes base64 vyžaduje výslovný souhlas.

{
  "inputs": [
    {
      "id": "scanverion-api-key",
      "type": "promptString",
      "description": "API klíč 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. Ověření bez zpracování

Po nastavení klíče v prostředí terminálu spusťte příkaz doctor. Zkontroluje adresáře a funkce dostupné po autentizaci, ale nenahrává soubory ani nepotvrzuje oprávnění ke zpracování.

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

V klientovi MCP zavolejte list_capabilities a načtěte scanverion://guide. Tento samostatný návod přibalený k serveru je v angličtině a obsahuje postup pro MCP Inspector i ukázku se syntetickým vzorkem.

Nástroje a účtování

analyze_document

Zpoplatněné. Ve výchozím stavu pouze Detection; pro OCR a extrakci polí výslovně zvolte Scanner.

analyze_vehicle

Zpoplatněné. Podporuje Detection a Blur.

list_capabilities

Katalog modelů AI a limitů bez poplatku za zpracování; nejde o kontrolu oprávnění.

list_api_capabilities

Veřejný katalog API bez poplatku za zpracování; neověřuje přístup konkrétního účtu.

get_usage_summary

Volání a kredity bez poplatku za zpracování, pro data YYYY-MM-DD včetně obou hranic. Odhad ceny není dostupný, není nulový.

První zpracování dokumentu

Použijte syntetický nebo schválený vzorek v povoleném adresáři. Toto volání nahraje soubor a může spotřebovat kredity.

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

Zadejte právě jeden vstup: filePath nebo imageBase64. Base64 vyžaduje podporovaný název souboru nebo typ MIME. Vstupy JPEG, PNG, WebP a PDF nesmějí být prázdné ani větší než 10 MiB. Výsledky zachovávají text JSON a přidávají structuredContent.data.

Řešení problémů a bezpečné opakování

• CONFIGURATION_ERROR: Zkontrolujte klíč, pole absolutních cest adresářů, HTTPS adresu API a časový limit (1 000 až 300 000 ms).
• INVALID_INPUT: Zkontrolujte přístup k souboru, formát, base64, operace a rozsah dat.
• 401 / 403: Zkontrolujte platnost klíče, přístup k pracovnímu prostoru a rozsah process:write.
• 402 / 429: Zkontrolujte kredity nebo limity volání. Prohlédněte kód chyby, ID požadavku a možnost opakování.
• Časový limit ani zrušení nezaručují vrácení poplatku nebo zastavení práce na serveru. Automatické opakování je vypnuté. Stejný idempotency key použijte pouze pro stejný logický požadavek; duplicita může vrátit 409.

Nepovolujte celé domovské adresáře. Kontrola vyřešených cest blokuje přechod mimo adresář i únik přes symbolické odkazy, ale není izolací na úrovni OS. Proces nezpřístupňujte nedůvěryhodným klientům a nedovolte jiným uživatelům měnit povolené adresáře. Extrahovaný text považujte za nedůvěryhodná data, nikoli za pokyny.