MCP et intégrations

Claude (MCP)

Claude parle à tryVidimus par un serveur MCP : un petit programme qui s'exécute sur votre ordinateur et appelle l'API avec votre clé. Il donne neuf outils à Claude, dont un seul écrit quelque chose.

Sur npm : @tryvidimus/mcp

Claude Code

Ajoutez le serveur avec une commande :

$ claude mcp add tryvidimus -e TRYVIDIMUS_API_KEY=sk_test_… -- npx -y @tryvidimus/mcp

Claude Desktop

Ouvrez Paramètres, puis Développeur, puis Modifier la configuration, et ajoutez :

{
  "mcpServers": {
    "tryvidimus": {
      "command": "npx",
      "args": ["-y", "@tryvidimus/mcp"],
      "env": { "TRYVIDIMUS_API_KEY": "sk_test_…" }
    }
  }
}

Les outils

• create_capture_session — Crée une session de capture et renvoie le lien à envoyer à la personne qui prend les photos. Le seul outil qui écrit.
• list_proofs — Liste vos preuves, avec des filtres.
• get_proof — Statut d'une preuve, son étape, la cause d'un échec, ses fichiers.
• get_media_access_link — Un lien temporaire vers la copie signée d'un fichier (jamais l'original).
• verify_proof — Recalcule les empreintes et vérifie l'horodatage d'une preuve (et, pour les anciennes preuves horodatées par lot, son inclusion dans le lot), sans croire notre serveur.
• list_webhook_endpoints — Liste vos endpoints de webhook (jamais les secrets).
• get_credits — Votre solde en euros : ajouté, dépensé, restant.
• list_credit_transactions — Les mouvements du solde : fonds ajoutés, et débits avec la preuve qui les a causés.
• list_capture_templates — Vos modèles de capture, dont vous donnez le nom en créant une session. En lecture seule : les modèles se gèrent par l'API ou la ligne de commande.

Utilisez une clé de bac à sable (sk_test_…). Le serveur refuse une clé de production, sauf si vous définissez TRYVIDIMUS_MCP_ALLOW_LIVE=true. La clé reste dans l'environnement : elle n'est jamais donnée au modèle.

ChatGPT

ChatGPT ne peut pas lancer un programme sur votre ordinateur : il ne peut donc pas utiliser le serveur MCP. Créez plutôt un GPT personnalisé avec une Action : ChatGPT appelle alors l'API lui-même, à partir du schéma.

1. Dans ChatGPT, créez un GPT, ouvrez Configurer, puis Créer une action.
2. Choisissez Importer depuis une URL et collez l'adresse du schéma :
3. Dans Authentification, choisissez Clé d'API, puis Bearer, et collez une clé de bac à sable (sk_test_…).
4. Testez une opération dans l'aperçu.

https://api.tryvidimus.com/openapi.json

Toute personne qui utilise votre GPT appelle l'API avec la clé que vous avez collée. Utilisez une clé de bac à sable, et gardez le GPT pour vous ou votre équipe.

Postman et autres outils d'API

Importez l'adresse du schéma dans Postman, Insomnia ou Bruno, puis donnez une clé de bac à sable comme jeton bearer. Chaque route, chaque champ et chaque exemple viennent avec.

Ligne de commande

Un outil en ligne de commande tryvidimus (connexion, sessions, modèles de capture, solde, preuves, vérification, webhooks) est construit et sera publié au lancement. Il a les mêmes garde-fous : la clé n'est jamais passée en argument.

Sur npm : @tryvidimus/cli