Laat uw agent het bewijs ophalen.
"Ga naar Vidimus en bezorg me het bewijs van dit betwiste geval." Vidimus is gebouwd om óók door agents gebruikt te worden — Claude, ChatGPT of uw eigen automatisering. Drie lagen: een leesbare samenvatting voor modellen (llms.txt), een volledig beschreven API (OpenAPI · Swagger) en een MCP-server met kant-en-klare tools. Publieke feiten zonder sleutel; uw eigen dossiers met een eigen sleutel voor uw agent, nooit de sleutel van uw organisatie.
| Opdracht van de gebruiker | Wat de agent doet | Sleutel |
|---|---|---|
| "Is registratie reg_… nog geldig en onaangeraakt?" | GET /verify/{id} → alle controles, ook de gekwalificeerde tijdstempel | nee |
| "Toon me alles over zending VAC-2026-007." | GET /passport/{ref} → tijdlijn over alle partijen (alleen feiten) | nee |
| "Controleer deze bewijsbundel van een leverancier." | POST /verify-upload (zip) → oordeel + controles | nee |
| "Bezorg me het bewijs van de meerwerkbon van blok B." | GET /registrations?ref=… → /dossier → /bundle | ja |
| "Is deze pdf de versie die we destijds vastlegden?" | SHA-256 lokaal → POST /lookup → match + bewijs | ja |
| "Leg deze afleverbon vast en laat de ontvanger tekenen." | POST /registrations → POST /registrations/{id}/share (QR/mail) | ja |
| "Toon de temperatuurreeks van logger TL-0917." | GET /sources/{id}/reeks → elke meting van die meetbron met haar vingerafdruk (een meting heeft geen deellink) | ja |
| "Zet een opdracht klaar voor de chauffeur." | POST /streams/{id}/opdracht → wallet-link, gemaild of als QR | ja |
Gehost, niets te installeren. Geef uw agent één adres en een eigen sleutel, nooit de sleutel van uw organisatie. U maakt hem in de app, onder Verbinden. Op het tabblad AI-assistent krijgt uw assistent een sleutel die opzoekt en controleert, of een sleutel die vastlegt in één logboek en dan alleen ziet wat hij zelf vastlegde. Intrekken werkt meteen, zonder uw systemen te raken. Zonder sleutel werken alleen de publieke tools.
{"mcpServers": {"vidimus": {
"type": "http", "url": "https://app.vidimus.be/mcp",
"headers": {"x-api-key": "${VIDIMUS_MCP_KEY}"}}}}
De sleutel staat altijd in de header x-api-key (of Authorization: Bearer), het liefst uit een omgevingsvariabele, nooit in een adres.
| Programma | Werkt het? |
|---|---|
| Claude Code, Cursor, VS Code, Codex | Ja, met de sleutel in de header. In de app staat per programma het fragment om te kopiëren. |
| Claude in de browser, de Claude-app, ChatGPT | Nog niet: die vragen een aanmelding in plaats van een sleutel. Daar werken we aan. Tot dan werken ze alleen voor publieke controles. |
Een koppeling bouwen met uw agent. Voor een systeem of toestel (TMS, WMS, sensor) maakt de beheerder het eerst aan onder Verbinden. Dan krijgt uw agent een testsleutel (vks_test_…, servernaam vidimus-test, omgevingsvariabele VIDIMUS_TEST_KEY): die legt niets vast, en elk antwoord bevat "proef": true. De agent kijkt met connection_status wat er klaarstaat en test met test_measurement of test_registration tot het antwoord "aanvaard": true bevat. Daarna stuurt de code van het systeem zelf één bericht met de testsleutel. Pas dan staat er "Test geslaagd" en maakt de beheerder de echte sleutel. Die hoort in het systeem als VIDIMUS_API_KEY, nooit in de chat, in code of in een MCP-verbinding.
Let op: er bestaat géén Vidimus-pakket op PyPI van ons. Wie pip install vidimus doet, installeert de code van iemand anders. Gebruik alleen het adres hierboven.
Tools: verify_registration · passport · list_registrations · list_streams · get_dossier · get_content · register · connection_status · test_measurement · test_registration · create_share · tamper_check · usage · explain.
Gebruiker: "Bezorg me het bewijs van de betwiste aflevering van vrijdag, container MSKU 452 118-0."
Agent: passport("MSKU 452 118-0") → vindt de aflevering + de bevestiging van de terminal
get_dossier(reg_…) → het leesbare dossier
verify_registration(reg_…) → "GELDIG: inhoud, handtekeningen en tijdstempels kloppen."
Elke bewijsbundel bevat een zelfstandig controlescript (verify_bundle.py, Python 3 met het pakket cryptography) en de tijdstempeltokens (RFC 3161), waaronder de gekwalificeerde tijdstempel van een gekwalificeerde vertrouwensdienstverlener op de EU-vertrouwenslijst. Een agent — of uw IT — controleert dus zonder één verbinding met ons:
python3 verify_bundle.py bundel.zip → GELDIG · 7 van 8 nagerekend (het Bitcoin-blok vergelijkt u online) openssl ts -reply -token_in -in tijdstempel.tsr -text → tijdstip + Merkle-wortel van de tijdstempeldienst https://eidas.ec.europa.eu/efda/tl-browser/ → uitgever van gekwalificeerd.tsr staat als gekwalificeerd op de EU-vertrouwenslijst