L'inventaire que votre assistant IA sait piloter
L'API n'a pas été ajoutée après coup : les Server Actions de l'application et les points d'entrée /api/v1 partagent la même couche de validation et les mêmes règles d'isolation. Ce qu'un agent peut faire, il le fait exactement comme l'interface.
Ce qu'un agent peut faire
Chercher comme un humain
`GET /api/v1/search` accepte une requête en langage courant et renvoie l'objet avec le chemin complet de son emplacement — pas un identifiant à résoudre ensuite.
Déplacer, avec l'historique
`POST /api/v1/items/{id}/move` passe par la même logique que l'interface : l'historique est écrit et la fraîcheur de l'objet mise à jour. Un agent ne peut pas contourner l'audit.
Lire l'arborescence entière
`GET /api/v1/households/{id}/tree` renvoie le logement complet, emplacements imbriqués et QR codes inclus, en une requête.
Créer rappels et prêts
Garanties, entretien, objets prêtés : les mêmes règles de validation que l'application, exposées comme outils.
Deux requêtes, de bout en bout
« Où est ma perceuse ? », puis « range-la dans la boîte bleue ».
curl -H "Authorization: Bearer ***" \
"https://myplace-inventory.vercel.app/api/v1/search?household_id=<uuid>&q=drill+garage"
curl -X POST -H "Authorization: Bearer ***" \
-H "Content-Type: application/json" \
-d '{"location_id":"<uuid>","note":"put away by agent"}' \
"https://myplace-inventory.vercel.app/api/v1/items/<uuid>/move"Réponses structurées { data } / { error: { code, message } }, et le chemin complet renvoyé après chaque mutation — branchable tel quel sur des outils OpenAPI ou des GPT Actions.
Connecteur MCP, en une commande
Claude Desktop, Claude Code et les autres clients compatibles avec le Model Context Protocol Model Context Protocol parlent à votre inventaire sans écrire une seule requête : 21 outils qui reprennent l'API à l'identique — mêmes validations, même isolation, même historique.
claude mcp add --transport http navel https://myplace-inventory.vercel.app/api/mcp \
--header "Authorization: Bearer ***"Puis, en langage courant : « où est la perceuse ? », « range-la dans la boîte bleue », « qu'est-ce que j'ai prêté à Marc ? ». Les suppressions, elles, ne sont pas exposées : un objet dont vous vous séparez change de statut, il ne disparaît pas.
Ce qu'un agent ne peut pas faire
Agir sans un token que vous avez créé
Les tokens se créent depuis Paramètres → API & agents, ne s'affichent qu'une seule fois, sont stockés hachés (SHA-256) et sont révocables à tout moment.
Sortir du foyer autorisé
L'appartenance au foyer est revérifiée à chaque requête, en plus de l'isolation appliquée par la base de données elle-même. Un token ne donne accès qu'aux foyers de son propriétaire.
Créez un compte, puis un token
L'accès API est inclus dans l'offre Patrimoine, et ouvert à tous pendant la bêta.
Créer un compte