Re:port Flow MCP

Offizieller Anzeigename: Re:port Flow MCP. Paket- und Implementierungskennung: reportflow-mcp. Legacy-Suchaliase: ReportFlow MCP Server und ReportFlow.

Übersicht

Ein MCP-Server (Model Context Protocol), der Ihre Re:port Flow-Vorlagen in PDF-Berichte verwandelt – Rechnungen, Verträge, Kontoauszüge, alles, was Sie gestaltet haben – direkt von Claude oder einem anderen MCP-kompatiblen KI-Agenten.

Related MCP server: PDF Tools AI MCP

Funktionen

• PDFs aus natürlichsprachlichen Anfragen generieren, wie „Rechnung über $300 für Acme Corp erstellen“

• Ihre Re:port Flow-Designs und deren Parameterschemata der KI direkt als MCP-Ressourcen zur Verfügung stellen.

• Viele PDFs in einem Rutsch generieren und als einzelnes ZIP herunterladen

• Ausgaben in dem Workspace-Ordner speichern, in dem sich der Benutzer gerade befindet (Claude Desktop / Claude Code / Cursor / VS Code werden unterstützt)

Einrichtung

Re:port Flow MCP läuft auf zwei Arten – wählen Sie die, die zu Ihrem Client passt.

Remote-Server (claude.ai / Web-Clients) – Streamable HTTP

Fügen Sie Re:port Flow als benutzerdefinierten Connector hinzu, der auf den gehosteten Endpunkt zeigt:

https://mcp.re-port-flow.com/mcp

Gehen Sie in Claude (claude.ai) zu Einstellungen → Connectors → Benutzerdefinierten Connector hinzufügen und fügen Sie die obige URL ein. Die Authentifizierung erfolgt In-App über OAuth (siehe Authentifizierung) – es muss nichts lokal installiert werden.

Lokaler Server (Claude Desktop / Claude Code / Cursor) – stdio über npx

Fügen Sie Folgendes zu Ihrer Konfigurationsdatei hinzu (.mcp.json, claude_desktop_config.json, ~/.cursor/mcp.json, usw.):

{
  "mcpServers": {
    "reportflow": {
      "command": "npx",
      "args": ["-y", "reportflow-mcp"]
    }
  }
}

Das ist die gesamte Einrichtung. Keine Umgebungsvariablen, keine API-Schlüssel, keine Geheimnisse zu verwalten.

VS Code (MCP-fähige Builds)

Dasselbe JSON in .vscode/mcp.json.

Voraussetzungen

• Remote: ein MCP-Client, der benutzerdefinierte HTTP-Connectors unterstützt (z. B. claude.ai). Keine lokale Installation.

• Lokal (stdio): Node.js 22+ (wird von npx automatisch abgerufen) und ein Browser, der während der ersten Anmeldung verfügbar ist.

• Ein Re:port Flow-Konto (in beiden Fällen).

Unterstützte Protokollrevisionen

Beide Transporte (stdio / Streamable HTTP) bedienen zwei MCP-Protokollgenerationen von einem einzigen Endpunkt aus:

• 2026-07-28 (aktuell) – zustandsloses Protokoll pro Anfrage. Moderne Clients erkennen es über server/discover; kein Session-Header, Anfragen tragen ihre Protokollversion in _meta.

• Revisionen aus 2025 (2025-11-25, 2025-06-18, 2025-03-26, 2024-11-05, 2024-10-07) – klassischer initialize-Handshake, aus Gründen der Abwärtskompatibilität mit vorhandenen Clients (Claude Desktop, benutzerdefinierte Connectors von claude.ai, Cursor, ChatGPT, n8n, …) beibehalten.

Die Versionsauswahl ist bei beiden Transporten automatisch: Moderne Clients testen mit server/discover, Legacy-Clients senden weiterhin initialize – auf beiden Seiten ist keine Konfiguration erforderlich, und bestehende Verbindungen funktionieren unverändert weiter.

Authentifizierung

Remote (claude.ai)

Wenn Sie den Connector hinzufügen, führt Claude den OAuth-Ablauf für Sie aus: Anmelden → Arbeitsbereich wählen → zustimmen. Die Tokens werden vom Client aufbewahrt – es gibt keinen lokalen Schlüsselbund oder Browserschritt zu verwalten.

Lokal (stdio)

Laden Sie den MCP-Client neu und bitten Sie die KI:

Authentifizieren Sie sich bei Re:port Flow

Ein Browserfenster öffnet sich. Anmelden → Arbeitsbereich wählen → zustimmen, und schon sind Sie fertig. Die Tokens werden im OS-Schlüsselbund gespeichert (macOS Keychain / Windows Credential Manager / Linux libsecret), mit einem chmod-0600-Datei-Fallback, und werden automatisch aktualisiert.

Verwendungsbeispiele

Jedes Beispiel unten ist ein Prompt, den Sie direkt einfügen können; die KI wählt die passenden Werkzeuge aus.

1. Ein einzelnes PDF generieren (Liste → Schema → Generieren)

Erstellen Sie mit der Rechnungsvorlage ein PDF für Acme Corp in Höhe von insgesamt $330.

Die KI listet Designs mit list_templates auf, ruft das Parameterschema mit get_design_parameters ab, füllt die Werte ein und ruft generate_pdf_sync auf.

• Remote: gibt eine Download-URL zurück (fileUrl).

• Lokal: speichert die Datei außerdem und gibt ihren absoluten Pfad zurück.

2. Viele PDFs in einem Rutsch generieren

Generieren Sie mit der Kontoauszugsvorlage ein PDF pro Kunde (Acme $100, Globex $250, Initech $80) und geben Sie sie mir gemeinsam.

• Lokal (stdio): generate_pdfs_sync schreibt ein einzelnes ZIP in Ihren Workspace.

• Remote: generate_pdfs_async führt den Batch aus und gibt eine Anforderungs-ID sowie eine Download-URL zurück.

3. Asynchron generieren und anschließend herunterladen (lokal)

Starten Sie das Vertrags-PDF im Hintergrund und laden Sie es dann herunter, sobald es fertig ist.

Die KI ruft generate_pdf_async auf (gibt sofort eine requestId zurück) und ruft dann download_file auf, um das fertige PDF zu speichern. Das Pendant für Batches ist generate_pdfs_async → download_zip. Diese Download-Werkzeuge gibt es nur unter stdio; auf dem Remote-Server liefern die synchronen/asynchronen Werkzeuge bereits eine fileUrl zurück.

Tipp – Natürlichsprachliche Parameter: Auf einem Sampling-fähigen Client können Sie „Params für eine Rechnung über $1,000 an A社 entwerfen“ sagen, und die KI ruft suggest_params auf, um die Kurzbeschreibung vor der Generierung in ein gültiges params-Objekt umzuwandeln.

4. Ohne vorhandene Vorlagen starten (Galerie → Kopieren → Generieren)

Ich habe noch keine Vorlagen – erstellen Sie ein Rechnungs-PDF für Acme Corp.

Wenn list_templates leer ist, durchsucht die KI die öffentliche Vorlagengalerie mit search_gallery_templates, zeigt Ihnen die Kandidaten, kopiert Ihre Auswahl mit copy_gallery_template in Ihren Workspace und fährt dann mit dem normalen Ablauf fort (get_design_parameters → generate_pdf_sync). Die Kopie landet immer in dem Workspace, den Sie auf dem OAuth-Zustimmungsbildschirm ausgewählt haben – die KI kann keinen anderen Workspace ansteuern.

Slash-Befehle

Wo Dateien gespeichert werden (lokaler Modus)

Der Ausgabeort wird in dieser Reihenfolge bestimmt:

1. Explizite Anweisung des Benutzers (z. B. „auf meinem Desktop speichern“)

2. Das Wurzelverzeichnis des aktuell geöffneten Workspace (Claude Code / Cursor / VS Code)

3. Das temporäre Verzeichnis des Betriebssystems als Fallback

Referenz

Tools (von der KI aufgerufen)

Ressourcen (als KI-Kontext anhängbar)

Prompts (Rezeptkarten für Slash-Befehle)

/generate_pdf, /generate_pdfs, /reportflow_help – Argumente übergeben; die KI folgt dem vorbereiteten Workflow.

Fehlerbehebung

Datenschutz

Re:port Flow MCP ist ein schlanker Client: Er leitet Ihre Anfragen an Ihr eigenes Re:port Flow-Konto weiter und gibt die erzeugten PDFs zurück. Er verkauft oder teilt Ihre Daten nicht mit Dritten. Authentifizierungstoken werden lokal gespeichert (Betriebssystem-Schlüsselbund, oder eine chmod-0600-Datei als Fallback) und nur an die eigenen Dienste von Re:port Flow gesendet – während des OAuth-Logins und als Bearer-Anmeldedaten bei jedem authentifizierten API-Aufruf (Auflisten von Vorlagen, Erzeugen oder Herunterladen von PDFs). Sie werden niemals an Dritte weitergegeben.

Die vollständige Datenschutzerklärung – welche Daten erfasst werden, wie lange sie aufbewahrt werden und wie sie verarbeitet werden – finden Sie unter: lp.re-port-flow.com

Sicherheit

Der gehostete Endpunkt validiert den Host-Header (Schutz vor DNS-Rebinding) und lehnt strukturell ungültige Origin-Header mit 403 Forbidden ab, gemäß den Sicherheitsanforderungen der MCP-Streamable-HTTP-Spezifikation. Die Authentifizierung erfolgt ausschließlich über ein Bearer-Token – keine Cookies, und CORS erlaubt niemals Anmeldedaten. Die vollständige Richtlinie und ihr Bedrohungsmodell sind in docs/security.md (Japanisch) dokumentiert.

Support

Sie brauchen Hilfe, haben einen Fehler gefunden oder eine Frage zur Verzeichnisprüfung?

• Re:port Flow (Datenschutz & Support): https://lp.re-port-flow.com

• GitHub Issues: https://github.com/re-port-flow/reportflow-mcp/issues

Lizenz

MIT – siehe LICENSE.

Links

• Re:port Flow: https://re-port-flow.com

• Datenschutz & Support: https://lp.re-port-flow.com

• npm: https://www.npmjs.com/package/reportflow-mcp

• Issues: https://github.com/re-port-flow/reportflow-mcp/issues