Utilisation de PaperOffice avec Claude, ChatGPT, Grok et Cursor (MCP): le guide complet

Ce que fait le connecteur

Le MCP (Model Context Protocol) est une norme ouverte par laquelle un assistant IA utilise les outils d'un autre système. PaperOffice fournit un serveur MCP distant pour cela. Une fois connecté, un assistant tel que Claude peut travailler avec les documents de vos espaces de travail PaperOffice: rechercher, lire, résumer, extraire des données, télécharger, renommer, déplacer, demander des signatures et démarrer des workflows, toujours selon vos autorisations PaperOffice.

Rien à installer. L'assistant se connecte à une URL, vous vous connectez avec votre compte PaperOffice, et les outils de PaperOffice apparaissent dans le chat.

Assistants pris en charge et URLs du connecteur

• Claude (claude.ai, Claude Desktop, Claude Code): https://mcp.paperoffice.ai/claude, connexion via OAuth 2.1.
• ChatGPT: https://mcp.paperoffice.ai/chatgpt, connexion via OAuth 2.1.
• Grok: https://mcp.paperoffice.ai/grok, connexion via OAuth 2.1.
• Cursor: https://mcp.paperoffice.ai/cursor, avec un jeton utilisateur personnel ou un jeton de groupe.

Les profils pointent vers le même serveur et diffèrent uniquement par la portée des outils.

Ce dont vous avez besoin

• Un compte PaperOffice avec au moins un espace de travail.
• Credits sur le compte. Les appels d'outils sont facturés comme des appels API.
• Un plan d'assistant qui permet les connecteurs, par exemple Claude Pro, Max, Team ou Enterprise. Dans les plans Team et Enterprise, un administrateur peut devoir activer le connecteur au préalable.

Connecter Claude

1. Dans claude.ai, ouvrez Paramètres → Connectors.
2. Choisissez Ajouter un connecteur personnalisé, saisissez le nom PaperOffice et l'URL https://mcp.paperoffice.ai/claude. Laissez l'ID client et le secret vides; la connexion OAuth démarre automatiquement.
3. Choisissez Connecter et connectez-vous avec votre compte PaperOffice. Examinez l'accès demandé et confirmez.
4. Dans le chat, activez les outils de PaperOffice pour la conversation.

Claude Desktop utilise la même liste de connecteurs que claude.ai. Dans Claude Code, ajoutez le serveur avec claude mcp add --transport http paperoffice https://mcp.paperoffice.ai/claude et terminez la connexion avec /mcp.

Un premier test: demandez « Quels espaces de travail PaperOffice puis-je accéder? » Claude devrait lister vos espaces de travail.

Connecter ChatGPT et Grok

ChatGPT: ouvrez Paramètres → Connectors, ajoutez un connecteur personnalisé avec le nom PaperOffice, l'URL https://mcp.paperoffice.ai/chatgpt et OAuth comme authentification, puis connectez-vous et identifiez-vous. Selon votre plan, le mode développeur doit peut-être être activé pour les connecteurs personnalisés. Le profil ChatGPT est une sélection curatée d'outils; il ne contient par exemple aucun outil de signature ni de workflow.

Grok: ouvrez grok.com/connectors, créez un connecteur personnalisé avec l'URL https://mcp.paperoffice.ai/grok et connectez-vous avec votre compte PaperOffice lors de la première connexion. Le profil Grok est également une sélection curatée d'outils.

Connecter Cursor avec un jeton

1. Connectez-vous à l'application PaperOffice et ouvrez Compte → API.
2. Créez un jeton utilisateur ou utilisez un jeton de groupe fourni par votre administrateur. Vous pouvez afficher et copier le jeton à tout moment sur la page API ; conservez-le en sécurité.
3. Ajoutez le serveur au fichier mcp.json de Cursor avec l'URL https://mcp.paperoffice.ai/cursor et le jeton en tant que jeton porteur dans l'en-tête Authorization.
4. Redémarrez Cursor ou rechargez les serveurs MCP.

Ne commettez jamais un fichier mcp.json contenant un jeton réel dans un dépôt. Les clés secrètes et les clés publiable de l'API REST sont bloquées pour MCP.

Autorisations : l'assistant ne reçoit jamais plus que vous

L'assistant fonctionne avec les permissions de l'utilisateur PaperOffice connecté. L'appartenance à un espace de travail, les rôles, les dossiers partagés, les règles de rétention (WORM) et les conservations légales s'appliquent inchangées. Un utilisateur en lecture seule dans PaperOffice reste en lecture seule dans l'assistant.

Chaque outil porte un titre et indique s'il effectue uniquement des lectures ou des modifications. L'assistant utilise ces indications pour vous demander votre accord avant d'agir. La suppression, le vidage de la corbeille et l'envoi de demandes de signature sont marqués comme destructeurs, attendez-vous donc à une question de confirmation. Les documents supprimés vont d'abord dans la corbeille PaperOffice et peuvent être restaurés dans l'application.

Les paramètres du compte, la facturation, la gestion des utilisateurs et la création de clés API ne sont pas disponibles via le connecteur. Ils restent dans l'application PaperOffice.

Flux de données: ce que l'assistant voit et ce que PaperOffice reçoit

1. Vous écrivez une demande dans l'assistant.
2. L'assistant décide quel outil PaperOffice appeler et envoie les paramètres, par exemple un terme de recherche ou un ID de document, au serveur MCP PaperOffice.
3. PaperOffice exécute l'appel avec vos permissions et renvoie le résultat, par exemple le texte d'un document ou une liste de noms de fichiers.
4. Le résultat fait partie de votre conversation avec l'assistant et est traité selon les conditions du fournisseur de l'assistant.

PaperOffice ne reçoit pas votre historique de chat, vos invites ou les réponses de l'assistant. Seul l'appel d'outil atteint le serveur: nom de l'outil, paramètres, heure et utilisateur. PaperOffice ne téléverse pas de documents vers le fournisseur de l'assistant par lui-même; le fournisseur ne reçoit que ce que l'assistant a demandé.

Chaque appel d'outil est enregistré avec l'heure, l'utilisateur et Credits. Les administrateurs voient les appels sous API & Développeur → Utilisation de l'API.

Facturation

Chaque appel d'outil via le connecteur est facturé dans Credits, exactement comme l'appel API correspondant. Il n'y a pas d'abonnement séparé pour le connecteur. Certaines requêtes de statut et de santé ne sont pas facturées; les détails se trouvent dans la documentation de l'API. Lorsque les Credits sont épuisés, les appels sont rejetés avec un message clair; rien n'est supprimé. Plus dans le guide sur la facturation et les crédits Credits: Facturation et crédits Credits dans PaperOffice AI.

Révoquer l'accès

1. Dans l'assistant, supprimez ou déconnectez le connecteur PaperOffice. L'assistant cesse de l'utiliser immédiatement; les conversations contenant déjà des résultats PaperOffice conservent ce texte.
2. Dans PaperOffice, ouvrez Compte → API. Les connexions de l'assistant apparaissent dans la liste des jetons avec un badge MCP. Supprimez le jeton de cette connexion à cet endroit.
3. Pour Cursor, faites tourner ou supprimez le jeton sur la même page.

La révocation de l'accès ne supprime aucune donnée.

Dépannage

• La fenêtre de connexion ne s'ouvre pas: autorisez les pop-ups pour l'assistant et essayez une fenêtre de navigation privée. Dans les plans Équipe ou Enterprise, demandez à l'administrateur si le connecteur est activé.
• Connecté, mais aucun outil PaperOffice n'apparaît: activez les outils pour la conversation, ou démarrez une nouvelle conversation.
• "Non autorisé" lors d'un appel d'outil : la connexion a été révoquée ou a expiré. Connectez-vous à nouveau. Avec un jeton, vérifiez qu'il s'agit d'un jeton utilisateur ou de groupe.
• L'assistant ne trouve aucun document : demandez d'abord la liste des espaces de travail. L'utilisateur connecté peut ne pas avoir accès à l'espace de travail que vous attendez. Les documents téléversés récemment ont besoin d'un moment jusqu'à ce que le traitement soit terminé.
• Pas assez de Credits: rechargez dans l'application PaperOffice ou activez le rechargement automatique.

Toujours bloqué ? Ouvrez un ticket de support avec l'assistant et le plan, le message exact, l'heure avec le fuseau horaire et, si possible, une capture d'écran sans données personnelles.

Recommandation pour les équipes IT

• Domaines à autoriser : mcp.paperoffice.ai, api.paperoffice.ai et app.paperoffice.ai. Tout le trafic utilise HTTPS ; aucune connexion entrante vers votre réseau n'est requise.
• Commencez par un pilote : un espace de travail et des rôles en lecture seule. Activez les rôles d'écriture par espace de travail après le pilote.
• Examinez l'utilisation de l'API régulièrement pendant les premières semaines.

Questions fréquemment posées

• Dois-je installer quoi que ce soit ? Non. L'assistant se connecte à une URL.
• L'assistant peut-il voir tous mes documents? Uniquement ce que votre utilisateur PaperOffice peut voir.
• PaperOffice lit-il mes chats? Non. Seules les appels d'outil atteignent PaperOffice.
• Existe-t-il un abonnement séparé pour le connecteur? Non. Les appels sont facturés dans Credits comme des appels API.
• Comment mettre fin à l'accès ? Supprimez le connecteur dans l'assistant et supprimez le jeton de la connexion sous Compte → API.