Pyrolis
Référence API
Deux surfaces sont montées sur la console. L'une est utilisable aujourd'hui, l'autre est en place mais n'expose encore aucune ressource — autant le dire ici plutôt que vous le laisser découvrir à la première requête.
MCP — /mcp · disponible
C'est la surface qui fonctionne, et la plus inhabituelle. Les actions métier sont exposées comme outils MCP (Model Context Protocol, révision 2024-11-05, en streamable-HTTP) : une quatre-vingtaine d'outils sur dix domaines — clients, devis et commandes, factures et encaissements, parc, missions et comptes rendus, catalogue, réglementaire, agences et équipes.
Un assistant compatible appelle les mêmes actions que la console, avec les mêmes validations et les mêmes autorisations. Chaque appel s'exécute en tant que le membre dont la clé provient : sa clé ne lui ouvre rien de plus que son écran.
1 · Obtenir une clé
Demandez-la à l'équipe Pyrolis en précisant quel utilisateur doit la porter — la clé hérite de son rôle et de son périmètre, et c'est son nom qui apparaîtra au journal d'audit. Elle vous est transmise une seule fois, et vaut 180 jours.
2 · Brancher Claude Code
Une commande, dans le terminal :
claude mcp add --transport http pyrolis \ https://app.pyrolis.fr/mcp \ --header "Authorization: Bearer $PYROLIS_MCP_KEY"
3 · Brancher Claude Desktop
Claude Desktop parle le MCP local ; on passe donc par le pont mcp-remote. Ajoutez ceci à claude_desktop_config.json (menu Réglages → Développeur → Modifier la configuration), puis redémarrez l'application :
{
"mcpServers": {
"pyrolis": {
"command": "npx",
"args": [
"-y", "mcp-remote",
"https://app.pyrolis.fr/mcp",
"--header", "Authorization: Bearer VOTRE_CLÉ"
]
}
}
}
4 · Vérifier que ça marche
Demandez-lui quelque chose que seule votre base peut savoir — par exemple : « Combien de vérifications sont en retard, et sur quels sites ? » ou « Liste les factures échues depuis plus de 30 jours. » Une réponse chiffrée et nominative signifie que la connexion, la clé et le périmètre sont bons.
| Si ça coince | Cause la plus probable |
|---|---|
| 401 | Clé absente, expirée, ou clé de tablette : celles-ci n'ouvrent pas le MCP, c'est délibéré. Il faut une clé liée à un utilisateur. |
| L'assistant ne voit aucun outil | Configuration non rechargée — redémarrez le client. |
| Il répond mais ne voit pas certaines données | Le rôle du porteur de la clé. Un technicien n'a pas les montants ; c'est le comportement attendu, pas une panne. |
JSON:API — /api/json · pas encore ouvert
Le routeur est monté et la spécification OpenAPI est servie, mais aucune ressource n'y est publiée à ce jour : une requête sur une collection répond 404, et le schéma en ligne ne décrit pour l'instant que l'enveloppe d'erreurs.
| Explorateur | /api/json/swaggerui |
| Schéma | /api/json/open_api |
Quand des ressources y seront publiées, ce sera au format JSON:API — une spécification, pas du REST écrit à la main : filtres, tris, pagination et inclusion de relations y obéissent partout aux mêmes règles. En attendant, MCP couvre les mêmes actions.
RPC — /rpc/run · interne
La surface que l'application technicien utilise pour synchroniser. Son contrat suit les besoins de la PWA et change avec elle : n'écrivez pas d'intégration contre elle.
Authentification
Par clé, en en-tête Authorization: Bearer, adossée au compte du membre qui la porte — d'où le périmètre et les droits de la clé.