Comment utiliser le serveur MCP Papermark avec Claude, Cursor et ChatGPT ?

Le serveur MCP Papermark expose l'intégralité de l'API Papermark à tout client IA compatible MCP. Grâce à lui, un assistant comme Claude ou Cursor peut créer des espaces de données, téléverser des documents, générer des liens et consulter des analyses en votre nom, à l'aide de 43 outils typés.

Le serveur MCP est disponible à partir du plan Business. Les instances Papermark auto-hébergées peuvent connecter des clients IA sur n'importe quel plan.

Qu'est-ce que MCP ?

MCP est l'acronyme de Model Context Protocol. Il s'agit d'un standard ouvert permettant de connecter des assistants IA à des outils externes et des sources de données. Un serveur MCP fournit à un client IA un ensemble d'outils typés qu'il peut appeler, vous évitant ainsi de copier-coller du contexte manuellement.

Papermark propose un serveur MCP officiel, @papermark/mcp-server sur npm, ainsi qu'un endpoint HTTP hébergé à mcp.papermark.com/mcp. Les deux exposent les mêmes 43 outils.

Ce que l'IA peut faire

Une fois connecté, un assistant IA peut :

• Créer et gérer des espaces de données : create_dataroom, list_datarooms, update_dataroom
• Téléverser des documents : upload_document depuis un chemin de fichier ou une URL
• Générer des liens de partage : create_link avec mot de passe, expiration, vérification par e-mail, autorisation de téléchargement
• Rechercher dans votre contenu : search_documents par requête
• Consulter les analyses : list_link_views, get_view_analytics pour les durées page par page
• Gérer les dossiers, les visiteurs et les permissions via le reste des outils

Exemple de prompt pour un agent : "Crée un espace de données appelé Série B, téléverse tous les PDF dans ~/acme/, puis génère un lien protégé par mot de passe qui expire dans 30 jours."

Étape 1 : Générer un token API

1. Connectez-vous à Papermark.
2. Accédez à Paramètres, puis Tokens API.
3. Cliquez sur Créer un token et choisissez les portées que vous souhaitez accorder à l'IA.
4. Copiez le token. Il commence par pm_live_.

Pour les assistants IA, envisagez de créer un token avec des portées limitées (par exemple, sans permissions delete) afin que l'agent ne puisse pas supprimer des données accidentellement.

Étape 2 : Connecter Claude Desktop ou Claude Code (stdio)

Pour les clients IA locaux tels que Claude Desktop et Claude Code, utilisez le transport stdio.

1. Ouvrez votre fichier de configuration Claude Desktop :
   • macOS : ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows : %APPDATA%\Claude\claude_desktop_config.json
2. Ajoutez Papermark à mcpServers :

{
  "mcpServers": {
    "papermark": {
      "command": "npx",
      "args": ["-y", "@papermark/mcp-server"],
      "env": {
        "PAPERMARK_TOKEN": "pm_live_..."
      }
    }
  }
}

3. Enregistrez le fichier et redémarrez Claude Desktop.
4. Dans une nouvelle conversation, demandez à Claude quelque chose comme "liste mes documents Papermark". Vous devriez voir Claude appeler l'outil MCP et renvoyer des résultats.

La même configuration mcpServers fonctionne dans Claude Code.

Étape 3 : Connecter Cursor, les connecteurs claude.ai et les applications ChatGPT (HTTP)

Pour les clients basés sur navigateur et autres clients compatibles HTTP, utilisez l'endpoint MCP hébergé.

{
  "papermark": {
    "url": "https://mcp.papermark.com/mcp",
    "transport": "http",
    "headers": {
      "Authorization": "Bearer pm_live_..."
    }
  }
}

Aucune installation requise. Intégrez simplement ceci dans les paramètres MCP de votre client et vous êtes connecté.

Clients HTTP pris en charge

• Cursor (Paramètres, MCP)
• claude.ai Connectors (web)
• ChatGPT Apps
• Continue
• Tout autre client compatible MCP

Flux d'appareil OAuth 2.1

Au lieu de coller un token à longue durée de vie, vous pouvez vous connecter de manière interactive. Le serveur MCP vous guide à travers une connexion par code d'appareil via navigateur et stocke le token à ~/.config/papermark/auth.json. Aucune information d'identification copiée-collée dans les journaux de conversation.

npx @papermark/mcp-server login

Les 43 outils en un coup d'œil

Le serveur expose un outil par opération API. Quelques points forts :

Consultez la liste complète dans le README @papermark/mcp-server ou dans tools/list une fois le serveur connecté.

Exemples de prompts pour agents

• "Crée une data room appelée Acme Série B avec des dossiers pour les Finances, le Juridique et la Due Diligence."
• "Importe ~/Downloads/pitch.pdf dans la data room Acme Série B et génère un lien protégé par mot de passe qui expire dans 14 jours."
• "Quel investisseur a passé le plus de temps sur la page 7 de notre pitch deck cette semaine ?"
• "Résume l'engagement sur le lien lk_8K2m et identifie les visiteurs qui n'ont consulté que les trois premières pages."
• "Récupère les durées page par page pour la consultation vw_3m9k et dis-moi à quel endroit le visiteur a décroché."

Sécurité et audit

• Le serveur MCP utilise votre token API, il hérite donc des droits associés à ce token.
• Tous les appels d'outils passent par l'API standard et sont enregistrés dans le journal d'audit de votre équipe.
• Vous pouvez révoquer le token à tout moment depuis Paramètres, Tokens API.
• Les appels d'outils ne sont pas conservés par Papermark au-delà de la journalisation standard des requêtes.

Questions fréquemment posées

Guides associés

• Comment utiliser l'API REST Papermark
• Comment utiliser le CLI Papermark
• Agent IA pour un document unique
• Agent IA pour une data room complète

Besoin d'aide pour vous connecter ? Contactez support@papermark.com ou utilisez le chat intégré à l'application.