Installer AMR
Écrit pour qu'un agent IA (Claude Code, Cursor, tout client MCP) installe AMR et obtienne seul un premier mandat vérifié. Sans compte, sans e-mail, sans personne à qui demander.
1. Lancer le serveur
Il faut uv. Le paquet PyPI s'appelle « mandatia » (version 0.1.2 au 16/11/2026).
uvx mandatia
# le dernier code du dépôt, à la place :
uvx --from git+https://github.com/JC7333/amr amr
# ou cloner et lancer :
git clone https://github.com/JC7333/amr.git && cd amr && uv sync && uv run amr
uvx amr installe un autre projet, sans rapport : ne l'utilisez pas. AMR fonctionne avec les versions 1 et 2 du SDK Python MCP (mcp>=1.2,<3) ; aucune épingle de version n'est nécessaire.
Tout tourne sur votre machine. AMR ne fait aucun appel réseau, sauf deux options désactivées par défaut : report_issue si l'opérateur définit AMR_ISSUE_TOKEN, et la vérification de clé did:web s'il définit AMR_DID_WEB_RESOLVE=1.
2. Le déclarer dans votre client MCP
# Claude Code
claude mcp add amr -- uvx mandatia
# Autres clients MCP (Cursor : .cursor/mcp.json) : définir les trois chemins
AMR_DB_PATH=/absolute/path/amr_mandates.db
AMR_SIGNING_KEY_PATH=/absolute/path/amr_signing_key.pem
AMR_PUBLIC_KEY_PATH=/absolute/path/amr_signing_key.pub
Par défaut, AMR écrit sa base et sa clé dans le dossier courant du client. Gardez la clé privée .pem hors du contrôle de version.
3. Donner à chaque côté ses seuls outils
Un agent qui peut créer, signer ou révoquer son propre mandat s'autorise lui-même, et le mandat ne prouve alors rien. Définissez AMR_TOOL_PROFILE dans l'environnement de chaque client, tous pointant vers le même AMR_DB_PATH.
| Profil | Qui | Outils |
|---|---|---|
principal | la personne ou l'organe qui donne les mandats | créer, signer, révoquer, contester, prouver |
agent | l'agent qui agit sous un mandat | verify_mandate, issue_action_token, log_action, issue_mandate_attestation, get_registry_public_key ; create_mandate uniquement pour des sous-mandats sous son propre mandat |
receiver | un tiers sur lequel l'agent agit | check_action_token, get_registry_public_key |
full (par défaut) | tests et installations à un seul utilisateur | tous les outils |
Dans le code de main depuis le 14/11/2026, pas encore dans la version 0.1.2 publiée : chaque outil porte les annotations MCP (readOnlyHint, destructiveHint, idempotentHint, openWorldHint). Le client s'en sert pour savoir quels appels demandent votre accord : les uns ne font que lire (verify_mandate, get_proof), d'autres ajoutent au registre (create_mandate, log_action), revoke_mandate est définitif, register_principal_key et report_issue peuvent joindre le réseau si l'opérateur l'active. Ce sont des indications pour le client, pas une protection : AMR applique ses propres règles, quoi que le client en fasse. python -m amr.tools_list les affiche outil par outil.
4. Le premier mandat, dans cet ordre
create_mandate, verify_mandate, log_action, issue_mandate_attestation avec get_registry_public_key, revoke_mandate, get_proof.
Un exemple exécutable, vérifié par la suite de tests : uv run python examples/quickstart_agent.py.
Résumés lisibles par machine : AGENTS.md, llms.txt du dépôt, llms.txt de ce site, README.
Les 19 outils
Rangés par ce qu'ils servent à faire. Les limites connues sont écrites à côté de l'outil concerné.
Autoriser
- create_mandate
Enregistrez un mandat, c'est-à-dire l'instruction écrite, datée et signée par laquelle une personne identifiée fixe ce que son agent peut faire en son nom. Il porte le mandant (une personne, ou un organe par sa décision), l'agent, le périmètre, l'acte qui donne au signataire le pouvoir d'autoriser (délégation de pouvoir, décision d'organe, contrat) et l'échéance. Chaque mandat est hashé SHA-256 et chaîné.
- register_principal_key
Le mandant enregistre sa propre clé publique Ed25519, pour que ses mandats portent sa signature.
Limite connue : pour un
principal_idordinaire, le registre ne vérifie pas qui enregistre une clé (la première enregistrée gagne) ; une signature valable prouve donc la possession de cette clé, pas l'identité de la personne derrière. Un identifiantdid:webcomble ce manque au niveau d'un nom de domaine : la clé n'est acceptée que si le domaine la publie (option réseau, désactivée par défaut). - prepare_mandate_signature
Les octets exacts d'un mandat que le mandant signe avec sa propre clé. Un agent ne peut pas signer à sa place.
- prepare_mandate_pdf
Le mandat en PDF, que le mandant lit et signe avec son propre outil de signature. Le registre ne le signe pas ; une fois signé, le fichier va à attach_signed_mandate_pdf.
- attach_signed_mandate_pdf
Vérifie, hors ligne, la signature PAdES posée par le mandant sur ce PDF, selon les autorités de confiance choisies par l'opérateur, et inscrit le signataire dans la preuve. Il ne lit pas les listes de confiance européennes, ne vérifie pas la révocation et ne décide pas si le signataire peut engager le mandant.
Verrouiller
- issue_action_token
Le verrou. AMR se place dans la couche d'émission de jetons. Pas de mandat valide → pas de jeton JWS signé Ed25519 → pas d'action possible. Verrou structurel avant l'acte, pas un audit après. Dans le code open source depuis le 23 avril 2026.
- check_action_token
Revérifier un jeton d'action auprès du registre au moment d'agir : la signature prouve l'autorisation à l'émission, ce contrôle dit si elle tient encore.
Vérifier
- verify_mandate
Avant une action sensible, l'agent vérifie que son mandat est valide, actif et non révoqué, et que chaque mandat au-dessus de lui l'est aussi. Un appel. La réponse rend le périmètre du mandat, elle ne juge pas l'action : c'est
issue_action_tokenqui refuse une action hors périmètre.Dans le code de main depuis le 15/11/2026, pas encore dans la version 0.1.2 publiée : avec
mandate_id, la réponse porte sur ce seul mandat. Un mandat révoqué, expiré ou détenu par un autre agent répond non, même si l'agent en a un autre en vigueur. - issue_mandate_attestation
Une attestation signée d'un mandat, que l'agent montre à un tiers. Le destinataire la vérifie hors ligne avec la clé publique du registre, sans compte.
- get_registry_public_key
La clé publique du registre, pour vérifier attestations et jetons sans appeler le registre.
Prouver
- log_action
Enregistrez chaque action prise sous un mandat. Chaque événement est hashé, horodaté et chaîné au mandat parent. Piste d'audit dont toute modification se voit, par construction.
- get_proof
Générez une preuve cryptographique de tout mandat ou action. Vérification de chaîne SHA-256. Toute modification se voit. Vérifiable par un tiers.
- export_insurer_dossier
Un dossier signé d'un mandat sur une période, pour un assureur ou un auditeur : périmètre, statut, sous-mandats, actions, jetons et contrôles d'intégrité. JSON et page imprimable.
Retirer, contester, signaler
- revoke_mandate
Révoquer un mandat maintenant. Définitif. Le mandat et toute sa branche de sous-mandats s'arrêtent aussitôt ; les jetons déjà émis sont signalés jusqu'à leur fin.
- prepare_revocation_signature
Les octets d'une révocation que le mandant signe, quand il a une clé enregistrée.
- contest_action
Consigner qu'un mandant conteste un acte déjà accompli par un agent : une trace datée et chaînée, une par acte, non modifiable.
- prepare_contest_signature
Les octets d'une contestation que le mandant signe, quand il a une clé enregistrée.
- list_action_contests
Lister les actes contestés, avec un rappel de délai de réponse choisi par l'opérateur. Aucun délai légal n'est calculé.
- report_issue
Signaler un problème d'AMR lui-même. Sans jeton de l'opérateur, aucun appel réseau : un lien prérempli à ouvrir.