# L’API couvre tout ce que fait l’interface

Chaque écran de Krokul fonctionne sur l’API qui vous est ouverte : clés aux droits du rôle, webhooks avec relances, documentation issue du code et MCP pour les agents IA.

**En bref.** Krokul est un CRM B2B doté d’une API publique v1 qui couvre toutes les données et actions de l’interface, puisque l’interface elle-même fonctionne dessus. Les clés d’API se créent avec les droits d’un rôle et un journal des appels ; les webhooks envoient les événements (affaire, document, paiement, entreprise cliente) avec une file de livraison, des relances et un journal ; la documentation en anglais est générée depuis la spécification du code et contient des exemples tirés de réponses réelles ; le serveur MCP permet aux agents IA de lire et d’agir dans la limite des droits de la clé. Tout cela fait partie du produit et ne demande pas d’offre supérieure.

**Offre :** Disponible à partir de l’offre Finances, $149 par mois ; MCP et limites plus élevées avec Marge

## Ce que cela donne sans Krokul

2. Un webhook n’est pas arrivé parce que le serveur du client était en panne pendant trois minutes. L’événement est perdu, la commande n’est pas créée, et personne ne s’en aperçoit.
3. L’API n’existe que dans l’offre la plus chère, et la documentation tient en trois pages sans exemples. L’intégration coûte plus que le CRM.

## Ce que fait Krokul

### Une seule API pour l’écran et pour vous

L’interface de Krokul appelle les mêmes routes que celles qu’ouvre une clé d’API. Un champ que vous voyez à l’écran est aussi dans l’API, par construction et non par promesse.

### Des clés avec les droits du rôle

Une clé se crée pour un rôle : commercial, comptable, lecture seule. Ce que le rôle ne peut pas faire, la clé non plus ; chaque appel est journalisé.

### Des webhooks avec file

Les événements sur les affaires, les documents, les paiements et les entreprises clientes partent vers votre URL avec une file, des relances en cas d’échec et un journal de livraison. Les événements non livrés sont visibles et peuvent être renvoyés à la main.

### Une documentation issue du code, et MCP

La spécification découle du code et les exemples de réponses réelles : la documentation ne se périme pas. Le serveur MCP connecte les agents IA avec les mêmes droits que la clé.

## Comment ça marche

1. **Créez une clé pour un rôle** Dans les paramètres : nom, rôle, date d’expiration. La clé voit exactement ce que verrait une personne ayant ce rôle.
2. **Lisez la documentation et ses exemples** Une documentation en anglais qui décrit chaque route et ses champs, avec des exemples de réponses, à l’adresse indiquée dans le pied de page du site.
3. **Connectez les webhooks** Une URL et des événements ; le journal de livraison affiche chaque tentative avec son code de réponse. En cas d’échec, la relance se fait selon un calendrier ou à la main.
4. **Connectez un agent via MCP** Une clé et l’adresse MCP, et un agent IA externe lit les données et propose des actions dans la limite de ses droits, avec le même journal.

## Résultat

- Aucun événement ne se perd : la file et les relances livrent le webhook, et le journal montre chaque tentative.
- L’API, les webhooks et MCP ne sont pas facturés à part : ils font partie du produit.

## Ce qui n’est pas inclus

## Questions

### L’API couvre-t-elle vraiment tout ?

Oui, parce que l’interface fonctionne sur les mêmes routes : nous n’avons pas d’API « interne » distincte aux capacités plus larges.

### Comment limiter ce qu’une clé peut voir ?

Par le rôle. Une clé en lecture seule ne peut rien créer ; une clé avec le rôle commercial ne verra pas le coût de revient. Le serveur l’impose.

### Et si un webhook n’arrive pas ?

Le journal de livraison affiche la tentative et le code de réponse ; la relance se fait automatiquement selon un calendrier ou à la main d’un clic.

### Qu’est-ce que MCP et à quoi sert-il ?

Un protocole que les agents IA utilisent pour lire des données et appeler des actions. Krokul a son propre serveur MCP : connectez un agent avec une clé, et il verra exactement ce que le rôle autorise.

### Combien coûte l’API ?

L’API, les clés et les webhooks sont inclus dans l’offre Finances, $149 par mois ; MCP et les limites d’appels plus élevées sont dans l’offre Marge. Les enregistrements créés via l’API comptent comme des transactions, comme ceux créés à l’écran.

### Comment connecter un service absent du Marketplace ?

Avec une règle d’intégration personnalisée : Kro la rédige à partir de votre description, la règle est testée sur des événements d’exemple et ne s’active qu’après ce test. Le service envoie un événement à l’adresse de la règle — Krokul retrouve l’affaire, le document ou le contact et crée un paiement, un contact ou une tâche ; chaque événement reste dans le journal. Les règles personnalisées sont incluses dans l’offre Margin.

## Ouvrez la documentation et faites votre première requête

Créez une clé dans les paramètres, appelez la route « entreprises clientes » et obtenez votre liste, en cinq minutes, sans écrire au support.

Inclus dans l’offre Finances.

## Suite de la chaîne

- [Automatisations : le système fait la routine et montre pourquoi](https://krokul.com/fr/solutions/automations/index.md)
- [Le rôle décide qui voit quoi. Le serveur l’impose](https://krokul.com/fr/solutions/security/index.md)
- [Vos données sont à vous : API, export et retour arrière dès le premier jour](https://krokul.com/fr/solutions/data/index.md)
- [Un assistant IA qui configure le système en mots simples](https://krokul.com/fr/solutions/assistant/index.md)

---

Application: https://app.krokul.com/ · API: https://app.krokul.com/api/v1/docs