Intégration
BêtaConnectez Claude, Cursor et vos agents IA à vos PDF
Pour connecter Claude, Cursor ou un autre agent IA à vos PDF, utilisez le serveur MCP (Model Context Protocol) distant de PDFBetter : créez une clé d’agent dans Paramètres → Agents (MCP), ajoutez https://pdfbetter.com/api/mcp/ avec cette clé dans votre client MCP, puis demandez ce dont vous avez besoin. L’agent peut lister vos documents, remplir des champs de formulaire, fusionner, diviser, convertir, compresser et passer à l’OCR vos fichiers, extraire les données de factures en JSON, lancer des workflows, interroger des espaces de travail et répondre à vos questions en citant les pages. Les résultats reviennent sous forme de nouveaux documents ou de nouvelles révisions, avec des liens de téléchargement de courte durée ; les originaux ne sont jamais écrasés.
Your MCP client
you ›
Merge the three latest invoices into one PDF and give me the link
→ list_documents
→ merge_documents
→ export_document
PDFBetter MCP server
Only the tools the key's permissions allow. Each call acts as you, within your plan.
Documents
- list_documents
- fill_fields
- export_document
PDF tools
- merge_documents
- convert
- ocr_document
AI & data
- ask_document
- extract_document
- ask_workspace
Workflows & review
- run_workflow
- compare_documents
- suggest_redactions
What comes back
- A new document or revision — originals aren't overwritten
- A download link that expires after a few minutes
- Long jobs return a job id to poll
Connexion en trois étapes
Le point d’accès est https://pdfbetter.com/api/mcp/ (gardez la barre oblique finale). Il utilise le transport Streamable HTTP et s’authentifie avec un en-tête Authorization: Bearer.
Créez une clé d’agent
Dans Paramètres → Agents (MCP), nommez la clé d’après le client qui l’utilisera et choisissez ses autorisations. La clé commence par pb_mcp_ et ne s’affiche qu’une fois.
Ajoutez le serveur à votre client
Claude Code : claude mcp add --transport http pdfbetter https://pdfbetter.com/api/mcp/ --header "Authorization: Bearer pb_mcp_…". Cursor : ajoutez l’URL et un en-tête Authorization dans mcp.json. La page des paramètres propose des extraits prêts à copier pour chaque client, y compris Claude Desktop via la passerelle mcp-remote.
Demandez un résultat
Par exemple : « Fusionnez les trois dernières factures en un seul PDF et donnez-moi le lien », ou « Quel est le préavis prévu dans le bail ? Citez la page. »
1
Create an agent key
pb_mcp_…2
Add the server to your client
https://pdfbetter.com/api/mcp/3
Ask for an outcome
“What is the notice period in the lease? Quote the page.”
Ce que l’agent peut faire
Ce que l’agent peut faire
Documents : lister et rechercher des documents, lire leurs détails, importer un PDF depuis une URL publique, obtenir un lien d’envoi pour un fichier local, lister et remplir les champs de formulaire, exporter le PDF rempli, créer un document à partir d’un modèle, et consulter les formulaires publiés et leurs réponses.
Outils PDF : fusionner, diviser, faire pivoter et extraire des pages (chaque résultat est enregistré comme nouveau document), convertir un PDF en Word, Excel, PowerPoint, CSV, texte ou images et des fichiers Office en PDF, compresser, et ajouter une couche de texte interrogeable aux numérisations (OCR).
IA : un résumé dont les points clés citent les numéros de page, et des réponses aux questions avec des citations vérifiées mot pour mot sur la page indiquée. Quand le document ne contient pas la réponse, l’agent en est informé au lieu de recevoir une supposition.
Extraction de données : lister et créer des schémas d’extraction, extraire un document avec la page source de chaque valeur, lancer un traitement par lots, suivre sa progression, enregistrer les décisions de vérification et exporter en JSON, CSV ou Excel.
Workflows et espaces de travail : lister les workflows enregistrés, lancer une exécution sur un document, savoir où elle en est et l’annuler, et valider une étape de vérification uniquement là où vous avez autorisé la validation par un agent. Créer des espaces de travail, y ajouter des documents, les interroger avec des citations qui tiennent compte des versions, et générer une note de synthèse ou un plan de présentation sourcés.
Aides à la relecture : comparer deux versions d’un document et obtenir la liste commentée des modifications, demander des suggestions de caviardage (l’application du caviardage reste faite par une personne dans l’application), et consulter l’activité des liens de partage et les réponses aux formulaires.
- Le point d’accès, prêt à copier
- Une configuration à copier-coller pour chaque client
- Chaque clé n’a que les autorisations cochées
Settings → Agents (MCP), where keys and client snippets live. Sample content; names are fictional.
Autorisations et sécurité
Autorisations et sécurité
Chaque clé reçoit les autorisations que vous choisissez à sa création : lire les documents, créer et remplir des documents, lire les formulaires et réponses, lire les modèles, utiliser les outils PDF, utiliser l’IA, lire ou lancer des extractions, lire ou lancer des workflows, lire ou gérer des espaces de travail, et lire les statistiques de partage. L’agent ne voit et ne peut appeler que les outils autorisés par sa clé ; tout autre appel est refusé.
Les clés agissent en votre nom, sur vos propres documents et sur ceux partagés avec votre équipe. Révoquez une clé dans les Paramètres et le client perd l’accès immédiatement. Nous ne conservons qu’une empreinte (hash) de chaque clé.
Les modifications de documents existants gardent l’historique : remplir des champs et l’OCR créent une nouvelle révision, et les outils de pages produisent de nouveaux documents. Le remplissage de champs et l’OCR sur un document existant sont aussi inscrits dans son journal d’audit.
Le point d’accès refuse les requêtes venant de pages web : une clé se place dans un client MCP ou sur un serveur, jamais dans un navigateur.
Tarifs
Tarifs
L’accès agent est inclus dans toutes les formules avec compte, y compris Free. Chaque appel d’outil compte pour un appel d’agent ; les appels en échec ne sont pas décomptés.
Appels d’agent par mois : 200 sur Free, 5 000 sur Pro et illimités (usage raisonnable) sur Business.
Le travail déclenché par un appel consomme les mêmes quotas que dans l’application : documents exportés, conversions serveur (compression comprise), pages d’OCR et crédits IA. Une clé API Business (pb_live_) fonctionne aussi sur ce point d’accès.
Client configuration
Connect your MCP client
Endpoint https://pdfbetter.com/api/mcp/. Replace pb_mcp_YOUR_KEY with the agent key you create in Settings; the settings page fills it in for you.
claude mcp add --transport http pdfbetter https://pdfbetter.com/api/mcp/ --header "Authorization: Bearer pb_mcp_YOUR_KEY"Add --scope user to use it in every project.
{
"mcpServers": {
"pdfbetter": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://pdfbetter.com/api/mcp/",
"--header",
"Authorization:${PDFBETTER_AUTH}"
],
"env": {
"PDFBETTER_AUTH": "Bearer pb_mcp_YOUR_KEY"
}
}
}
}Claude Desktop's custom connectors sign in with OAuth, which PDFBetter doesn't offer yet; this uses the open-source mcp-remote bridge (needs Node.js) to send your key.
{
"mcpServers": {
"pdfbetter": {
"url": "https://pdfbetter.com/api/mcp/",
"headers": {
"Authorization": "Bearer pb_mcp_YOUR_KEY"
}
}
}
}URL: https://pdfbetter.com/api/mcp/
Transport: Streamable HTTP (POST, stateless, JSON responses)
Header: Authorization: Bearer pb_mcp_YOUR_KEYKeep the trailing slash in the URL. Keys are secrets: use them from agents and servers, never in a web page.
Forfaits
Ce que comprend chaque forfait
| Gratuit | Pro | Business | |
|---|---|---|---|
| Connecter des agents IA (MCP) | Inclus | Inclus | Inclus |
| Appels d’outils par agents (MCP) par mois | 200 | 5 000 | illimité |
| Téléchargements de documents modifiés par mois | 3 | illimité | illimité |
| Conversions Office et avancées par mois | 10 | 500 | 2 000 |
| Pages OCR par mois | 20 | 1 000 | 5 000 |
| Crédits IA par mois | 20 | 500 | 2 000 |
Chaque action IA coûte un nombre fixe de crédits ; la liste complète figure sur la page Tarifs. Comparer tous les forfaits
Ce que la fonctionnalité ne fait pas
- Un serveur MCP n’est ni un planificateur ni un agent autonome : rien ne s’exécute tant que votre client n’appelle pas un outil. Pour répéter des étapes sur de nouveaux documents, utilisez les workflows.
- Les agents n’agissent que dans le périmètre de leur clé et les limites de votre formule. Ils ne peuvent pas envoyer de demandes de signature, gérer des webhooks, supprimer des documents ni modifier les paramètres du compte.
- Les traitements longs (conversions, compression, OCR) renvoient un identifiant de tâche que l’agent interroge ; l’appel n’attend pas que le fichier soit prêt.
- L’authentification se fait par une clé dans un en-tête. Il n’existe pas encore de connexion OAuth : les clients qui n’acceptent que des connecteurs OAuth ont besoin d’une passerelle comme mcp-remote.
- Les liens de téléchargement expirent au bout de quelques minutes ; l’agent en redemande un si nécessaire.
- Les réponses de l’IA lisent la couche de texte du document. Les pages numérisées doivent d’abord passer à l’OCR, et les pages au-delà de la limite de pages IA de votre formule ne sont pas lues (la réponse précise lesquelles).
Serveur MCP PDFBetter : questions fréquentes
Quels clients MCP fonctionnent avec PDFBetter ?
Tout client qui accepte les serveurs distants en Streamable HTTP avec un en-tête Authorization personnalisé, dont Claude Code et Cursor. Claude Desktop fonctionne via la passerelle open source mcp-remote, en attendant que PDFBetter propose la connexion OAuth.
L’agent modifie-t-il mes fichiers d’origine ?
Non. Fusionner, diviser, faire pivoter et extraire des pages créent de nouveaux documents. Remplir des champs et l’OCR enregistrent une nouvelle révision du même document, et les révisions précédentes restent dans son historique des versions.
Comment les appels d’agent sont-ils décomptés ?
Chaque appel d’outil réussi compte pour un appel d’agent dans votre quota mensuel ; les appels en échec (autorisation manquante, plage de pages invalide…) ne comptent pas. Les exports, conversions, pages d’OCR et crédits IA sont décomptés par leurs propres compteurs, exactement comme dans l’application.
Puis-je limiter ce qu’un agent peut faire ?
Oui. Choisissez les autorisations à la création de la clé, par exemple un accès en lecture seule aux documents. Les outils hors de ce périmètre sont masqués pour l’agent et refusés s’il les appelle. Utilisez une clé par client pour pouvoir les révoquer séparément.
Un agent peut-il traiter un fichier stocké sur mon ordinateur ?
Oui. L’agent demande un lien d’envoi, y dépose le fichier, puis crée un document à partir de cet envoi. Les fichiers publics peuvent aussi être importés par URL ; les adresses de réseau privé et les redirections sont refusées.
Faut-il installer quelque chose ?
Aucun serveur à installer. Claude Code et Cursor se connectent directement à l’URL avec votre clé dans un en-tête. Claude Desktop a besoin de Node.js pour la passerelle mcp-remote, que l’extrait de la page des paramètres lance avec npx.
Un agent peut-il extraire les données de factures ou lancer mes workflows ?
Oui, si sa clé dispose des autorisations d’extraction ou de workflow. Il peut extraire des champs en JSON avec la page source, lancer des lots et des exports, et démarrer des exécutions de workflow. Les étapes de vérification attendent toujours une personne, sauf si vous avez autorisé la validation par un agent sur cette étape.
Les réponses de l’IA sont-elles fiables ?
Les réponses s’appuient sur le texte du document et citent les pages. Chaque citation est comparée au texte de la page indiquée et supprimée si elle n’y figure pas ; une réponse sans citation vérifiable est signalée comme introuvable. Vérifiez les réponses importantes sur les pages citées.