Intégration agents et MCP

Aujourd’hui, un développeur qui intègre Livstick travaille souvent avec un agent à ses côtés, qui lit la documentation et écrit le code. Cette page décrit ce que Livstick met à disposition pour que cet agent s’appuie sur des faits plutôt que sur des suppositions.

Ce qui existe déjà

Trois points sont acquis aujourd’hui, et un agent peut s’appuyer sur chacun d’eux sans avoir à les faire confirmer.

Les deux API client publient leur propre spécification OpenAPI 3.1, servie par l’API elle-même — un agent peut lire le contrat au lieu de le déduire d’exemples.
La configuration du widget Recorder est décrite par un JSON Schema livré dans le package : c’est ce qui permet de compléter et de valider automatiquement la configuration, sans deviner le nom d’un champ.
Cette documentation est rendue côté serveur : chaque page se lit sans exécuter de JavaScript, ce qui la rend accessible à tout outil qui la récupère.

text

GET /api/v3/docs/openapi.v3.1.yaml
GET /v2.1/docs/openapi.v3.1.yaml

Ce qui est prévu

Trois autres éléments sont prévus. Aucun n’est encore disponible : considérez chaque point ci-dessous comme une orientation, pas comme une fonctionnalité utilisable aujourd’hui.

Un index de cette documentation lisible par machine, prévu, avec une version Markdown à côté de chaque page.
Des skills téléchargeables et versionnés, prévus, qu’une équipe pourra déposer dans son propre projet.
Un serveur MCP d’intégration, prévu — décrit en détail ci-dessous.

Le serveur MCP d’intégration

Sa raison d’être est unique : pendant qu’un agent écrit du code d’intégration, il doit vérifier ce qu’il vient de faire — le conteneur a-t-il bien été créé, le message a-t-il bien atteint l’état released, qu’a réellement enregistré l’API ? C’est un outil de vérification, pas un outil d’exécution.

Garanties
Garantie	Signification
Environnement	Environnement de test uniquement — aucune action n’atteint jamais la production.
Accès	Délivré et révoqué depuis le portail client, lié à une plateforme, limité dans le temps.
Lecture par défaut	État d’un conteneur, liste des conteneurs, état et contenu d’un message, liens d’un conteneur — ainsi que la création de conteneurs de test.
Hors périmètre par défaut	notify et unlock — les deux opérations qui atteignent un vrai destinataire.
Journalisation	Chaque appel est journalisé comme un appel d’API et reste visible dans le portail.

Travailler avec un agent aujourd’hui

En attendant la sortie du serveur MCP, le plus utile pour une équipe est de fournir à son agent les sources déjà citées sur cette page — les deux spécifications OpenAPI, ainsi que les trois pages ci-dessous.

Configuration du Recorder: Le JSON Schema qui permet de compléter et de valider automatiquement la configuration du widget.
Conteneurs et messages: La distinction conteneur/message, celle qu’un agent livré à ses suppositions comprend mal le plus souvent.
Identifiants: La distinction crid/urid/editKey, que les mêmes suppositions confondent tout aussi souvent.