API publique et MCP
Créez des intégrations et donnez aux assistants un accès limité, en lecture seule, aux données de votre entreprise.
Explorer l’API publique
L’API publique v1 permet de lister et de consulter les contacts, factures, devis, ventes, interventions, produits, dépenses, paiements et fournisseurs. Utilisez /v1 sur le nom d’hôte de votre entreprise. Le contrat OpenAPI est généré à partir de schémas Zod et vérifié pour détecter toute divergence.
Un accès contrôlé par votre entreprise
Un propriétaire crée une clé API d’entreprise dans Paramètres → Clés API et sélectionne les autorisations de lecture nécessaires. Transmettez la clé comme identifiant Bearer dans l’en-tête Authorization. La clé détermine l’entreprise et les données accessibles; chaque requête exige l’autorisation de lecture correspondante.
Connecter un assistant avec MCP
Le point d’accès MCP est /mcp sur le nom d’hôte de votre entreprise. Il utilise Streamable HTTP avec la même clé API Bearer. Ses deux outils en lecture seule, list_records et get_record, permettent de lister les enregistrements d’une entité ou de consulter un enregistrement par identifiant. Chaque appel exige l’autorisation de lecture de l’entité correspondante. Les outils d’écriture et la configuration OAuth ne sont pas disponibles en v1.
Consulter le guide de connexion à l’API publique et à MCP (llms.txt, en anglais)
Limites d’utilisation
Des limites de débit s’appliquent par adresse IP et par clé. Les lectures réussies de l’API publique et les appels d’outils MCP partagent un quota mensuel de crédits par entreprise, avec un plafond strict. Les propriétaires peuvent consulter l’utilisation dans Paramètres → Clés API.