Wie verwendet man den Papermark MCP-Server mit Claude, Cursor und ChatGPT?

Der Papermark MCP-Server stellt die vollständige Papermark API für jeden MCP-kompatiblen KI-Client bereit. Damit kann ein Assistent wie Claude oder Cursor in deinem Auftrag Datenräume erstellen, Dokumente hochladen, Links generieren und Analysen abrufen – mit 43 typisierten Tools.

Der MCP-Server ist ab dem Business-Plan verfügbar. Selbst gehostete Papermark-Instanzen können KI-Clients mit jedem Plan verbinden.

Was ist MCP?

MCP steht für Model Context Protocol. Es ist ein offener Standard zur Verbindung von KI-Assistenten mit externen Tools und Datenquellen. Ein MCP-Server stellt einem KI-Client eine Reihe typisierter Tools zur Verfügung, die er aufrufen kann – anstatt dass du Kontext manuell kopieren und einfügen musst.

Papermark liefert einen offiziellen MCP-Server, @papermark/mcp-server auf npm, sowie einen gehosteten HTTP-Endpunkt unter mcp.papermark.com/mcp. Beide stellen dieselben 43 Tools bereit.

Was die KI leisten kann

Nach der Verbindung kann ein KI-Assistent:

• Datenräume erstellen und verwalten: create_dataroom, list_datarooms, update_dataroom
• Dokumente hochladen: upload_document aus einem Dateipfad oder einer URL
• Freigabelinks erstellen: create_link mit Passwort, Ablaufdatum, E-Mail-Schranke und Download-Berechtigung
• Inhalte durchsuchen: search_documents nach Suchbegriff
• Analysen abrufen: list_link_views, get_view_analytics für seitenweise Aufenthaltsdauern
• Ordner, Besucher und Berechtigungen verwalten über die übrigen Tools

Ein typischer Agenten-Prompt: "Erstelle einen Datenraum namens Series B, lade alle PDFs in ~/acme/ hoch und generiere dann einen passwortgeschützten Link, der in 30 Tagen abläuft."

Schritt 1: API-Token generieren

1. Melde dich bei Papermark an.
2. Gehe zu Einstellungen und dann zu API-Token.
3. Klicke auf Token erstellen und wähle die gewünschten Berechtigungen für die KI aus.
4. Kopiere den Token. Er beginnt mit pm_live_.

Für KI-Assistenten empfiehlt es sich, einen Token mit eingeschränkten Berechtigungen zu erstellen (z. B. ohne delete-Berechtigungen), damit der Agent nicht versehentlich Daten löscht.

Schritt 2: Claude Desktop oder Claude Code verbinden (stdio)

Für lokale KI-Clients wie Claude Desktop und Claude Code wird der stdio-Transport verwendet.

1. Öffne die Claude Desktop-Konfigurationsdatei:
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
2. Füge Papermark zu mcpServers hinzu:

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

3. Speichere die Datei und starte Claude Desktop neu.
4. Frage Claude in einem neuen Chat zum Beispiel „Zeige mir meine Papermark-Dokumente“. Claude sollte daraufhin das MCP-Tool aufrufen und die Ergebnisse zurückgeben.

Die gleiche mcpServers-Konfiguration funktioniert auch in Claude Code.

Schritt 3: Cursor, claude.ai Connectors und ChatGPT Apps verbinden (HTTP)

Für browserbasierte und andere HTTP-fähige Clients wird der gehostete MCP-Endpunkt verwendet.

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

Keine Installation erforderlich. Trage dies in die MCP-Einstellungen deines Clients ein und du bist verbunden.

Unterstützte HTTP-Clients

• Cursor (Einstellungen, MCP)
• claude.ai Connectors (Web)
• ChatGPT Apps
• Continue
• Jeder andere MCP-kompatible Client

OAuth 2.1 Gerätefluss

Anstatt einen langlebigen Token einzufügen, kannst du dich interaktiv anmelden. Der MCP-Server führt dich durch einen browserbasierten Gerätecode-Login und speichert den Token unter ~/.config/papermark/auth.json. Keine Anmeldedaten per Kopieren und Einfügen in Chat-Protokollen.

npx @papermark/mcp-server login

Die 43 Tools auf einen Blick

Der Server stellt pro API-Operation ein Tool bereit. Einige Highlights:

Die vollständige Liste findest du in der @papermark/mcp-server README oder in tools/list, sobald der Server verbunden ist.

Beispiel-Agenteneingaben

• "Erstelle einen Datenraum namens Acme Series B mit Ordnern für Finanzen, Rechtliches und Due Diligence."
• "Lade ~/Downloads/pitch.pdf in den Datenraum Acme Series B hoch und erstelle einen passwortgeschützten Link, der in 14 Tagen abläuft."
• "Welcher Investor hat diese Woche die meiste Zeit auf Seite 7 unseres Pitch Decks verbracht?"
• "Fasse das Engagement für Link lk_8K2m zusammen und identifiziere Besucher, die nur die ersten drei Seiten angesehen haben."
• "Rufe die seitenweisen Verweildauern für Aufruf vw_3m9k ab und zeige mir, wo der Besucher abgebrochen hat."

Sicherheit und Prüfprotokoll

• Der MCP-Server verwendet dein API-Token und übernimmt daher dessen Berechtigungen.
• Alle Tool-Aufrufe laufen über die Standard-API und werden im Audit-Log deines Teams protokolliert.
• Du kannst das Token jederzeit unter Einstellungen, API-Tokens widerrufen.
• Tool-Aufrufe werden von Papermark nicht über das Standard-Anfragen-Logging hinaus gespeichert.

Häufig gestellte Fragen

Verwandte Anleitungen

• So verwendest du die Papermark REST API
• So verwendest du die Papermark CLI
• KI-Agent für ein einzelnes Dokument
• KI-Agent für einen gesamten Datenraum

Benötigst du Hilfe beim Verbinden? Kontaktiere support@papermark.com oder nutze den In-App-Chat.