Construisez sur les données que votre équipe utilise déjà.
Une API REST et un serveur MCP pour les autres outils d’IA, tous deux en développement, et des webhooks via l’Automatisation dès aujourd’hui. Une clé ne peut rien faire de plus que la personne qui la possède.
Les webhooks de l’Automatisation sont construits. L’API publique et le connecteur MCP sont en développement ; aujourd’hui, les clés d’API ne fonctionnent qu’avec la CLI CyrilSites.
# En développement : factures en retard, au nom du propriétaire de la clé curl "https://app.getcyril.com/api/finance/invoices?status=overdue&limit=2" \ -H "Authorization: Bearer $CYRIL_API_KEY" { "data": [ { "number": "ROWA-0998", "status": "overdue", "currency": "EUR", "total": "50595.00", "amountPaid": "0.00" }, { "number": "ROWA-0997", "status": "overdue", "currency": "EUR", "total": "5272.00", "amountPaid": "0.00" } ], "meta": { "page": 1, "limit": 2, "total": 2, "totalPages": 1 } }
# En développement : que puis-je appeler, et de quoi chaque outil a-t-il besoin ? curl "$CYRIL_MCP_URL/" # Recherche dans Cyril au nom du propriétaire de la clé. # Les données qu’il ne peut pas voir ne sont tout simplement pas renvoyées. curl -X POST "$CYRIL_MCP_URL/tools/call" \ -H "X-API-Key: $CYRIL_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "tool": "search_cyril", "input": { "query": "Crécerelle", "entityTypes": ["project", "ticket", "invoice"] } }'
Un seul jeu d’autorisations, quel que soit l’appelant.
Une clé appartient à la personne qui l’a créée et ne peut rien faire de plus qu’elle. Aujourd’hui, les clés fonctionnent avec l’outil en ligne de commande CyrilSites ; l’API publique et le serveur MCP qui les utiliseront sont en développement.
clé d’API- Lit et modifie les factures
- Lit les sociétés et les contacts
- Aucun accès aux dossiers RH
- Ne peut rien supprimer
403.Une API REST sans surprises.
En développement : la même API que celle sur laquelle est construite l’application Cyril, ouverte à vos clés d’API. Des chemins prévisibles, une seule forme de réponse et des erreurs exploitables.
- Une référence interactiveCouvre aujourd’hui les points de terminaison principaux du compte, de la facturation, des produits et des fichiers, et s’ouvre depuis Paramètres, rubrique Clés d’API. D’autres applications sont en cours d’ajout.
- Des clés que vous contrôlezCréez, limitez et révoquez des clés par organisation. Les limites de débit et l’expiration par clé ne sont pas encore construites.
- Un seul chemin par ressourceOrganisés par application, comme
/api/projects/tasks. Un point de terminaison retiré répond410et indique son remplaçant. - Des listes paginées de la même façonChaque liste accepte
pageetlimit, jusqu’à 100 à la fois, et indique le nombre total. - Un bac à sable pour développerCréez une organisation bac à sable distincte et testez sans toucher aux données réelles.
Erreurs Toutes les erreurs ont la même forme
| Statut | Code | Quand |
|---|---|---|
| 400 | VALIDATION_ERROR | Un champ n’a pas passé la validation. Le message le nomme. |
| 401 | UNAUTHORIZED | La clé est absente, invalide ou révoquée. |
| 403 | FORBIDDEN | La clé est valide ; la personne à qui elle appartient n’a pas le droit. |
| 404 | NOT_FOUND | N’existe pas, ou appartient à une autre organisation. |
| 409 | CONFLICT | Un doublon, comme une adresse e-mail déjà enregistrée. |
| 410 | GONE | Retiré. Le message indique le remplaçant. |
| 422 | UNPROCESSABLE | Valide, mais enfreint une règle métier. |
| 429 | RATE_LIMITED | Ralentissez et réessayez. |
{ "error": "Cannot delete the last organisation owner",
"code": "UNPROCESSABLE" }Laissez d’autres outils d’IA travailler avec Cyril.
En développement. Les outils Cyril qu’il proposera sont écrits ; la connexion depuis des assistants compatibles avec le Model Context Protocol n’est pas encore disponible.
VentesSociétés, contacts, affaires
- list_companies
- read_company
- list_contacts
- read_contact
- list_deals
- read_deal
- search_sales
- create_contact
- update_deal
- log_activity
- send_email
FinanceFactures, devis
- list_invoices
- read_invoice
- list_estimates
- read_estimate
- create_invoice
- create_estimate
ProjetsProjets, tâches
- list_projects
- read_project
- list_tasks
- read_task
- create_task
- update_task_status
SupportTickets, centre d’aide
- list_tickets
- read_ticket
- search_kb
- create_ticket
Docs et outilsEspaces, outils personnalisés
- list_doc_spaces
- read_doc_space
- list_custom_tools
- read_custom_tool
PartoutUne seule recherche
- search_cyril
LectureCréation et mise à jourUne sélection des outils écrits jusqu’ici.
- Rien de destructif
- Il n’existe aucun outil de suppression. Supprimer des données reste l’affaire des personnes, dans Cyril.
- Les règles annoncées d’emblée
- Chaque outil indique l’autorisation dont il a besoin et s’il exige une validation, avant que quiconque ne l’appelle.
- Modifications enregistrées
- Les modifications faites via une clé sont consignées dans le journal d’audit, au nom de la personne qui la possède.
POST https://ops.sorbierconseil.example/hooks/paid
{ "trigger": "invoice.paid",
"payload": {
"invoiceId": "…",
"amount": "66631.00" },
"timestamp": "…" }Des webhooks, sans écrire de serveur.
Dans l’Automatisation, toute règle peut se terminer par l’envoi d’un webhook vers l’URL de votre choix, avec l’événement qui l’a déclenchée. Un webhook entrant peut aussi déclencher une règle.
Les règles s’exécutent sur les mêmes données et avec les mêmes autorisations que tout le reste. En savoir plus sur l’Automatisation.
Ou passez-vous du code.
En développement : décrivez l’outil dont vous avez besoin, Cyril l’ébauche sur des données d’exemple, avec une vérification avant sa mise en service. Un calculateur, un rapport ou une petite application interne, dans Cyril.
Créez vos outilsCe qui est prêt.
Construit signifie que cela existe et est testé aujourd’hui. Vous y aurez accès quand votre organisation obtiendra l’accès anticipé. La liste complète figure sur ce qui est prêt aujourd’hui.
- API RESTAccès avec vos propres clés d’API, en développement
- Pas encore
- Référence de l’APIInteractive ; points de terminaison principaux du compte, de la facturation, des produits et des fichiers
- Construit
- Clés d’APIÀ portée limitée, révocables ; CLI CyrilSites uniquement aujourd’hui
- Construit
- Organisation bac à sableUn espace distinct pour les tests
- Construit
- Serveur MCPOutils écrits ; les clients MCP ne peuvent pas encore se connecter
- Pas encore
- Webhooks dans l’AutomatisationActions sortantes et déclencheurs entrants
- Construit
- Des outils personnalisés qui écrivent dans vos donnéesLes outils construits dans Cyril ne feront d’abord que lire ; l’écriture viendra plus tard
- Pas encore
Obtenez une clé dès que votre place ouvre.
Cyril ouvre d’abord aux membres fondateurs. Ils conservent leur tarif et sont accompagnés pour s’installer, intégrations comprises.
Un seul e-mail, quand votre place ouvre. Rien d’autre.
