Reportflow Mcp

Name: Reportflow Mcp
Author: re-port-flow

@re-port-flow

代码仓库

关于 Reportflow Mcp

remote endpoint at https://mcp.re-port-flow.com/mcp works directly from Claude.ai (web) without npm setup

#report #pdf

基本信息

分类

其他

传输方式

stdio

发布者

re-port-flow

提交者

正道小堀

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "reportflow": {
      "type": "http",
      "url": "https://mcp.re-port-flow.com/mcp"
    }
  }
}

工具

デザインテンプレートのパラメータ構造を取得します。帳票生成に必要なパラメータの型・構造を確認できます。

ワークスペース内のデザイン一覧を取得します。各デザインのID・名称・最新バージョン・サムネイルURLを返します。取得したidをdesignIdとしてPDF生成ツールやget_design_parametersに使用します。

デザインIDとパラメータを指定してPDFを生成します。応答にダウンロード URL が含まれるため、本ツール 1 回の呼び出しで結果提示が完結します (別途ダウンロード用ツールを呼ぶ必要はありません)。 - stdio モード (Claude Desktop / Code): ローカルに保存し絶対パスも返します。outputDir で保存先を指定できます (未指定時はクライアントのワークスペース Roots または OS 一時ディレクトリ)。 - HTTP モード (claude.ai / n8n 等): サーバー側には保存しません。includePreview=true を指定すると inline preview 用のバイナリも併せて返します (claude.ai が PDF preview をサポートしていない現状ではデフォルト false 推奨)。【重要】呼び出し前に必ず get_design_parameters でデザインの必要パラメータ構造を確認し、ユーザーから必要な値を聞き出すこと。プレースホルダー値・架空の値を勝手に生成しないこと。

複数のパラメータセットでPDFを一括非同期生成します。即座にrequestIdとfiles情報を返します。ZIPダウンロードはdownload_zipツールを使用してください。【重要】呼び出し前に必ず get_design_parameters でデザインの必要パラメータ構造を確認し、ユーザーから必要な値を聞き出すこと。ユーザーが指定していないパラメータがある場合は、本ツールを呼ぶ前にユーザーに必ず確認すること。プレースホルダー値・架空の値を勝手に生成しないこと。パラメータが一切提供されていない場合も、まずユーザーに値を尋ねること。

自然文の要件と designId からクライアント AI（Sampling）を使って generate_pdf_sync の params JSON を組み立てます。サーバー側 API キー不要。Sampling 未対応クライアントでは利用不可です。生成された params は内容確認のうえユーザーの承認を得てから generate_pdf_sync に渡してください。

概览

What is Reportflow Mcp?

Reportflow Mcp is a Model Context Protocol server for generating business documents (PDFs) from natural-language requests. It integrates with ReportFlow’s no-code template designer and marketplace, exposing designs, parameter schemas, and PDF generation as MCP tools, resources, and prompts. It is aimed at business users who need document automation without a development environment.

How to use Reportflow Mcp?

Two modes are supported. Remote (recommended): configure your MCP client with an HTTP endpoint at https://mcp.re-port-flow.com/mcp – no Node.js installation required. Local (stdio): set the MCP server command to npx -y reportflow-mcp (Node.js 18+ needed). On first use, authenticate via OAuth 2.0 (browser consent flow); for local mode, ask the AI to “authenticate with ReportFlow”. After setup, the AI can invoke tools like generate_pdf_sync and list_templates directly.

Key features of Reportflow Mcp

Remote-ready, setup-free hosted endpoint (no Node.js required)
No-code template design via Konva-based browser GUI
Free template marketplace for invoices, quotes, receipts, and more
OAuth 2.0 + PKCE + Dynamic Client Registration (no API key exposed)
Bulk PDF generation with single ZIP download
Tool annotations (title, readOnlyHint, destructiveHint) for MCP-aware clients

Use cases of Reportflow Mcp

Generate an invoice or quote from a natural-language description (e.g., "create an invoice for Acme Corp totalling $330")
Produce receipts, delivery slips, or reports using ready-made templates from the gallery
Bulk-generate many PDFs and download them as a single ZIP archive
Allow business users without a local dev setup to start generating documents immediately

FAQ from Reportflow Mcp

How does Reportflow Mcp differ from other document-generation MCP servers?

Reportflow Mcp is remote-ready (no Node.js needed), uses a no-code browser-based template editor with a free marketplace, and authenticates via OAuth 2.0 + PKCE + Dynamic Client Registration—no API key is shared with the AI client.

What are the runtime requirements?

Remote mode: An MCP-capable AI client (e.g., Claude.ai, Claude Desktop, Cursor, VS Code) and a ReportFlow account. Local mode: Node.js 18+, a browser for first-run OAuth consent, and a ReportFlow account.

How does authentication work?

On first connection, a browser tab opens for OAuth consent (workspace selection and approval). Tokens are managed server-side (remote) or stored in the OS keychain/local file (local). No manual API key configuration is needed.

What templates are available?

A free template gallery at https://templates.re-port-flow.com covers invoices, quotes, receipts, delivery slips, reports, and more. Users can also design custom templates in the browser GUI.