Reportflow Mcp

by re-port-flow

312 downloads

Not rated

GitHub

Other

About

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

Details

Author: re-port-flow
Downloads: 312
Categories: Other

- 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

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Reportflow Mcp

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

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

JSON

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

JSON

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

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

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

JSON

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

JSON

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

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

From the repository

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.

`get_design_parameters`

【PDF 生成の起点 / Sampling 不要・全クライアント対応】指定 designId のパラメータ構造（各フィールドの name・type・label、および作成者が設定した場合は意味・入力ガイドを表す description）を取得します。generate_pdf_sync / generate_pdfs_async を呼ぶ前に必ず本ツールでスキーマを確認し、description があればその意図に沿って、ユーザーから実値を聞き取って params を組み立ててください。プレースホルダーや架空値の生成は禁止です。

`list_templates`

ワークスペース内のデザイン一覧を取得します。各デザインのID・名称・最新バージョン・サムネイルURLを返します。取得したidをdesignIdとしてPDF生成ツールやget_design_parametersに使用します。テンプレートを選ぶ際は、まず label（名称）とユーザーの希望の一致度を最優先に判断し、最も近いものを選んでください。名称だけで絞り込めない場合に限り作業内容から推測してよく、それでも曖昧な場合は候補を提示してユーザーに確認してください。

`generate_pdf_sync`

デザインIDとパラメータを指定してPDFを生成します。応答にダウンロード URL が含まれるため、本ツール 1 回の呼び出しで結果提示が完結します (別途ダウンロード用ツールを呼ぶ必要はありません)。 - stdio モード (Claude Desktop / Code): ローカルに保存し絶対パスも返します。outputDir で保存先を指定できます (未指定時はクライアントのワークスペース Roots または OS 一時ディレクトリ)。 - HTTP モード (claude.ai / n8n 等): サーバー側には保存せず、ダウンロード URL (fileUrl) と requestId / fileId を返します。【重要】呼び出し前に必ず get_design_parameters でデザインの必要パラメータ構造を確認し、ユーザーから必要な値を聞き出すこと。プレースホルダー値・架空の値を勝手に生成しないこと。【passthrough のプライバシー注意】content.passthrough のトップレベルの文字列/数値の値は生成 PDF の XMP メタデータに埋め込まれ、PDF 受領者や OS のファイル検索 (Spotlight / Windows Search) から閲覧可能になるため、個人情報・機微情報を入れないこと。

`generate_pdfs_async`

複数のパラメータセットでPDFを一括非同期生成します。即座にrequestIdとfiles情報を返します。ZIPダウンロードはdownload_zipツールを使用してください。【重要】呼び出し前に必ず get_design_parameters でデザインの必要パラメータ構造を確認し、ユーザーから必要な値を聞き出すこと。ユーザーが指定していないパラメータがある場合は、本ツールを呼ぶ前にユーザーに必ず確認すること。プレースホルダー値・架空の値を勝手に生成しないこと。パラメータが一切提供されていない場合も、まずユーザーに値を尋ねること。【passthrough のプライバシー注意】contents[].passthrough のトップレベルの文字列/数値の値は生成 PDF の XMP メタデータに埋め込まれ、PDF 受領者や OS のファイル検索 (Spotlight / Windows Search) から閲覧可能になるため、個人情報・機微情報を入れないこと。

`suggest_params`

自然文の要件と designId から、クライアント AI（Sampling）で generate_pdf_sync 用の params JSON を下書きします。【Sampling 必須】claude.ai 等の Sampling 非対応クライアントでは自動生成できず、その場合はパラメータスキーマをそのまま返すので手動で params を埋めてください。パラメータ構造の確認だけが目的なら get_design_parameters を使ってください。サーバー側 API キー不要。生成された params は必ずユーザー承認のうえ generate_pdf_sync に渡してください。

`search`

Re:port Flow の内部テンプレートカタログ（ユーザー自身のワークスペースに登録済みのデザイン）から、名称の部分一致でテンプレートを解決し、各ヒットの id・title・url を返します。外部サイトや Web の検索は一切行わず、参照範囲は当該ワークスペース内に限定されます。請求書・見積書などのテンプレートを探したいときに使用します。返した id（"<designId>@<version>" 形式）は fetch ツールに渡してパラメータ詳細を取得できます。

`fetch`

Re:port Flow の内部テンプレートカタログから、デザイン id（"<designId>@<version>" 形式。version は省略可で最新版）で 1 件のテンプレート詳細（PDF 生成に必要なパラメータスキーマ）を取得します。外部サイトや Web へのアクセスは行わず、参照範囲はユーザー自身のワークスペース内に限定されます。search ツールで見つけたテンプレートの中身を確認したいときに使用します。

`search_gallery_templates`

公開テンプレートギャラリーから、まだワークスペースに取り込んでいないテンプレートをキーワードで探します（認証不要）。タイトル・説明・タグ・カテゴリの部分一致で絞り込み、各候補の slug・title・description・category・tags・thumbnailUrl・duplicateCount を返します。ワークスペース内の既存デザインを探す場合はこのツールではなく list_templates / search を使ってください。重要: このツールが返す slug では PDF 生成できません。先に copy_gallery_template で自分のワークスペースへ複製し、返された designId を get_design_parameters / generate_pdf_sync に渡してください。

`get_gallery_template`

公開テンプレートギャラリーのテンプレート詳細を slug で取得します（認証不要）。説明全文・カテゴリ・タグ・サムネイルURL・テンプレート版・複製実績数・作成者名を返します。slug は search_gallery_templates の結果から取得してください。重要: ギャラリーのテンプレートはまだワークスペースにありません。この slug では PDF 生成できないため、使う場合は copy_gallery_template で複製し、返された designId を get_design_parameters / generate_pdf_sync に渡してください。

`copy_gallery_template`

公開テンプレートギャラリーのテンプレートを、認可時に選択した自分のワークスペースへ複製します（要認証・書き込み）。複製先ワークスペースは接続時の認可で決まっており、引数で変更できません。成功すると designId と version を返すので、そのまま get_design_parameters → generate_pdf_sync に渡して PDF 生成へ進めます。slug は search_gallery_templates / get_gallery_template で確認してください。注意: 呼ぶたびに新しいデザインが 1 件作成されます（同じ slug でも既存の複製は再利用されません）。同じテンプレートを誤って何度も複製しないでください。

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

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

McpServers

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

Why ReportFlow MCP

Several MCP servers exist for business-document generation. ReportFlow MCP differentiates itself on three axes. 1. Remote-ready, setup-free — A hosted endpoint at https://mcp.re-port-flow.com/mcp lets you connect from Claude.ai (web) without installing npm or Node.js. Unlike other Japanese 帳票 (chohyo) MCP servers that ship as stdio-only local processes, business users without a dev environment can start using it on day one. 2. No-code template design + template marketplace — Templates are designed in a browser-based GUI editor (Konva-based) with no code. A free template gallery covers invoices, quotes, receipts, delivery slips, reports and more, so AI agents can invoke ready-made templates from day one. You don't need to author JSON schemas to add templates. 3. OAuth 2.0 + Dynamic Client Registration — Authentication is OAuth 2.0 (Authorization Code + PKCE) with Dynamic Client Registration — no API key is ever handed to the AI client. The security posture matches Claude.ai's first-party Connectors. ## What it does - Generate PDFs from natural-language requests like "create an invoice for Acme Corp totalling $330" - Expose your ReportFlow designs and parameter schemas as MCP Resources so the AI can attach them as context - Bulk-generate many PDFs and download them as a single ZIP - Save outputs to your AI client's workspace folder (stdio mode) ## Setup ### Remote (recommended — no Node.js required) ```json { "mcpServers": { "reportflow": { "type": "http", "url": "https://mcp.re-port-flow.com/mcp" } } } VS Code uses servers at the top level instead of mcpServers. In Claude.ai (web), open Settings → Connectors → Add custom connector and paste the URL above. Local (stdio) — requires Node.js 18+ { "mcpServers": { "reportflow": { "command": "npx", "args": ["-y", "reportflow-mcp"] } } } MCP capabilities - Tools: authenticate, list_templates, get_design_parameters, generate_pdf_sync, generate_pdf_async, generate_pdfs_sync, generate_pdfs_async, download_file, download_zip, suggest_params - Resources: reportflow://designs, reportflow://designs/{id}/parameters, reportflow://errors, reportflow://server-info - Prompts: /generate_pdf, /generate_pdfs, /reportflow_help - OAuth 2.0 + PKCE + Dynamic Client Registration - Tool Annotations (title / readOnlyHint / destructiveHint / idempotentHint / openWorldHint) on every tool so MCP-aware clients render human-readable names and route the right approval prompts Authentication Remote: when the client connects for the first time, a browser tab opens for OAuth consent. Pick a workspace, approve, done. Tokens are managed server-side. Local: ask the AI to "authenticate with ReportFlow" — same OAuth flow. Tokens are stored in the OS keychain (macOS Keychain / Windows Credential Manager / Linux libsecret), with a chmod-0600 file fallback when libsecret is unavailable. Requirements - Remote: an MCP-capable AI client (Claude.ai, Claude Desktop, Cursor, VS Code) and a ReportFlow account. That's it. - Local: Node.js 18+ (auto-fetched by npx), a local environment with a browser for first-run auth, and a ReportFlow account. Links - npm: https://www.npmjs.com/package/reportflow-mcp - GitHub: https://github.com/re-port-flow/reportflow-mcp - Official docs: https://doc.re-port-flow.com/docs/integrations/mcp - MCP Registry: io.github.re-port-flow/reportflow-mcp - Glama: https://glama.ai/mcp/servers/re-port-flow/reportflow-mcp License: MIT

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

Reportflow Mcp

About

Details

Jump to

Setting up with Highlight

Setting up with Cursor

JSON

JSON

JSON

Setting up with Claude Desktop

JSON

JSON

JSON

Setting up with Windsurf

JSON

JSON

JSON

Setting up with Cline

JSON

JSON

JSON

Setting up with Goose

JSON

JSON

JSON

From the repository

`get_design_parameters`

`list_templates`

`generate_pdf_sync`

`generate_pdfs_async`

`suggest_params`

`search`

`fetch`

`search_gallery_templates`

`get_gallery_template`

`copy_gallery_template`

Claude Desktop / Cursor

McpServers

Why ReportFlow MCP

Install

About

Details

Jump to

Setting up with Highlight

From the repository

get_design_parameters

list_templates

generate_pdf_sync

generate_pdfs_async

suggest_params

search

fetch

search_gallery_templates

get_gallery_template

copy_gallery_template

Claude Desktop / Cursor

McpServers

Why ReportFlow MCP

Install

More like this

Sequential Thinking

Filesystem

EverArt

Google Drive

Reactive Resume

FastMCP v2 🚀

`get_design_parameters`

`list_templates`

`generate_pdf_sync`

`generate_pdfs_async`

`suggest_params`

`search`

`fetch`

`search_gallery_templates`

`get_gallery_template`

`copy_gallery_template`