# Superdocu — démarrage rapide pour agents IA > Superdocu est une plateforme de collecte de documents et de conformité. Les entreprises demandent des documents et des informations à leurs contacts (clients, fournisseurs, salariés), les valident et suivent leurs dates d'expiration. Un agent peut lire et agir sur un compte Superdocu via MCP, l'API REST v2 ou la CLI. Mêmes droits et mêmes règles métier partout. ## 1. Serveur MCP (assistants IA) - URL : https://app.superdocu.com/mcp - Transport : Streamable HTTP, JSON-RPC - Auth : OAuth 2.1 + PKCE (S256), enregistrement dynamique du client (RFC 7591). Pas de clé API, pas de fichier de config. - Claude : Réglages > Connecteurs > Ajouter un connecteur personnalisé > coller l'URL > se connecter > valider les droits - ChatGPT : Réglages > Connecteurs > ajouter un connecteur MCP avec la même URL - Scopes : mcp (toujours), see_all_contacts, manage_contacts, validate_documents, manage_workflows, manage_portals. L'utilisateur peut décocher chacun d'eux. - Jetons : JWT, 1 h, renouvelés automatiquement. Un outil exige aussi la permission de rôle correspondante (sinon : permission_denied). - Ressource : superdocu://resources/workflow-blueprint (grammaire des champs pour workflow_create et step_input_add) - Guide : https://developers.superdocu.com/mcp ## 2. Outils MCP (75) - identité : me_show - contacts : contact_list, contact_show, contact_create, contact_update, contact_delete, contact_invite, contact_enable, contact_disable, contact_remind, contact_download, contact_timeline_global, contact_timeline_contact - workflows des contacts : contact_workflow_list, contact_workflow_show, contact_workflow_create, contact_workflow_update, contact_workflow_archive, contact_workflow_unarchive, contact_workflow_delete, contact_workflow_download - validation : dashboard_show, documents_group_show, documents_group_approve, documents_group_request, documents_group_mark_not_applicable, documents_group_approve_not_applicable, documents_group_refuse_not_applicable, documents_group_update_expiration, documents_group_delete, custom_documents_group_create, document_approve, document_reject, document_url, document_delete, step_request_show, step_request_approve, step_request_reject, step_request_update - modèles de workflow : workflow_list, workflow_show, workflow_create, workflow_update, workflow_enable, workflow_disable, workflow_duplicate, workflow_update_reminders, workflow_state_create, workflow_state_update, workflow_state_reposition, step_input_add, step_input_attach, step_input_update, step_input_reposition, step_input_set_conditions, company_document_type_list, company_document_type_show - portails : portal_list, portal_show, portal_create, portal_update, portal_delete, portal_publish, portal_unpublish - autres : reminder_options, reminder_list, contact_tag_list, contact_tag_create, contact_tag_delete, shared_document_list, shared_document_url, shared_document_update, shared_document_update_position, shared_document_delete, download_show ## 3. API REST v2 (votre code) - URL de base : https://api.superdocu.com/api/v2 - En-têtes : Authorization: Bearer <JWT> ; Accept: application/vnd.api+json (JSON:API) - Jetons : créés dans l'admin Superdocu (Développeurs). Plan Pro ou supérieur. - Boucle : GET /me (vérifier les droits) > GET /dashboard (actions en attente typées : validate_document, validate_form_answer, review_not_applicable) > lire available_actions / unavailable_actions sur la ressource > agir > recommencer - Ne codez pas de machine à états en dur : lisez d'abord available_actions. Si la raison est permission_denied, remontez à un humain. - Idempotence : Idempotency-Key (UUID v4) sur POST/PATCH/DELETE, conservée 48 h. Un rejeu renvoie Idempotent-Replay: true. - Pagination : per_page 1-100, curseurs after / before, has_more, next_cursor - Limites par jeton : lectures 600/min, écritures 200/min, écritures qui envoient des emails 30/min, téléchargements et imports 10/min. 429 + Retry-After. - Erreurs : JSON:API avec un code stable (permission_denied, not_found, validation_failed, rate_limited, invalid_cursor, build_mode_active...) - Doc pour LLM (Markdown brut) : https://developers.superdocu.com/api-v2/tutorial.md - Référence OpenAPI : https://developers.superdocu.com/api ## 4. CLI (agents de code, scripts) - Installation : brew install Superdocu/tap/superdocu (ou : curl -fsSL https://raw.githubusercontent.com/Superdocu/cli/main/install.sh | sh) - Auth : superdocu login --token <jwt> ; vérifier : superdocu whoami - Exemples : superdocu dashboard get ; superdocu contacts list --filter-status active ; superdocu documents-groups request <id> --requested-message "..." - Sortie : JSON lisible, --raw en compact, -o <fichier> pour les exports. --idempotency-key <uuid> sur les mutations. - Dépôt : https://github.com/Superdocu/cli (macOS, Linux) ## 5. Webhooks - Événements (11) : documents_group_to_review, documents_group_will_expire, documents_group_expired, documents_group_rejected, contact_complete, contact_invited_to_workflow, contact_workflow_started, contact_workflow_complete, step_request_submitted, step_request_approved, step_request_rejected - Signature : X-Hub-Signature = base64(SHA256(verify_token + X-Hub-Timestamp)) - Nouvelles tentatives pendant 2 jours en cas de 4xx/5xx. Gérez les doublons. - Doc : https://developers.superdocu.com/webhooks ## 6. Limites - Pas de dépôt de fichiers via MCP (documents, imports CSV) : passez par l'API ou la CLI. - Étapes, modules et workflows ne se suppriment pas via MCP : désactivez le workflow. - Modifier un workflow ne s'applique qu'aux prochaines assignations. - Outils qui envoient des emails : 30 appels/min par jeton. Exports ZIP : 10/min. ## 7. Plans - MCP : tous les plans, essai gratuit de 7 jours compris. - Jetons API v2, webhooks, Zapier : plan Pro et au-delà. - CLI : gratuite et open source. - Tarifs : https://www.superdocu.com/fr/pricing/ - Inscription : https://app.superdocu.com/c/sign_up ## 8. Vocabulaire - contact : la personne ou l'entreprise externe qui envoie des documents (jamais « prestataire ») - workflow : une suite d'étapes (formulaires, demandes de documents, checklists, signature électronique) assignée à un contact - documents group : un type de document demandé à un contact, avec ses fichiers, son statut et sa date d'expiration - portail : une page d'inscription publique qui crée les contacts automatiquement
Agentic ready : MCP, API v2 et CLI
La collecte de documents pour agents IA.
MCP, API & CLI.
Branchez Claude, ChatGPT ou votre propre code sur Superdocu. Vos agents relancent les pièces manquantes, valident les envois et construisent vos workflows, uniquement avec les droits que vous leur donnez.
Ces entreprises visionnaires utilisent Superdocu :
Branchez Superdocu sur
Pourquoi Superdocu
Votre agent sait rédiger la relance. Il ne sait pas quel Kbis manque.
La collecte de documents vit encore dans les boîtes mail, les Drive partagés et les tableurs. Un agent IA ne peut pas en faire grand-chose : pas de statut, pas de règles, aucun moyen de savoir ce qui est déjà validé. Superdocu transforme ce bazar en données et en actions qu’un agent peut utiliser sans risque.
Structuré, pas éparpillé
Des prochaines étapes, pas des devinettes
Garde-fous inclus
Trois portes d’entrée
Choisissez la porte que parle votre agent.
Le serveur MCP, l’API v2 et la CLI partagent les mêmes droits et les mêmes règles métier. Commencez dans un chat, finissez en automatisation.
MCP
Pour les assistants IA. Collez une URL dans Claude, ChatGPT ou tout client MCP, connectez-vous, cochez les droits accordés. Pas de clé API, pas de fichier de config.
# Réglages → Connecteurs → Ajouter un connecteur
https://app.superdocu.com/mcpOAuth 2.1 avec PKCE, jetons renouvelés automatiquement
75 outils : contacts, workflows, documents, relances, portails
Uniquement les outils autorisés par les droits accordés
API v2
Pour votre code et vos automatisations. Une API REST qui couvre presque tout ce que fait votre équipe dans l’app, pensée pour qu’un agent l’utilise sans deviner.
curl -H "Authorization: Bearer $TOKEN" \
-H "Accept: application/vnd.api+json" \
https://api.superdocu.com/api/v2/dashboardJSON:API, pagination par curseur, codes d’erreur stables
Idempotency-Key sur chaque écriture, conservée 48 h
En-têtes de rate limit et 11 événements webhook signés
CLI
Pour les agents de code et les scripts. Une ligne de commande open source pour macOS et Linux : Claude Code, Codex ou Cursor pilotent Superdocu depuis le terminal.
brew install Superdocu/tap/superdocu
superdocu login
superdocu dashboard getJSON lisible par défaut, --raw pour les pipes
Générée depuis la spec de l’API v2, toujours à jour
--idempotency-key sur les mutations
Vrais prompts
Demandez-lui comme à un collègue.
Ce qu’un assistant peut réellement faire dans Superdocu aujourd’hui, dans la limite des droits accordés.
Suivre : faire avancer les dossiers
« Qui n’a pas encore terminé l’onboarding chauffeurs ? »
« Relance tous ceux dont l’attestation d’assurance a expiré. »
« Résume tout ce qui s’est passé avec Alice Durand la semaine dernière. »
Valider : vider la file
« Montre-moi les documents en attente de validation. »
« Refuse cette attestation et explique qu’elle doit dater de moins de 3 mois. »
« Qu’est-ce qui manque encore au dossier Nova Services ? »
Construire : tout paramétrer
« Crée un workflow pour les chauffeurs indépendants : pièce d’identité, permis, attestation URSSAF et un court formulaire. »
« Duplique notre onboarding fournisseurs et ajoute une étape attestation d’assurance. »
« Modifie le calendrier de relances du workflow sous-traitants. »
Du prompt au portail
D’un message à un portail en ligne.
Décrivez le process. Votre agent le paramètre.
Expliquez votre onboarding comme à un nouvel arrivant. L’assistant crée le workflow, ajoute les étapes, les formulaires et les demandes de documents, règle les relances, puis publie un portail public pour que vos nouveaux contacts s’inscrivent tout seuls.
Vous relisez dans l’éditeur de workflows, vous ajustez, et c’est parti. Le paramétrage, c’était la partie pénible. Maintenant, c’est un message.
Étapes, formulaires, demandes de documents et conditions
Calendrier de relances et dates d’expiration
Portail d’inscription public, publié ou en brouillon
En vrai
Ce que les équipes confient à leur agent.
Des tâches qui mangeaient une matinée. Le même Superdocu, mais ce n’est plus vous qui cliquez.
Conformité fournisseurs
« Liste les sous-traitants dont l’attestation URSSAF expire ce mois-ci et relance-les. » Les expirations sont suivies, les relances partent, vous recevez un résumé au lieu d’un tableur.
Transport
« Crée le transporteur, assigne-lui notre onboarding, préviens-moi quand sa licence est vérifiée. » La licence est contrôlée auprès du registre officiel. Votre agent fait le point.
Immigration
« Qu’est-ce qui manque au dossier de la famille Martin ? Refuse le scan de passeport flou et redemande-le. » Le client reçoit un motif clair et une nouvelle demande dans son portail.
Back-office
Webhook contact_complete → votre agent met à jour le CRM et poste dans Slack. Il ne se réveille que quand il s’est vraiment passé quelque chose.
Pour les builders
Pensé pour des boucles d’agent, pas pour des démos.
L’API v2 a été reconstruite en considérant les agents comme des utilisateurs à part entière. Un endpoint dit à votre agent ce qui demande son attention, et chaque élément indique ce qu’il a le droit de faire ensuite.
1. Trier
GET /dashboard renvoie les actions en attente, typées : validate_document, validate_form_answer, review_not_applicable.
2. Décider
Votre modèle lit le fichier, les available_actions, et pourquoi d’autres actions sont bloquées (ici : pas encore de date d’expiration).
3. Agir
Valider, refuser avec un motif ou redemander un document. Les retries sont sans risque grâce à l’idempotence.
4. Réagir
Les webhooks se déclenchent sur les dépôts, validations et expirations : votre agent ne se réveille que quand il y a du travail.
// GET /api/v2/dashboard → included[0]
{ "type": "pending_action",
"attributes": { "action_type": "validate_document",
"resource_type": "documents_group", "resource_id": "4821",
"label": "Attestation URSSAF" } }
// GET /api/v2/documents_groups/4821
"available_actions": [ { "name": "request", "method": "POST",
"required_attributes": ["requested_message"] } ],
"unavailable_actions": [ { "name": "approve",
"reason": "expiration_date_required" } ]Payloads simplifiés. Schéma complet dans la référence OpenAPI.
Une doc que votre agent sait lire
Garde-fous
Laissez-le travailler. Gardez les clés.
Confier vos dossiers clients à une IA, c’est légitime d’être prudent. L’agent obtient exactement l’accès que vous choisissez, et rien qui contourne vos règles.
Vous choisissez les droits
Jamais plus que votre rôle
Mêmes règles métier
Pas de double envoi
Des limites là où ça compte
Fichiers protégés
Bon à savoir
Des pièces vérifiées, des limites assumées.
Vérifié, pas seulement collecté
Pour les entreprises françaises, Superdocu contrôle les pièces officielles auprès des sources publiques. Votre agent travaille avec des résultats de vérification, pas avec un PDF et de l’espoir.
Attestation URSSAF, vérifiée via le service officiel de l’URSSAF
Extrait Kbis, contrôlé auprès des registres officiels
Licence de transport, contrôlée auprès des registres publics
Dates d’expiration suivies, pour ne rater aucun renouvellement
Ce qui est inclus, et ce qui ne l’est pas (encore)
Le MCP fonctionne sur tous les plans, essai gratuit de 7 jours compris. Les jetons API v2, les webhooks et Zapier sont inclus à partir du plan Pro. La CLI est gratuite et open source.
Pas encore via MCP : le dépôt de fichiers (documents, imports CSV). Passez par l’API ou la CLI.
Les workflows ne se suppriment pas depuis MCP. Désactivez-les à la place.
Modifier un workflow ne s’applique qu’aux prochaines assignations.
Vos questions sur Superdocu agentic.
Des réponses courtes pour les équipes qui branchent Superdocu sur leurs agents.
Qu’est-ce que le serveur MCP de Superdocu ?
C’est un serveur MCP (Model Context Protocol) disponible à l’adresse https://app.superdocu.com/mcp. Il permet à des assistants IA comme Claude ou ChatGPT de consulter et d’agir sur votre compte Superdocu : contacts, workflows, documents, relances et validations.
Faut-il une clé API pour connecter Claude ou ChatGPT ?
Non. Ajoutez l’URL MCP comme connecteur personnalisé, connectez-vous à Superdocu et validez les droits que vous souhaitez accorder. OAuth s’occupe du reste, et les jetons d’accès se renouvellent automatiquement.
Un agent IA peut-il valider ou refuser des documents ?
Oui, si vous lui accordez le droit de validation et que votre rôle Superdocu le permet. Les règles de l’app web s’appliquent : par exemple, un document qui expire ne peut pas être validé sans date d’expiration.
Quelle différence entre le serveur MCP, l’API v2 et la CLI ?
Le serveur MCP est fait pour les assistants IA, l’API v2 pour votre propre code et vos automatisations, et la CLI encapsule l’API pour les scripts et les agents de code qui travaillent dans un terminal. Les trois partagent les mêmes droits et les mêmes règles métier.
Quels plans Superdocu incluent l’accès pour les agents ?
Le serveur MCP est disponible sur tous les plans. La création de jetons API et les webhooks nécessitent le plan Pro ou supérieur. Tous les plans commencent par 7 jours d’essai gratuit.
Mes données sont-elles en sécurité quand un assistant IA est connecté ?
L’assistant n’accède qu’à ce que votre rôle et les droits accordés permettent. Les fichiers passent par des liens signés de courte durée, les actions qui envoient des emails sont limitées en débit, et vos données restent hébergées en Europe.
D’autres questions ? Écrivez-nous, on lit tout.
Donnez enfin du travail utile à votre agent.
Connectez Superdocu à Claude ou ChatGPT en deux minutes, puis demandez-lui ce qui manque.
7 jours d’essai gratuit, sans engagement.