Le serveur MCP de Coffrify expose plus de 200 outils à votre assistant, regroupés par familles fonctionnelles. Chaque outil correspond à une opération réelle de l'API REST v1 (créer un transfert, lister des webhooks, interroger l'audit, etc.), mais l'assistant les déclenche pour vous à partir d'une instruction en langage naturel. Une fois la connexion établie (jeton cof_mcp_, serveur https://mcp.coffrify.com/<workspace>), vous n'avez plus à écrire d'appels HTTP : vous formulez votre demande, et l'assistant choisit l'outil adapté, renseigne les paramètres, puis interprète la réponse. Cette page recense les principales familles et leurs outils, avec quelques exemples d'invocation.
Familles d'outils
Les outils sont organisés en familles : transferts, drop-boxes (réception), coffres, collections, magic links, dossiers, templates, webhooks, clés API, workspace, quotas, facturation, analytics, branding, domaines, membres, notifications, sessions, téléchargements, alertes, audit, RGPD, carnet d'adresses, rooms, MFA, status, changelog, SSO / SCIM, recherche globale, approbations, règles & automation, storage et diagnostics. Chaque outil porte un nom préfixé par coffrify_, par exemple coffrify_create_transfer. Les sections suivantes détaillent les familles les plus utilisées.
Transferts
La famille des transferts couvre tout le cycle de vie d'un envoi chiffré : création, recherche, consultation, suppression et opérations avancées (clonage, extension d'expiration, gestion du mot de passe, QR code, timeline). Ce sont les outils les plus courants.
| Outil | Rôle | Scope requis |
|---|---|---|
| coffrify_create_transfer | Créer un nouveau transfert et obtenir les URL de téléversement | transfers:write |
| coffrify_list_transfers | Lister les transferts du workspace avec pagination par curseur | transfers:read |
| coffrify_search_transfers | Rechercher des transferts par statut, date, taille, etc. | transfers:read |
| coffrify_get_transfer | Récupérer les détails complets d'un transfert | transfers:read |
| coffrify_delete_transfer | Supprimer un transfert et révoquer son lien de partage | transfers:write |
| coffrify_clone_transfer | Dupliquer un transfert (nouveau code, compteur remis à zéro) | transfers:write |
| coffrify_extend_transfer_expiry | Repousser la date d'expiration d'un transfert | transfers:write |
| coffrify_get_transfer_timeline | Obtenir la chronologie complète d'un transfert | transfers:read |
Webhooks
La famille des webhooks permet à l'assistant de créer, lister, tester et diagnostiquer vos abonnements aux événements. Les outils de lecture (lister, voir une livraison, métriques de santé) demandent webhooks:read ; les outils d'écriture (créer, modifier, tester, rejouer, faire tourner le secret) demandent webhooks:manage.
| Outil | Rôle | Scope requis |
|---|---|---|
| coffrify_create_webhook | Créer un webhook avec une URL et la liste des événements souscrits | webhooks:manage |
| coffrify_list_webhooks | Lister les webhooks configurés du workspace | webhooks:read |
| coffrify_test_webhook | Envoyer un test signé à l'URL d'un webhook | webhooks:manage |
| coffrify_update_webhook | Modifier l'URL, les événements ou l'état d'un webhook | webhooks:manage |
| coffrify_list_webhook_deliveries | Consulter l'historique des livraisons (statuts, tentatives) | webhooks:read |
| coffrify_replay_webhook_delivery | Rejouer une livraison passée | webhooks:manage |
| coffrify_rotate_webhook_secret | Régénérer le secret de signature avec période de grâce | webhooks:manage |
| coffrify_list_webhook_event_types | Lister le catalogue complet des types d'événements | webhooks:read |
Audit
La famille audit donne à l'assistant un accès en lecture au journal d'activité, avec filtres par acteur, action, ressource et date. Ces outils sont précieux pour la conformité et les enquêtes : vous posez une question, l'assistant interroge le journal et vous résume les entrées pertinentes.
| Outil | Rôle | Scope requis |
|---|---|---|
| coffrify_query_audit_log | Interroger le journal d'audit avec filtres (acteur, action, ressource, date) | audit:read |
| coffrify_audit_export | Exporter le journal au format CSV ou JSON via une URL signée | audit:export |
| coffrify_get_workspace_audit_summary | Résumer l'audit des dernières 24 heures (top acteurs, top actions) | audit:read |
| coffrify_audit_trail_for_transfer | Réunir tous les événements liés à un transfert en un seul appel | audit:read |
Analytics, quotas et facturation
Ces familles permettent à l'assistant de répondre à des questions d'usage et de coût. Les outils analytics (coffrify_analytics_summary, coffrify_top_transfers, coffrify_geo_breakdown, coffrify_conversion_funnel) agrègent téléchargements, bande passante et géographie. Les outils quotas (coffrify_check_quota, coffrify_storage_history, coffrify_bandwidth_daily) comparent votre consommation aux plafonds du plan. Les outils facturation (coffrify_get_subscription, coffrify_get_usage_billing_period, coffrify_tier_recommendation) éclairent le plan le plus adapté.
- analytics:read :
coffrify_analytics_summary,coffrify_top_transfers,coffrify_top_recipients_analytics,coffrify_geo_breakdown,coffrify_conversion_funnel. - quotas:read :
coffrify_check_quota,coffrify_storage_history,coffrify_bandwidth_daily,coffrify_throughput_recent. - billing:read :
coffrify_get_subscription,coffrify_get_usage_billing_period,coffrify_create_billing_portal_link,coffrify_tier_recommendation.
Collections, coffres et drop-boxes
Au-delà des transferts simples, l'assistant gère vos espaces structurés. Les collections regroupent plusieurs transferts en un bundle partageable (coffrify_list_collections, coffrify_create_collection, coffrify_add_to_collection). Les coffres sont des espaces sectionnés de type data room (coffrify_list_coffres, coffrify_create_coffre, coffrify_manage_coffre_sections, coffrify_manage_coffre_items). Les drop-boxes de réception laissent des tiers vous déposer des fichiers (coffrify_list_requests, coffrify_create_request, coffrify_list_request_submissions).
Diagnostics et recherche globale
La famille diagnostics donne à l'assistant des outils d'investigation de haut niveau. coffrify_diagnose_transfer vérifie pourquoi un transfert ne fonctionne pas (expiration, plafond de téléchargements, statut de scan, restrictions géographiques, mot de passe). coffrify_explain_error traduit un code d'erreur en actions concrètes. coffrify_workspace_setup_checklist note l'état d'avancement d'un nouvel espace. Côté recherche, coffrify_global_search interroge en un appel les transferts, coffres, drop-boxes, dossiers, collections et rooms.
Paramètres clés à fournir
Vous n'avez pas à connaître la signature exacte de chaque outil : décrivez simplement votre intention et l'assistant renseigne les paramètres. Voici les informations les plus utiles à préciser dans votre demande pour obtenir un résultat exact du premier coup.
| Pour une action de type | Précisez idéalement |
|---|---|
| Créer un transfert | Le ou les fichiers, l'expiration souhaitée, le nombre maximal de téléchargements, l'éventuel mot de passe et le destinataire |
| Lister ou rechercher | Le filtre (statut, période, taille) et le nombre de résultats voulus |
| Créer un webhook | L'URL de destination et la liste des événements à souscrire |
| Interroger l'audit | L'acteur, l'action ou la ressource concernée et la fenêtre temporelle |
| Diagnostiquer | L'identifiant ou le code de partage du transfert concerné |
Découvrir le catalogue complet
Le serveur MCP annonce la totalité de ses outils à votre client lors de la connexion. Vous pouvez aussi demander directement à l'assistant : « Quels outils Coffrify peux-tu utiliser pour les webhooks ? ». Il listera les outils de la famille concernée et leurs scopes. La liste est régulièrement enrichie, et tout nouvel outil apparaît automatiquement dès qu'il est publié, sans changement de configuration de votre part.