Készítse el első integrációját.

Helyi stdio / nyilvános npm-csomag

Tegye elérhetővé a Scanverion eszközeit VS Code- vagy Claude Desktop-ügynökének. A nyilvános npm-csomag helyben, stdio kapcsolaton fut, és a jóváhagyott bemeneteket az API-ba tölti fel; az OCR nem helyben történik. A hosztolt HTTP MCP korlátozott, API-kulcsos fejlesztői előzetes, nem általánosan elérhető szolgáltatás és nem MCP OAuth. Ez az útmutató a helyi stdio beállítását ismerteti.

1. A csomag telepítése

Használjon Node.js 22 vagy újabb verziót és npm-et. Telepítse a nyilvános csomagot egy külön telepítési könyvtárba a megadott paranccsal. Az npm a Scanverion SDK függőséget is telepíti. Kódtár-hozzáférés nem szükséges.

npm install @scanverion/mcp-server@0.1.1

2. A kliens beállítása

Egyesítse ezt a .vscode/mcp.json fájllal vagy a felhasználói MCP-konfigurációval. A VS Code rejtett beviteli mezőben kéri a kulcsot. Ne írja a kulcsot csevegésbe.

Ezen az oldalon nem kell kulcsot megadnia, és nem tárolunk kulcsot. Az üres könyvtármező letiltja a helyi fájlelérést; a base64-feltöltéshez is kifejezett jóváhagyás szükséges.

{
  "inputs": [
    {
      "id": "scanverion-api-key",
      "type": "promptString",
      "description": "Scanverion API-kulcs",
      "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. Ellenőrzés feldolgozás nélkül

A kulcs terminálkörnyezetben történő beállítása után futtassa a doctor parancsot. Ellenőrzi a könyvtárakat és a hitelesítéssel elérhető funkciókat, de nem tölt fel fájlokat, és nem igazolja a feldolgozási jogosultságot.

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

Az MCP-kliensben hívja meg a list_capabilities eszközt, és olvassa el a scanverion://guide erőforrást. Ez a kiszolgálóhoz mellékelt külön útmutató angol nyelvű; MCP Inspector-leírást és szintetikus mintával végzett példát tartalmaz.

Eszközök és számlázás

analyze_document

Díjköteles. Alapértelmezésben csak Detection; OCR-hez és mezőkinyeréshez külön kérje a Scanner műveletet.

analyze_vehicle

Díjköteles. A Detection és Blur műveleteket támogatja.

list_capabilities

AI-modellek és korlátok katalógusa feldolgozási díj nélkül; nem jogosultság-ellenőrzés.

list_api_capabilities

Nyilvános API-katalógus feldolgozási díj nélkül; nem ellenőrzi az adott fiók hozzáférését.

get_usage_summary

Hívások és kreditek feldolgozási díj nélkül, YYYY-MM-DD dátumokkal, mindkét határnapot beleértve. A költségbecslés nem érhető el, nem nulla.

Az első dokumentumhívás

Használjon szintetikus vagy jóváhagyott mintát az engedélyezett könyvtárban. Ez a hívás feltölti a fájlt, és krediteket fogyaszthat.

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

Pontosan egy bemenetet adjon meg: filePath vagy imageBase64. A base64 támogatott fájlnevet vagy MIME-típust igényel. A JPEG, PNG, WebP és PDF bemenet nem lehet üres, és legfeljebb 10 MiB méretű lehet. Az eredmények megtartják a JSON-szöveget, és hozzáadják a structuredContent.data mezőt.

Hibaelhárítás és biztonságos újrapróbálkozás

• CONFIGURATION_ERROR: Ellenőrizze a kulcsot, az abszolút könyvtárutak tömbjét, az API HTTPS-címét és az időkorlátot (1 000–300 000 ms).
• INVALID_INPUT: Ellenőrizze a fájlelérést, formátumot, base64-kódolást, műveleteket és dátumtartományt.
• 401 / 403: Ellenőrizze a kulcs érvényességét, a munkaterület elérését és a process:write jogosultságot.
• 402 / 429: Ellenőrizze a krediteket vagy a híváskorlátokat. Vizsgálja meg a hibakódot, a kérésazonosítót és az újrapróbálhatóságot.
• Az időtúllépés és a megszakítás nem garantál visszatérítést vagy a szerveroldali munka leállását. Az automatikus újrapróbálkozás ki van kapcsolva. Ugyanazt az idempotenciakulcsot csak ugyanahhoz a logikai kéréshez használja; az ismétlés 409 választ adhat.

Ne engedélyezzen teljes felhasználói könyvtárakat. A feloldott útvonalak ellenőrzése blokkolja a könyvtárból való kilépést és a szimbolikus hivatkozásokon át történő kijutást, de nem operációs rendszer szintű elkülönítés. Ne tegye elérhetővé a folyamatot nem megbízható klienseknek, és ne engedje más felhasználóknak módosítani a jóváhagyott könyvtárakat. A kinyert szöveget nem megbízható adatként, ne utasításként kezelje.